tldextract 5.1.3__tar.gz → 5.2.0__tar.gz

{tldextract-5.1.3 → tldextract-5.2.0}/CHANGELOG.md

@@ -3,6 +3,21 @@
 After upgrading, update your cache file by deleting it or via `tldextract
 --update`.
 
+## 5.2.0 (2025-04-07)
+
+* Features
+  * Add `reverse_domain_name` result property ([#342](https://github.com/john-kurkowski/tldextract/issues/342))
+* Bugfixes
+  * Extend exported public interface with `ExtractResult` and `update` ([`36ff658`](https://github.com/john-kurkowski/tldextract/commit/36ff658c53b510c5d56f8af235c8b08ce3c512f5))
+    * These were always meant to be public. Eases user import.
+* Docs
+  * Document result fields
+  * Note all return values
+  * Colocate usage in the usage section
+  * Link to private domain docs
+* Misc.
+  * Update bundled snapshot
+
 ## 5.1.3 (2024-11-04)
 
 * Bugfixes
@@ -10,7 +25,7 @@ After upgrading, update your cache file by deleting it or via `tldextract
   * Drop support for EOL Python 3.8 ([#340](https://github.com/john-kurkowski/tldextract/issues/340))
   * Support Python 3.13 ([#341](https://github.com/john-kurkowski/tldextract/issues/341))
   * Update bundled snapshot
-* Documentation
+* Docs
   * Clarify how to use your own definitions
   * Clarify first-successful definitions vs. merged definitions
 * Misc.

{tldextract-5.1.3 → tldextract-5.2.0}/LICENSE

@@ -1,6 +1,6 @@
 BSD 3-Clause License
 
-Copyright (c) 2013-2024, John Kurkowski
+Copyright (c) 2013-2025, John Kurkowski
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

{tldextract-5.1.3 → tldextract-5.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: tldextract
-Version: 5.1.3
+Version: 5.2.0
 Summary: Accurately separates a URL's subdomain, domain, and public suffix, using the Public Suffix List (PSL). By default, this includes the public ICANN TLDs and their exceptions. You can optionally support the Public Suffix List's private domains as well.
 Author-email: John Kurkowski <john.kurkowski@gmail.com>
 License: BSD-3-Clause
@@ -37,6 +37,7 @@ Requires-Dist: tox; extra == "testing"
 Requires-Dist: tox-uv; extra == "testing"
 Requires-Dist: types-filelock; extra == "testing"
 Requires-Dist: types-requests; extra == "testing"
+Dynamic: license-file
 
 # tldextract [![PyPI version](https://badge.fury.io/py/tldextract.svg)](https://badge.fury.io/py/tldextract) [![Build Status](https://github.com/john-kurkowski/tldextract/actions/workflows/ci.yml/badge.svg)](https://github.com/john-kurkowski/tldextract/actions/workflows/ci.yml)
 
@@ -95,8 +96,17 @@ To rejoin the original hostname, if it was indeed a valid, registered hostname:
 'forums.bbc.co.uk'
 ```
 
+In addition to the Python interface, there is a command-line interface. Split
+the URL components by space:
+
+```zsh
+$ tldextract 'http://forums.bbc.co.uk'
+forums bbc co.uk
+```
+
 By default, this package supports the public ICANN TLDs and their exceptions.
-You can optionally support the Public Suffix List's private domains as well.
+You can optionally support the Public Suffix List's [private
+domains](#public-vs-private-domains) as well.
 
 This package started by implementing the chosen answer from [this StackOverflow question on
 getting the "domain name" from a URL](http://stackoverflow.com/questions/569137/how-to-get-domain-name-from-url/569219#569219).
@@ -118,13 +128,6 @@ Or the latest dev version:
 pip install -e 'git://github.com/john-kurkowski/tldextract.git#egg=tldextract'
 ```
 
-Command-line usage, splits the URL components by space:
-
-```zsh
-tldextract http://forums.bbc.co.uk
-# forums bbc co.uk
-```
-
 ## Note about caching
 
 Beware when first calling `tldextract`, it updates its TLD list with a live HTTP
@@ -188,15 +191,17 @@ ExtractResult(subdomain='waiterrant', domain='blogspot', suffix='com', is_privat
 ```
 
 The following overrides this.
+
 ```python
 >>> extract = tldextract.TLDExtract()
 >>> extract('waiterrant.blogspot.com', include_psl_private_domains=True)
 ExtractResult(subdomain='', domain='waiterrant', suffix='blogspot.com', is_private=True)
 ```
 
-or to change the default for all extract calls,
+To change the default for all extract calls:
+
 ```python
->>> extract = tldextract.TLDExtract( include_psl_private_domains=True)
+>>> extract = tldextract.TLDExtract(include_psl_private_domains=True)
 >>> extract('waiterrant.blogspot.com')
 ExtractResult(subdomain='', domain='waiterrant', suffix='blogspot.com', is_private=True)
 ```

{tldextract-5.1.3 → tldextract-5.2.0}/README.md

@@ -55,8 +55,17 @@ To rejoin the original hostname, if it was indeed a valid, registered hostname:
 'forums.bbc.co.uk'
 ```
 
+In addition to the Python interface, there is a command-line interface. Split
+the URL components by space:
+
+```zsh
+$ tldextract 'http://forums.bbc.co.uk'
+forums bbc co.uk
+```
+
 By default, this package supports the public ICANN TLDs and their exceptions.
-You can optionally support the Public Suffix List's private domains as well.
+You can optionally support the Public Suffix List's [private
+domains](#public-vs-private-domains) as well.
 
 This package started by implementing the chosen answer from [this StackOverflow question on
 getting the "domain name" from a URL](http://stackoverflow.com/questions/569137/how-to-get-domain-name-from-url/569219#569219).
@@ -78,13 +87,6 @@ Or the latest dev version:
 pip install -e 'git://github.com/john-kurkowski/tldextract.git#egg=tldextract'
 ```
 
-Command-line usage, splits the URL components by space:
-
-```zsh
-tldextract http://forums.bbc.co.uk
-# forums bbc co.uk
-```
-
 ## Note about caching
 
 Beware when first calling `tldextract`, it updates its TLD list with a live HTTP
@@ -148,15 +150,17 @@ ExtractResult(subdomain='waiterrant', domain='blogspot', suffix='com', is_privat
 ```
 
 The following overrides this.
+
 ```python
 >>> extract = tldextract.TLDExtract()
 >>> extract('waiterrant.blogspot.com', include_psl_private_domains=True)
 ExtractResult(subdomain='', domain='waiterrant', suffix='blogspot.com', is_private=True)
 ```
 
-or to change the default for all extract calls,
+To change the default for all extract calls:
+
 ```python
->>> extract = tldextract.TLDExtract( include_psl_private_domains=True)
+>>> extract = tldextract.TLDExtract(include_psl_private_domains=True)
 >>> extract('waiterrant.blogspot.com')
 ExtractResult(subdomain='', domain='waiterrant', suffix='blogspot.com', is_private=True)
 ```

{tldextract-5.1.3 → tldextract-5.2.0}/pyproject.toml

@@ -90,6 +90,9 @@ strict = true
 [tool.pytest.ini_options]
 addopts = "--doctest-modules"
 
+[tool.ruff.format]
+docstring-code-format = true
+
 [tool.ruff.lint]
 select = [
   "A",

{tldextract-5.1.3 → tldextract-5.2.0}/scripts/release.py

@@ -13,10 +13,18 @@ It will:
 Prerequisites:
     - This must be run from the root of the repository.
     - The repo must have a clean git working tree.
-    - The user must have the GITHUB_TOKEN environment variable set to a GitHub personal access token with repository "Contents" read and write permission.
-    - The user will need credentials for the PyPI repository, which the user will be prompted for during the upload step. The user will need to paste the token manually from a password manager or similar.
-    - The CHANGELOG.md file must already contain an entry for the version being released.
-    - Install requirements with: pip install --upgrade --editable '.[release]'
+    - The user must have the `GITHUB_TOKEN` environment variable set to a
+      GitHub personal access token with repository "Contents" read and write
+      permission. To generate, see
+      https://github.com/settings/personal-access-tokens
+    - The user will need an API token for the PyPI repository, which the user
+      will be prompted for during the upload step. The user will need to paste
+      the token manually from a password manager or similar. To generate, see
+      https://pypi.org/manage/account/
+    - The CHANGELOG.md file must already contain an entry for the version being
+      released.
+    - Install requirements with: `pip install --upgrade --editable
+      '.[release]'`
 
 """
 
@@ -158,7 +166,7 @@ def create_github_release_draft(token: str, version: str) -> None:
         )
         return
 
-    print(f'Release created successfully: {response.json()["html_url"]}')
+    print(f"Release created successfully: {response.json()['html_url']}")
 
     if not changelog_notes:
         print(

{tldextract-5.1.3 → tldextract-5.2.0}/tests/main_test.py

@@ -415,6 +415,46 @@ def test_ipv4_lookalike() -> None:
     )
 
 
+def test_reverse_domain_name_notation() -> None:
+    """Test property `reverse_domain_name`."""
+    assert (
+        tldextract.extract("www.example.com").reverse_domain_name == "com.example.www"
+    )
+    assert (
+        tldextract.extract("www.theregister.co.uk").reverse_domain_name
+        == "co.uk.theregister.www"
+    )
+    assert tldextract.extract("example.com").reverse_domain_name == "com.example"
+    assert (
+        tldextract.extract("theregister.co.uk").reverse_domain_name
+        == "co.uk.theregister"
+    )
+    assert (
+        tldextract.extract("media.forums.theregister.co.uk").reverse_domain_name
+        == "co.uk.theregister.forums.media"
+    )
+    assert (
+        tldextract.extract(
+            "foo.uk.com", include_psl_private_domains=False
+        ).reverse_domain_name
+        == "com.uk.foo"
+    )
+    assert (
+        tldextract.extract(
+            "foo.uk.com", include_psl_private_domains=True
+        ).reverse_domain_name
+        == "uk.com.foo"
+    )
+
+
+def test_bad_kwargs_no_way_to_fetch() -> None:
+    """Test an impossible combination of kwargs that disable all ways to fetch data."""
+    with pytest.raises(ValueError, match="disable all ways"):
+        tldextract.TLDExtract(
+            cache_dir=None, suffix_list_urls=(), fallback_to_snapshot=False
+        )
+
+
 def test_cache_permission(
     mocker: pytest_mock.MockerFixture, monkeypatch: pytest.MonkeyPatch, tmp_path: Path
 ) -> None: