tldextract 5.1.2__tar.gz → 5.2.0__tar.gz

{tldextract-5.1.2 → tldextract-5.2.0}/.github/workflows/ci.yml

@@ -14,22 +14,21 @@ jobs:
         os: [macos-latest, windows-latest, ubuntu-latest]
         language:
           [
-            {python-version: "3.8", toxenv: "py38"},
             {python-version: "3.9", toxenv: "py39"},
             {python-version: "3.10", toxenv: "py310"},
             {python-version: "3.11", toxenv: "py311"},
             {python-version: "3.12", toxenv: "py312"},
-            {python-version: "pypy3.8", toxenv: "pypy38"},
+            {python-version: "3.13", toxenv: "py313"},
             {python-version: "pypy3.9", toxenv: "pypy39"},
             {python-version: "pypy3.10", toxenv: "pypy310"},
           ]
         include:
           - os: ubuntu-latest
-            language: {python-version: "3.8", toxenv: "codestyle"}
+            language: {python-version: "3.9", toxenv: "codestyle"}
           - os: ubuntu-latest
-            language: {python-version: "3.8", toxenv: "lint"}
+            language: {python-version: "3.9", toxenv: "lint"}
           - os: ubuntu-latest
-            language: {python-version: "3.8", toxenv: "typecheck"}
+            language: {python-version: "3.9", toxenv: "typecheck"}
     runs-on: ${{ matrix.os }}
     steps:
       - name: Check out repository
@@ -41,7 +40,7 @@ jobs:
           check-latest: true
       - name: Install Python requirements
         run: |
-          pip install --upgrade tox
+          pip install --upgrade tox tox-uv
       - name: Test
         run: tox
         env:

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

@@ -3,6 +3,35 @@
 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
+  * Reduce logging errors ([`921a825`](https://github.com/john-kurkowski/tldextract/commit/921a82523c0e4403d21d50b2c3410d9af43520ac))
+  * 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
+* Docs
+  * Clarify how to use your own definitions
+  * Clarify first-successful definitions vs. merged definitions
+* Misc.
+  * Switch from Black to Ruff ([#333](https://github.com/john-kurkowski/tldextract/issues/333))
+  * Switch from pip to uv, during tox ([#324](https://github.com/john-kurkowski/tldextract/issues/324))
+
 ## 5.1.2 (2024-03-18)
 
 * Bugfixes

{tldextract-5.1.2 → 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.2 → tldextract-5.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: tldextract
-Version: 5.1.2
+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
@@ -10,12 +10,12 @@ Classifier: Development Status :: 5 - Production/Stable
 Classifier: Topic :: Utilities
 Classifier: License :: OSI Approved :: BSD License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Python: >=3.8
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: idna
@@ -26,7 +26,6 @@ Provides-Extra: release
 Requires-Dist: build; extra == "release"
 Requires-Dist: twine; extra == "release"
 Provides-Extra: testing
-Requires-Dist: black; extra == "testing"
 Requires-Dist: mypy; extra == "testing"
 Requires-Dist: pytest; extra == "testing"
 Requires-Dist: pytest-gitignore; extra == "testing"
@@ -35,8 +34,10 @@ Requires-Dist: responses; extra == "testing"
 Requires-Dist: ruff; extra == "testing"
 Requires-Dist: syrupy; extra == "testing"
 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,19 +128,12 @@ 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
 request. This updated TLD set is usually cached indefinitely in `$HOME/.cache/python-tldextract`.
-To control the cache's location, set TLDEXTRACT_CACHE environment variable or set the
-cache_dir path in TLDExtract initialization.
+To control the cache's location, set the `TLDEXTRACT_CACHE` environment variable or set the
+`cache_dir` path when constructing a `TLDExtract`.
 
 (Arguably runtime bootstrapping like that shouldn't be the default behavior,
 like for production systems. But I want you to have the latest TLDs, especially
@@ -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)
 ```
@@ -219,10 +224,12 @@ extract = tldextract.TLDExtract(
     fallback_to_snapshot=False)
 ```
 
-The above snippet will fetch from the URL *you* specified, upon first need to download the
-suffix list (i.e. if the cached version doesn't exist).
+If the cached version of public suffix definitions doesn't exist, such as on
+the first run, the above snippet will request the URLs you specified in order,
+and use the first successful response.
 
-If you want to use input data from your local filesystem, just use the `file://` protocol:
+If you want to use input data from your local filesystem, use the `file://`
+protocol with an absolute path:
 
 ```python
 extract = tldextract.TLDExtract(
@@ -231,17 +238,24 @@ extract = tldextract.TLDExtract(
     fallback_to_snapshot=False)
 ```
 
-Use an absolute path when specifying the `suffix_list_urls` keyword argument.
-`os.path` is your friend.
-
-The command line update command can be used with a URL or local file you specify:
+This also works via command line update:
 
 ```zsh
 tldextract --update --suffix_list_url "http://foo.bar.baz"
 ```
 
-This could be useful in production when you don't want the delay associated with updating the suffix
-list on first use, or if you are behind a complex firewall that prevents a simple update from working.
+Using your own URLs could be useful in production when you don't want the delay
+with updating the suffix list on first use, or if you are behind a complex
+firewall.
+
+You can also specify additional suffixes in the `extra_suffixes` param. These
+will be merged into whatever public suffix definitions are already in use by
+`tldextract`.
+
+```python
+extract = tldextract.TLDExtract(
+    extra_suffixes=["foo", "bar", "baz"])
+```
 
 ## FAQ
 
@@ -250,9 +264,9 @@ list on first use, or if you are behind a complex firewall that prevents a simpl
 This project doesn't contain an actual list of public suffixes. That comes from
 [the Public Suffix List (PSL)](https://publicsuffix.org/). Submit amendments there.
 
-(In the meantime, you can tell tldextract about your exception by either
+In the meantime, you can tell tldextract about your exception by either
 forking the PSL and using your fork in the `suffix_list_urls` param, or adding
-your suffix piecemeal with the `extra_suffixes` param.)
+your suffix piecemeal with the `extra_suffixes` param.
 
 ### I see my suffix in [the Public Suffix List (PSL)](https://publicsuffix.org/), but this library doesn't extract it.
 
@@ -309,5 +323,5 @@ tox -e py311
 Automatically format all code:
 
 ```zsh
-black .
+ruff format .
 ```

{tldextract-5.1.2 → 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,19 +87,12 @@ 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
 request. This updated TLD set is usually cached indefinitely in `$HOME/.cache/python-tldextract`.
-To control the cache's location, set TLDEXTRACT_CACHE environment variable or set the
-cache_dir path in TLDExtract initialization.
+To control the cache's location, set the `TLDEXTRACT_CACHE` environment variable or set the
+`cache_dir` path when constructing a `TLDExtract`.
 
 (Arguably runtime bootstrapping like that shouldn't be the default behavior,
 like for production systems. But I want you to have the latest TLDs, especially
@@ -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)
 ```
@@ -179,10 +183,12 @@ extract = tldextract.TLDExtract(
     fallback_to_snapshot=False)
 ```
 
-The above snippet will fetch from the URL *you* specified, upon first need to download the
-suffix list (i.e. if the cached version doesn't exist).
+If the cached version of public suffix definitions doesn't exist, such as on
+the first run, the above snippet will request the URLs you specified in order,
+and use the first successful response.
 
-If you want to use input data from your local filesystem, just use the `file://` protocol:
+If you want to use input data from your local filesystem, use the `file://`
+protocol with an absolute path:
 
 ```python
 extract = tldextract.TLDExtract(
@@ -191,17 +197,24 @@ extract = tldextract.TLDExtract(
     fallback_to_snapshot=False)
 ```
 
-Use an absolute path when specifying the `suffix_list_urls` keyword argument.
-`os.path` is your friend.
-
-The command line update command can be used with a URL or local file you specify:
+This also works via command line update:
 
 ```zsh
 tldextract --update --suffix_list_url "http://foo.bar.baz"
 ```
 
-This could be useful in production when you don't want the delay associated with updating the suffix
-list on first use, or if you are behind a complex firewall that prevents a simple update from working.
+Using your own URLs could be useful in production when you don't want the delay
+with updating the suffix list on first use, or if you are behind a complex
+firewall.
+
+You can also specify additional suffixes in the `extra_suffixes` param. These
+will be merged into whatever public suffix definitions are already in use by
+`tldextract`.
+
+```python
+extract = tldextract.TLDExtract(
+    extra_suffixes=["foo", "bar", "baz"])
+```
 
 ## FAQ
 
@@ -210,9 +223,9 @@ list on first use, or if you are behind a complex firewall that prevents a simpl
 This project doesn't contain an actual list of public suffixes. That comes from
 [the Public Suffix List (PSL)](https://publicsuffix.org/). Submit amendments there.
 
-(In the meantime, you can tell tldextract about your exception by either
+In the meantime, you can tell tldextract about your exception by either
 forking the PSL and using your fork in the `suffix_list_urls` param, or adding
-your suffix piecemeal with the `extra_suffixes` param.)
+your suffix piecemeal with the `extra_suffixes` param.
 
 ### I see my suffix in [the Public Suffix List (PSL)](https://publicsuffix.org/), but this library doesn't extract it.
 
@@ -269,5 +282,5 @@ tox -e py311
 Automatically format all code:
 
 ```zsh
-black .
+ruff format .
 ```

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

@@ -23,13 +23,13 @@ classifiers = [
     "Topic :: Utilities",
     "License :: OSI Approved :: BSD License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
 ]
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 dynamic = ["version"]
 readme = "README.md"
 
@@ -46,7 +46,6 @@ release = [
     "twine",
 ]
 testing = [
-    "black",
     "mypy",
     "pytest",
     "pytest-gitignore",
@@ -55,6 +54,7 @@ testing = [
     "ruff",
     "syrupy",
     "tox",
+    "tox-uv",
     "types-filelock",
     "types-requests",
 ]
@@ -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",
@@ -104,7 +107,7 @@ select = [
   "W",
 ]
 ignore = [
-  "E501", # line too long; if Black does its job, not worried about the rare long line
+  "E501", # line too long; if formatter does its job, not worried about the rare long line
 ]
 
 [tool.ruff.lint.pydocstyle]

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

@@ -13,28 +13,44 @@ 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 valid GitHub personal access token.
-    - 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]'`
 
 """
 
 from __future__ import annotations
 
+import contextlib
 import os
 import re
 import subprocess
 import sys
+from collections.abc import Iterator
 from pathlib import Path
 
 import requests
 
 
-def add_git_tag_for_version(version: str) -> None:
+@contextlib.contextmanager
+def add_git_tag_for_version(version: str) -> Iterator[None]:
     """Add a git tag for the given version."""
     subprocess.run(["git", "tag", "-a", version, "-m", version], check=True)
     print(f"Version {version} tag added successfully.")
+    try:
+        yield
+    except:
+        subprocess.run(["git", "tag", "-d", version])
+        raise
 
 
 def remove_previous_dist() -> None:
@@ -68,14 +84,16 @@ def verify_build(is_test: str) -> None:
     confirmation = input("Does the build look correct? (y/n): ")
     if confirmation == "y":
         print("Build verified successfully.")
-        upload_build_to_pypi(is_test)
-        push_git_tags()
     else:
         raise Exception("Could not verify. Build was not uploaded.")
 
 
 def generate_github_release_notes_body(token: str, version: str) -> str:
-    """Generate and grab release notes URL from Github."""
+    """Generate and grab release notes URL from Github.
+
+    Delete their first paragraph, because we track its contents in a tighter
+    form in CHANGELOG.md. See `get_changelog_release_notes`.
+    """
     response = requests.post(
         "https://api.github.com/repos/john-kurkowski/tldextract/releases/generate-notes",
         headers={
@@ -94,24 +112,13 @@ def generate_github_release_notes_body(token: str, version: str) -> str:
             file=sys.stderr,
         )
         return ""
-    return str(response.json()["body"])
 
+    body = str(response.json()["body"])
+    paragraphs = body.split("\n\n")
+    return "\n\n".join(paragraphs[1:])
 
-def get_release_notes_url(body: str) -> str:
-    """Parse the release notes content to get the changelog URL."""
-    url_pattern = re.compile(r"\*\*Full Changelog\*\*: (.*)$")
-    match = url_pattern.search(body)
-    if match:
-        return match.group(1)
-    else:
-        print(
-            "WARNING: Failed to parse release notes URL from GitHub response.",
-            file=sys.stderr,
-        )
-        return ""
 
-
-def get_changelog_release_notes(release_notes_url: str, version: str) -> str:
+def get_changelog_release_notes(version: str) -> str:
     """Get the changelog release notes.
 
     Uses a regex starting on a heading beginning with the version number
@@ -125,25 +132,15 @@ def get_changelog_release_notes(release_notes_url: str, version: str) -> str:
     if match:
         return str(match.group(1)).strip()
     else:
-        print(
-            f"WARNING: Failed to parse changelog release notes. Manually copy this version's notes from the CHANGELOG.md file to {release_notes_url}.",
-            file=sys.stderr,
-        )
         return ""
 
 
-def create_release_notes_body(token: str, version: str) -> str:
-    """Compile the release notes."""
-    github_release_body = generate_github_release_notes_body(token, version)
-    release_notes_url = get_release_notes_url(github_release_body)
-    changelog_notes = get_changelog_release_notes(release_notes_url, version)
-    full_release_notes = f"{changelog_notes}\n\n**Full Changelog**: {release_notes_url}"
-    return full_release_notes
-
-
 def create_github_release_draft(token: str, version: str) -> None:
     """Create a release on GitHub."""
-    release_body = create_release_notes_body(token, version)
+    github_release_body = generate_github_release_notes_body(token, version)
+    changelog_notes = get_changelog_release_notes(version)
+    release_body = f"{changelog_notes}\n\n{github_release_body}"
+
     response = requests.post(
         "https://api.github.com/repos/john-kurkowski/tldextract/releases",
         headers={
@@ -168,7 +165,14 @@ def create_github_release_draft(token: str, version: str) -> None:
             file=sys.stderr,
         )
         return
-    print(f'Release created successfully: {response.json()["html_url"]}')
+
+    print(f"Release created successfully: {response.json()['html_url']}")
+
+    if not changelog_notes:
+        print(
+            "WARNING: Failed to parse changelog release notes. Manually copy this version's notes from the CHANGELOG.md file to the above URL.",
+            file=sys.stderr,
+        )
 
 
 def upload_build_to_pypi(is_test: str) -> None:
@@ -227,10 +231,12 @@ def main() -> None:
     is_test = get_is_test_response()
     version_number = input("Enter the version number: ")
 
-    add_git_tag_for_version(version_number)
-    remove_previous_dist()
-    create_build()
-    verify_build(is_test)
+    with add_git_tag_for_version(version_number):
+        remove_previous_dist()
+        create_build()
+        verify_build(is_test)
+        upload_build_to_pypi(is_test)
+    push_git_tags()
     create_github_release_draft(github_token, version_number)
 
 

{tldextract-5.1.2 → tldextract-5.2.0}/tests/__snapshots__/test_release.ambr

@@ -72,6 +72,9 @@
               * Misc.
                   * Increase typecheck aggression
               
+              ## New Contributors
+              * @jdoe contributed
+              
               **Full Changelog**: fake-body
             ''',
             'draft': True,

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

@@ -4,7 +4,6 @@ from __future__ import annotations
 
 import logging
 import os
-import sys
 import tempfile
 from collections.abc import Sequence
 from pathlib import Path
@@ -168,8 +167,7 @@ def test_looks_like_ipv6() -> None:
     assert looks_like_ipv6("aBcD:ef01:2345:6789:aBcD:ef01:aaaa:2288") is True
     assert looks_like_ipv6("aBcD:ef01:2345:6789:aBcD:ef01:127.0.0.1") is True
     assert looks_like_ipv6("ZBcD:ef01:2345:6789:aBcD:ef01:127.0.0.1") is False
-    if sys.version_info >= (3, 8, 12):  # noqa: UP036
-        assert looks_like_ipv6("aBcD:ef01:2345:6789:aBcD:ef01:127.0.0.01") is False
+    assert looks_like_ipv6("aBcD:ef01:2345:6789:aBcD:ef01:127.0.0.01") is False
     assert looks_like_ipv6("aBcD:ef01:2345:6789:aBcD:") is False
 
 
@@ -417,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: