namecheap-python 1.0.4__tar.gz → 1.0.6__tar.gz

{namecheap_python-1.0.4 → namecheap_python-1.0.6}/CLI.md

@@ -144,10 +144,12 @@ nc dns add example.com TXT @ "v=spf1 include:_spf.google.com ~all"
 # Add URL redirect
 nc dns add example.com URL301 www https://newsite.com
 
-# Custom TTL
+# Custom TTL (default is 1799 = "Automatic" in Namecheap UI)
 nc dns add example.com A www 192.0.2.1 --ttl 300
 ```
 
+**Note:** The default TTL is 1799 seconds, which displays as "Automatic" in the Namecheap web interface.
+
 ### Delete DNS Records
 
 ```bash

{namecheap_python-1.0.4 → namecheap_python-1.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: namecheap-python
-Version: 1.0.4
+Version: 1.0.6
 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
@@ -300,6 +300,8 @@ 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.
+
 ### Domain Management
 
 ```python
@@ -357,12 +359,28 @@ except NamecheapError as e:
         print(f"💡 Tip: {e.help}")
 ```
 
+## ⚠️ Namecheap API Quirks
+
+This section documents undocumented or unusual Namecheap API behaviors we've discovered:
+
+### TTL "Automatic" = 1799 seconds
+
+The Namecheap web interface displays TTL as **"Automatic"** when the value is exactly **1799 seconds**, but shows **"30 min"** when it's **1800 seconds**. This behavior is completely undocumented in their official API documentation.
+
+Their API docs state TTL defaults to 1800 when omitted, but the UI treats 1799 specially. This SDK defaults to 1799 to match the "Automatic" behavior users see in the web interface.
+
+```python
+# Both are valid, but display differently in Namecheap UI:
+nc.dns.builder().a("www", "192.0.2.1", ttl=1799)  # Shows as "Automatic"
+nc.dns.builder().a("www", "192.0.2.1", ttl=1800)  # Shows as "30 min"
+```
+
 ## 🚧 Pending Features
 
 The following Namecheap API features are planned for future releases:
 
 - **SSL API** - Certificate management
-- **Domain Transfer API** - Transfer domains between registrars  
+- **Domain Transfer API** - Transfer domains between registrars
 - **Domain NS API** - Custom nameserver management
 - **Users API** - Account management and balance checking
 - **Whois API** - WHOIS information lookups

{namecheap_python-1.0.4 → namecheap_python-1.0.6}/README.md

@@ -258,6 +258,8 @@ 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.
+
 ### Domain Management
 
 ```python
@@ -315,12 +317,28 @@ except NamecheapError as e:
         print(f"💡 Tip: {e.help}")
 ```
 
+## ⚠️ Namecheap API Quirks
+
+This section documents undocumented or unusual Namecheap API behaviors we've discovered:
+
+### TTL "Automatic" = 1799 seconds
+
+The Namecheap web interface displays TTL as **"Automatic"** when the value is exactly **1799 seconds**, but shows **"30 min"** when it's **1800 seconds**. This behavior is completely undocumented in their official API documentation.
+
+Their API docs state TTL defaults to 1800 when omitted, but the UI treats 1799 specially. This SDK defaults to 1799 to match the "Automatic" behavior users see in the web interface.
+
+```python
+# Both are valid, but display differently in Namecheap UI:
+nc.dns.builder().a("www", "192.0.2.1", ttl=1799)  # Shows as "Automatic"
+nc.dns.builder().a("www", "192.0.2.1", ttl=1800)  # Shows as "30 min"
+```
+
 ## 🚧 Pending Features
 
 The following Namecheap API features are planned for future releases:
 
 - **SSL API** - Certificate management
-- **Domain Transfer API** - Transfer domains between registrars  
+- **Domain Transfer API** - Transfer domains between registrars
 - **Domain NS API** - Custom nameserver management
 - **Users API** - Account management and balance checking
 - **Whois API** - WHOIS information lookups

{namecheap_python-1.0.4 → namecheap_python-1.0.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "namecheap-python"
-version = "1.0.4"
+version = "1.0.6"
 description = "A friendly Python SDK for Namecheap API"
 authors = [{name = "Adrian Galilea Delgado", email = "adriangalilea@gmail.com"}]
 readme = "README.md"

{namecheap_python-1.0.4 → namecheap_python-1.0.6}/src/namecheap/__init__.py

@@ -14,7 +14,7 @@ from .client import Namecheap
 from .errors import ConfigurationError, NamecheapError, ValidationError
 from .models import Contact, DNSRecord, Domain, DomainCheck
 
-__version__ = "1.0.0"
+__version__ = "1.0.5"
 __all__ = [
     "ConfigurationError",
     "Contact",

{namecheap_python-1.0.4 → namecheap_python-1.0.6}/src/namecheap/_api/dns.py

@@ -22,14 +22,14 @@ class DNSRecordBuilder:
         """Initialize empty builder."""
         self._records: list[DNSRecord] = []
 
-    def a(self, name: str, ip: str, ttl: int = 1800) -> Self:
+    def a(self, name: str, ip: str, ttl: int = 1799) -> Self:
         """
         Add an A record.
 
         Args:
             name: Record name (@ for root)
             ip: IPv4 address
-            ttl: Time to live in seconds (60-86400, default: 1800)
+            ttl: Time to live in seconds (60-86400, default: 1799 = "Automatic")
 
         Returns:
             Self for chaining
@@ -41,14 +41,14 @@ class DNSRecordBuilder:
         )
         return self
 
-    def aaaa(self, name: str, ipv6: str, ttl: int = 1800) -> Self:
+    def aaaa(self, name: str, ipv6: str, ttl: int = 1799) -> Self:
         """
         Add an AAAA record.
 
         Args:
             name: Record name (@ for root)
             ipv6: IPv6 address
-            ttl: Time to live in seconds
+            ttl: Time to live in seconds (default: 1799 = "Automatic")
 
         Returns:
             Self for chaining
@@ -60,14 +60,14 @@ class DNSRecordBuilder:
         )
         return self
 
-    def cname(self, name: str, target: str, ttl: int = 1800) -> Self:
+    def cname(self, name: str, target: str, ttl: int = 1799) -> Self:
         """
         Add a CNAME record.
 
         Args:
             name: Record name (cannot be @)
             target: Target domain
-            ttl: Time to live in seconds
+            ttl: Time to live in seconds (default: 1799 = "Automatic")
 
         Returns:
             Self for chaining
@@ -81,7 +81,7 @@ class DNSRecordBuilder:
         )
         return self
 
-    def mx(self, name: str, server: str, priority: int = 10, ttl: int = 1800) -> Self:
+    def mx(self, name: str, server: str, priority: int = 10, ttl: int = 1799) -> Self:
         """
         Add an MX record.
 
@@ -89,7 +89,7 @@ class DNSRecordBuilder:
             name: Record name (@ for root)
             server: Mail server hostname
             priority: MX priority (lower = higher priority)
-            ttl: Time to live in seconds
+            ttl: Time to live in seconds (default: 1799 = "Automatic")
 
         Returns:
             Self for chaining
@@ -107,14 +107,14 @@ class DNSRecordBuilder:
         )
         return self
 
-    def txt(self, name: str, value: str, ttl: int = 1800) -> Self:
+    def txt(self, name: str, value: str, ttl: int = 1799) -> Self:
         """
         Add a TXT record.
 
         Args:
             name: Record name (@ for root)
             value: Text value
-            ttl: Time to live in seconds
+            ttl: Time to live in seconds (default: 1799 = "Automatic")
 
         Returns:
             Self for chaining
@@ -126,14 +126,14 @@ class DNSRecordBuilder:
         )
         return self
 
-    def ns(self, name: str, nameserver: str, ttl: int = 1800) -> Self:
+    def ns(self, name: str, nameserver: str, ttl: int = 1799) -> Self:
         """
         Add an NS record.
 
         Args:
             name: Record name
             nameserver: Nameserver hostname
-            ttl: Time to live in seconds
+            ttl: Time to live in seconds (default: 1799 = "Automatic")
 
         Returns:
             Self for chaining
@@ -151,7 +151,7 @@ class DNSRecordBuilder:
         url: str,
         *,
         redirect_type: Literal["301", "frame"] = "301",
-        ttl: int = 1800,
+        ttl: int = 1799,
     ) -> Self:
         """
         Add a URL redirect record.
@@ -160,7 +160,7 @@ class DNSRecordBuilder:
             name: Record name (@ for root)
             url: Target URL
             redirect_type: "301" for permanent redirect, "frame" for masked
-            ttl: Time to live in seconds
+            ttl: Time to live in seconds (default: 1799 = "Automatic")
 
         Returns:
             Self for chaining

{namecheap_python-1.0.4 → namecheap_python-1.0.6}/src/namecheap/models.py

@@ -188,7 +188,7 @@ class DNSRecord(XMLModel):
         Field(alias="@Type")
     )
     value: str = Field(alias="@Address")
-    ttl: int = Field(alias="@TTL", default=1800)
+    ttl: int = Field(alias="@TTL", default=1799)  # 1799 = "Automatic" in Namecheap UI
     priority: int | None = Field(alias="@MXPref", default=None)
 
     @field_validator("ttl", mode="before")
@@ -196,9 +196,9 @@ class DNSRecord(XMLModel):
     def parse_ttl(cls, v: Any) -> int:
         """Ensure TTL is within valid range."""
         try:
-            ttl = int(v) if v else 1800
+            ttl = int(v) if v else 1799
         except (ValueError, TypeError):
-            ttl = 1800
+            ttl = 1799
         return max(60, min(86400, ttl))
 
     @field_validator("priority", mode="before")
@@ -239,12 +239,15 @@ 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}")
 
 

{namecheap_python-1.0.4 → namecheap_python-1.0.6}/src/namecheap_cli/__main__.py

@@ -512,7 +512,12 @@ def dns_list(config: Config, domain: str, type: str | None, name: str | None) ->
 )
 @click.argument("name")
 @click.argument("value")
-@click.option("--ttl", type=int, default=1800, help="TTL in seconds (60-86400)")
+@click.option(
+    "--ttl",
+    type=int,
+    default=1799,
+    help="TTL in seconds (60-86400, default: 1799 = Automatic)",
+)
 @click.option("--priority", type=int, help="Priority (required for MX records)")
 @pass_config
 def dns_add(
@@ -849,7 +854,7 @@ def config_init() -> None:
             "color": True,
             "auto_renew": True,
             "whois_privacy": True,
-            "dns_ttl": 1800,
+            "dns_ttl": 1799,
         },
     }
 

{namecheap_python-1.0.4 → namecheap_python-1.0.6}/src/namecheap_dns_tui/__main__.py

@@ -233,9 +233,9 @@ class AddRecordModal(ModalScreen):
                 with Vertical(classes="field-group"):
                     yield Label("TTL (seconds):")
                     initial_ttl = (
-                        str(self.editing_record.ttl) if self.editing_record else "1800"
+                        str(self.editing_record.ttl) if self.editing_record else "1799"
                     )
-                    yield Input(placeholder="1800", id="record-ttl", value=initial_ttl)
+                    yield Input(placeholder="1799", id="record-ttl", value=initial_ttl)
 
                 with Vertical(classes="field-group", id="priority-group"):
                     yield Label("Priority:")
@@ -296,7 +296,7 @@ class AddRecordModal(ModalScreen):
                 record_type = self.query_one("#record-type", Select).value
                 name = self.query_one("#record-name", Input).value or "@"
                 value = self.query_one("#record-value", Input).value
-                ttl_str = self.query_one("#record-ttl", Input).value or "1800"
+                ttl_str = self.query_one("#record-ttl", Input).value or "1799"
                 ttl = max(60, min(86400, int(ttl_str)))
 
                 priority = None

{namecheap_python-1.0.4 → namecheap_python-1.0.6}/uv.lock

@@ -200,7 +200,7 @@ wheels = [
 
 [[package]]
 name = "namecheap-python"
-version = "1.0.3"
+version = "1.0.5"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },