modelsdotdev 0.20260514.0__tar.gz

modelsdotdev-0.20260514.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Vercel, Inc.
+Model data Copyright (c) 2025 models.dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

modelsdotdev-0.20260514.0/PKG-INFO

@@ -0,0 +1,61 @@
+Metadata-Version: 2.4
+Name: modelsdotdev
+Version: 0.20260514.0
+Summary: An offline models.dev database bundle exposed as a typed Python module.
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# modelsdotdev-python
+
+An offline [models.dev](https://models.dev) database bundle exposed as a
+Python module.
+
+```python
+from modelsdotdev import get_model_by_id, get_provider_by_name
+
+provider = get_provider_by_name("OpenAI")
+model = get_model_by_id("openai/gpt-5.5")
+
+if provider is not None:
+    provider_model = provider.get_model_by_id("gpt-5.5")
+    provider_models = list(provider.iter_models())
+```
+
+## Development
+
+Install dependencies and run the test suite with uv:
+
+```sh
+uv run pytest
+```
+
+Running the test suite refreshes the database used by tests. Editable installs
+refresh the in-tree SQLite database; other installs use a temporary database
+path exposed through `MODELDOTDEV_DATABASE_PATH`. You can also refresh the
+in-tree database explicitly with the Poe task:
+
+```sh
+uv run poe generate-db
+```
+
+Source checkouts do not generate the database during normal imports or editable
+installs. Distribution builds generate it automatically if it is missing so
+published artifacts remain self-contained.
+
+## License
+
+This project is licensed under the MIT License. See [LICENSE](LICENSE) for
+details.

modelsdotdev-0.20260514.0/README.md

@@ -0,0 +1,41 @@
+# modelsdotdev-python
+
+An offline [models.dev](https://models.dev) database bundle exposed as a
+Python module.
+
+```python
+from modelsdotdev import get_model_by_id, get_provider_by_name
+
+provider = get_provider_by_name("OpenAI")
+model = get_model_by_id("openai/gpt-5.5")
+
+if provider is not None:
+    provider_model = provider.get_model_by_id("gpt-5.5")
+    provider_models = list(provider.iter_models())
+```
+
+## Development
+
+Install dependencies and run the test suite with uv:
+
+```sh
+uv run pytest
+```
+
+Running the test suite refreshes the database used by tests. Editable installs
+refresh the in-tree SQLite database; other installs use a temporary database
+path exposed through `MODELDOTDEV_DATABASE_PATH`. You can also refresh the
+in-tree database explicitly with the Poe task:
+
+```sh
+uv run poe generate-db
+```
+
+Source checkouts do not generate the database during normal imports or editable
+installs. Distribution builds generate it automatically if it is missing so
+published artifacts remain self-contained.
+
+## License
+
+This project is licensed under the MIT License. See [LICENSE](LICENSE) for
+details.

modelsdotdev-0.20260514.0/build_backend.py

@@ -0,0 +1,106 @@
+"""Build hooks for packaging the generated models.dev database."""
+
+from __future__ import annotations
+
+import importlib
+import sys
+from pathlib import Path
+from typing import Any
+
+_ROOT = Path(__file__).resolve().parent
+_SRC = _ROOT / "src"
+_DB_PATH = _SRC / "modelsdotdev" / "_db.sqlite"
+
+
+def _uv_build() -> Any:
+    return importlib.import_module("uv_build")
+
+
+def _ensure_database() -> None:
+    if _DB_PATH.is_file():
+        return
+
+    src = str(_SRC)
+    if src not in sys.path:
+        sys.path.insert(0, src)
+
+    sync = importlib.import_module("modelsdotdev._internal.sync")
+    sync.generate_database(output=_DB_PATH)
+
+
+def build_sdist(
+    sdist_directory: str,
+    config_settings: dict[str, Any] | None = None,
+) -> str:
+    """Build a source distribution after ensuring package data exists."""
+    _ensure_database()
+    return _uv_build().build_sdist(sdist_directory, config_settings)
+
+
+def build_wheel(
+    wheel_directory: str,
+    config_settings: dict[str, Any] | None = None,
+    metadata_directory: str | None = None,
+) -> str:
+    """Build a wheel after ensuring package data exists."""
+    _ensure_database()
+    return _uv_build().build_wheel(
+        wheel_directory,
+        config_settings,
+        metadata_directory,
+    )
+
+
+def build_editable(
+    wheel_directory: str,
+    config_settings: dict[str, Any] | None = None,
+    metadata_directory: str | None = None,
+) -> str:
+    """Build an editable wheel without mutating the source checkout."""
+    return _uv_build().build_editable(
+        wheel_directory,
+        config_settings,
+        metadata_directory,
+    )
+
+
+def get_requires_for_build_wheel(
+    config_settings: dict[str, Any] | None = None,
+) -> list[str]:
+    """Return additional build requirements for wheel builds."""
+    hook = getattr(_uv_build(), "get_requires_for_build_wheel", None)
+    if hook is None:
+        return []
+    return hook(config_settings)
+
+
+def get_requires_for_build_editable(
+    config_settings: dict[str, Any] | None = None,
+) -> list[str]:
+    """Return additional build requirements for editable wheel builds."""
+    hook = getattr(_uv_build(), "get_requires_for_build_editable", None)
+    if hook is None:
+        return []
+    return hook(config_settings)
+
+
+def prepare_metadata_for_build_wheel(
+    metadata_directory: str,
+    config_settings: dict[str, Any] | None = None,
+) -> str:
+    """Prepare wheel metadata using uv_build."""
+    return _uv_build().prepare_metadata_for_build_wheel(
+        metadata_directory,
+        config_settings,
+    )
+
+
+def prepare_metadata_for_build_editable(
+    metadata_directory: str,
+    config_settings: dict[str, Any] | None = None,
+) -> str:
+    """Prepare editable wheel metadata using uv_build."""
+    return _uv_build().prepare_metadata_for_build_editable(
+        metadata_directory,
+        config_settings,
+    )

modelsdotdev-0.20260514.0/pyproject.toml

@@ -0,0 +1,115 @@
+[project]
+name = "modelsdotdev"
+version = "0.20260514.0"
+description = "An offline models.dev database bundle exposed as a typed Python module."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.12"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+
+[build-system]
+requires = ["uv_build>=0.11.0,<0.12"]
+build-backend = "build_backend"
+backend-path = ["."]
+
+[tool.uv.build-backend]
+module-root = "src"
+source-include = ["build_backend.py"]
+
+[dependency-groups]
+dev = [
+    "ty~=0.0.35",
+    "mypy~=2.1.0",
+    "poethepoet~=0.37.0",
+    "pytest~=9.0.3",
+    "ruff~=0.15.2",
+]
+
+[tool.poe.tasks]
+generate-db = "python -m modelsdotdev._internal.sync"
+
+[tool.mypy]
+python_version = "3.12"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+mypy_path = ["src"]
+packages = ["modelsdotdev", "tests"]
+explicit_package_bases = true
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+disable_error_code = ["unused-ignore"]
+
+[tool.ty.environment]
+python-version = "3.12"
+root = ["./src", "./"]
+
+[tool.ruff]
+line-length = 80
+indent-width = 4
+target-version = "py312"
+exclude = [
+    ".github",
+    ".git",
+    "build",
+    "dist",
+    ".eggs",
+]
+
+[tool.ruff.lint]
+preview = true
+extend-select = [
+    "B",    # flake8-bugbear
+    "C4",   # flake8-comprehensions
+    "D",    # pydocstyle
+    "E",    # error
+    "ERA",  # flake8-eradicate
+    "F",    # pyflakes
+    "FBT",  # flake8-boolean-trap
+    "G",    # flake8-logging-format
+    "I",    # isort
+    "N",    # pep8-naming
+    "PGH",  # pygrep-hooks
+    "PIE",  # flake8-pie
+    "PLE",  # pylint-error
+    "PLW",  # pylint-warning
+    "PLC",  # pylint-convention
+    "RUF",  # ruff specific
+    "SIM",  # flake8-simplify
+    "T20",  # flake8-print
+    "TC",   # flake8-type-checking
+    "UP",   # pyupgrade
+    "W",    # warning
+]
+
+extend-ignore = [
+    "D203",    # incorrect-blank-line-before-class
+    "D213",    # multi-line-summary-second-line
+    "F541",    # f-string-missing-placeholders
+    "PLW1514", # unspecified-encoding (UTF-8 is Python 3 default)
+    "PLW2901", # redefined-loop-name (intentional pattern for line processing)
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**/*.py" = [
+    "D",       # docstrings not required in tests
+    "PLC2701", # allow private imports in tests
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

modelsdotdev-0.20260514.0/src/modelsdotdev/.gitignore

@@ -0,0 +1 @@
+_db.sqlite

modelsdotdev-0.20260514.0/src/modelsdotdev/__init__.py

@@ -0,0 +1,43 @@
+"""Typed offline interface for an offline models.dev database."""
+
+from modelsdotdev._internal.data import (
+    Capability,
+    Cost,
+    ExperimentalMode,
+    Limits,
+    Modalities,
+    Modality,
+    Model,
+    ModelProviderConfig,
+    ModelRef,
+    Provider,
+    ProviderAPIShape,
+    Status,
+    get_model_by_id,
+    get_provider_by_id,
+    get_provider_by_name,
+    iter_models,
+    iter_providers,
+    parse_model_id,
+)
+
+__all__ = [
+    "Capability",
+    "Cost",
+    "ExperimentalMode",
+    "Limits",
+    "Modalities",
+    "Modality",
+    "Model",
+    "ModelProviderConfig",
+    "ModelRef",
+    "Provider",
+    "ProviderAPIShape",
+    "Status",
+    "get_model_by_id",
+    "get_provider_by_id",
+    "get_provider_by_name",
+    "iter_models",
+    "iter_providers",
+    "parse_model_id",
+]