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

namecheap_python-1.2.0/CLAUDE.md

@@ -0,0 +1,2 @@
+@README.md
+@CONTRIBUTING.md

namecheap_python-1.2.0/CONTRIBUTING.md

@@ -0,0 +1,113 @@
+# Contributing
+
+## Setup
+
+```bash
+git clone https://github.com/adriangalilea/namecheap-python.git
+cd namecheap-python
+uv sync --all-extras
+pre-commit install
+```
+
+## Code Quality
+
+```bash
+uv run ruff check        # lint
+uv run ruff check --fix  # auto-fix
+uv run ruff format       # format
+
+pre-commit run --all-files  # run all hooks
+```
+
+## Building
+
+```bash
+uv build
+```
+
+## Release
+
+Automated via GitHub Actions on push to `main`. If the version in `pyproject.toml` doesn't exist on PyPI, CI publishes automatically, creates a git tag, and generates a GitHub release with changelog via [git-cliff](https://git-cliff.org/).
+
+Bump version in both `pyproject.toml` and `src/namecheap/__init__.py`.
+
+## Debugging
+
+```python
+import logging
+logging.basicConfig(level=logging.DEBUG)
+```
+
+Or set `NAMECHEAP_DEBUG=true`.
+
+## Architecture
+
+### Project Structure
+
+```
+src/
+├── namecheap/              # Core SDK
+│   ├── client.py           # Main client — wires up API classes
+│   ├── models.py           # Pydantic models (all API data types live here)
+│   ├── errors.py           # Exceptions with helpful messages
+│   ├── logging.py          # Colored logging and error display
+│   └── _api/               # API implementations
+│       ├── base.py         # BaseAPI with _request() — all API calls go through here
+│       ├── domains.py      # namecheap.domains.* endpoints
+│       └── dns.py          # namecheap.domains.dns.* endpoints + builder
+├── namecheap_cli/          # CLI (click)
+│   ├── __main__.py         # All commands in one file
+│   └── completion.py       # Shell completions
+└── namecheap_dns_tui/      # TUI (textual)
+    └── __main__.py
+```
+
+### Key Patterns
+
+**SDK layer** (`src/namecheap/_api/`):
+- Every API class extends `BaseAPI` which provides `_request(command, params, model=, path=)`
+- `_request` handles auth params, XML parsing, error handling, and Pydantic deserialization
+- Pass `model=SomeModel` to auto-parse, or omit for raw dict access
+- Pass `path="DotSeparated.Path"` to navigate the XML response
+- Domain parsing uses `tldextract` to split into SLD/TLD — see any method in `dns.py`
+- Return Pydantic models, not dicts — see `Nameservers`, `DNSRecord`, `Domain`, etc.
+- Use `assert` for assumptions, `ValueError` for bad user input
+
+**Models** (`src/namecheap/models.py`):
+- `XMLModel` base handles XML attribute aliases (`@Name` → `name`) and boolean parsing
+- All new data types go here and get exported from `__init__.py`
+
+**CLI layer** (`src/namecheap_cli/__main__.py`):
+- Commands use `@pass_config` decorator for client initialization
+- Interactive operations use `rich.progress.Progress` with `SpinnerColumn` for loading
+- Destructive operations use `rich.prompt.Confirm.ask` with `--yes/-y` to skip
+- Table output via `rich.table.Table`, with `output_formatter()` for JSON/YAML alternatives
+- Error handling: catch `NamecheapError`, print with `[red]`, `sys.exit(1)`
+
+**DNS Builder** (`src/namecheap/_api/dns.py`):
+- Fluent interface: `builder.a(...).mx(...).txt(...)` returns `Self` for chaining
+- Default TTL is 1799 (displays as "Automatic" in Namecheap UI)
+
+### Adding a New API Endpoint
+
+1. Add Pydantic model in `models.py`, export from `__init__.py`
+2. Add method in the appropriate `_api/*.py` file using `self._request()`
+3. Add CLI command in `__main__.py` following existing patterns
+4. Update the API Coverage table in `README.md`
+
+Best reference: `dns.py:get_nameservers()` for SDK, `__main__.py:dns_nameservers()` for CLI.
+
+## PR Checklist
+
+- [ ] `uv run ruff check` passes
+- [ ] `uv run ruff format --check` passes
+- [ ] Examples work correctly
+- [ ] Documentation updated if needed
+
+## Links
+
+- [Namecheap API Documentation](https://www.namecheap.com/support/api/methods/)
+- [Pydantic Documentation](https://docs.pydantic.dev/)
+- [Click Documentation](https://click.palletsprojects.com/)
+- [Textual Documentation](https://textual.textualize.io/)
+- [Ruff Documentation](https://docs.astral.sh/ruff/)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: namecheap-python
-Version: 1.0.6
+Version: 1.2.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
@@ -42,6 +42,12 @@ Description-Content-Type: text/markdown
 
 # Namecheap Python SDK
 
+[![PyPI version](https://badge.fury.io/py/namecheap-python.svg)](https://pypi.org/project/namecheap-python/)
+[![Downloads](https://pepy.tech/badge/namecheap-python)](https://pepy.tech/project/namecheap-python)
+[![Downloads/month](https://pepy.tech/badge/namecheap-python/month)](https://pepy.tech/project/namecheap-python)
+[![Python](https://img.shields.io/pypi/pyversions/namecheap-python)](https://pypi.org/project/namecheap-python/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 A modern, friendly Python SDK for the Namecheap API with comprehensive CLI and TUI tools.
 
 ## 🚀 Features
@@ -206,6 +212,38 @@ Adding CNAME record to tdo.garden...
 ```
 
 
+Check account balance:
+
+```bash
+❯ namecheap-cli account balance
+          Account Balance
+┏━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━┓
+┃ Field               ┃    Amount ┃
+┡━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━┩
+│ Available Balance   │  0.00 USD │
+│ Account Balance     │  0.00 USD │
+│ Earned Amount       │  0.00 USD │
+│ Withdrawable        │  0.00 USD │
+│ Auto-Renew Required │ 20.16 USD │
+└─────────────────────┴───────────┘
+```
+
+Get detailed domain info:
+
+```bash
+❯ namecheap-cli domain info self.fm
+
+Domain Information: self.fm
+
+Status: Ok
+Owner: adriangalilea
+Created: 07/15/2023
+Expires: 07/15/2026
+Premium: No
+WHOIS Guard: ✓ Enabled
+DNS Provider: CUSTOM
+```
+
 You can also export DNS records:
 
 ```bash
@@ -302,6 +340,51 @@ 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 Info
+
+```python
+info = nc.domains.get_info("example.com")
+print(info.status)              # 'Ok'
+print(info.whoisguard_enabled)  # True
+print(info.dns_provider)        # 'CUSTOM'
+print(info.created)             # '07/15/2023'
+print(info.expires)             # '07/15/2026'
+```
+
+### Account Balance
+
+```python
+bal = nc.users.get_balances()
+print(f"{bal.available_balance} {bal.currency}")  # '4932.96 USD'
+print(bal.funds_required_for_auto_renew)          # Decimal('20.16')
+```
+
+### Email Forwarding
+
+```python
+rules = nc.dns.get_email_forwarding("example.com")
+for r in rules:
+    print(f"{r.mailbox} -> {r.forward_to}")
+```
+
 ### Domain Management
 
 ```python
@@ -375,22 +458,24 @@ 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 NS API** - Custom nameserver management
-- **Users API** - Account management and balance checking
-- **Whois API** - WHOIS information lookups
-- **Email Forwarding** - Email forwarding configuration
-
-See [pending.md](pending.md) for full details.
+## 📊 [API Coverage](https://www.namecheap.com/support/api/methods/)
+
+| 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.users.*` | ⚠️ Partial | `getBalances`, `getPricing` (needs debugging). Planned: `changePassword`, `update`, `create`, `login`, `resetPassword` |
+| `namecheap.domains.*` | 🚧 Planned | `getContacts`, `getTldList`, `reactivate` |
+| `namecheap.domains.dns.*` | 🚧 Planned | `setEmailForwarding` |
+| `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.domains.ns.*` | 🚧 Planned | Glue records — `create`, `delete`, `getInfo`, `update` |
+| `namecheap.domainprivacy.*` | 🚧 Planned | `enable`, `disable`, `renew`, `getList`, `changeemailaddress` |
 
 ## 🛠️ Development
 
-See [Development Guide](docs/dev/README.md) for detailed development instructions.
+See [CONTRIBUTING.md](CONTRIBUTING.md) for setup and development guidelines.
 
 ## 📝 License
 
@@ -399,3 +484,9 @@ 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
+
+- [@huntertur](https://github.com/huntertur) — Rich dependency fix
+- [@jeffmcadams](https://github.com/jeffmcadams) — Domain serialization round-trip
+- [@cosmin](https://github.com/cosmin) — Nameserver management

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

@@ -1,5 +1,11 @@
 # Namecheap Python SDK
 
+[![PyPI version](https://badge.fury.io/py/namecheap-python.svg)](https://pypi.org/project/namecheap-python/)
+[![Downloads](https://pepy.tech/badge/namecheap-python)](https://pepy.tech/project/namecheap-python)
+[![Downloads/month](https://pepy.tech/badge/namecheap-python/month)](https://pepy.tech/project/namecheap-python)
+[![Python](https://img.shields.io/pypi/pyversions/namecheap-python)](https://pypi.org/project/namecheap-python/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 A modern, friendly Python SDK for the Namecheap API with comprehensive CLI and TUI tools.
 
 ## 🚀 Features
@@ -164,6 +170,38 @@ Adding CNAME record to tdo.garden...
 ```
 
 
+Check account balance:
+
+```bash
+❯ namecheap-cli account balance
+          Account Balance
+┏━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━┓
+┃ Field               ┃    Amount ┃
+┡━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━┩
+│ Available Balance   │  0.00 USD │
+│ Account Balance     │  0.00 USD │
+│ Earned Amount       │  0.00 USD │
+│ Withdrawable        │  0.00 USD │
+│ Auto-Renew Required │ 20.16 USD │
+└─────────────────────┴───────────┘
+```
+
+Get detailed domain info:
+
+```bash
+❯ namecheap-cli domain info self.fm
+
+Domain Information: self.fm
+
+Status: Ok
+Owner: adriangalilea
+Created: 07/15/2023
+Expires: 07/15/2026
+Premium: No
+WHOIS Guard: ✓ Enabled
+DNS Provider: CUSTOM
+```
+
 You can also export DNS records:
 
 ```bash
@@ -260,6 +298,51 @@ 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 Info
+
+```python
+info = nc.domains.get_info("example.com")
+print(info.status)              # 'Ok'
+print(info.whoisguard_enabled)  # True
+print(info.dns_provider)        # 'CUSTOM'
+print(info.created)             # '07/15/2023'
+print(info.expires)             # '07/15/2026'
+```
+
+### Account Balance
+
+```python
+bal = nc.users.get_balances()
+print(f"{bal.available_balance} {bal.currency}")  # '4932.96 USD'
+print(bal.funds_required_for_auto_renew)          # Decimal('20.16')
+```
+
+### Email Forwarding
+
+```python
+rules = nc.dns.get_email_forwarding("example.com")
+for r in rules:
+    print(f"{r.mailbox} -> {r.forward_to}")
+```
+
 ### Domain Management
 
 ```python
@@ -333,22 +416,24 @@ 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 NS API** - Custom nameserver management
-- **Users API** - Account management and balance checking
-- **Whois API** - WHOIS information lookups
-- **Email Forwarding** - Email forwarding configuration
-
-See [pending.md](pending.md) for full details.
+## 📊 [API Coverage](https://www.namecheap.com/support/api/methods/)
+
+| 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.users.*` | ⚠️ Partial | `getBalances`, `getPricing` (needs debugging). Planned: `changePassword`, `update`, `create`, `login`, `resetPassword` |
+| `namecheap.domains.*` | 🚧 Planned | `getContacts`, `getTldList`, `reactivate` |
+| `namecheap.domains.dns.*` | 🚧 Planned | `setEmailForwarding` |
+| `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.domains.ns.*` | 🚧 Planned | Glue records — `create`, `delete`, `getInfo`, `update` |
+| `namecheap.domainprivacy.*` | 🚧 Planned | `enable`, `disable`, `renew`, `getList`, `changeemailaddress` |
 
 ## 🛠️ Development
 
-See [Development Guide](docs/dev/README.md) for detailed development instructions.
+See [CONTRIBUTING.md](CONTRIBUTING.md) for setup and development guidelines.
 
 ## 📝 License
 
@@ -357,3 +442,9 @@ 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
+
+- [@huntertur](https://github.com/huntertur) — Rich dependency fix
+- [@jeffmcadams](https://github.com/jeffmcadams) — Domain serialization round-trip
+- [@cosmin](https://github.com/cosmin) — Nameserver management

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

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

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

@@ -12,16 +12,29 @@ from __future__ import annotations
 
 from .client import Namecheap
 from .errors import ConfigurationError, NamecheapError, ValidationError
-from .models import Contact, DNSRecord, Domain, DomainCheck
+from .models import (
+    AccountBalance,
+    Contact,
+    DNSRecord,
+    Domain,
+    DomainCheck,
+    DomainInfo,
+    EmailForward,
+    Nameservers,
+)
 
-__version__ = "1.0.5"
+__version__ = "1.2.0"
 __all__ = [
+    "AccountBalance",
     "ConfigurationError",
     "Contact",
     "DNSRecord",
     "Domain",
     "DomainCheck",
+    "DomainInfo",
+    "EmailForward",
     "Namecheap",
     "NamecheapError",
+    "Nameservers",
     "ValidationError",
 ]

{namecheap_python-1.0.6 → namecheap_python-1.2.0}/src/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, EmailForward, Nameservers
 
 from .base import BaseAPI
 
@@ -381,3 +381,150 @@ 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)
+
+    def get_email_forwarding(self, domain: str) -> list[EmailForward]:
+        """
+        Get email forwarding rules for a domain.
+
+        Args:
+            domain: Domain name
+
+        Returns:
+            List of EmailForward rules
+
+        Examples:
+            >>> rules = nc.dns.get_email_forwarding("example.com")
+            >>> for r in rules:
+            ...     print(f"{r.mailbox} -> {r.forward_to}")
+        """
+        result: Any = self._request(
+            "namecheap.domains.dns.getEmailForwarding",
+            {"DomainName": domain},
+            path="DomainDNSGetEmailForwardingResult",
+        )
+
+        if not result:
+            return []
+
+        forwards = result.get("Forward", [])
+        if isinstance(forwards, dict):
+            forwards = [forwards]
+        assert isinstance(forwards, list), f"Unexpected Forward type: {type(forwards)}"
+
+        return [
+            EmailForward(mailbox=f.get("@mailbox", ""), forward_to=f.get("#text", ""))
+            for f in forwards
+        ]