npmctl-route53 0.3.6__tar.gz

npmctl_route53-0.3.6/LICENSE

@@ -0,0 +1 @@
+Apache-2.0

npmctl_route53-0.3.6/PKG-INFO

@@ -0,0 +1,198 @@
+Metadata-Version: 2.4
+Name: npmctl-route53
+Version: 0.3.6
+Summary: AWS Route 53 DNS provider extension for npmctl.
+Keywords: aws,route53,dns,nginx-proxy-manager,npmctl
+Author: Jacob Stewart
+Author-email: Jacob Stewart <jacob@swarmauri.com>
+License-Expression: Apache-2.0
+License-File: LICENSE
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: Name Service (DNS)
+Classifier: Topic :: System :: Systems Administration
+Requires-Dist: boto3>=1.34.0
+Requires-Python: >=3.10, <3.15
+Project-URL: Homepage, https://github.com/groupsum/npmctl
+Project-URL: Repository, https://github.com/groupsum/npmctl
+Project-URL: Documentation, https://github.com/groupsum/npmctl/tree/master/packages/npmctl-route53
+Project-URL: Issues, https://github.com/groupsum/npmctl/issues
+Description-Content-Type: text/markdown
+
+<h1 align="center">npmctl-route53</h1>
+
+<p align="center"><strong>AWS Route 53 DNS provider plugin for npmctl</strong></p>
+
+<p align="center">
+  Extend <code>npmctl</code> with Route 53-backed DNS record management for declarative workflows, provider discovery, and DNS-aware automation.
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/npmctl-route53/"><img src="https://img.shields.io/pypi/v/npmctl-route53.svg" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/npmctl-route53/"><img src="https://img.shields.io/pypi/pyversions/npmctl-route53.svg" alt="Python versions"></a>
+  <a href="https://github.com/groupsum/npmctl/actions/workflows/ci.yml"><img src="https://github.com/groupsum/npmctl/actions/workflows/ci.yml/badge.svg?branch=master" alt="CI"></a>
+  <a href="https://github.com/groupsum/npmctl/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="Apache 2.0 License"></a>
+</p>
+
+<p align="center">
+  <a href="https://hits.sh/github.com/groupsum/npmctl/blob/master/packages/npmctl-route53/README.md/"><img src="https://hits.sh/github.com/groupsum/npmctl/blob/master/packages/npmctl-route53/README.md.svg?label=npmctl-route53%20package%20hits" alt="npmctl-route53 package hits"></a>
+  <a href="https://pepy.tech/projects/npmctl-route53"><img src="https://static.pepy.tech/badge/npmctl-route53" alt="npmctl-route53 downloads"></a>
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/groupsum/npmctl/master/docs/images/marketing/npmctl-architecture-infographic.png" alt="npmctl architecture infographic">
+</p>
+
+`npmctl-route53` is the AWS Route 53 DNS provider package for `npmctl`. Install it when you want desired-state DNS records or DNS diagnostics to resolve through Route 53 instead of using only the base `npmctl` package.
+
+## Supported Python Versions
+
+`npmctl-route53` supports Python `3.10`, `3.11`, `3.12`, `3.13`, and `3.14`.
+
+## Why npmctl-route53
+
+- Adds Route 53 DNS provider discovery to `npmctl`
+- Lets DNS workflows live beside proxy and certificate desired state
+- Keeps AWS DNS dependencies out of the core CLI package
+- Supports operator diagnostics through `npmctl dns doctor`
+- Provides client helpers for Route 53 A and CNAME change-batch workflows
+
+## FAQ
+
+### What is npmctl-route53?
+
+**Answer:** `npmctl-route53` is a plugin package that teaches `npmctl` how to talk to AWS Route 53 through `boto3` for DNS record operations and DNS provider diagnostics.
+
+### When do I need npmctl-route53?
+
+**Answer:** You need `npmctl-route53` when your `npmctl` workflow includes Route 53 hosted-zone DNS records or when you want `npmctl` to validate Route 53 DNS connectivity and credentials.
+
+### Does npmctl-route53 work without npmctl?
+
+**Answer:** No. `npmctl-route53` is an extension package for `npmctl`, not a standalone CLI.
+
+### Can npmctl-route53 set A and CNAME records?
+
+**Answer:** Yes. Route 53 supports A and CNAME record sets through `ChangeResourceRecordSets`, and this package exposes helpers for `CREATE`, `UPSERT`, and `DELETE` batches.
+
+### What credentials are required?
+
+**Answer:** Route 53 access uses the standard AWS credential chain or `ROUTE53_PROFILE`. Diagnostics require hosted-zone and record-set list permissions; mutation helpers require `route53:ChangeResourceRecordSets`.
+
+## Install
+
+Install the base CLI and the Route 53 provider package together:
+
+```bash
+pipx install npmctl
+pipx inject npmctl npmctl-route53
+npmctl plugins list
+```
+
+With `uv`:
+
+```bash
+uv tool install npmctl
+uv tool install npmctl-route53
+npmctl plugins list
+```
+
+Inside a virtual environment:
+
+```bash
+python -m venv .venv
+. .venv/bin/activate
+python -m pip install npmctl npmctl-route53
+npmctl plugins list
+```
+
+## Configure Route 53
+
+Use the standard AWS credential chain:
+
+```bash
+export AWS_ACCESS_KEY_ID=...
+export AWS_SECRET_ACCESS_KEY=...
+export AWS_SESSION_TOKEN=...
+```
+
+Or use a named profile:
+
+```bash
+export AWS_PROFILE=production-dns
+```
+
+Optional package-specific override:
+
+```bash
+export ROUTE53_PROFILE=production-dns
+```
+
+## Verify Plugin Discovery
+
+Check that `npmctl` can discover the provider:
+
+```bash
+npmctl plugins list
+npmctl dns doctor --provider route53
+```
+
+## Minimal DNS Workflow
+
+Once the provider is installed and configured, `npmctl` can validate or diagnose Route 53-backed DNS behavior through the base CLI:
+
+```bash
+npmctl dns providers
+npmctl dns zones --provider route53
+npmctl dns records --provider route53 --zone example.com
+```
+
+## Route 53 API Surface
+
+The provider follows the AWS Route 53 API through `boto3`:
+
+- `ListHostedZones`: discover hosted zones.
+- `ListResourceRecordSets`: list records in one hosted zone.
+- `ChangeResourceRecordSets` with `CREATE`: create record sets.
+- `ChangeResourceRecordSets` with `UPSERT`: create or update record sets.
+- `ChangeResourceRecordSets` with `DELETE`: delete record sets.
+
+Required IAM actions for diagnostics:
+
+- `route53:ListHostedZones`
+- `route53:ListResourceRecordSets`
+
+Required IAM action for mutation helpers:
+
+- `route53:ChangeResourceRecordSets`
+
+## Programmatic Record Operations
+
+```python
+from npmctl_route53 import Route53Client, Route53Config
+
+client = Route53Client(Route53Config.from_env())
+client.create_record("example.com", type="A", name="www", value="192.0.2.10", ttl=300)
+client.upsert_record("example.com", type="CNAME", name="app", value="target.example.net", ttl=300)
+client.delete_record("example.com", type="A", name="www", value="192.0.2.10", ttl=300)
+```
+
+## Safety Notes
+
+- Route 53 changes are hosted-zone scoped. Confirm the selected hosted zone before mutation.
+- Prefer IAM policies scoped to the intended hosted zone ARN.
+- `UPSERT` can overwrite live DNS answers. Use create-only workflows when adoption is not explicit.
+- Use npmctl owner metadata for desired DNS records so future apply support can remain owner-scoped.
+
+## More Documentation
+
+- Related PyPI package: https://pypi.org/project/npmctl/
+- Repository: https://github.com/groupsum/npmctl
+- DNS provider docs: https://github.com/groupsum/npmctl/tree/master/docs/dns-providers.md

npmctl_route53-0.3.6/README.md

@@ -0,0 +1,170 @@
+<h1 align="center">npmctl-route53</h1>
+
+<p align="center"><strong>AWS Route 53 DNS provider plugin for npmctl</strong></p>
+
+<p align="center">
+  Extend <code>npmctl</code> with Route 53-backed DNS record management for declarative workflows, provider discovery, and DNS-aware automation.
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/npmctl-route53/"><img src="https://img.shields.io/pypi/v/npmctl-route53.svg" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/npmctl-route53/"><img src="https://img.shields.io/pypi/pyversions/npmctl-route53.svg" alt="Python versions"></a>
+  <a href="https://github.com/groupsum/npmctl/actions/workflows/ci.yml"><img src="https://github.com/groupsum/npmctl/actions/workflows/ci.yml/badge.svg?branch=master" alt="CI"></a>
+  <a href="https://github.com/groupsum/npmctl/blob/master/LICENSE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="Apache 2.0 License"></a>
+</p>
+
+<p align="center">
+  <a href="https://hits.sh/github.com/groupsum/npmctl/blob/master/packages/npmctl-route53/README.md/"><img src="https://hits.sh/github.com/groupsum/npmctl/blob/master/packages/npmctl-route53/README.md.svg?label=npmctl-route53%20package%20hits" alt="npmctl-route53 package hits"></a>
+  <a href="https://pepy.tech/projects/npmctl-route53"><img src="https://static.pepy.tech/badge/npmctl-route53" alt="npmctl-route53 downloads"></a>
+</p>
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/groupsum/npmctl/master/docs/images/marketing/npmctl-architecture-infographic.png" alt="npmctl architecture infographic">
+</p>
+
+`npmctl-route53` is the AWS Route 53 DNS provider package for `npmctl`. Install it when you want desired-state DNS records or DNS diagnostics to resolve through Route 53 instead of using only the base `npmctl` package.
+
+## Supported Python Versions
+
+`npmctl-route53` supports Python `3.10`, `3.11`, `3.12`, `3.13`, and `3.14`.
+
+## Why npmctl-route53
+
+- Adds Route 53 DNS provider discovery to `npmctl`
+- Lets DNS workflows live beside proxy and certificate desired state
+- Keeps AWS DNS dependencies out of the core CLI package
+- Supports operator diagnostics through `npmctl dns doctor`
+- Provides client helpers for Route 53 A and CNAME change-batch workflows
+
+## FAQ
+
+### What is npmctl-route53?
+
+**Answer:** `npmctl-route53` is a plugin package that teaches `npmctl` how to talk to AWS Route 53 through `boto3` for DNS record operations and DNS provider diagnostics.
+
+### When do I need npmctl-route53?
+
+**Answer:** You need `npmctl-route53` when your `npmctl` workflow includes Route 53 hosted-zone DNS records or when you want `npmctl` to validate Route 53 DNS connectivity and credentials.
+
+### Does npmctl-route53 work without npmctl?
+
+**Answer:** No. `npmctl-route53` is an extension package for `npmctl`, not a standalone CLI.
+
+### Can npmctl-route53 set A and CNAME records?
+
+**Answer:** Yes. Route 53 supports A and CNAME record sets through `ChangeResourceRecordSets`, and this package exposes helpers for `CREATE`, `UPSERT`, and `DELETE` batches.
+
+### What credentials are required?
+
+**Answer:** Route 53 access uses the standard AWS credential chain or `ROUTE53_PROFILE`. Diagnostics require hosted-zone and record-set list permissions; mutation helpers require `route53:ChangeResourceRecordSets`.
+
+## Install
+
+Install the base CLI and the Route 53 provider package together:
+
+```bash
+pipx install npmctl
+pipx inject npmctl npmctl-route53
+npmctl plugins list
+```
+
+With `uv`:
+
+```bash
+uv tool install npmctl
+uv tool install npmctl-route53
+npmctl plugins list
+```
+
+Inside a virtual environment:
+
+```bash
+python -m venv .venv
+. .venv/bin/activate
+python -m pip install npmctl npmctl-route53
+npmctl plugins list
+```
+
+## Configure Route 53
+
+Use the standard AWS credential chain:
+
+```bash
+export AWS_ACCESS_KEY_ID=...
+export AWS_SECRET_ACCESS_KEY=...
+export AWS_SESSION_TOKEN=...
+```
+
+Or use a named profile:
+
+```bash
+export AWS_PROFILE=production-dns
+```
+
+Optional package-specific override:
+
+```bash
+export ROUTE53_PROFILE=production-dns
+```
+
+## Verify Plugin Discovery
+
+Check that `npmctl` can discover the provider:
+
+```bash
+npmctl plugins list
+npmctl dns doctor --provider route53
+```
+
+## Minimal DNS Workflow
+
+Once the provider is installed and configured, `npmctl` can validate or diagnose Route 53-backed DNS behavior through the base CLI:
+
+```bash
+npmctl dns providers
+npmctl dns zones --provider route53
+npmctl dns records --provider route53 --zone example.com
+```
+
+## Route 53 API Surface
+
+The provider follows the AWS Route 53 API through `boto3`:
+
+- `ListHostedZones`: discover hosted zones.
+- `ListResourceRecordSets`: list records in one hosted zone.
+- `ChangeResourceRecordSets` with `CREATE`: create record sets.
+- `ChangeResourceRecordSets` with `UPSERT`: create or update record sets.
+- `ChangeResourceRecordSets` with `DELETE`: delete record sets.
+
+Required IAM actions for diagnostics:
+
+- `route53:ListHostedZones`
+- `route53:ListResourceRecordSets`
+
+Required IAM action for mutation helpers:
+
+- `route53:ChangeResourceRecordSets`
+
+## Programmatic Record Operations
+
+```python
+from npmctl_route53 import Route53Client, Route53Config
+
+client = Route53Client(Route53Config.from_env())
+client.create_record("example.com", type="A", name="www", value="192.0.2.10", ttl=300)
+client.upsert_record("example.com", type="CNAME", name="app", value="target.example.net", ttl=300)
+client.delete_record("example.com", type="A", name="www", value="192.0.2.10", ttl=300)
+```
+
+## Safety Notes
+
+- Route 53 changes are hosted-zone scoped. Confirm the selected hosted zone before mutation.
+- Prefer IAM policies scoped to the intended hosted zone ARN.
+- `UPSERT` can overwrite live DNS answers. Use create-only workflows when adoption is not explicit.
+- Use npmctl owner metadata for desired DNS records so future apply support can remain owner-scoped.
+
+## More Documentation
+
+- Related PyPI package: https://pypi.org/project/npmctl/
+- Repository: https://github.com/groupsum/npmctl
+- DNS provider docs: https://github.com/groupsum/npmctl/tree/master/docs/dns-providers.md

npmctl_route53-0.3.6/pyproject.toml

@@ -0,0 +1,39 @@
+[project]
+name = "npmctl-route53"
+version = "0.3.6"
+description = "AWS Route 53 DNS provider extension for npmctl."
+readme = "README.md"
+requires-python = ">=3.10,<3.15"
+license = "Apache-2.0"
+license-files = ["LICENSE"]
+authors = [{ name = "Jacob Stewart", email = "jacob@swarmauri.com" }]
+classifiers = [
+  "Development Status :: 1 - Planning",
+  "Intended Audience :: System Administrators",
+  "License :: OSI Approved :: Apache Software License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Topic :: Internet :: Name Service (DNS)",
+  "Topic :: System :: Systems Administration",
+]
+keywords = ["aws", "route53", "dns", "nginx-proxy-manager", "npmctl"]
+dependencies = [
+  "boto3>=1.34.0",
+]
+
+[project.entry-points."npmctl.dns_providers"]
+route53 = "npmctl_route53.provider:Route53DnsProvider"
+
+[project.urls]
+Homepage = "https://github.com/groupsum/npmctl"
+Repository = "https://github.com/groupsum/npmctl"
+Documentation = "https://github.com/groupsum/npmctl/tree/master/packages/npmctl-route53"
+Issues = "https://github.com/groupsum/npmctl/issues"
+
+[build-system]
+requires = ["uv-build>=0.11.8,<0.12"]
+build-backend = "uv_build"

npmctl_route53-0.3.6/src/npmctl_route53/__init__.py

@@ -0,0 +1,7 @@
+"""AWS Route 53 DNS extension for npmctl."""
+
+from npmctl_route53.client import Route53Client
+from npmctl_route53.config import Route53Config
+from npmctl_route53.provider import Route53DnsProvider
+
+__all__ = ["Route53Client", "Route53Config", "Route53DnsProvider"]

npmctl_route53-0.3.6/src/npmctl_route53/client.py

@@ -0,0 +1,98 @@
+"""Small AWS Route 53 API client."""
+
+from __future__ import annotations
+
+from npmctl_route53.config import Route53Config
+from npmctl_route53.errors import Route53Error
+from npmctl_route53.models import Route53Record, Route53Zone
+
+
+class Route53Client:
+    """Client wrapper for Route 53 hosted zones and record sets."""
+
+    def __init__(self, config: Route53Config, *, api: object | None = None) -> None:
+        self.config = config
+        self._api = api
+
+    @property
+    def api(self) -> object:
+        if self._api is None:
+            self._api = _default_api(self.config)
+        return self._api
+
+    def zones(self) -> tuple[str, ...]:
+        return tuple(zone.name for zone in self._zones())
+
+    def records(self, zone: str) -> tuple[Route53Record, ...]:
+        zone_id = self._zone_id(zone)
+        data = self.api.list_resource_record_sets(HostedZoneId=zone_id)  # type: ignore[attr-defined]
+        return tuple(Route53Record.from_mapping(item) for item in data.get("ResourceRecordSets", []))
+
+    def create_record(self, zone: str, *, type: str, name: str, value: str, ttl: int = 300) -> str | None:
+        return self._change_record("CREATE", zone, type=type, name=name, value=value, ttl=ttl)
+
+    def upsert_record(self, zone: str, *, type: str, name: str, value: str, ttl: int = 300) -> str | None:
+        return self._change_record("UPSERT", zone, type=type, name=name, value=value, ttl=ttl)
+
+    def delete_record(self, zone: str, *, type: str, name: str, value: str, ttl: int = 300) -> str | None:
+        return self._change_record("DELETE", zone, type=type, name=name, value=value, ttl=ttl)
+
+    def _zones(self) -> tuple[Route53Zone, ...]:
+        data = self.api.list_hosted_zones()  # type: ignore[attr-defined]
+        return tuple(Route53Zone.from_mapping(item) for item in data.get("HostedZones", []))
+
+    def _zone_id(self, zone: str) -> str:
+        target = _dns_name(zone)
+        for item in self._zones():
+            if item.name == target:
+                return item.zone_id
+        raise Route53Error(f"Route 53 hosted zone not found: {zone}")
+
+    def _change_record(self, action: str, zone: str, *, type: str, name: str, value: str, ttl: int) -> str | None:
+        data = self.api.change_resource_record_sets(  # type: ignore[attr-defined]
+            HostedZoneId=self._zone_id(zone),
+            ChangeBatch={
+                "Changes": [
+                    {
+                        "Action": action,
+                        "ResourceRecordSet": {
+                            "Name": _absolute_name(name, zone),
+                            "Type": type.upper(),
+                            "TTL": ttl,
+                            "ResourceRecords": [{"Value": value}],
+                        },
+                    }
+                ]
+            },
+        )
+        change = data.get("ChangeInfo", {})
+        change_id = change.get("Id")
+        return None if change_id is None else str(change_id)
+
+
+def _default_api(config: Route53Config) -> object:
+    try:
+        import boto3
+    except ImportError as exc:  # pragma: no cover - exercised only without package dependency installed.
+        raise Route53Error("boto3 is required for live Route 53 access") from exc
+    session_kwargs: dict[str, str] = {}
+    if config.profile:
+        session_kwargs["profile_name"] = config.profile
+    if config.region_name:
+        session_kwargs["region_name"] = config.region_name
+    session = boto3.Session(**session_kwargs)
+    return session.client("route53")
+
+
+def _absolute_name(name: str, zone: str) -> str:
+    normalized_name = _dns_name(name)
+    normalized_zone = _dns_name(zone)
+    if normalized_name in ("", "@"):
+        return f"{normalized_zone}."
+    if normalized_name.endswith(f".{normalized_zone}"):
+        return f"{normalized_name}."
+    return f"{normalized_name}.{normalized_zone}."
+
+
+def _dns_name(value: str) -> str:
+    return value.strip().lower().rstrip(".")

npmctl_route53-0.3.6/src/npmctl_route53/config.py

@@ -0,0 +1,26 @@
+"""Configuration loading for the Route 53 DNS provider."""
+
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass
+from typing import Mapping
+
+
+@dataclass(frozen=True, slots=True)
+class Route53Config:
+    """Route 53 API configuration."""
+
+    profile: str | None = None
+    region_name: str | None = None
+
+    @classmethod
+    def from_env(cls, env: Mapping[str, str] | None = None) -> Route53Config:
+        values = os.environ if env is None else env
+        return cls(
+            profile=values.get("ROUTE53_PROFILE") or values.get("AWS_PROFILE") or None,
+            region_name=values.get("AWS_REGION") or values.get("AWS_DEFAULT_REGION") or None,
+        )
+
+    def redacted(self) -> dict[str, str | bool | None]:
+        return {"profile": self.profile, "region_name": self.region_name, "aws_credentials": "standard-chain"}

npmctl_route53-0.3.6/src/npmctl_route53/errors.py

@@ -0,0 +1,7 @@
+"""Route 53 provider errors."""
+
+from __future__ import annotations
+
+
+class Route53Error(RuntimeError):
+    """Raised when the Route 53 API returns an error."""

npmctl_route53-0.3.6/src/npmctl_route53/models.py

@@ -0,0 +1,62 @@
+"""Route 53 DNS response models."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any, Mapping
+
+
+@dataclass(frozen=True, slots=True)
+class Route53Zone:
+    """One Route 53 hosted zone."""
+
+    zone_id: str
+    name: str
+
+    @classmethod
+    def from_mapping(cls, raw: Mapping[str, Any]) -> Route53Zone:
+        return cls(zone_id=str(raw.get("Id", "")).split("/")[-1], name=_dns_name(str(raw.get("Name", ""))))
+
+
+@dataclass(frozen=True, slots=True)
+class Route53Record:
+    """One Route 53 resource record set."""
+
+    name: str
+    type: str
+    values: tuple[str, ...]
+    ttl: int | None = None
+
+    @classmethod
+    def from_mapping(cls, raw: Mapping[str, Any]) -> Route53Record:
+        records = raw.get("ResourceRecords", [])
+        alias_target = raw.get("AliasTarget")
+        values = tuple(str(item.get("Value", "")) for item in records if isinstance(item, Mapping))
+        if not values and isinstance(alias_target, Mapping):
+            values = (str(alias_target.get("DNSName", "")),)
+        return cls(
+            name=_dns_name(str(raw.get("Name", ""))),
+            type=str(raw.get("Type", "")).upper(),
+            values=values,
+            ttl=_optional_int(raw.get("TTL")),
+        )
+
+    def to_dict(self) -> dict[str, str | int | tuple[str, ...] | None]:
+        return {
+            "id": None,
+            "name": self.name,
+            "type": self.type,
+            "value": self.values[0] if self.values else "",
+            "values": self.values,
+            "ttl": self.ttl,
+        }
+
+
+def _dns_name(value: str) -> str:
+    return value.strip().lower().rstrip(".")
+
+
+def _optional_int(value: Any) -> int | None:
+    if value in (None, ""):
+        return None
+    return int(value)

npmctl_route53-0.3.6/src/npmctl_route53/provider.py

@@ -0,0 +1,27 @@
+"""npmctl DNS provider implementation for Route 53."""
+
+from __future__ import annotations
+
+from npmctl_route53.client import Route53Client
+from npmctl_route53.config import Route53Config
+
+
+class Route53DnsProvider:
+    """DNS provider backed by AWS Route 53."""
+
+    name = "route53"
+
+    def __init__(self, client: Route53Client | None = None) -> None:
+        self._client = client
+
+    @property
+    def client(self) -> Route53Client:
+        if self._client is None:
+            self._client = Route53Client(Route53Config.from_env())
+        return self._client
+
+    def zones(self) -> tuple[str, ...]:
+        return self.client.zones()
+
+    def records(self, zone: str) -> tuple[dict[str, object], ...]:
+        return tuple(record.to_dict() for record in self.client.records(zone))

npmctl_route53-0.3.6/src/npmctl_route53/py.typed

@@ -0,0 +1 @@
+