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

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/_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/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")

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_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.dist-info → namecheap_python-1.0.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: namecheap-python
-Version: 1.0.4
+Version: 1.0.5
 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.dist-info → namecheap_python-1.0.5.dist-info}/RECORD

@@ -1,25 +1,25 @@
-namecheap/__init__.py,sha256=4UD1BF-qTulQicElN3CmB5hUeKnlLPvtpbJD08YZp94,666
+namecheap/__init__.py,sha256=TyOenTWmRyClXBbw1i4vlMc2GRujp6h9tZqjCNBY5l8,666
 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=IUNi103jcQ7T_WgfcqXuXsZokkjUDRNYkPwtr7KJ_qU,11910
+namecheap/models.py,sha256=DJKt_XH9BLn6KVvYsvzpOdfl6qHEf_52ts5-xbJXM4A,11948
 namecheap/_api/__init__.py,sha256=ymQxKCySphoeoo4s_J0tLziXttLNhOQ8AZbCzFcuAHs,36
 namecheap/_api/base.py,sha256=FoczO1Q860PaFUFv-S3IoIV2xaGVJAlchkWnmTI6dlw,6121
-namecheap/_api/dns.py,sha256=Eibn3NzR1o3p_ukxUFDeaKTrJYgBnIomMBKsp881ZrE,10962
+namecheap/_api/dns.py,sha256=XJj5E1-4SokWawCit6iZGlvMypxPGjb7COTs4mpNTes,11156
 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=08iIreRm_30z-mmcvqd-qFEaoGWgOJJsCT7UPk7EZ-E,30768
+namecheap_cli/__main__.py,sha256=-936gBbkwqbCTLM6c_eQdZRLH6NwtC9vywnmWfRAyzw,30814
 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
-namecheap_dns_tui/__main__.py,sha256=DSSNcLAjJvQYlrVtdfped9wwM28kdisbFEZ6oPfD8jA,30034
+namecheap_dns_tui/__main__.py,sha256=7nWfaBJPpgAXJXX4VpHhmhDFILx9s6LL2upBM-3NNEA,30034
 namecheap_dns_tui/assets/screenshot1.png,sha256=OXO2P80ll5WRzLYgaakcNnzos8svlJoX8Ai9eZM3HjE,194120
 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.4.dist-info/METADATA,sha256=BqQa4-cxQnS9svtKC_8waxaNlMm6ofqoruCHm5wBlQE,13771
-namecheap_python-1.0.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-namecheap_python-1.0.4.dist-info/entry_points.txt,sha256=AyhiXroLUpM0Vdo_-RvH0S8o4XDPsDlsEl_65vm6DEk,96
-namecheap_python-1.0.4.dist-info/licenses/LICENSE,sha256=pemTblFP6BBje3bBv_yL_sr2iAqB2H0-LdWMvVIR42o,1062
-namecheap_python-1.0.4.dist-info/RECORD,,
+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,,