namecheap-python 1.0.5__py3-none-any.whl → 1.1.0__py3-none-any.whl

namecheap/__init__.py

@@ -12,9 +12,9 @@ from __future__ import annotations
 
 from .client import Namecheap
 from .errors import ConfigurationError, NamecheapError, ValidationError
-from .models import Contact, DNSRecord, Domain, DomainCheck
+from .models import Contact, DNSRecord, Domain, DomainCheck, Nameservers
 
-__version__ = "1.0.5"
+__version__ = "1.1.0"
 __all__ = [
     "ConfigurationError",
     "Contact",
@@ -23,5 +23,6 @@ __all__ = [
     "DomainCheck",
     "Namecheap",
     "NamecheapError",
+    "Nameservers",
     "ValidationError",
 ]

namecheap/_api/dns.py

@@ -6,7 +6,7 @@ from typing import TYPE_CHECKING, Any, Literal
 
 import tldextract
 
-from namecheap.models import DNSRecord
+from namecheap.models import DNSRecord, Nameservers
 
 from .base import BaseAPI
 
@@ -381,3 +381,116 @@ class DnsAPI(BaseAPI):
             >>> nc.dns.set("example.com", builder)
         """
         return DNSRecordBuilder()
+
+    def set_custom_nameservers(self, domain: str, nameservers: list[str]) -> bool:
+        """
+        Set custom nameservers for a domain.
+
+        This switches the domain from Namecheap's default DNS to custom
+        nameservers (e.g., Route 53, Cloudflare, etc.).
+
+        Args:
+            domain: Domain name
+            nameservers: List of nameserver hostnames (e.g., ["ns1.example.com", "ns2.example.com"])
+
+        Returns:
+            True if successful
+
+        Examples:
+            >>> nc.dns.set_custom_nameservers("example.com", [
+            ...     "ns-123.awsdns-45.com",
+            ...     "ns-456.awsdns-67.net",
+            ...     "ns-789.awsdns-89.org",
+            ...     "ns-012.awsdns-12.co.uk",
+            ... ])
+        """
+        assert nameservers, "At least one nameserver is required"
+        assert len(nameservers) <= 5, "Maximum of 5 nameservers allowed"
+
+        ext = tldextract.extract(domain)
+        if not ext.domain or not ext.suffix:
+            raise ValueError(f"Invalid domain name: {domain}")
+
+        result: Any = self._request(
+            "namecheap.domains.dns.setCustom",
+            {
+                "SLD": ext.domain,
+                "TLD": ext.suffix,
+                "Nameservers": ",".join(nameservers),
+            },
+            path="DomainDNSSetCustomResult",
+        )
+
+        return bool(result and result.get("@Updated") == "true")
+
+    def set_default_nameservers(self, domain: str) -> bool:
+        """
+        Reset domain to use Namecheap's default nameservers.
+
+        This switches the domain back to Namecheap BasicDNS from custom nameservers.
+
+        Args:
+            domain: Domain name
+
+        Returns:
+            True if successful
+
+        Examples:
+            >>> nc.dns.set_default_nameservers("example.com")
+        """
+        ext = tldextract.extract(domain)
+        if not ext.domain or not ext.suffix:
+            raise ValueError(f"Invalid domain name: {domain}")
+
+        result: Any = self._request(
+            "namecheap.domains.dns.setDefault",
+            {
+                "SLD": ext.domain,
+                "TLD": ext.suffix,
+            },
+            path="DomainDNSSetDefaultResult",
+        )
+
+        return bool(result and result.get("@Updated") == "true")
+
+    def get_nameservers(self, domain: str) -> Nameservers:
+        """
+        Get current nameservers for a domain.
+
+        Args:
+            domain: Domain name
+
+        Returns:
+            Nameservers with is_default flag and nameserver hostnames
+
+        Examples:
+            >>> ns = nc.dns.get_nameservers("example.com")
+            >>> ns.is_default
+            True
+            >>> ns.nameservers
+            ['dns1.registrar-servers.com', 'dns2.registrar-servers.com']
+        """
+        ext = tldextract.extract(domain)
+        if not ext.domain or not ext.suffix:
+            raise ValueError(f"Invalid domain name: {domain}")
+
+        result: Any = self._request(
+            "namecheap.domains.dns.getList",
+            {
+                "SLD": ext.domain,
+                "TLD": ext.suffix,
+            },
+            path="DomainDNSGetListResult",
+        )
+
+        assert result, f"API returned empty result for {domain} nameserver query"
+
+        is_default = result.get("@IsUsingOurDNS", "false").lower() == "true"
+
+        ns_data = result.get("Nameserver", [])
+        assert isinstance(ns_data, str | list), (
+            f"Unexpected Nameserver type: {type(ns_data)}"
+        )
+        nameservers = [ns_data] if isinstance(ns_data, str) else ns_data
+
+        return Nameservers(is_default=is_default, nameservers=nameservers)

namecheap/models.py

@@ -239,15 +239,25 @@ class Domain(XMLModel):
     @field_validator("created", "expires", mode="before")
     @classmethod
     def parse_datetime(cls, v: Any) -> datetime:
-        """Parse datetime strings."""
+        """Parse datetime from Namecheap API or Pydantic serialization."""
         if isinstance(v, datetime):
             return v
         if isinstance(v, str):
-            # Namecheap uses MM/DD/YYYY format
-            return datetime.strptime(v, "%m/%d/%Y")
+            # Namecheap API format (MM/DD/YYYY)
+            if "/" in v:
+                return datetime.strptime(v, "%m/%d/%Y")
+            # Pydantic serialization format (ISO 8601)
+            return datetime.fromisoformat(v)
         raise ValueError(f"Cannot parse datetime from {v}")
 
 
+class Nameservers(BaseModel):
+    """Current nameserver configuration for a domain."""
+
+    is_default: bool = Field(description="True when using Namecheap's own DNS")
+    nameservers: list[str] = Field(description="Nameserver hostnames")
+
+
 class Contact(BaseModel):
     """Contact information for domain registration."""
 

namecheap_cli/__main__.py

@@ -700,6 +700,131 @@ def dns_delete(
         sys.exit(1)
 
 
+@dns_group.command("nameservers")
+@click.argument("domain")
+@pass_config
+def dns_nameservers(config: Config, domain: str) -> None:
+    """Show current nameserver configuration for a domain."""
+    nc = config.init_client()
+
+    try:
+        with Progress(
+            SpinnerColumn(),
+            TextColumn("[progress.description]{task.description}"),
+            transient=True,
+        ) as progress:
+            progress.add_task(f"Getting nameserver info for {domain}...", total=None)
+            ns = nc.dns.get_nameservers(domain)
+
+        if config.output_format == "table":
+            console.print(f"\n[bold cyan]Nameservers for {domain}[/bold cyan]\n")
+
+            if ns.is_default:
+                console.print("[green]Using Namecheap BasicDNS[/green]")
+            else:
+                console.print("[yellow]Using custom nameservers:[/yellow]")
+            for nameserver in ns.nameservers:
+                console.print(f"  • {nameserver}")
+        else:
+            output_formatter(ns.model_dump(), config.output_format)
+
+    except NamecheapError as e:
+        console.print(f"[red]❌ Error: {e}[/red]")
+        sys.exit(1)
+
+
+@dns_group.command("set-nameservers")
+@click.argument("domain")
+@click.argument("nameservers", nargs=-1, required=True)
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation")
+@pass_config
+def dns_set_nameservers(
+    config: Config, domain: str, nameservers: tuple[str, ...], yes: bool
+) -> None:
+    """Set custom nameservers for a domain.
+
+    This switches the domain from Namecheap's default DNS to custom nameservers.
+
+    Example:
+        namecheap-cli dns set-nameservers example.com ns1.route53.com ns2.route53.com
+    """
+    nc = config.init_client()
+
+    try:
+        if not yes and not config.quiet:
+            console.print(
+                f"\n[yellow]Setting custom nameservers for {domain}:[/yellow]"
+            )
+            for ns in nameservers:
+                console.print(f"  • {ns}")
+            console.print()
+
+            if not Confirm.ask("Continue?", default=True):
+                console.print("[yellow]Cancelled[/yellow]")
+                return
+
+        with Progress(
+            SpinnerColumn(),
+            TextColumn("[progress.description]{task.description}"),
+            transient=True,
+        ) as progress:
+            progress.add_task(f"Setting nameservers for {domain}...", total=None)
+            success = nc.dns.set_custom_nameservers(domain, list(nameservers))
+
+        if success:
+            console.print(f"[green]✅ Custom nameservers set for {domain}[/green]")
+            if not config.quiet:
+                console.print(
+                    "\n[dim]Note: DNS propagation may take up to 48 hours.[/dim]"
+                )
+        else:
+            console.print("[red]❌ Failed to set nameservers[/red]")
+            sys.exit(1)
+
+    except NamecheapError as e:
+        console.print(f"[red]❌ Error: {e}[/red]")
+        sys.exit(1)
+
+
+@dns_group.command("reset-nameservers")
+@click.argument("domain")
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation")
+@pass_config
+def dns_reset_nameservers(config: Config, domain: str, yes: bool) -> None:
+    """Reset domain to use Namecheap's default nameservers.
+
+    This switches the domain back to Namecheap BasicDNS from custom nameservers.
+    """
+    nc = config.init_client()
+
+    try:
+        if not yes and not config.quiet:
+            console.print(
+                f"\n[yellow]This will reset {domain} to Namecheap's default DNS.[/yellow]"
+            )
+            if not Confirm.ask("Continue?", default=True):
+                console.print("[yellow]Cancelled[/yellow]")
+                return
+
+        with Progress(
+            SpinnerColumn(),
+            TextColumn("[progress.description]{task.description}"),
+            transient=True,
+        ) as progress:
+            progress.add_task(f"Resetting nameservers for {domain}...", total=None)
+            success = nc.dns.set_default_nameservers(domain)
+
+        if success:
+            console.print(f"[green]✅ {domain} is now using Namecheap BasicDNS[/green]")
+        else:
+            console.print("[red]❌ Failed to reset nameservers[/red]")
+            sys.exit(1)
+
+    except NamecheapError as e:
+        console.print(f"[red]❌ Error: {e}[/red]")
+        sys.exit(1)
+
+
 @dns_group.command("export")
 @click.argument("domain")
 @click.option(

{namecheap_python-1.0.5.dist-info → namecheap_python-1.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: namecheap-python
-Version: 1.0.5
+Version: 1.1.0
 Summary: A friendly Python SDK for Namecheap API
 Project-URL: Homepage, https://github.com/adriangalilea/namecheap-python
 Project-URL: Repository, https://github.com/adriangalilea/namecheap-python
@@ -302,6 +302,24 @@ nc.dns.set("example.com",
 
 **Note on TTL:** The default TTL is **1799 seconds**, which displays as **"Automatic"** in the Namecheap web interface. This is an undocumented Namecheap API behavior. You can specify custom TTL values (60-86400 seconds) in any DNS method.
 
+### Nameserver Management
+
+```python
+# Check current nameservers
+ns = nc.dns.get_nameservers("example.com")
+print(ns.nameservers)  # ['dns1.registrar-servers.com', 'dns2.registrar-servers.com']
+print(ns.is_default)   # True
+
+# Switch to custom nameservers (e.g., Cloudflare, Route 53)
+nc.dns.set_custom_nameservers("example.com", [
+    "ns1.cloudflare.com",
+    "ns2.cloudflare.com",
+])
+
+# Reset back to Namecheap BasicDNS
+nc.dns.set_default_nameservers("example.com")
+```
+
 ### Domain Management
 
 ```python
@@ -381,7 +399,7 @@ The following Namecheap API features are planned for future releases:
 
 - **SSL API** - Certificate management
 - **Domain Transfer API** - Transfer domains between registrars
-- **Domain NS API** - Custom nameserver management
+- **Domain NS API** - Glue record management (child nameservers)
 - **Users API** - Account management and balance checking
 - **Whois API** - WHOIS information lookups
 - **Email Forwarding** - Email forwarding configuration
@@ -399,3 +417,7 @@ MIT License - see [LICENSE](LICENSE) file for details.
 ## 🤝 Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request. See the [Development Guide](docs/dev/README.md) for setup instructions and guidelines.
+
+### Contributors
+
+- [@cosmin](https://github.com/cosmin) — Nameserver management

{namecheap_python-1.0.5.dist-info → namecheap_python-1.1.0.dist-info}/RECORD

@@ -1,15 +1,15 @@
-namecheap/__init__.py,sha256=TyOenTWmRyClXBbw1i4vlMc2GRujp6h9tZqjCNBY5l8,666
+namecheap/__init__.py,sha256=anOp8HDUUv8KiSr3Ia1Cs6gcShrWP955iBTJ4y3aB_M,698
 namecheap/client.py,sha256=wnhCA5zeZMGypD1uNHbMYCGoP9paaZjtYZucBUsEY6k,6441
 namecheap/errors.py,sha256=5bGbV1e4_jkK8YXZXbLF6GJCVUTKw1CtMl9-mz7ogZg,5010
 namecheap/logging.py,sha256=lMR1fr1dWWz3z2NFEY-vl8b52FmmhH76R2NjyifSdYA,3396
-namecheap/models.py,sha256=DJKt_XH9BLn6KVvYsvzpOdfl6qHEf_52ts5-xbJXM4A,11948
+namecheap/models.py,sha256=4n5q7MhukmLUIK1ekNXf51lfwzF08yJVoI2_b3vafXI,12356
 namecheap/_api/__init__.py,sha256=ymQxKCySphoeoo4s_J0tLziXttLNhOQ8AZbCzFcuAHs,36
 namecheap/_api/base.py,sha256=FoczO1Q860PaFUFv-S3IoIV2xaGVJAlchkWnmTI6dlw,6121
-namecheap/_api/dns.py,sha256=XJj5E1-4SokWawCit6iZGlvMypxPGjb7COTs4mpNTes,11156
+namecheap/_api/dns.py,sha256=c8aBHIugJx1DjCVC1F8cu8Z4aBZMVz6eQaBZrklGUQc,14795
 namecheap/_api/domains.py,sha256=h6cWc03iCwPqOJTfbR8pyom_8MUVPoqSIRJRws1i3UY,16603
 namecheap_cli/README.md,sha256=liduIiGr8DHXGTht5swrYnvtAlcdCMQOnSdCD61g4Vw,7337
 namecheap_cli/__init__.py,sha256=nGRHc_CkO4xKhSQdAVG-koEffP8VS0TvbfbZkg7Jg4k,108
-namecheap_cli/__main__.py,sha256=-936gBbkwqbCTLM6c_eQdZRLH6NwtC9vywnmWfRAyzw,30814
+namecheap_cli/__main__.py,sha256=_xZ8uGxpv1mtJGI2IjYw7WbVf6vQ5kkRkoR2OsSp37o,35153
 namecheap_cli/completion.py,sha256=JTEMnceQli7TombjZkHh-IcZKW4RFRI8Yk5VynxPsEA,2777
 namecheap_dns_tui/README.md,sha256=It16ZiZh0haEeaENfF5HX0Ec4dBawdTYiAi-TiG9wi0,1690
 namecheap_dns_tui/__init__.py,sha256=-yL_1Ha41FlQcmjG-raUrZP9CjTJD3d0w2BW2X-twJg,106
@@ -18,8 +18,8 @@ namecheap_dns_tui/assets/screenshot1.png,sha256=OXO2P80ll5WRzLYgaakcNnzos8svlJoX
 namecheap_dns_tui/assets/screenshot2.png,sha256=5VN_qDMNhWEyrOqKw7vxl1h-TgmZQ_V9aph3Xmf_AFg,279194
 namecheap_dns_tui/assets/screenshot3.png,sha256=h39wSKxx1JCkgeAB7Q3_JlBcAtX1vsRFKtWtOwbBVso,220625
 namecheap_dns_tui/assets/screenshot4.png,sha256=J4nCOW16z3vaRiPbcMiiIRgV7q3XFbi_1N1ivD1Pa4Y,238068
-namecheap_python-1.0.5.dist-info/METADATA,sha256=5EDUj4EdODdfGecq8pcXoU_wHsUZzqcqd_ciHkgY3A4,14802
-namecheap_python-1.0.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-namecheap_python-1.0.5.dist-info/entry_points.txt,sha256=AyhiXroLUpM0Vdo_-RvH0S8o4XDPsDlsEl_65vm6DEk,96
-namecheap_python-1.0.5.dist-info/licenses/LICENSE,sha256=pemTblFP6BBje3bBv_yL_sr2iAqB2H0-LdWMvVIR42o,1062
-namecheap_python-1.0.5.dist-info/RECORD,,
+namecheap_python-1.1.0.dist-info/METADATA,sha256=FpJL0AqYw-5ji7oVax8XtfLogWRzY1YvfRMPJlGTgi0,15374
+namecheap_python-1.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+namecheap_python-1.1.0.dist-info/entry_points.txt,sha256=AyhiXroLUpM0Vdo_-RvH0S8o4XDPsDlsEl_65vm6DEk,96
+namecheap_python-1.1.0.dist-info/licenses/LICENSE,sha256=pemTblFP6BBje3bBv_yL_sr2iAqB2H0-LdWMvVIR42o,1062
+namecheap_python-1.1.0.dist-info/RECORD,,

{namecheap_python-1.0.5.dist-info → namecheap_python-1.1.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.27.0
+Generator: hatchling 1.28.0
 Root-Is-Purelib: true
 Tag: py3-none-any