gruns

furl: Parse and Modify URLs in Python

furl is a Python library for parsing and modifying URLs, making common URL operations less tedious than working directly with Python’s standard URL utilities. It supports Python 3 and PyPy3, with mutable URL components and encoding handled for you.

View on GitHub Compare
Stars
2.8k
Forks
172
Stars, last 30 days
+2
Last commit
7 days ago
Contributors
15

Our take

Maintaineda few commits in the last 90 days

Health score

33/100

How it is scored
Activity
31
Community
35
Issues
46
Pull requests
20

+2 stars in the last 30 days

furl is a focused URL-manipulation library with recent maintenance activity, but its work is highly concentrated in one contributor and it has had no release in over a year.

Good fit if

  • Your Python 3 or PyPy3 code frequently parses or edits URL components.
  • You need ordered, repeated query parameters or convenient path and fragment editing.
  • You are comfortable adopting a library whose recent maintenance is active but concentrated in one person.

Look elsewhere if

  • Your project does not need structured URL manipulation and standard-library utilities are sufficient.
  • Your adoption policy requires a clearly asserted license: the README describes furl as Unlicensed and public domain, while GitHub metadata reports no asserted license.
  • You require frequent packaged releases, as the latest release is more than a year old despite recent commits.
All health signals
Last commit2026-10-18 (7 days ago)
Commits, last 90 days4
Releases, last 12 months0 (latest v2.1.4, 2025-03-09)
Contributors15 (top contributor: 89% of commits)
Issues closed, last 90 days1
Pull requests merged, last 90 days0
Project age14 years

Checked on 2026-10-26 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

2,812

Forks

175

Change since Nov 16, 2026: 0 stars·0 forks

Overview

furl is a Python library for parsing and modifying URLs. It addresses the tedium of common URL operations with Python’s standard URL utilities by exposing URL components as objects that can be inspected and changed. The project supports Python 3 and PyPy3.

It is suited to application code that needs to build, edit, or inspect complete URLs, including paths, repeated query parameters, and fragments. Install it from PyPI with pip, and consult the README for the full API and examples.

Key Features

  • Access and update URL scheme, credentials, host, port, path, query, and fragment.
  • Modify paths through decoded segments, normalization, and a slash operator.
  • Preserve query parameter order and support multiple values for the same key.
  • Add, set, or remove URL components with chainable methods.
  • Handle percent-encoding and Unicode in URL components, including internationalized hostnames.
  • Join relative or absolute URLs using browser-like URL resolution.
  • Inspect URLs and components through dictionary representations.

Use Cases

  • Python web applications can add or remove query parameters while retaining repeated values and their ordering.
  • API clients can assemble request URLs from path segments and query arguments without manually encoding each component.
  • Redirect or navigation logic can resolve a relative URL against a current URL.
  • Tools that inspect or rewrite links can work with structured URL fields instead of manipulating raw strings.

What you need

Detected in the repository

  • Python (from setup.py)
  • A test suite and automated checks on GitHub Actions

Getting Started

Install with pip:

pip install furl

See the README for usage examples and API details.

License in Plain Words

No standard license was detected. Without a license, the default copyright rules apply: you may read the code, but not reuse it. Check the repository or ask the authors.

Alternatives

  • purl: purl offers an immutable URL API and RFC 6570 URI templates, while furl provides mutable URL components.
ProjectLanguageLicenseStarsStatus
furlPython–2.8kMaintained
purlPythonMIT303Inactive

Considerations

The repository is marked maintained and has recent commits, though the measured activity over the last 90 days is modest. It lists 15 contributors, but most code contribution is concentrated in one person. There have been no releases in the past year, and the measured period shows little issue closure and no merged pull requests. The README says the project supports Python 3 and PyPy3; the supplied requirements data identifies Python as the runtime, with tests and CI present. Resolve the license discrepancy between the README’s public-domain claim and the GitHub metadata before relying on that claim for a project with licensing requirements.

Found this useful?

Share it with someone who would like furl.

Comparisons