summaryrefslogtreecommitdiffstats
path: root/third_party/python/yarl/PKG-INFO
diff options
context:
space:
mode:
Diffstat (limited to 'third_party/python/yarl/PKG-INFO')
-rw-r--r--third_party/python/yarl/PKG-INFO797
1 files changed, 797 insertions, 0 deletions
diff --git a/third_party/python/yarl/PKG-INFO b/third_party/python/yarl/PKG-INFO
new file mode 100644
index 0000000000..3c242e5135
--- /dev/null
+++ b/third_party/python/yarl/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