codeinthehole

purl: Build and Manipulate Immutable Python URLs

purl is a Python library for inspecting and building URLs through an immutable API. It also supports RFC 6570 URI templates, making it useful for applications that need to construct URLs safely and predictably.

Stars
303
Forks
37
Stars, last 30 days
+1
Last commit
3.2 years ago
Contributors
13

Our take

Inactiveno commits in over a year

Health score

23/100

How it is scored
Activity
19
Community
32
Issues
21
Pull requests
20

+1 stars in the last 30 days

purl offers a focused immutable URL API with URI-template support, but its long period without project activity calls for caution before adopting it as a new dependency.

Good fit if

  • You need an immutable URL utility for a Python project.
  • RFC 6570 template expansion is useful to your URL-generation workflow.
  • You can validate the library against your needs and maintain a fork if necessary.

Look elsewhere if

  • You need evidence of active maintenance or recent releases: the project is marked inactive, with no recent commits or releases.
  • Your team cannot take on maintenance risk: most contributions come from one person, and there has been no recent issue or pull-request activity.
  • You need a tool outside Python; the README identifies Python as its runtime.
All health signals
Last commit2023-08-04 (3.2 years ago)
Commits, last 90 days0
Releases, last 12 months0
Contributors13 (top contributor: 91% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age14 years

Checked on 2026-10-24 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

304

Forks

37

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

Overview

purl is a Python library for working with URLs as immutable objects. It provides an API to inspect URL components and create modified URLs without changing the original, helping Python applications avoid ad hoc string manipulation.

The library also supports RFC 6570 URI templates. It suits developers who need URL construction and parsing utilities in Python, rather than a standalone URL service or command-line tool. See the project repository and documentation.

Key Features

  • Construct URLs from a string or from keyword arguments.
  • Inspect components including scheme, host, path, query, fragment, and credentials.
  • Create modified URL instances through accessor methods that also act as mutators.
  • Read, add, and remove query parameters, including repeated parameters.
  • Access and modify path segments, or append a segment to a path.
  • Expand RFC 6570 URI templates with the Template class or expand function.
  • Support equality, pickling, and use as a dictionary key.

Use Cases

  • Python web applications that need to add query parameters while preserving the original URL.
  • API clients that construct request URLs from path segments and parameters.
  • Applications that inspect incoming URLs and need access to their individual components.
  • Systems that generate URLs from reusable RFC 6570 templates.

What you need

Detected in the repository

  • Python (from setup.py)
  • A test suite

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install the published package:

pip install purl

See the README for usage examples and test instructions.

Alternatives

  • furl: furl focuses on parsing and editing URL components, while purl also provides RFC 6570 URI template support.
ProjectLanguageLicenseStarsStatus
purlPythonMIT303Inactive
furlPython–2.8kMaintained

Considerations

The project is marked inactive, with no commits or releases in over a year and no recent issue closures or merged pull requests. Although the repository lists 13 contributors, contributions are highly concentrated in one person, which may increase the chance that users need to handle maintenance themselves. The README documents support for older Python versions, but does not establish compatibility with current versions, so verify your target runtime before adopting it. The repository is MIT-licensed.

Found this useful?

Share it with someone who would like purl.

Comparisons