不可变 URL 的力量：purl Python 库详解

在 Web 开发和数据处理中，URL 的处理是常见的任务。Python 的标准库urllib.parse提供了 URL 处理的功能，但使用起来可能有些繁琐。purl库提供了一个简单、不可变的 URL 类，具有简洁的 API，可以更方便地进行 URL 的询问和处理。

「什么是 purl？」

purl是一个 Python 库，它提供了一个URL类，用于表示和操作 URL。它的设计目标是提供一个简洁、易用的 API，同时保证 URL 对象的不可变性。

「purl 的主要特点：」

「简洁的 API：」提供清晰易懂的 API，方便进行各种 URL 操作。

「不可变性：」URL对象是不可变的，每次操作都会返回一个新的URL对象，避免了意外的修改。

「易于使用：」学习曲线平缓，容易上手。

「支持各种 URL 组成部分：」可以方便地访问和修改 URL 的各个部分，例如 scheme、host、path、query、fragment 等。

「环境搭建」

首先，确保你的计算机上安装了 Python。然后，使用 pip 安装purl：

pip install purl

「基本用法」

以下是一些使用purl的基本示例：

from purl import URL

# 创建 URL 对象

url = URL('https://www.example.com/path/to/page?query=param#fragment')

# 获取 URL 的各个部分

print(url.scheme())      # 输出：https

print(url.host())        # 输出：www.example.com

print(url.path())        # 输出：/path/to/page

print(url.query())       # 输出：query=param

print(url.fragment())    # 输出：fragment

print(url.query_params) # 输出：{'query': 'param'}

# 修改 URL 的各个部分 (返回新的 URL 对象)

new_url = url.with_scheme('http')

print(new_url)        # 输出：http://www.example.com/path/to/page?query=param#fragment

new_url = url.with_host('new.example.com')

print(new_url)        # 输出：https://new.example.com/path/to/page?query=param#fragment

new_url = url.with_path('/new/path')

print(new_url)        # 输出：https://www.example.com/new/path?query=param#fragment

new_url = url.with_query('new_query=new_value')

print(new_url)        # 输出：https://www.example.com/path/to/page?new_query=new_value#fragment

new_url = url.with_fragment('new_fragment')

print(new_url)        # 输出：https://www.example.com/path/to/page?query=param#new_fragment

# 链式调用

new_url = URL('https://www.example.com').with_path('new/path').with_query('query=param')

print(new_url)        # 输出：https://www.example.com/new/path?query=param

# 添加或修改查询参数

new_url = url.add_query_param('new_query', 'new_value')

print(new_url)      # 输出：https://www.example.com/path/to/page?query=param&new_query=new_value#fragment

new_url = url.set_query_param('query', 'new_param') # 修改已存在的参数

print(new_url)      # 输出：https://www.example.com/path/to/page?new_param#fragment

# 删除查询参数

new_url = url.del_query_param('query')

print(new_url)      # 输出：https://www.example.com/path/to/page#fragment

# 获取路径部分

print(url.path_segments()) # 输出：['path', 'to', 'page']

# URL 编码和解码

url = URL('https://www.example.com/?query=a b')

print(url.query()) # 输出：query=a%20b

print(url.query_params) # 输出：{'query': 'a b'}

# 将 URL 转换为字符串

print(str(url))     # 输出：https://www.example.com/path/to/page?query=param#fragment

# 与 urllib.parse 兼容

import urllib.parse

parsed_url = urllib.parse.urlparse(str(url))

print(parsed_url.netloc) # 输出：www.example.com

「代码解释：」

from purl import URL导入URL类。

url = URL(url_string)创建一个URL对象。

url.scheme()、url.host()、url.path()、url.query()、url.fragment()分别访问 URL 的各个部分。

with_xxx()方法用于修改 URL 的各个部分，并返回一个新的URL对象。

add_query_param()、set_query_param()、del_query_param()方法用于操作查询参数。

url.path_segments()返回路径的各个部分组成的列表。

「与 furl 的比较」

purl和furl都是用于简化 URL 处理的 Python 库，它们有一些相似之处，但也存在一些区别：

「API 风格：」purl的 API 更加简洁，方法名更短，例如url.scheme()而不是f.scheme。furl提供了更多的链式调用和路径操作方法。

「不可变性：」两者都强调 URL 对象的不可变性。

「功能：」furl提供了更多高级功能，例如更灵活的路径操作和 URL 编码处理。purl则更专注于提供基本的 URL 解析和构建功能。

选择哪个库取决于你的具体需求。如果你需要一个非常简单、轻量的库，并且只需要基本的 URL 操作，那么purl可能更适合你。如果你需要更强大的功能和更灵活的 API，那么furl可能是更好的选择。

purl提供了一个简单、不可变的 URL 类，具有简洁的 API，使得 URL 处理变得更加容易。它非常适合在各种需要处理 URL 的 Python 项目中使用，尤其是在需要保证 URL 对象不被意外修改的场景下。