The module provides handy URL class for URL parsing and changing.
.. 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.aio-libs.org
.. image:: https://img.shields.io/pypi/pyversions/yarl.svg :target: https://pypi.python.org/pypi/yarl
.. image:: https://img.shields.io/matrix/aio-libs:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat :target: https://matrix.to/#/%23aio-libs:matrix.org :alt: Matrix Room — #aio-libs:matrix.org
.. image:: https://img.shields.io/matrix/aio-libs-space:matrix.org?label=Discuss%20on%20Matrix%20at%20%23aio-libs-space%3Amatrix.org&logo=matrix&server_fqdn=matrix.org&style=flat :target: https://matrix.to/#/%23aio-libs-space:matrix.org :alt: Matrix Space — #aio-libs-space:matrix.org
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
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/%D1%88%D0%BB%D1%8F%D1%85')
Regular properties are percent-decoded, use raw_
versions for
getting encoded strings:
.. code-block:: pycon
url.path '/шлях'
url.raw_path '/%D1%88%D0%BB%D1%8F%D1%85'
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.aio-libs.org.
::
$ 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 using a PEP 517
configuration setting pure-python
, or setting the YARL_NO_EXTENSIONS
environment variable to a non-empty value, e.g.:
.. code-block:: console
$ pip install yarl --config-settings=pure-python=false
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.
YARL requires multidict_ library.
The documentation is located at https://yarl.aio-libs.org.
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.
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.
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.
aio-libs google group: https://groups.google.com/forum/#!forum/aio-libs
Feel free to post your questions and ideas here.
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
=========
.. 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
(2024-09-01)
Removed support 3986#section-3.2.3
port normalization when the scheme is not one of http
, https
, wss
, or ws
-- by @bdraco <https://github.com/sponsors/bdraco>
__.
Support for port normalization was recently added in #1033 <https://github.com/aio-libs/yarl/issues/1033>
__ and contained code that would do blocking I/O if the scheme was not one of the four listed above. The code has been removed because this library is intended to be safe for usage with asyncio
.
Related issues and pull requests on GitHub:
#1076 <https://github.com/aio-libs/yarl/issues/1076>
__.
Improved performance of property caching -- by @bdraco <https://github.com/sponsors/bdraco>
__.
The reify
implementation from aiohttp
was adapted to replace the internal cached_property
implementation.
Related issues and pull requests on GitHub:
#1070 <https://github.com/aio-libs/yarl/issues/1070>
__.
(2024-08-30)
Reverted 3986
compatible URL.join()()
honoring empty segments which was introduced in #1039 <https://github.com/aio-libs/yarl/issues/1039>
__.
This change introduced a regression handling query string parameters with joined URLs. The change was reverted to maintain compatibility with the previous behavior.
Related issues and pull requests on GitHub:
#1067 <https://github.com/aio-libs/yarl/issues/1067>
__.
(2024-08-30)
Joining URLs with empty segments has been changed
to match 3986
.
Previously empty segments would be removed from path, breaking use-cases such as
.. code-block:: python
URL("https://web.archive.org/web/") / "https://github.com/"
Now / operation()
and URL.joinpath()()
keep empty segments, but do not introduce new empty segments.
e.g.
.. code-block:: python
URL("https://example.org/") / ""
does not introduce an empty segment.
-- by @commonism <https://github.com/sponsors/commonism>
_ and @youtux <https://github.com/sponsors/youtux>
_
Related issues and pull requests on GitHub:
#1026 <https://github.com/aio-libs/yarl/issues/1026>
__.
The default protocol ports of well-known URI schemes are now taken into account
during the normalization of the URL string representation in accordance with
3986#section-3.2.3
.
Specified ports are removed from the str
representation of a ~yarl.URL
if the port matches the scheme's default port -- by @commonism <https://github.com/sponsors/commonism>
__.
Related issues and pull requests on GitHub:
#1033 <https://github.com/aio-libs/yarl/issues/1033>
__.
URL.join()()
has been changed to match
3986
and align with
/ operation()
and URL.joinpath()()
when joining URLs with empty segments.
Previously urllib.parse.urljoin
was used,
which has known issues with empty segments
(python/cpython#84774 <https://github.com/python/cpython/issues/84774>
_).
Due to the semantics of URL.join()()
, joining an
URL with scheme requires making it relative, prefixing with ./
.
.. code-block:: pycon
URL("https://web.archive.org/web/").join(URL("./https://github.com/aio-libs/yarl")) URL('https://web.archive.org/web/https://github.com/aio-libs/yarl')
Empty segments are honored in the base as well as the joined part.
.. code-block:: pycon
URL("https://web.archive.org/web/https://").join(URL("github.com/aio-libs/yarl")) URL('https://web.archive.org/web/https://github.com/aio-libs/yarl')
-- by @commonism <https://github.com/sponsors/commonism>
__
Related issues and pull requests on GitHub:
#1039 <https://github.com/aio-libs/yarl/issues/1039>
__.
Stopped decoding %2F
(/
) in URL.path
, as this could lead to code incorrectly treating it as a path separator
-- by @Dreamsorcerer <https://github.com/sponsors/Dreamsorcerer>
__.
Related issues and pull requests on GitHub:
#1057 <https://github.com/aio-libs/yarl/issues/1057>
__.
Dropped support for Python 3.7 -- by @Dreamsorcerer <https://github.com/sponsors/Dreamsorcerer>
__.
Related issues and pull requests on GitHub:
#1016 <https://github.com/aio-libs/yarl/issues/1016>
__.
On the Contributing docs
page,
a link to the Towncrier philosophy
has been fixed.
Related issues and pull requests on GitHub:
#981 <https://github.com/aio-libs/yarl/issues/981>
__.
The pre-existing / magic method()
has been documented in the API reference -- by @commonism <https://github.com/sponsors/commonism>
__.
Related issues and pull requests on GitHub:
#1026 <https://github.com/aio-libs/yarl/issues/1026>
__.
A flaw in the logic for copying the project directory into a
temporary folder that led to infinite recursion when TMPDIR
was set to a project subdirectory path. This was happening in Fedora
and its downstream due to the use of pyproject-rpm-macros
<https://src.fedoraproject.org/rpms/pyproject-rpm-macros>
__. It was
only reproducible with pip wheel
and was not affecting the
pyproject-build
users.
-- by @hroncok <https://github.com/sponsors/hroncok>
_ and @webknjaz <https://github.com/sponsors/webknjaz>
_
Related issues and pull requests on GitHub:
#992 <https://github.com/aio-libs/yarl/issues/992>
, #1014 <https://github.com/aio-libs/yarl/issues/1014>
.
Support Python 3.13 and publish non-free-threaded wheels
Related issues and pull requests on GitHub:
#1054 <https://github.com/aio-libs/yarl/issues/1054>
__.
The CI/CD setup has been updated to test arm64
wheels
under macOS 14, except for Python 3.7 that is unsupported
in that environment -- by @webknjaz <https://github.com/sponsors/webknjaz>
__.
Related issues and pull requests on GitHub:
#1015 <https://github.com/aio-libs/yarl/issues/1015>
__.
Removed unused type ignores and casts -- by @hauntsaninja <https://github.com/sponsors/hauntsaninja>
__.
Related issues and pull requests on GitHub:
#1031 <https://github.com/aio-libs/yarl/issues/1031>
__.
port
, scheme
, and raw_host
are now cached_property
-- by @bdraco <https://github.com/sponsors/bdraco>
__.
aiohttp
accesses these properties quite often, which cause urllib
to build the _hostinfo
property every time. port
, scheme
, and raw_host
are now cached properties, which will improve performance.
Related issues and pull requests on GitHub:
#1044 <https://github.com/aio-libs/yarl/issues/1044>
, #1058 <https://github.com/aio-libs/yarl/issues/1058>
.
Started raising TypeError
when a string value is passed into
yarl.URL.build()
as the port
argument -- by @commonism <https://github.com/sponsors/commonism>
__.
Previously the empty string as port would create malformed URLs when rendered as string representations. (#883 <https://github.com/aio-libs/yarl/issues/883>
__)
The leading --
has been dropped from the PEP 517 <https://peps.python.org/pep-517>
_ in-tree build
backend config setting names. --pure-python
is now just pure-python
-- by @webknjaz <https://github.com/sponsors/webknjaz>
_.
The usage now looks as follows:
.. code-block:: console
$ python -m build \
--config-setting=pure-python=true \
--config-setting=with-cython-tracing=true
(#963 <https://github.com/aio-libs/yarl/issues/963>
__)
A step-by-step Release Guide
guide has
been added, describing how to release yarl -- by @webknjaz <https://github.com/sponsors/webknjaz>
__.
This is primarily targeting maintainers. (#960 <https://github.com/aio-libs/yarl/issues/960>
__)
Coverage collection has been implemented for the Cython modules
-- by @webknjaz <https://github.com/sponsors/webknjaz>
__.
It will also be reported to Codecov from any non-release CI jobs.
To measure coverage in a development environment, yarl can be installed in editable mode:
.. code-block:: console
$ python -Im pip install -e .
Editable install produces C-files required for the Cython coverage plugin to map the measurements back to the PYX-files.
#961 <https://github.com/aio-libs/yarl/issues/961>
__
It is now possible to request line tracing in Cython builds using the
with-cython-tracing
PEP 517 <https://peps.python.org/pep-517>
_ config setting
-- @webknjaz <https://github.com/sponsors/webknjaz>
_.
This can be used in CI and development environment to measure coverage on Cython modules, but is not normally useful to the end-users or downstream packagers.
Here's a usage example:
.. code-block:: console
$ python -Im pip install . --config-settings=with-cython-tracing=true
For editable installs, this setting is on by default. Otherwise, it's off unless requested explicitly.
The following produces C-files required for the Cython coverage plugin to map the measurements back to the PYX-files:
.. code-block:: console
$ python -Im pip install -e .
Alternatively, the YARL_CYTHON_TRACING=1
environment variable
can be set to do the same as the PEP 517 <https://peps.python.org/pep-517>
__ config setting.
#962 <https://github.com/aio-libs/yarl/issues/962>
__
yarl.URL.joinpath()
-- by @gmacon <https://github.com/sponsors/gmacon>
. (#862 <https://github.com/aio-libs/yarl/issues/862>
, #866 <https://github.com/aio-libs/yarl/issues/866>
__)yarl.URL.__truediv__()
operations (URL / segment
) -- by @mjpieters <https://github.com/sponsors/mjpieters>
. (#871 <https://github.com/aio-libs/yarl/issues/871>
, #884 <https://github.com/aio-libs/yarl/issues/884>
__)@mjpieters <https://github.com/sponsors/mjpieters>
. (#876 <https://github.com/aio-libs/yarl/issues/876>
, #882 <https://github.com/aio-libs/yarl/issues/882>
__)URL.missing_port()
, URL.__bytes__()
and the encoding
argument to yarl.URL.joinpath()
-- by @mjpieters <https://github.com/sponsors/mjpieters>
. (#891 <https://github.com/aio-libs/yarl/issues/891>
)@mjpieters <https://github.com/sponsors/mjpieters>
. (#829 <https://github.com/aio-libs/yarl/issues/829>
, #881 <https://github.com/aio-libs/yarl/issues/881>
__)setuptools.build_meta
as the PEP 517 <https://peps.python.org/pep-517>
__ build
backend in pyproject.toml
explicitly -- by @webknjaz <https://github.com/sponsors/webknjaz>
. (#886 <https://github.com/aio-libs/yarl/issues/886>
)setup.cfg
config -- by @webknjaz <https://github.com/sponsors/webknjaz>
. (#890 <https://github.com/aio-libs/yarl/issues/890>
)The packaging is replaced from an old-fashioned setup.py
to an
in-tree PEP 517 <https://peps.python.org/pep-517>
_ build backend -- by @webknjaz <https://github.com/sponsors/webknjaz>
_.
Whenever the end-users or downstream packagers need to build yarl
from
source (a Git checkout or an sdist), they may pass a config_settings
flag --pure-python
. If this flag is not set, a C-extension will be built
and included into the distribution.
Here is how this can be done with pip
:
.. code-block:: console
$ python -m pip install . --config-settings=--pure-python=false
This will also work with -e | --editable
.
The same can be achieved via pypa/build
:
.. code-block:: console
$ python -m build --config-setting=--pure-python=false
Adding -w | --wheel
can force pypa/build
produce a wheel from source
directly, as opposed to building an sdist
and then building from it. (#893 <https://github.com/aio-libs/yarl/issues/893>
__)
.. attention::
v1.9.3 was the only version using the --pure-python
setting name.
Later versions dropped the --
prefix, making it just pure-python
.
Declared Python 3.12 supported officially in the distribution package metadata
-- by @edgarrmondragon <https://github.com/sponsors/edgarrmondragon>
. (#942 <https://github.com/aio-libs/yarl/issues/942>
)
#821 <https://github.com/aio-libs/yarl/issues/821>
_
and 3986
-- by @kenballus <https://github.com/sponsors/kenballus>
. (#821 <https://github.com/aio-libs/yarl/issues/821>
, #822 <https://github.com/aio-libs/yarl/issues/822>
_)@mjpieters <https://github.com/sponsors/mjpieters>
. (#881 <https://github.com/aio-libs/yarl/issues/881>
)@edgarrmondragon <https://github.com/sponsors/edgarrmondragon>
. (#942 <https://github.com/aio-libs/yarl/issues/942>
)MyST is now integrated in Sphinx -- by @webknjaz <https://github.com/sponsors/webknjaz>
__.
This allows the contributors to author new documents in Markdown
when they have difficulties with going straight RST. (#953 <https://github.com/aio-libs/yarl/issues/953>
__)
yarl.URL.__truediv__()
and absolute URLs with empty paths causing the raw path to lack the leading /
.
(#854 <https://github.com/aio-libs/yarl/issues/854>
_)#850 <https://github.com/aio-libs/yarl/issues/850>
_)This release was never published to PyPI, due to issues with the build process.
URL.joinpath(*elements)
, to create a new URL appending multiple path elements. (#704 <https://github.com/aio-libs/yarl/issues/704>
_)URL.__truediv__()()
return NotImplemented
if called with an
unsupported type — by @michaeljpeters <https://github.com/sponsors/michaeljpeters>
_.
(#832 <https://github.com/aio-libs/yarl/issues/832>
)..
segments would otherwise go beyond the URL path root.
(#536 <https://github.com/aio-libs/yarl/issues/536>
_)#792 <https://github.com/aio-libs/yarl/issues/792>
)#793 <https://github.com/aio-libs/yarl/issues/793>
)yarl.URL.build()
raise a TypeError
if the host
argument is None
— by @paulpapacz <https://github.com/sponsors/paulpapacz>
_. (#808 <https://github.com/aio-libs/yarl/issues/808>
)update_query()
getting rid of the query when the argument
is empty but not None
. (#845 <https://github.com/aio-libs/yarl/issues/845>
_)#220 <https://github.com/aio-libs/yarl/issues/220>
_This is the first release that started shipping wheels for Python 3.11.
#694 <https://github.com/aio-libs/yarl/issues/694>
, #699 <https://github.com/aio-libs/yarl/issues/699>
, #700 <https://github.com/aio-libs/yarl/issues/700>
, #701 <https://github.com/aio-libs/yarl/issues/701>
, #702 <https://github.com/aio-libs/yarl/issues/702>
, #703 <https://github.com/aio-libs/yarl/issues/703>
, #739 <https://github.com/aio-libs/yarl/issues/739>
_URL.raw_suffix
, URL.suffix
, URL.raw_suffixes
, URL.suffixes
, URL.with_suffix
. (#613 <https://github.com/aio-libs/yarl/issues/613>
_)yarl.URL.human_repr()
.
(#665 <https://github.com/aio-libs/yarl/issues/665>
_)multidict:index
docs. (#665 <https://github.com/aio-libs/yarl/issues/665>
_)#672 <https://github.com/aio-libs/yarl/issues/672>
_)#646 <https://github.com/aio-libs/yarl/issues/646>
, #699 <https://github.com/aio-libs/yarl/issues/699>
, #701 <https://github.com/aio-libs/yarl/issues/701>
_with_port()
to stop reencoding parts of the URL that were already encoded. (#623 <https://github.com/aio-libs/yarl/issues/623>
_)__bytes__()
magic method so that bytes(url)
will work and use optimal ASCII encoding.
(#582 <https://github.com/aio-libs/yarl/issues/582>
_)#622 <https://github.com/aio-libs/yarl/issues/622>
_)musl
tag targeting typical Alpine Linux runtimes. (#622 <https://github.com/aio-libs/yarl/issues/622>
_)#622 <https://github.com/aio-libs/yarl/issues/622>
_)%e2%82%f8
). All non-decodable percent-sequences are now preserved.
#517 <https://github.com/aio-libs/yarl/issues/517>
_#535 <https://github.com/aio-libs/yarl/issues/535>
_.c
files in TarBall distribution.
#530 <https://github.com/aio-libs/multidict/issues/530>
_aarch64
, i686
, ppc64le
, s390x
architectures on
Linux as well as x86_64
.
#507 <https://github.com/aio-libs/yarl/issues/507>
_#526 <https://github.com/aio-libs/yarl/issues/526>
_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>
_#514 <https://github.com/aio-libs/yarl/issues/514>
_%
which is not followed by two hexadecimal digits.
#516 <https://github.com/aio-libs/yarl/issues/516>
_%
followed by a space and hexadecimal digit.
#520 <https://github.com/aio-libs/yarl/issues/520>
_with_query()
/update_query()
methods for key=[val1, val2]
case.
#528 <https://github.com/aio-libs/yarl/issues/528>
_#492 <https://github.com/aio-libs/yarl/issues/492>
_URL.build()
, with_xxx()
and in /
operator.
#502 <https://github.com/aio-libs/yarl/issues/502>
_origin()
.
#504 <https://github.com/aio-libs/yarl/issues/504>
_yarl._quoting_c
C-extension into published PyPI dists.
#485 <https://github.com/aio-libs/yarl/issues/485>
_#484 <https://github.com/aio-libs/yarl/issues/484>
_#386 <https://github.com/aio-libs/yarl/issues/386>
_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>
_
URL.build()
with scheme and path (creates a relative URL).
#464 <https://github.com/aio-libs/yarl/issues/464>
_#476 <https://github.com/aio-libs/yarl/issues/476>
_@final
/ Final
type hints
#477 <https://github.com/aio-libs/yarl/issues/477>
_URL.build()
method.
#478 <https://github.com/aio-libs/yarl/issues/478>
#483 <https://github.com/aio-libs/yarl/issues/483>
_#409 <https://github.com/aio-libs/yarl/issues/409>
_#426 <https://github.com/aio-libs/yarl/issues/426>
_Query
and QueryVariable
type aliases in __init__.pyi
, now they are prefixed with underscore.
#431 <https://github.com/aio-libs/yarl/issues/431>
_#451 <https://github.com/aio-libs/yarl/issues/451>
_str.isascii()
in Python 3.6
#389 <https://github.com/aio-libs/yarl/issues/389>
_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 message the path that produces starting slash forbidden error (#376)
Skip slow IDNA encoding for ASCII-only strings (#387)
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 can't be converted to int (#168)
bool(URL())
now returns False
(#272)
build
(#199)cached_property
(#195)str
subclasses in URL
constructor (#190)Forbid inheritance, replace __init__
with __new__
(#171)
Support PEP-561 (provide type hinting marker) (#182)
netloc
(#170)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)
TypeError
by url.query_string()
after
url.with_query({})
(empty mapping) (#141)raw_path_qs
attribute (#137)strict
parameter as no-op in quote
/ unquote
strict
parameter as no-op for sake of compatibility with
aiohttp 2.2Drop strict mode (#123)
Fix "ValueError: Unallowed PCT %"
when there's a "%"
in the URL (#124)
Document encoded
parameter (#102)
Support relative URLs like '?key=value'
(#100)
Unsafe encoding for QS fixed. Encode ;
character in value parameter (#104)
Process passwords without user names (#95)
Properly support paths without leading slash in URL.with_path()
(#90)
Enable type annotation checks
Normalize path (#86)
Clear query and fragment parts in .with_path()
(#85)
Unexpected compare behavior (#73)
Do not quote or unquote + if not a query string. (#74)
Added URL.build
class method (#58)
Added path_qs
attribute (#42)
:
in pathLoad from pickle without _cache (#56)
Percent-encoded pluses in path variables become spaces (#59)
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)
quote
/ unquote
.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
str
but all classes inherited from str
also (#25)int
as value for .with_query()
setup.py
(#20)typing.NamedTuple
fields but indexes on URL construction_encode
class methodquote()
and unquote()
as public API'/path?arg'
)relative()
(#16)with_query()
parameteris_default_port()
Avoid doubling slashes when joining paths (#13)
Appending path starting from slash is forbidden (#12)
kwargs
support for with_query()
(#10)Document with_query()
, with_fragment()
and origin()
Allow None
for with_query()
and with_fragment()