diff options
Diffstat (limited to 'third_party/python/yarl/yarl.egg-info/PKG-INFO')
| -rw-r--r-- | third_party/python/yarl/yarl.egg-info/PKG-INFO | 797 |
1 files changed, 797 insertions, 0 deletions
diff --git a/third_party/python/yarl/yarl.egg-info/PKG-INFO b/third_party/python/yarl/yarl.egg-info/PKG-INFO new file mode 100644 index 0000000000..3c242e5135 --- /dev/null +++ b/third_party/python/yarl/yarl.egg-info/PKG-INFO @@ -0,0 +1,797 @@ +Metadata-Version: 2.1 +Name: yarl +Version: 1.6.3 +Summary: Yet another URL library +Home-page: https://github.com/aio-libs/yarl/ +Author: Andrew Svetlov +Author-email: andrew.svetlov@gmail.com +License: Apache 2 +Description: yarl + ==== + + .. image:: https://github.com/aio-libs/yarl/workflows/CI/badge.svg + :target: https://github.com/aio-libs/yarl/actions?query=workflow%3ACI + :align: right + + .. image:: https://codecov.io/gh/aio-libs/yarl/branch/master/graph/badge.svg + :target: https://codecov.io/gh/aio-libs/yarl + + .. image:: https://badge.fury.io/py/yarl.svg + :target: https://badge.fury.io/py/yarl + + + .. image:: https://readthedocs.org/projects/yarl/badge/?version=latest + :target: https://yarl.readthedocs.io + + + .. image:: https://img.shields.io/pypi/pyversions/yarl.svg + :target: https://pypi.python.org/pypi/yarl + + .. image:: https://badges.gitter.im/Join%20Chat.svg + :target: https://gitter.im/aio-libs/Lobby + :alt: Chat on Gitter + + Introduction + ------------ + + Url is constructed from ``str``: + + .. code-block:: pycon + + >>> from yarl import URL + >>> url = URL('https://www.python.org/~guido?arg=1#frag') + >>> url + URL('https://www.python.org/~guido?arg=1#frag') + + All url parts: *scheme*, *user*, *password*, *host*, *port*, *path*, + *query* and *fragment* are accessible by properties: + + .. code-block:: pycon + + >>> url.scheme + 'https' + >>> url.host + 'www.python.org' + >>> url.path + '/~guido' + >>> url.query_string + 'arg=1' + >>> url.query + <MultiDictProxy('arg': '1')> + >>> url.fragment + 'frag' + + All url manipulations produce a new url object: + + .. code-block:: pycon + + >>> url = URL('https://www.python.org') + >>> url / 'foo' / 'bar' + URL('https://www.python.org/foo/bar') + >>> url / 'foo' % {'bar': 'baz'} + URL('https://www.python.org/foo?bar=baz') + + Strings passed to constructor and modification methods are + automatically encoded giving canonical representation as result: + + .. code-block:: pycon + + >>> url = URL('https://www.python.org/путь') + >>> url + URL('https://www.python.org/%D0%BF%D1%83%D1%82%D1%8C') + + Regular properties are *percent-decoded*, use ``raw_`` versions for + getting *encoded* strings: + + .. code-block:: pycon + + >>> url.path + '/путь' + + >>> url.raw_path + '/%D0%BF%D1%83%D1%82%D1%8C' + + Human readable representation of URL is available as ``.human_repr()``: + + .. code-block:: pycon + + >>> url.human_repr() + 'https://www.python.org/путь' + + For full documentation please read https://yarl.readthedocs.org. + + + Installation + ------------ + + :: + + $ pip install yarl + + The library is Python 3 only! + + PyPI contains binary wheels for Linux, Windows and MacOS. If you want to install + ``yarl`` on another operating system (like *Alpine Linux*, which is not + manylinux-compliant because of the missing glibc and therefore, cannot be + used with our wheels) the the tarball will be used to compile the library from + the source code. It requires a C compiler and and Python headers installed. + + To skip the compilation you must explicitly opt-in by setting the `YARL_NO_EXTENSIONS` + environment variable to a non-empty value, e.g.: + + .. code-block:: bash + + $ YARL_NO_EXTENSIONS=1 pip install yarl + + Please note that the pure-Python (uncompiled) version is much slower. However, + PyPy always uses a pure-Python implementation, and, as such, it is unaffected + by this variable. + + Dependencies + ------------ + + YARL requires multidict_ library. + + + API documentation + ------------------ + + The documentation is located at https://yarl.readthedocs.org + + + Why isn't boolean supported by the URL query API? + ------------------------------------------------- + + There is no standard for boolean representation of boolean values. + + Some systems prefer ``true``/``false``, others like ``yes``/``no``, ``on``/``off``, + ``Y``/``N``, ``1``/``0``, etc. + + ``yarl`` cannot make an unambiguous decision on how to serialize ``bool`` values because + it is specific to how the end-user's application is built and would be different for + different apps. The library doesn't accept booleans in the API; a user should convert + bools into strings using own preferred translation protocol. + + + Comparison with other URL libraries + ------------------------------------ + + * furl (https://pypi.python.org/pypi/furl) + + The library has rich functionality but the ``furl`` object is mutable. + + I'm afraid to pass this object into foreign code: who knows if the + code will modify my url in a terrible way while I just want to send URL + with handy helpers for accessing URL properties. + + ``furl`` has other non-obvious tricky things but the main objection + is mutability. + + * URLObject (https://pypi.python.org/pypi/URLObject) + + URLObject is immutable, that's pretty good. + + Every URL change generates a new URL object. + + But the library doesn't do any decode/encode transformations leaving the + end user to cope with these gory details. + + + Source code + ----------- + + The project is hosted on GitHub_ + + Please file an issue on the `bug tracker + <https://github.com/aio-libs/yarl/issues>`_ if you have found a bug + or have some suggestion in order to improve the library. + + The library uses `Azure Pipelines <https://dev.azure.com/aio-libs/yarl>`_ for + Continuous Integration. + + Discussion list + --------------- + + *aio-libs* google group: https://groups.google.com/forum/#!forum/aio-libs + + Feel free to post your questions and ideas here. + + + Authors and License + ------------------- + + The ``yarl`` package is written by Andrew Svetlov. + + It's *Apache 2* licensed and freely available. + + + .. _GitHub: https://github.com/aio-libs/yarl + + .. _multidict: https://github.com/aio-libs/multidict + + + ========= + Changelog + ========= + + .. + You should *NOT* be adding new change log entries to this file, this + file is managed by towncrier. You *may* edit previous change logs to + fix problems like typo corrections or such. + To add a new change log entry, please see + https://pip.pypa.io/en/latest/development/#adding-a-news-entry + we named the news folder "changes". + + WARNING: Don't drop the next directive! + + .. towncrier release notes start + + 1.6.3 (2020-11-14) + ================== + + Bugfixes + -------- + + - No longer loose characters when decoding incorrect percent-sequences (like ``%e2%82%f8``). All non-decodable percent-sequences are now preserved. + `#517 <https://github.com/aio-libs/yarl/issues/517>`_ + - Provide x86 Windows wheels. + `#535 <https://github.com/aio-libs/yarl/issues/535>`_ + + + ---- + + + 1.6.2 (2020-10-12) + ================== + + + Bugfixes + -------- + + - Provide generated ``.c`` files in TarBall distribution. + `#530 <https://github.com/aio-libs/multidict/issues/530>`_ + + 1.6.1 (2020-10-12) + ================== + + Features + -------- + + - Provide wheels for ``aarch64``, ``i686``, ``ppc64le``, ``s390x`` architectures on + Linux as well as ``x86_64``. + `#507 <https://github.com/aio-libs/yarl/issues/507>`_ + - Provide wheels for Python 3.9. + `#526 <https://github.com/aio-libs/yarl/issues/526>`_ + + Bugfixes + -------- + + - ``human_repr()`` now always produces valid representation equivalent to the original URL (if the original URL is valid). + `#511 <https://github.com/aio-libs/yarl/issues/511>`_ + - Fixed requoting a single percent followed by a percent-encoded character in the Cython implementation. + `#514 <https://github.com/aio-libs/yarl/issues/514>`_ + - Fix ValueError when decoding ``%`` which is not followed by two hexadecimal digits. + `#516 <https://github.com/aio-libs/yarl/issues/516>`_ + - Fix decoding ``%`` followed by a space and hexadecimal digit. + `#520 <https://github.com/aio-libs/yarl/issues/520>`_ + - Fix annotation of ``with_query()``/``update_query()`` methods for ``key=[val1, val2]`` case. + `#528 <https://github.com/aio-libs/yarl/issues/528>`_ + + Removal + ------- + + - Drop Python 3.5 support; Python 3.6 is the minimal supported Python version. + + + ---- + + + 1.6.0 (2020-09-23) + ================== + + Features + -------- + + - Allow for int and float subclasses in query, while still denying bool. + `#492 <https://github.com/aio-libs/yarl/issues/492>`_ + + + Bugfixes + -------- + + - Do not requote arguments in ``URL.build()``, ``with_xxx()`` and in ``/`` operator. + `#502 <https://github.com/aio-libs/yarl/issues/502>`_ + - Keep IPv6 brackets in ``origin()``. + `#504 <https://github.com/aio-libs/yarl/issues/504>`_ + + + ---- + + + 1.5.1 (2020-08-01) + ================== + + Bugfixes + -------- + + - Fix including relocated internal ``yarl._quoting_c`` C-extension into published PyPI dists. + `#485 <https://github.com/aio-libs/yarl/issues/485>`_ + + + Misc + ---- + + - `#484 <https://github.com/aio-libs/yarl/issues/484>`_ + + + ---- + + + 1.5.0 (2020-07-26) + ================== + + Features + -------- + + - Convert host to lowercase on URL building. + `#386 <https://github.com/aio-libs/yarl/issues/386>`_ + - Allow using ``mod`` operator (`%`) for updating query string (an alias for ``update_query()`` method). + `#435 <https://github.com/aio-libs/yarl/issues/435>`_ + - Allow use of sequences such as ``list`` and ``tuple`` in the values + of a mapping such as ``dict`` to represent that a key has many values:: + + url = URL("http://example.com") + assert url.with_query({"a": [1, 2]}) == URL("http://example.com/?a=1&a=2") + + `#443 <https://github.com/aio-libs/yarl/issues/443>`_ + - Support URL.build() with scheme and path (creates a relative URL). + `#464 <https://github.com/aio-libs/yarl/issues/464>`_ + - Cache slow IDNA encode/decode calls. + `#476 <https://github.com/aio-libs/yarl/issues/476>`_ + - Add ``@final`` / ``Final`` type hints + `#477 <https://github.com/aio-libs/yarl/issues/477>`_ + - Support URL authority/raw_authority properties and authority argument of ``URL.build()`` method. + `#478 <https://github.com/aio-libs/yarl/issues/478>`_ + - Hide the library implementation details, make the exposed public list very clean. + `#483 <https://github.com/aio-libs/yarl/issues/483>`_ + + + Bugfixes + -------- + + - Fix tests with newer Python (3.7.6, 3.8.1 and 3.9.0+). + `#409 <https://github.com/aio-libs/yarl/issues/409>`_ + - Fix a bug where query component, passed in a form of mapping or sequence, is unquoted in unexpected way. + `#426 <https://github.com/aio-libs/yarl/issues/426>`_ + - Hide `Query` and `QueryVariable` type aliases in `__init__.pyi`, now they are prefixed with underscore. + `#431 <https://github.com/aio-libs/yarl/issues/431>`_ + - Keep ipv6 brackets after updating port/user/password. + `#451 <https://github.com/aio-libs/yarl/issues/451>`_ + + + ---- + + + 1.4.2 (2019-12-05) + ================== + + Features + -------- + + - Workaround for missing `str.isascii()` in Python 3.6 + `#389 <https://github.com/aio-libs/yarl/issues/389>`_ + + + ---- + + + 1.4.1 (2019-11-29) + ================== + + * Fix regression, make the library work on Python 3.5 and 3.6 again. + + 1.4.0 (2019-11-29) + ================== + + * Distinguish an empty password in URL from a password not provided at all (#262) + + * Fixed annotations for optional parameters of ``URL.build`` (#309) + + * Use None as default value of ``user`` parameter of ``URL.build`` (#309) + + * Enforce building C Accelerated modules when installing from source tarball, use + ``YARL_NO_EXTENSIONS`` environment variable for falling back to (slower) Pure Python + implementation (#329) + + * Drop Python 3.5 support + + * Fix quoting of plus in path by pure python version (#339) + + * Don't create a new URL if fragment is unchanged (#292) + + * Included in error msg the path that produces starting slash forbidden error (#376) + + * Skip slow IDNA encoding for ASCII-only strings (#387) + + + 1.3.0 (2018-12-11) + ================== + + * Fix annotations for ``query`` parameter (#207) + + * An incoming query sequence can have int variables (the same as for + Mapping type) (#208) + + * Add ``URL.explicit_port`` property (#218) + + * Give a friendlier error when port cant be converted to int (#168) + + * ``bool(URL())`` now returns ``False`` (#272) + + 1.2.6 (2018-06-14) + ================== + + * Drop Python 3.4 trove classifier (#205) + + 1.2.5 (2018-05-23) + ================== + + * Fix annotations for ``build`` (#199) + + 1.2.4 (2018-05-08) + ================== + + * Fix annotations for ``cached_property`` (#195) + + 1.2.3 (2018-05-03) + ================== + + * Accept ``str`` subclasses in ``URL`` constructor (#190) + + 1.2.2 (2018-05-01) + ================== + + * Fix build + + 1.2.1 (2018-04-30) + ================== + + * Pin minimal required Python to 3.5.3 (#189) + + 1.2.0 (2018-04-30) + ================== + + * Forbid inheritance, replace ``__init__`` with ``__new__`` (#171) + + * Support PEP-561 (provide type hinting marker) (#182) + + 1.1.1 (2018-02-17) + ================== + + * Fix performance regression: don't encode enmpty netloc (#170) + + 1.1.0 (2018-01-21) + ================== + + * Make pure Python quoter consistent with Cython version (#162) + + 1.0.0 (2018-01-15) + ================== + + * Use fast path if quoted string does not need requoting (#154) + + * Speed up quoting/unquoting by ``_Quoter`` and ``_Unquoter`` classes (#155) + + * Drop ``yarl.quote`` and ``yarl.unquote`` public functions (#155) + + * Add custom string writer, reuse static buffer if available (#157) + Code is 50-80 times faster than Pure Python version (was 4-5 times faster) + + * Don't recode IP zone (#144) + + * Support ``encoded=True`` in ``yarl.URL.build()`` (#158) + + * Fix updating query with multiple keys (#160) + + 0.18.0 (2018-01-10) + =================== + + * Fallback to IDNA 2003 if domain name is not IDNA 2008 compatible (#152) + + 0.17.0 (2017-12-30) + =================== + + * Use IDNA 2008 for domain name processing (#149) + + 0.16.0 (2017-12-07) + =================== + + * Fix raising ``TypeError`` by ``url.query_string()`` after + ``url.with_query({})`` (empty mapping) (#141) + + 0.15.0 (2017-11-23) + =================== + + * Add ``raw_path_qs`` attribute (#137) + + 0.14.2 (2017-11-14) + =================== + + * Restore ``strict`` parameter as no-op in ``quote`` / ``unquote`` + + 0.14.1 (2017-11-13) + =================== + + * Restore ``strict`` parameter as no-op for sake of compatibility with + aiohttp 2.2 + + 0.14.0 (2017-11-11) + =================== + + * Drop strict mode (#123) + + * Fix ``"ValueError: Unallowed PCT %"`` when there's a ``"%"`` in the url (#124) + + 0.13.0 (2017-10-01) + =================== + + * Document ``encoded`` parameter (#102) + + * Support relative urls like ``'?key=value'`` (#100) + + * Unsafe encoding for QS fixed. Encode ``;`` char in value param (#104) + + * Process passwords without user names (#95) + + 0.12.0 (2017-06-26) + =================== + + * Properly support paths without leading slash in ``URL.with_path()`` (#90) + + * Enable type annotation checks + + 0.11.0 (2017-06-26) + =================== + + * Normalize path (#86) + + * Clear query and fragment parts in ``.with_path()`` (#85) + + 0.10.3 (2017-06-13) + =================== + + * Prevent double URL args unquoting (#83) + + 0.10.2 (2017-05-05) + =================== + + * Unexpected hash behaviour (#75) + + + 0.10.1 (2017-05-03) + =================== + + * Unexpected compare behaviour (#73) + + * Do not quote or unquote + if not a query string. (#74) + + + 0.10.0 (2017-03-14) + =================== + + * Added ``URL.build`` class method (#58) + + * Added ``path_qs`` attribute (#42) + + + 0.9.8 (2017-02-16) + ================== + + * Do not quote ``:`` in path + + + 0.9.7 (2017-02-16) + ================== + + * Load from pickle without _cache (#56) + + * Percent-encoded pluses in path variables become spaces (#59) + + + 0.9.6 (2017-02-15) + ================== + + * Revert backward incompatible change (BaseURL) + + + 0.9.5 (2017-02-14) + ================== + + * Fix BaseURL rich comparison support + + + 0.9.4 (2017-02-14) + ================== + + * Use BaseURL + + + 0.9.3 (2017-02-14) + ================== + + * Added BaseURL + + + 0.9.2 (2017-02-08) + ================== + + * Remove debug print + + + 0.9.1 (2017-02-07) + ================== + + * Do not lose tail chars (#45) + + + 0.9.0 (2017-02-07) + ================== + + * Allow to quote ``%`` in non strict mode (#21) + + * Incorrect parsing of query parameters with %3B (;) inside (#34) + + * Fix core dumps (#41) + + * tmpbuf - compiling error (#43) + + * Added ``URL.update_path()`` method + + * Added ``URL.update_query()`` method (#47) + + + 0.8.1 (2016-12-03) + ================== + + * Fix broken aiohttp: revert back ``quote`` / ``unquote``. + + + 0.8.0 (2016-12-03) + ================== + + * Support more verbose error messages in ``.with_query()`` (#24) + + * Don't percent-encode ``@`` and ``:`` in path (#32) + + * Don't expose ``yarl.quote`` and ``yarl.unquote``, these functions are + part of private API + + 0.7.1 (2016-11-18) + ================== + + * Accept not only ``str`` but all classes inherited from ``str`` also (#25) + + 0.7.0 (2016-11-07) + ================== + + * Accept ``int`` as value for ``.with_query()`` + + 0.6.0 (2016-11-07) + ================== + + * Explicitly use UTF8 encoding in setup.py (#20) + * Properly unquote non-UTF8 strings (#19) + + 0.5.3 (2016-11-02) + ================== + + * Don't use namedtuple fields but indexes on URL construction + + 0.5.2 (2016-11-02) + ================== + + * Inline ``_encode`` class method + + 0.5.1 (2016-11-02) + ================== + + * Make URL construction faster by removing extra classmethod calls + + 0.5.0 (2016-11-02) + ================== + + * Add cython optimization for quoting/unquoting + * Provide binary wheels + + 0.4.3 (2016-09-29) + ================== + + * Fix typing stubs + + 0.4.2 (2016-09-29) + ================== + + * Expose ``quote()`` and ``unquote()`` as public API + + 0.4.1 (2016-09-28) + ================== + + * Support empty values in query (``'/path?arg'``) + + 0.4.0 (2016-09-27) + ================== + + * Introduce ``relative()`` (#16) + + 0.3.2 (2016-09-27) + ================== + + * Typo fixes #15 + + 0.3.1 (2016-09-26) + ================== + + * Support sequence of pairs as ``with_query()`` parameter + + 0.3.0 (2016-09-26) + ================== + + * Introduce ``is_default_port()`` + + 0.2.1 (2016-09-26) + ================== + + * Raise ValueError for URLs like 'http://:8080/' + + 0.2.0 (2016-09-18) + ================== + + * Avoid doubling slashes when joining paths (#13) + + * Appending path starting from slash is forbidden (#12) + + 0.1.4 (2016-09-09) + ================== + + * Add kwargs support for ``with_query()`` (#10) + + 0.1.3 (2016-09-07) + ================== + + * Document ``with_query()``, ``with_fragment()`` and ``origin()`` + + * Allow ``None`` for ``with_query()`` and ``with_fragment()`` + + 0.1.2 (2016-09-07) + ================== + + * Fix links, tune docs theme. + + 0.1.1 (2016-09-06) + ================== + + * Update README, old version used obsolete API + + 0.1.0 (2016-09-06) + ================== + + * The library was deeply refactored, bytes are gone away but all + accepted strings are encoded if needed. + + 0.0.1 (2016-08-30) + ================== + + * The first release. + +Platform: UNKNOWN +Classifier: License :: OSI Approved :: Apache Software License +Classifier: Intended Audience :: Developers +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.6 +Classifier: Programming Language :: Python :: 3.7 +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Topic :: Internet :: WWW/HTTP +Requires-Python: >=3.6 +Description-Content-Type: text/x-rst |