Skip to main content

Mozilla Public Suffix list as a Python package and updated daily

Project description

psl

Version Downloads CI

Mozilla Public Suffix list as a Python package and updated daily.

Install via python -m pip install psl

See https://publicsuffix.org for more information regarding the list itself.

API

The package provides the following members as an API:

domain_suffixes()

def domain_suffixes(dn: str, *, icann_only: bool=False) -> Suffixes: ...

Queries the Public Suffix list for the given domain and returns a named tuple containing the public and private suffixes for the domain. Either value can be None if that field isn't available. (eg private=None for the domain com)

domain_can_set_cookie()

def domain_can_set_cookie(*, http_domain: str, cookie_domain: str) -> bool: ...

Determines if a user-agent that receives an HTTP response from domain <http_domain> with Set-Cookie headers with parameter Domain=<cookie_domain> should allow that cookie to be set. This disallows cookies from being set on public suffixes and on domains that the HTTP domain has no authority over.

This is the same mechanism that modern browsers use to determine whether it's safe to set a cookie to prevent 'super-cookies'.

License

MPL-2.0

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

psl-2024.11.18.tar.gz (51.6 kB view details)

Uploaded Source

Built Distribution

psl-2024.11.18-py3-none-any.whl (50.5 kB view details)

Uploaded Python 3

File details

Details for the file psl-2024.11.18.tar.gz.

File metadata

  • Download URL: psl-2024.11.18.tar.gz
  • Upload date:
  • Size: 51.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.8.18

File hashes

Hashes for psl-2024.11.18.tar.gz
Algorithm Hash digest
SHA256 2757cf5699a3cbc37537ae13e7d542b8c0a985c014a8611027baff21388a96e0
MD5 1ff2000ecc82d623b24496e15a1611b9
BLAKE2b-256 42bd87af927155958b0d1251717aa45f018f2909a40716d8299979e1ff23ddd4

See more details on using hashes here.

File details

Details for the file psl-2024.11.18-py3-none-any.whl.

File metadata

  • Download URL: psl-2024.11.18-py3-none-any.whl
  • Upload date:
  • Size: 50.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.8.18

File hashes

Hashes for psl-2024.11.18-py3-none-any.whl
Algorithm Hash digest
SHA256 3645711e9b329095db619e919b04fc96ddd68a9bd15e36123a792e2ba2ca4f59
MD5 3eaad95479f1a7091fbab992a931d874
BLAKE2b-256 04d26b5a21a6b64ad064537b36743e4e9cbc3cf406db5ceb1130b63d7c3fb55a

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page