oda-data 2.5.0__tar.gz → 2.7.0__tar.gz

{oda_data-2.5.0 → oda_data-2.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
-Name: oda-data
-Version: 2.5.0
+Name: oda_data
+Version: 2.7.0
 Summary: A python package to work with Official Development Assistance data from the OECD DAC.
 Author: Jorge Rivera, Miguel Haro Ruiz
 Author-email: Jorge Rivera <jorge.rivera@one.org>, Miguel Haro Ruiz <miguel.haroruiz@one.org>
@@ -18,15 +18,16 @@ Classifier: Topic :: Scientific/Engineering
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Dist: cachetools>=6.2.0
 Requires-Dist: filelock>=3.20.0
-Requires-Dist: oda-reader>=1.4.1
+Requires-Dist: oda-reader>=1.6.0
+Requires-Dist: platformdirs>=4.0.0
 Requires-Dist: pandas[excel,parquet,performance]>=2.2.0
 Requires-Dist: pydeflate>=2.3.3
 Requires-Dist: reader>=3.18
 Requires-Dist: thefuzz>=0.22.1
 Requires-Python: >=3.11
-Project-URL: Documentation, https://github.com/ONEcampaign/oda_data_package
 Project-URL: Homepage, https://github.com/ONEcampaign/oda_data_package
 Project-URL: Repository, https://github.com/ONEcampaign/oda_data_package
+Project-URL: Documentation, https://github.com/ONEcampaign/oda_data_package
 Description-Content-Type: text/markdown
 
 [![pypi](https://img.shields.io/pypi/v/oda_data.svg)](https://pypi.org/project/oda_data/)
@@ -38,6 +39,7 @@ Description-Content-Type: text/markdown
 [![Downloads](https://static.pepy.tech/badge/oda-data)](https://pepy.tech/project/oda-data)
 
 # The ODA Data Package
+
 This is a Python package designed for accessing, processing, and analyzing Official Development Assistance (ODA) data from OECD DAC. With an intuitive API, it simplifies common tasks like retrieving ODA indicators, converting currencies, filtering data, and handling bulk downloads.
 
 **Note: This is the new version of the package (V2). This release includes many breaking changes and previous workflows
@@ -70,6 +72,7 @@ The package is compatible with Python 3.11 and above.
 Most users can get the data they need by using the `OECDClient` class.
 
 An object of this class can handle:
+
 - getting data for specific indicators (one or more)
 - filtering the data for specific donors, recipients(if relevant), years.
 - returning the data in a variety of currency/prices combinations.
@@ -159,6 +162,7 @@ OECDClient.export_available_indicators(export_folder="path/to/folder/")
 ```
 
 ### Providers
+
 You can get a dictionary with all available providers, with their code and name, by using the `.available_providers()` method:
 
 ```python
@@ -168,6 +172,7 @@ providers = OECDClient.available_providers()
 ```
 
 ### Recipients
+
 You can get a dictionary with all available recipients, with their code and name, by using the `.available_recipients()` method:
 
 ```python
@@ -177,6 +182,7 @@ recipients = OECDClient.available_recipients()
 ```
 
 ### Currencies
+
 You can get a dictionary with all available currencies, with their code and name, by using the `.available_currencies()` method:
 
 ```python
@@ -190,6 +196,7 @@ currencies = OECDClient.available_currencies()
 Different measures are available depending on the data source. Here's what each source supports:
 
 **DAC1 Measures:**
+
 - `commitment` - Total commitments
 - `commitment_grant` - Grant commitments only
 - `commitment_non_grant` - Non-grant commitments
@@ -201,10 +208,12 @@ Different measures are available depending on the data source. Here's what each
 - `received` - Amounts received
 
 **DAC2A Measures:**
+
 - `net_disbursement` - Net disbursements (default)
 - `gross_disbursement` - Gross disbursements
 
 **CRS Measures:**
+
 - `commitment` - Commitment amounts
 - `grant_equivalent` - Grant equivalent values
 - `gross_disbursement` - Gross disbursement amounts
@@ -214,16 +223,20 @@ Different measures are available depending on the data source. Here's what each
 - `export_credit` - Export credits
 
 **MultiSystem Measures:**
+
 - `commitment` - Commitments
 - `gross_disbursement` - Gross disbursements
 
 ## Accessing the data
+
 For more advanced users, you can use this package to get and work with different tables and databases from the OECD DAC.
 
 ### DAC 1
+
 The `DAC1Data` class can retrieve and return DAC 1 data.
 
 You can optionally specify:
+
 - years: to filter the data for specific years
 - providers: to filter the data for specific providers (based on their code).
 - indicators: to filter the data for a specific indicator (for DAC1 this means AIDTYPE_CODE)
@@ -231,6 +244,7 @@ You can optionally specify:
 Not specifying any or all of these parameters will return all the available data.
 
 After instantiating the object, you can call:
+
 - `download`: to download the data from the data-explorer API or the bulk download service. This method returns a DataFrame.
 - `read`: to read data as stored in the specified folder. If the data is not available, it will be downloaded.
 
@@ -270,11 +284,12 @@ data = dac1.read(
 )
 ```
 
-
 ### DAC 2A
+
 The `DAC2AData` class can retrieve and return DAC2a data.
 
 You can optionally specify:
+
 - years: to filter the data for specific years
 - providers: to filter the data for specific providers (based on their code).
 - recipients: to filter the data for specific recipients (based on their code).
@@ -283,6 +298,7 @@ You can optionally specify:
 Not specifying any or all of these parameters will return all the available data.
 
 After instantiating the object, you can call:
+
 - `download`: to download the data from the data-explorer API or the bulk download service. This method returns a DataFrame.
 - `read`: to read data as stored in the specified folder. If the data is not available, it will be downloaded.
 
@@ -332,9 +348,11 @@ data = dac2a.read(
 ```
 
 ### CRS
+
 The `CRSData` class can retrieve and return CRS data.
 
 You can optionally specify:
+
 - years: to filter the data for specific years
 - providers: to filter the data for specific providers (based on their code).
 - recipients: to filter the data for specific recipients (based on their code).
@@ -358,11 +376,12 @@ crs = CRSData(years=range(2010, 2024))
 data = crs.read(using_bulk_download=True)
 ```
 
-
 ### MultiSystem
+
 The `MultiSystemData` class can retrieve and return Providers Total Use of the Multilateral System data.
 
 You can optionally specify:
+
 - years: to filter the data for specific years
 - providers: to filter the data for specific providers (based on their code).
 - recipients: to filter the data for specific recipients (based on their code).
@@ -375,7 +394,6 @@ You can refer to the examples above for DAC1 and DAC2a to understand the usage o
 **Note**: given the speed and rate-limiting of the dac-explorer APIs, consider using the bulk option
 unless you're looking for something very specific.
 
-
 ## Utility Functions
 
 The package provides several utility functions to enhance and enrich your ODA data analysis:
@@ -448,21 +466,29 @@ dac_members = providers["dac_members"]
 
 ### Cache Management
 
-Control the package's caching behavior:
+`oda_data` stores downloaded data in a per-OS, version-segmented directory
+(`~/Library/Caches/oda-data/<version>/` on macOS, `~/.cache/oda-data/<version>/`
+on Linux, and the equivalent `AppData\Local` path on Windows). The location can be
+overridden with `oda_data.set_cache_root(path)` or the `ODA_DATA_CACHE_DIR`
+environment variable. See [CACHING.md](CACHING.md) for full details on disk
+locations, scopes, multi-process behavior, and migration from older versions.
 
-```python
-from oda_data import clear_cache, disable_cache, enable_cache
+The fastest recovery path for a corrupt or stale cache is:
 
-# Clear all cached data
-clear_cache()
+```python
+from oda_data import cache
 
-# Temporarily disable caching (for development/testing)
-disable_cache()
+# Clear only the raw zip archives and let them re-download on next read:
+cache.clear("raw")
 
-# Re-enable caching
-enable_cache()
+# Or wipe everything:
+cache.clear("all")
 ```
 
+The legacy helpers `clear_cache()`, `disable_cache()`, and `enable_cache()` continue
+to work and are thin wrappers over `cache.clear("all")`, `cache.disable_cache("all")`,
+and `cache.enable_cache("all")` respectively.
+
 ### Compatibility with Version 1.x
 
 For users migrating from v1.x, a compatibility layer is available:
@@ -534,11 +560,12 @@ data = aiddata.read()
 ## Key features
 
 - **Speed up analysis** - The package handles downloading, cleaning and loading all the data, so you can focus on the
-analysis.
+  analysis.
 - **Get data in the currency and prices you need** - ODA data is only available in US dollars (current or constant
-prices) and local currency units (current prices). The package allows you to view the data in US dollars, Euros,
-British Pounds and Canadian dollars, in both current and constant prices. We can add any other DAC currency if you
-request it via the [issues page](https://github.com/ONEcampaign/oda_data_package/issues)
+  prices) and local currency units (current prices). The package allows you to view the data in US dollars, Euros,
+  British Pounds and Canadian dollars, in both current and constant prices. We can add any other DAC currency if you
+  request it via the [issues page](https://github.com/ONEcampaign/oda_data_package/issues)
 
 ## Contributing
+
 Interested in contributing to the package? Please reach out.

{oda_data-2.5.0 → oda_data-2.7.0}/README.md

@@ -7,6 +7,7 @@
 [![Downloads](https://static.pepy.tech/badge/oda-data)](https://pepy.tech/project/oda-data)
 
 # The ODA Data Package
+
 This is a Python package designed for accessing, processing, and analyzing Official Development Assistance (ODA) data from OECD DAC. With an intuitive API, it simplifies common tasks like retrieving ODA indicators, converting currencies, filtering data, and handling bulk downloads.
 
 **Note: This is the new version of the package (V2). This release includes many breaking changes and previous workflows
@@ -39,6 +40,7 @@ The package is compatible with Python 3.11 and above.
 Most users can get the data they need by using the `OECDClient` class.
 
 An object of this class can handle:
+
 - getting data for specific indicators (one or more)
 - filtering the data for specific donors, recipients(if relevant), years.
 - returning the data in a variety of currency/prices combinations.
@@ -128,6 +130,7 @@ OECDClient.export_available_indicators(export_folder="path/to/folder/")
 ```
 
 ### Providers
+
 You can get a dictionary with all available providers, with their code and name, by using the `.available_providers()` method:
 
 ```python
@@ -137,6 +140,7 @@ providers = OECDClient.available_providers()
 ```
 
 ### Recipients
+
 You can get a dictionary with all available recipients, with their code and name, by using the `.available_recipients()` method:
 
 ```python
@@ -146,6 +150,7 @@ recipients = OECDClient.available_recipients()
 ```
 
 ### Currencies
+
 You can get a dictionary with all available currencies, with their code and name, by using the `.available_currencies()` method:
 
 ```python
@@ -159,6 +164,7 @@ currencies = OECDClient.available_currencies()
 Different measures are available depending on the data source. Here's what each source supports:
 
 **DAC1 Measures:**
+
 - `commitment` - Total commitments
 - `commitment_grant` - Grant commitments only
 - `commitment_non_grant` - Non-grant commitments
@@ -170,10 +176,12 @@ Different measures are available depending on the data source. Here's what each
 - `received` - Amounts received
 
 **DAC2A Measures:**
+
 - `net_disbursement` - Net disbursements (default)
 - `gross_disbursement` - Gross disbursements
 
 **CRS Measures:**
+
 - `commitment` - Commitment amounts
 - `grant_equivalent` - Grant equivalent values
 - `gross_disbursement` - Gross disbursement amounts
@@ -183,16 +191,20 @@ Different measures are available depending on the data source. Here's what each
 - `export_credit` - Export credits
 
 **MultiSystem Measures:**
+
 - `commitment` - Commitments
 - `gross_disbursement` - Gross disbursements
 
 ## Accessing the data
+
 For more advanced users, you can use this package to get and work with different tables and databases from the OECD DAC.
 
 ### DAC 1
+
 The `DAC1Data` class can retrieve and return DAC 1 data.
 
 You can optionally specify:
+
 - years: to filter the data for specific years
 - providers: to filter the data for specific providers (based on their code).
 - indicators: to filter the data for a specific indicator (for DAC1 this means AIDTYPE_CODE)
@@ -200,6 +212,7 @@ You can optionally specify:
 Not specifying any or all of these parameters will return all the available data.
 
 After instantiating the object, you can call:
+
 - `download`: to download the data from the data-explorer API or the bulk download service. This method returns a DataFrame.
 - `read`: to read data as stored in the specified folder. If the data is not available, it will be downloaded.
 
@@ -239,11 +252,12 @@ data = dac1.read(
 )
 ```
 
-
 ### DAC 2A
+
 The `DAC2AData` class can retrieve and return DAC2a data.
 
 You can optionally specify:
+
 - years: to filter the data for specific years
 - providers: to filter the data for specific providers (based on their code).
 - recipients: to filter the data for specific recipients (based on their code).
@@ -252,6 +266,7 @@ You can optionally specify:
 Not specifying any or all of these parameters will return all the available data.
 
 After instantiating the object, you can call:
+
 - `download`: to download the data from the data-explorer API or the bulk download service. This method returns a DataFrame.
 - `read`: to read data as stored in the specified folder. If the data is not available, it will be downloaded.
 
@@ -301,9 +316,11 @@ data = dac2a.read(
 ```
 
 ### CRS
+
 The `CRSData` class can retrieve and return CRS data.
 
 You can optionally specify:
+
 - years: to filter the data for specific years
 - providers: to filter the data for specific providers (based on their code).
 - recipients: to filter the data for specific recipients (based on their code).
@@ -327,11 +344,12 @@ crs = CRSData(years=range(2010, 2024))
 data = crs.read(using_bulk_download=True)
 ```
 
-
 ### MultiSystem
+
 The `MultiSystemData` class can retrieve and return Providers Total Use of the Multilateral System data.
 
 You can optionally specify:
+
 - years: to filter the data for specific years
 - providers: to filter the data for specific providers (based on their code).
 - recipients: to filter the data for specific recipients (based on their code).
@@ -344,7 +362,6 @@ You can refer to the examples above for DAC1 and DAC2a to understand the usage o
 **Note**: given the speed and rate-limiting of the dac-explorer APIs, consider using the bulk option
 unless you're looking for something very specific.
 
-
 ## Utility Functions
 
 The package provides several utility functions to enhance and enrich your ODA data analysis:
@@ -417,21 +434,29 @@ dac_members = providers["dac_members"]
 
 ### Cache Management
 
-Control the package's caching behavior:
+`oda_data` stores downloaded data in a per-OS, version-segmented directory
+(`~/Library/Caches/oda-data/<version>/` on macOS, `~/.cache/oda-data/<version>/`
+on Linux, and the equivalent `AppData\Local` path on Windows). The location can be
+overridden with `oda_data.set_cache_root(path)` or the `ODA_DATA_CACHE_DIR`
+environment variable. See [CACHING.md](CACHING.md) for full details on disk
+locations, scopes, multi-process behavior, and migration from older versions.
 
-```python
-from oda_data import clear_cache, disable_cache, enable_cache
+The fastest recovery path for a corrupt or stale cache is:
 
-# Clear all cached data
-clear_cache()
+```python
+from oda_data import cache
 
-# Temporarily disable caching (for development/testing)
-disable_cache()
+# Clear only the raw zip archives and let them re-download on next read:
+cache.clear("raw")
 
-# Re-enable caching
-enable_cache()
+# Or wipe everything:
+cache.clear("all")
 ```
 
+The legacy helpers `clear_cache()`, `disable_cache()`, and `enable_cache()` continue
+to work and are thin wrappers over `cache.clear("all")`, `cache.disable_cache("all")`,
+and `cache.enable_cache("all")` respectively.
+
 ### Compatibility with Version 1.x
 
 For users migrating from v1.x, a compatibility layer is available:
@@ -503,11 +528,12 @@ data = aiddata.read()
 ## Key features
 
 - **Speed up analysis** - The package handles downloading, cleaning and loading all the data, so you can focus on the
-analysis.
+  analysis.
 - **Get data in the currency and prices you need** - ODA data is only available in US dollars (current or constant
-prices) and local currency units (current prices). The package allows you to view the data in US dollars, Euros,
-British Pounds and Canadian dollars, in both current and constant prices. We can add any other DAC currency if you
-request it via the [issues page](https://github.com/ONEcampaign/oda_data_package/issues)
+  prices) and local currency units (current prices). The package allows you to view the data in US dollars, Euros,
+  British Pounds and Canadian dollars, in both current and constant prices. We can add any other DAC currency if you
+  request it via the [issues page](https://github.com/ONEcampaign/oda_data_package/issues)
 
 ## Contributing
+
 Interested in contributing to the package? Please reach out.

oda_data-2.7.0/pyproject.toml

@@ -0,0 +1,237 @@
+[project]
+name = "oda_data"
+version = "2.7.0"
+description = "A python package to work with Official Development Assistance data from the OECD DAC."
+requires-python = ">=3.11"
+
+license = {text = "MIT"}
+readme = "README.md"
+authors = [
+    {name = "Jorge Rivera", email = "jorge.rivera@one.org"},
+    {name = "Miguel Haro Ruiz", email = "miguel.haroruiz@one.org"}
+]
+
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Scientific/Engineering",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+dependencies = [
+    "cachetools>=6.2.0",
+    "filelock>=3.20.0",
+    "oda-reader>=1.6.0",
+    "platformdirs>=4.0.0",
+    "pandas[excel,parquet,performance]>=2.2.0",
+    "pydeflate>=2.3.3",
+    "reader>=3.18",
+    "thefuzz>=0.22.1",
+]
+
+[project.urls]
+Homepage = "https://github.com/ONEcampaign/oda_data_package"
+Repository = "https://github.com/ONEcampaign/oda_data_package"
+Documentation = "https://github.com/ONEcampaign/oda_data_package"
+
+[build-system]
+requires = ["uv_build>=0.11.8,<0.12"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pre-commit>=4.5.0",
+    "ruff>=0.14.9",
+    "ty>=0.0.33",
+    "mkdocs-material>=9.7.0",
+]
+test = [
+    "pytest>=8.0.0",
+    "pytest-mock>=3.12.0",
+    "pytest-cov>=4.1.0",
+    "pytest-xdist>=3.5.0",
+    "freezegun>=1.4.0",
+]
+
+[tool.ruff]
+# Set the maximum line length
+line-length = 88
+
+# Target Python 3.11+
+target-version = "py311"
+
+# Lint/format notebooks too
+extend-include = ["*.ipynb"]
+
+# Exclude common directories
+exclude = [
+    ".git",
+    ".venv",
+    "venv",
+    "__pycache__",
+    "build",
+    "dist",
+    "*.egg-info",
+    ".pytest_cache",
+    "htmlcov",
+]
+
+[tool.ruff.lint]
+# Enable recommended rules plus extras
+select = [
+    "E",     # pycodestyle errors
+    "W",     # pycodestyle warnings
+    "F",     # pyflakes
+    "I",     # isort
+    "N",     # pep8-naming
+    "UP",    # pyupgrade
+    "B",     # flake8-bugbear
+    "C4",    # flake8-comprehensions
+    "SIM",   # flake8-simplify
+    "PL",    # pylint
+    "RUF",   # ruff-specific rules
+    "ERA",   # eradicate (commented-out code)
+    "PERF",  # perflint
+    "ANN",   # flake8-annotations (require type hints on public APIs)
+]
+
+# Ignore specific rules that might be too strict
+ignore = [
+    "E501",    # Line too long (handled by formatter)
+    "PLR0913", # Too many arguments
+    "PLR0912", # Too many branches
+    "PLR0914", # Too many locals
+    "PLR0915", # Too many statements
+    "PLR2004", # Magic value used in comparison
+    "PLC0415", # Import outside top-level (used to avoid circular imports)
+    "ANN401",  # Allow `Any` in typed signatures
+]
+
+# Allow autofix for all enabled rules
+fixable = ["ALL"]
+unfixable = []
+
+[tool.ruff.lint.per-file-ignores]
+# Allow test files to have longer lines and more assertions
+"tests/**/*.py" = ["ANN", "E501", "PLR2004", "RUF002", "RUF003", "PLW0603", "ERA001"]  # Tests don't need annotations (ANN); allow × in comments/docstrings; PLW0603 for spawn-pool worker globals; ERA001 for intentional commented-out fixtures
+# Allow global variable usage in __init__.py (architectural decision)
+"src/oda_data/__init__.py" = ["PLW0603", "PLW0602", "F811"]
+# Lazy module-level state (override flag, chained-root cache, auto-migrate gate, 5GB warning latch).
+"src/oda_data/cache/config.py" = ["PLW0603"]
+"src/oda_data/cache/api.py" = ["PLW0603"]
+# Allow tmpdir reassignment pattern (Path conversion)
+"src/oda_data/tools/cache.py" = ["PLW2901"]
+# Existing complexity in OECDClient._apply_filters — out of scope for refactor here.
+"src/oda_data/api/oecd.py" = ["PLR0912"]
+# Allow loop variable binding patterns (intentional for lambda closures)
+"src/oda_data/indicators/crs/crs_functions.py" = ["B023"]
+"src/oda_data/indicators/research/sector_imputations.py" = ["B023"]
+# Allow mixedCase variable names matching official sector code names
+"src/oda_data/tools/sector_lists.py" = ["N816"]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.format]
+# Use double quotes for strings
+quote-style = "double"
+
+# Use spaces for indentation
+indent-style = "space"
+
+# Like Black, respect magic trailing commas
+skip-magic-trailing-comma = false
+
+# Like Black, automatically detect line endings
+line-ending = "auto"
+
+[tool.ty.environment]
+python-version = "3.11"
+
+[tool.ty.src]
+include = ["src/oda_data"]
+
+# NOTE: The following two sections are borrowed from the bblocks-projects
+# `project` preset (the `package` preset omits them). This is a pandas/numpy-
+# heavy package, so the same false-positive cascade from those libraries'
+# incomplete stubs applies here. Kept as a deliberate divergence.
+[tool.ty.analysis]
+# Replace pandas / numpy type information with `Any` to eliminate the cascade
+# of false positives from those libraries' incomplete or absent stubs without
+# disabling type checking on our own code.
+# https://docs.astral.sh/ty/reference/configuration/
+replace-imports-with-any = [
+    "pandas",
+    "pandas.**",
+    "numpy",
+    "numpy.**",
+]
+
+[tool.ty.rules]
+# These warn-by-default rules fire frequently on dynamic dataframe / dict
+# patterns common in this codebase. Demoted to ignore.
+possibly-missing-attribute = "ignore"
+possibly-unresolved-reference = "ignore"
+
+[tool.pytest.ini_options]
+# Test discovery patterns
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+
+# Test execution options. Integration/network tests are deselected by default.
+addopts = """
+    -v
+    --strict-markers
+    --tb=short
+    --cov=src/oda_data
+    --cov-report=term-missing
+    --cov-report=html
+    --cov-branch
+    -m "not integration and not network"
+"""
+
+# Custom markers for organizing tests
+markers = [
+    "slow: marks tests as slow (deselect with '-m \"not slow\"')",
+    "integration: marks tests that call real OECD API (deselected by default)",
+    "network: marks tests requiring live network access (opt-in via RUN_NETWORK_TESTS=1; deselected by default)",
+    "unit: marks tests as unit tests",
+    "cache: marks tests related to caching functionality",
+    "validation: marks tests related to input validation",
+    "cleaning: marks tests related to data cleaning",
+]
+
+# Directories not searched for tests
+norecursedirs = [".git", ".venv", "venv", "__pycache__", "*.egg-info", ".pytest_cache", "htmlcov"]
+
+[tool.coverage.run]
+source = ["src/oda_data"]
+branch = true
+omit = [
+    "*/tests/*",
+    "*/__init__.py",
+    "*/config.py",
+    "*/logger.py",
+]
+
+[tool.coverage.report]
+precision = 2
+show_missing = true
+exclude_lines = [
+    "pragma: no cover",
+    "def __repr__",
+    "raise AssertionError",
+    "raise NotImplementedError",
+    "if __name__ == .__main__.:",
+    "if TYPE_CHECKING:",
+    "@abstractmethod",
+]