namecheap-python 1.2.0__py3-none-any.whl → 1.3.0__py3-none-any.whl

namecheap/__init__.py

@@ -18,12 +18,13 @@ from .models import (
     DNSRecord,
     Domain,
     DomainCheck,
+    DomainContacts,
     DomainInfo,
     EmailForward,
     Nameservers,
 )
 
-__version__ = "1.2.0"
+__version__ = "1.3.0"
 __all__ = [
     "AccountBalance",
     "ConfigurationError",
@@ -31,6 +32,7 @@ __all__ = [
     "DNSRecord",
     "Domain",
     "DomainCheck",
+    "DomainContacts",
     "DomainInfo",
     "EmailForward",
     "Namecheap",

namecheap/_api/dns.py

@@ -528,3 +528,41 @@ class DnsAPI(BaseAPI):
             EmailForward(mailbox=f.get("@mailbox", ""), forward_to=f.get("#text", ""))
             for f in forwards
         ]
+
+    def set_email_forwarding(
+        self, domain: str, rules: list[EmailForward] | list[dict[str, str]]
+    ) -> bool:
+        """
+        Set email forwarding rules for a domain. Replaces all existing rules.
+
+        Args:
+            domain: Domain name
+            rules: List of EmailForward or dicts with 'mailbox' and 'forward_to' keys
+
+        Returns:
+            True if successful
+
+        Examples:
+            >>> nc.dns.set_email_forwarding("example.com", [
+            ...     EmailForward(mailbox="info", forward_to="me@gmail.com"),
+            ...     EmailForward(mailbox="support", forward_to="help@gmail.com"),
+            ... ])
+        """
+        assert rules, "At least one forwarding rule is required"
+
+        params: dict[str, Any] = {"DomainName": domain}
+        for i, rule in enumerate(rules, 1):
+            if isinstance(rule, EmailForward):
+                params[f"MailBox{i}"] = rule.mailbox
+                params[f"ForwardTo{i}"] = rule.forward_to
+            else:
+                params[f"MailBox{i}"] = rule["mailbox"]
+                params[f"ForwardTo{i}"] = rule["forward_to"]
+
+        result: Any = self._request(
+            "namecheap.domains.dns.setEmailForwarding",
+            params,
+            path="DomainDNSSetEmailForwardingResult",
+        )
+
+        return bool(result and result.get("@IsSuccess", "false").lower() == "true")

namecheap/_api/domains.py

@@ -9,7 +9,7 @@ from typing import Any
 import tldextract
 
 from namecheap.logging import logger
-from namecheap.models import Contact, Domain, DomainCheck, DomainInfo
+from namecheap.models import Contact, Domain, DomainCheck, DomainContacts, DomainInfo
 
 from .base import BaseAPI
 
@@ -156,6 +156,52 @@ class DomainsAPI(BaseAPI):
 
         return DomainInfo.model_validate(flat)
 
+    def get_contacts(self, domain: str) -> DomainContacts:
+        """
+        Get contact information for a domain.
+
+        Args:
+            domain: Domain name
+
+        Returns:
+            DomainContacts with registrant, tech, admin, and aux_billing contacts
+
+        Examples:
+            >>> contacts = nc.domains.get_contacts("example.com")
+            >>> print(contacts.registrant.email)
+        """
+        result: Any = self._request(
+            "namecheap.domains.getContacts",
+            {"DomainName": domain},
+            path="DomainContactsResult",
+        )
+
+        assert result, f"API returned empty result for {domain} getContacts"
+
+        def parse_contact(data: dict[str, Any]) -> Contact:
+            return Contact.model_validate(
+                {
+                    "FirstName": data.get("FirstName", ""),
+                    "LastName": data.get("LastName", ""),
+                    "Organization": data.get("Organization"),
+                    "Address1": data.get("Address1", ""),
+                    "Address2": data.get("Address2"),
+                    "City": data.get("City", ""),
+                    "StateProvince": data.get("StateProvince", ""),
+                    "PostalCode": data.get("PostalCode", ""),
+                    "Country": data.get("Country", ""),
+                    "Phone": data.get("Phone", ""),
+                    "EmailAddress": data.get("EmailAddress", ""),
+                }
+            )
+
+        return DomainContacts(
+            registrant=parse_contact(result.get("Registrant", {})),
+            tech=parse_contact(result.get("Tech", {})),
+            admin=parse_contact(result.get("Admin", {})),
+            aux_billing=parse_contact(result.get("AuxBilling", {})),
+        )
+
     def register(
         self,
         domain: str,

namecheap/models.py

@@ -336,6 +336,17 @@ class Contact(BaseModel):
     model_config = ConfigDict(populate_by_name=True)
 
 
+class DomainContacts(BaseModel):
+    """Contact information for all roles on a domain."""
+
+    registrant: Contact
+    tech: Contact
+    admin: Contact
+    aux_billing: Contact
+
+    model_config = ConfigDict(populate_by_name=True)
+
+
 class Config(BaseModel):
     """Client configuration with validation."""
 

namecheap_cli/__main__.py

@@ -919,6 +919,103 @@ def dns_email_forwarding(config: Config, domain: str) -> None:
         sys.exit(1)
 
 
+@dns_group.command("set-email-forwarding")
+@click.argument("domain")
+@click.argument("rules", nargs=-1, required=True)
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation")
+@pass_config
+def dns_set_email_forwarding(
+    config: Config, domain: str, rules: tuple[str, ...], yes: bool
+) -> None:
+    """Set email forwarding rules. Replaces all existing rules.
+
+    Rules are in mailbox:forward_to format.
+
+    Example:
+        namecheap-cli dns set-email-forwarding example.com info:me@gmail.com support:help@gmail.com
+    """
+    nc = config.init_client()
+
+    parsed = []
+    for rule in rules:
+        assert ":" in rule, f"Invalid rule format '{rule}', expected mailbox:forward_to"
+        mailbox, forward_to = rule.split(":", 1)
+        parsed.append({"mailbox": mailbox, "forward_to": forward_to})
+
+    try:
+        if not yes and not config.quiet:
+            console.print(f"\n[yellow]Setting email forwarding for {domain}:[/yellow]")
+            for p in parsed:
+                console.print(f"  • {p['mailbox']}@{domain} → {p['forward_to']}")
+            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 email forwarding for {domain}...", total=None)
+            success = nc.dns.set_email_forwarding(domain, parsed)
+
+        if success:
+            console.print("[green]✅ Email forwarding updated successfully![/green]")
+        else:
+            console.print("[red]❌ Failed to update email forwarding[/red]")
+            sys.exit(1)
+
+    except NamecheapError as e:
+        console.print(f"[red]❌ Error: {e}[/red]")
+        sys.exit(1)
+
+
+@domain_group.command("contacts")
+@click.argument("domain")
+@pass_config
+def domain_contacts(config: Config, domain: str) -> None:
+    """Show contact information 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 contacts for {domain}...", total=None)
+            contacts = nc.domains.get_contacts(domain)
+
+        if config.output_format == "table":
+            for role, contact in [
+                ("Registrant", contacts.registrant),
+                ("Tech", contacts.tech),
+                ("Admin", contacts.admin),
+                ("Billing", contacts.aux_billing),
+            ]:
+                console.print(f"\n[bold cyan]{role}[/bold cyan]")
+                console.print(f"  {contact.first_name} {contact.last_name}")
+                if contact.organization:
+                    console.print(f"  {contact.organization}")
+                console.print(f"  {contact.email}")
+                console.print(f"  {contact.phone}")
+                console.print(f"  {contact.address1}")
+                if contact.address2:
+                    console.print(f"  {contact.address2}")
+                console.print(
+                    f"  {contact.city}, {contact.state_province} {contact.postal_code}"
+                )
+                console.print(f"  {contact.country}")
+        else:
+            output_formatter(contacts.model_dump(), config.output_format)
+
+    except NamecheapError as e:
+        console.print(f"[red]❌ Error: {e}[/red]")
+        sys.exit(1)
+
+
 @cli.group("account")
 def account_group() -> None:
     """Account management commands."""

{namecheap_python-1.2.0.dist-info → namecheap_python-1.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: namecheap-python
-Version: 1.2.0
+Version: 1.3.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
@@ -380,9 +380,24 @@ print(bal.funds_required_for_auto_renew)          # Decimal('20.16')
 ### Email Forwarding
 
 ```python
+# Read
 rules = nc.dns.get_email_forwarding("example.com")
 for r in rules:
     print(f"{r.mailbox} -> {r.forward_to}")
+
+# Write (replaces all existing rules)
+nc.dns.set_email_forwarding("example.com", [
+    EmailForward(mailbox="info", forward_to="me@gmail.com"),
+    EmailForward(mailbox="support", forward_to="help@gmail.com"),
+])
+```
+
+### Domain Contacts
+
+```python
+contacts = nc.domains.get_contacts("example.com")
+print(f"{contacts.registrant.first_name} {contacts.registrant.last_name}")
+print(contacts.registrant.email)
 ```
 
 ### Domain Management
@@ -462,11 +477,10 @@ nc.dns.builder().a("www", "192.0.2.1", ttl=1800)  # Shows as "30 min"
 
 | API | Status | Methods |
 |-----|--------|---------|
-| `namecheap.domains.*` | ✅ Done | `check`, `list`, `getInfo`, `register`, `renew`, `setContacts`, `lock`/`unlock` |
-| `namecheap.domains.dns.*` | ✅ Done | `getHosts`, `setHosts` (builder pattern), `add`, `delete`, `export`, `getList`, `setCustom`, `setDefault`, `getEmailForwarding` |
+| `namecheap.domains.*` | ✅ Done | `check`, `list`, `getInfo`, `getContacts`, `register`, `renew`, `setContacts`, `lock`/`unlock` |
+| `namecheap.domains.dns.*` | ✅ Done | `getHosts`, `setHosts` (builder pattern), `add`, `delete`, `export`, `getList`, `setCustom`, `setDefault`, `getEmailForwarding`, `setEmailForwarding` |
 | `namecheap.users.*` | ⚠️ Partial | `getBalances`, `getPricing` (needs debugging). Planned: `changePassword`, `update`, `create`, `login`, `resetPassword` |
-| `namecheap.domains.*` | 🚧 Planned | `getContacts`, `getTldList`, `reactivate` |
-| `namecheap.domains.dns.*` | 🚧 Planned | `setEmailForwarding` |
+| `namecheap.domains.*` | 🚧 Planned | `getTldList`, `reactivate` |
 | `namecheap.users.address.*` | 🚧 Planned | `create`, `delete`, `getInfo`, `getList`, `setDefault`, `update` |
 | `namecheap.ssl.*` | 🚧 Planned | `create`, `activate`, `renew`, `revoke`, `getList`, `getInfo`, `parseCSR`, `reissue`, and more |
 | `namecheap.domains.transfer.*` | 🚧 Planned | `create`, `getStatus`, `updateStatus`, `getList` |

{namecheap_python-1.2.0.dist-info → namecheap_python-1.3.0.dist-info}/RECORD

@@ -1,16 +1,16 @@
-namecheap/__init__.py,sha256=S-84LTSVWDXJeqvDoUoSsq84250m5J0MXYEPJ6xH3kw,837
+namecheap/__init__.py,sha256=sUX2-G_o6k1POjfJ9oV32Hi08zaPNL4WwfgrLr_2Qak,879
 namecheap/client.py,sha256=KesIaZVa9HpXvlp-hc3nr2x-sqzMPiHEa8NibiPq580,6644
 namecheap/errors.py,sha256=5bGbV1e4_jkK8YXZXbLF6GJCVUTKw1CtMl9-mz7ogZg,5010
 namecheap/logging.py,sha256=lMR1fr1dWWz3z2NFEY-vl8b52FmmhH76R2NjyifSdYA,3396
-namecheap/models.py,sha256=t4xloDJOgKeoERujhMRtTR0-B--ENzQsAn1WyFHyNbE,14261
+namecheap/models.py,sha256=0Fhni7yKd84bBopPURIvhwmOCYMzw8tlZwHWzRRZphY,14494
 namecheap/_api/__init__.py,sha256=ymQxKCySphoeoo4s_J0tLziXttLNhOQ8AZbCzFcuAHs,36
 namecheap/_api/base.py,sha256=FoczO1Q860PaFUFv-S3IoIV2xaGVJAlchkWnmTI6dlw,6121
-namecheap/_api/dns.py,sha256=MtOHr0AOUgS_Vv7U8WkLBw7xuU0XWbjAF6ptitteNmk,15827
-namecheap/_api/domains.py,sha256=bEPshE2GN6ubd0otTwLdZCpKVT9ErmDRy8fYxS2hkIY,18272
+namecheap/_api/dns.py,sha256=Hny5TsVWmmG-3rF6kb8JwboGFt2wKsd4-Z6T8GannBM,17213
+namecheap/_api/domains.py,sha256=txikTYACM82-3IXg2Gqagh9fRZ8aIZiu05unNpy2Zqs,20039
 namecheap/_api/users.py,sha256=CCXSZJiPkQiLHYRAlYKTBCDG3-JSPdNkNWWww71JXV0,795
 namecheap_cli/README.md,sha256=liduIiGr8DHXGTht5swrYnvtAlcdCMQOnSdCD61g4Vw,7337
 namecheap_cli/__init__.py,sha256=nGRHc_CkO4xKhSQdAVG-koEffP8VS0TvbfbZkg7Jg4k,108
-namecheap_cli/__main__.py,sha256=ZOmdVQZWkA3SHw7_nGCp_j5RdJCQff4NO6h_nIjgDnY,36425
+namecheap_cli/__main__.py,sha256=0vHk5aAhEzPKQ-UQOQdYqsolCF13DG3k9_z3pUbZXwk,40020
 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
@@ -19,8 +19,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.2.0.dist-info/METADATA,sha256=R44Jl31VrMFE8lzs_YxqgGuv7sHvN0rIj9qjgdvKyv0,18433
-namecheap_python-1.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-namecheap_python-1.2.0.dist-info/entry_points.txt,sha256=AyhiXroLUpM0Vdo_-RvH0S8o4XDPsDlsEl_65vm6DEk,96
-namecheap_python-1.2.0.dist-info/licenses/LICENSE,sha256=pemTblFP6BBje3bBv_yL_sr2iAqB2H0-LdWMvVIR42o,1062
-namecheap_python-1.2.0.dist-info/RECORD,,
+namecheap_python-1.3.0.dist-info/METADATA,sha256=phjrSgjok2JzRDjOQsEit1eb9Z7WF7Da5beLiKSEbGA,18802
+namecheap_python-1.3.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+namecheap_python-1.3.0.dist-info/entry_points.txt,sha256=AyhiXroLUpM0Vdo_-RvH0S8o4XDPsDlsEl_65vm6DEk,96
+namecheap_python-1.3.0.dist-info/licenses/LICENSE,sha256=pemTblFP6BBje3bBv_yL_sr2iAqB2H0-LdWMvVIR42o,1062
+namecheap_python-1.3.0.dist-info/RECORD,,