teritorio 2025.11.11__tar.gz

teritorio-2025.11.11/LICENSE.md

@@ -0,0 +1,11 @@
+# BSD 3-Clause License
+
+Copyright © 2025 Stephanos Kuma.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

teritorio-2025.11.11/PKG-INFO

@@ -0,0 +1,70 @@
+Metadata-Version: 2.3
+Name: teritorio
+Version: 2025.11.11
+Summary: A library for country and currency ISO codes
+Home-page: https://teritorio.readthedocs.io/en/stable/
+License: BSD-3-Clause
+Keywords: country,currency,iso
+Author: Stephanos Kuma
+Author-email: "Stephanos Kuma" <stephanos@kuma.ai>
+Requires-Python: >=3.10
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Dist: pyutilkit (~=0.11)
+Project-URL: Documentation, https://teritorio.readthedocs.io/en/stable/
+Project-URL: Repository, https://github.com/spapanik/teritorio
+Description-Content-Type: text/markdown
+
+# teritorio: ISO codes for countries and currencies
+
+[![build][build_badge]][build_url]
+[![lint][lint_badge]][lint_url]
+[![tests][tests_badge]][tests_url]
+[![license][licence_badge]][licence_url]
+[![codecov][codecov_badge]][codecov_url]
+[![readthedocs][readthedocs_badge]][readthedocs_url]
+[![pypi][pypi_badge]][pypi_url]
+[![downloads][pepy_badge]][pepy_url]
+[![build automation: yam][yam_badge]][yam_url]
+[![Lint: ruff][ruff_badge]][ruff_url]
+
+`teritorio` two iterable singletons that `Countries` and `Currencies`,
+that contain all the relevant ISO information about countries and
+currencies, respectively.
+
+## Versioning
+
+The project project adheres to [Calendar Versioning](https://calver.org). The reason is that the data are
+dominated by political decisions, making semantic versioning largely irrelevant.
+
+## Links
+
+- [Documentation]
+- [Changelog]
+
+[build_badge]: https://github.com/spapanik/teritorio/actions/workflows/build.yml/badge.svg
+[build_url]: https://github.com/spapanik/teritorio/actions/workflows/build.yml
+[lint_badge]: https://github.com/spapanik/teritorio/actions/workflows/lint.yml/badge.svg
+[lint_url]: https://github.com/spapanik/teritorio/actions/workflows/lint.yml
+[tests_badge]: https://github.com/spapanik/teritorio/actions/workflows/tests.yml/badge.svg
+[tests_url]: https://github.com/spapanik/teritorio/actions/workflows/tests.yml
+[licence_badge]: https://img.shields.io/pypi/l/teritorio
+[licence_url]: https://teritorio.readthedocs.io/en/stable/LICENSE/
+[codecov_badge]: https://codecov.io/github/spapanik/teritorio/graph/badge.svg?token=Q20F84BW72
+[codecov_url]: https://codecov.io/github/spapanik/teritorio
+[readthedocs_badge]: https://readthedocs.org/projects/teritorio/badge/?version=latest
+[readthedocs_url]: https://teritorio.readthedocs.io/en/latest/
+[pypi_badge]: https://img.shields.io/pypi/v/teritorio
+[pypi_url]: https://pypi.org/project/teritorio
+[pepy_badge]: https://pepy.tech/badge/teritorio
+[pepy_url]: https://pepy.tech/project/teritorio
+[yam_badge]: https://img.shields.io/badge/build%20automation-yamk-success
+[yam_url]: https://github.com/spapanik/yamk
+[ruff_badge]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v1.json
+[ruff_url]: https://github.com/charliermarsh/ruff
+[Documentation]: https://teritorio.readthedocs.io/en/stable/
+[Changelog]: https://teritorio.readthedocs.io/en/stable/CHANGELOG/
+[Calendar Versioning]: https://calver.org

teritorio-2025.11.11/docs/README.md

@@ -0,0 +1,50 @@
+# teritorio: ISO codes for countries and currencies
+
+[![build][build_badge]][build_url]
+[![lint][lint_badge]][lint_url]
+[![tests][tests_badge]][tests_url]
+[![license][licence_badge]][licence_url]
+[![codecov][codecov_badge]][codecov_url]
+[![readthedocs][readthedocs_badge]][readthedocs_url]
+[![pypi][pypi_badge]][pypi_url]
+[![downloads][pepy_badge]][pepy_url]
+[![build automation: yam][yam_badge]][yam_url]
+[![Lint: ruff][ruff_badge]][ruff_url]
+
+`teritorio` two iterable singletons that `Countries` and `Currencies`,
+that contain all the relevant ISO information about countries and
+currencies, respectively.
+
+## Versioning
+
+The project project adheres to [Calendar Versioning](https://calver.org). The reason is that the data are
+dominated by political decisions, making semantic versioning largely irrelevant.
+
+## Links
+
+- [Documentation]
+- [Changelog]
+
+[build_badge]: https://github.com/spapanik/teritorio/actions/workflows/build.yml/badge.svg
+[build_url]: https://github.com/spapanik/teritorio/actions/workflows/build.yml
+[lint_badge]: https://github.com/spapanik/teritorio/actions/workflows/lint.yml/badge.svg
+[lint_url]: https://github.com/spapanik/teritorio/actions/workflows/lint.yml
+[tests_badge]: https://github.com/spapanik/teritorio/actions/workflows/tests.yml/badge.svg
+[tests_url]: https://github.com/spapanik/teritorio/actions/workflows/tests.yml
+[licence_badge]: https://img.shields.io/pypi/l/teritorio
+[licence_url]: https://teritorio.readthedocs.io/en/stable/LICENSE/
+[codecov_badge]: https://codecov.io/github/spapanik/teritorio/graph/badge.svg?token=Q20F84BW72
+[codecov_url]: https://codecov.io/github/spapanik/teritorio
+[readthedocs_badge]: https://readthedocs.org/projects/teritorio/badge/?version=latest
+[readthedocs_url]: https://teritorio.readthedocs.io/en/latest/
+[pypi_badge]: https://img.shields.io/pypi/v/teritorio
+[pypi_url]: https://pypi.org/project/teritorio
+[pepy_badge]: https://pepy.tech/badge/teritorio
+[pepy_url]: https://pepy.tech/project/teritorio
+[yam_badge]: https://img.shields.io/badge/build%20automation-yamk-success
+[yam_url]: https://github.com/spapanik/yamk
+[ruff_badge]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v1.json
+[ruff_url]: https://github.com/charliermarsh/ruff
+[Documentation]: https://teritorio.readthedocs.io/en/stable/
+[Changelog]: https://teritorio.readthedocs.io/en/stable/CHANGELOG/
+[Calendar Versioning]: https://calver.org

teritorio-2025.11.11/pyproject.toml

@@ -0,0 +1,181 @@
+[build-system]
+requires = [
+    "phosphorus>=0.10",
+]
+build-backend = "phosphorus.construction.api"
+
+[project]
+name = "teritorio"
+dynamic = [
+    "version",
+]
+
+authors = [
+    { name = "Stephanos Kuma", email = "stephanos@kuma.ai" },
+]
+license = { text = "BSD-3-Clause" }
+
+readme = "docs/README.md"
+description = "A library for country and currency ISO codes"
+keywords = [
+    "iso",
+    "currency",
+    "country",
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3 :: Only",
+    "License :: OSI Approved :: BSD License",
+    "Intended Audience :: Financial and Insurance Industry",
+]
+
+requires-python = ">=3.10"
+dependencies = [
+    "pyutilkit~=0.11",
+]
+
+[project.urls]
+homepage = "https://teritorio.readthedocs.io/en/stable/"
+repository = "https://github.com/spapanik/teritorio"
+documentation = "https://teritorio.readthedocs.io/en/stable/"
+
+[dependency-groups]
+dev = [
+    "beautifulsoup4~=4.12",
+    "ipdb~=0.13",
+    "ipython~=8.37",
+    "lxml~=6.0",
+    "ptpython~=3.0",
+    { include-group = "lint" },
+    { include-group = "test" },
+    { include-group = "docs" },
+]
+lint = [
+    "mypy~=1.18",  # Keep mypy for CI/CD
+    "ty~=0.0.1a26",
+    "ruff~=0.13",
+    "types-beautifulsoup4~=4.12",
+    { include-group = "test_core" },
+]
+test = [
+    "pytest-cov~=7.0",
+    { include-group = "test_core" },
+]
+test_core = [
+    "pytest~=9.0",
+]
+docs = [
+    "mkdocs~=1.6",
+    "mkdocs-material~=9.6",
+    "mkdocs-material-extensions~=1.3",
+    "pygments~=2.19",
+    "pymdown-extensions~=10.15",
+]
+
+[tool.phosphorus.dynamic]
+version = { file = "src/teritorio/__version__.py" }
+
+[tool.mypy]
+# Keep mypy for CI/CD
+check_untyped_defs = true
+disallow_any_decorated = true
+disallow_any_explicit = true
+disallow_any_expr = false          # many builtins are Any
+disallow_any_generics = true
+disallow_any_unimported = true
+disallow_incomplete_defs = true
+disallow_subclassing_any = true
+disallow_untyped_calls = true
+disallow_untyped_decorators = true
+disallow_untyped_defs = true
+extra_checks = true
+ignore_missing_imports = true
+no_implicit_reexport = true
+show_column_numbers = true
+show_error_codes = true
+strict_equality = true
+warn_redundant_casts = true
+warn_return_any = true
+warn_unused_configs = true
+warn_unused_ignores = true
+warn_unreachable = true
+
+[[tool.mypy.overrides]]
+# Keep mypy for CI/CD
+module = "tests.*"
+disallow_any_decorated = false # mock.MagicMock is Any
+
+[tool.ruff]
+src = [
+    "src",
+]
+target-version = "py310"
+
+[tool.ruff.lint]
+select = [
+    "ALL",
+]
+ignore = [
+    "C901",   # Adding a limit to complexity is too arbitrary
+    "COM812", # Avoid conflicts with the formatter
+    "D10",    # Not everything needs a docstring
+    "D203",   # Prefer `no-blank-line-before-class` (D211)
+    "D213",   # Prefer `multi-line-summary-first-line` (D212)
+    "PLR09",  # Adding a limit to complexity is too arbitrary
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = [
+    "FBT001",  # Test arguments are handled by pytest
+    "PLR2004", # Tests should contain magic number comparisons
+    "S101",    # Pytest needs assert statements
+]
+"dev_scripts/**" = [
+    "INP001",
+]
+
+[tool.ruff.lint.flake8-tidy-imports]
+ban-relative-imports = "all"
+
+[tool.ruff.lint.flake8-tidy-imports.banned-api]
+"mock".msg = "Use unittest.mock"
+"pytz".msg = "Use zoneinfo"
+
+[tool.ruff.lint.isort]
+combine-as-imports = true
+forced-separate = [
+    "tests",
+]
+split-on-trailing-comma = false
+
+[tool.pytest.ini_options]
+minversion = "9.0"
+strict = true
+addopts = ["-ra", "-v"]
+testpaths = [
+    "tests",
+    "integration",
+]
+
+[tool.coverage.run]
+branch = true
+source = [
+    "src/",
+]
+data_file = ".cov_cache/coverage.dat"
+omit = [
+    "src/**/type_defs.py",
+]
+
+[tool.coverage.report]
+exclude_also = [
+    "if TYPE_CHECKING:",
+    "raise NotImplementedError",
+    "raise UnreachableCodeError",
+]
+fail_under = 100
+precision = 2
+show_missing = true
+skip_covered = true
+skip_empty = true

teritorio-2025.11.11/src/teritorio/__init__.py

@@ -0,0 +1,4 @@
+from teritorio.main import Countries, Currencies
+
+__all__ = ["Countries", "Currencies"]
+__version__ = "2023.06.16"

teritorio-2025.11.11/src/teritorio/__version__.py

@@ -0,0 +1 @@
+__version__ = "2025.11.11"