---
id: yarl
version: "1.24.5"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# yarl — Yet another URL library

License: permissive · Maintenance: active · Popularity: top 100 on PyPI

## Install

pip install yarl
uv add yarl
poetry add yarl

## Description

yarl
====

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/graph/badge.svg?flag=pytest
   :target: https://app.codecov.io/gh/aio-libs/yarl?flags[]=pytest
   :alt: Codecov coverage for the pytest-driven measurements

.. image:: https://img.shields.io/endpoint?url=https://codspeed.io/badge.json
   :target: https://codspeed.io/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::...

## AI interpretation — verify before relying

yarl provides an immutable URL class for parsing, validating, and manipulating URLs with automatic percent-encoding and convenient property access to URL components.

Verdict: yarl is a production-stable, actively maintained URL library in the top 100 PyPI packages with zero known vulnerabilities. Its immutable design, automatic encoding/decoding, and low install friction make it suitable for most URL-handling tasks, though users should be aware that the pure-Python fallback (used on PyPy or when extensions are disabled) has performance trade-offs.

[View on SkillFed](https://skillfed.io/packages/yarl) · [View on PyPI](https://pypi.org/project/yarl/)