kim tuyến là một đơn giản, không thay đổi lớp URL với một API sạch để thẩm vấn và thao tác.
Cài đặt
Từ PyPI (ổn định):
pips cài đặt kim tuyến
Từ Github (không ổn định):
pips cài đặt git git +: //github.com/codeinthehole/purl.git#egg=purl
Sử dụng
Xây dựng:
từ purl URL nhập khẩu
# Explicit constructor
u = URL (đề án = 'https', host = 'www.google.com', path = "/ search ', query =' q = thử nghiệm ')
# Sử dụng máy
u = URL.from_string ('https://www.google.com/search?q=testing')
# Kết hợp
u = URL.from_string ('http://www.google.com') .path ('tìm kiếm')
& Nbsp; .query_param ('q', 'kiểm tra')
Đối tượng URL là bất biến - tất cả các phương pháp mutator trả về một thể hiện mới.
Thẩm vấn:
u.scheme () # 'https'
u.host () # 'www.google.com'
u.domain () # 'www.google.com' - bí danh của máy chủ
u.port () # Không - chỉ trả về giá trị nếu đặt một cách rõ ràng
u.path () # '/ tìm kiếm'
u.query () # 'q = thử nghiệm'
u.fragment () # 'q = thử nghiệm'
u.path_segment (0) # 'tìm kiếm'
u.path_segments () # ('tìm kiếm',)
u.query_param ('q') # 'thử nghiệm'
u.query_param ('q', as_list = True) # ['thử nghiệm']
u.query_param ('lang', mặc định = 'GB') # 'GB'
u.query_params () {# 'q': 'thử nghiệm'}
u.subdomains () # ['www', 'google', 'com']
u.subdomain (0) # 'www'
Lưu ý rằng mỗi phương pháp accessor bị quá tải để có một phương pháp mutator quá, tương tự như các API jQuery. Ví dụ như:
u = URL.from_string ('https://github.com/codeinthehole')
# Truy cập
u.path_segment (0) # nhuận 'codeinthehole'
# Đột biến (tạo ra một thể hiện mới)
new_url = u.path_segment (0, 'tangentlabs') # trả về đối tượng URL mới
Vài điều khác:
- Kể từ khi lớp URL là không thay đổi nó có thể được sử dụng như một chìa khóa trong một từ điển
- Nó có thể được chọn và phục hồi
- Nó hỗ trợ hoạt động bình đẳng
là gì mới trong phiên bản này:
- Hỗ trợ cho RFC 6570 mẫu URI
là gì mới trong phiên bản 0.6:
- Thêm append_query_param phương pháp
- Thêm phương pháp remove_query_param
là gì mới trong phiên bản 0.4.1:
- Thêm tài liệu API
- Thêm vào readthedocs.org
là gì mới trong phiên bản 0.4:
- constructor thay đổi để chấp nhận chuỗi URL đầy đủ như arg đầu tiên
- Thêm phương pháp add_path_segment
là gì mới trong phiên bản 0.3.2:
- Sửa lỗi số cổng trong chuỗi khi sử dụng from_string constructor
Yêu cầu :
- Python
Bình luận không