namecheap-python 1.0.0__py3-none-any.whl → 1.0.2__py3-none-any.whl

namecheap/_api/base.py

@@ -56,7 +56,9 @@ def normalize_xml_response(data: dict[str, Any]) -> dict[str, Any]:
         # Fix known typos from Namecheap
         if key == "@YourAdditonalCost":  # Their typo (missing 'i' in Additional)
             normalized["@YourAdditionalCost"] = value  # Correct spelling
-            logger.debug("Fixed Namecheap typo: @YourAdditonalCost -> @YourAdditionalCost")
+            logger.debug(
+                "Fixed Namecheap typo: @YourAdditonalCost -> @YourAdditionalCost"
+            )
 
         # Debug canary: Alert if they have both versions (means they're fixing it)
         if "@YourAdditionalCost" in data and "@YourAdditonalCost" in data:
@@ -70,7 +72,8 @@ def normalize_xml_response(data: dict[str, Any]) -> dict[str, Any]:
             normalized[key] = normalize_xml_response(value)
         elif isinstance(value, list):
             normalized[key] = [
-                normalize_xml_response(item) if isinstance(item, dict) else item for item in value
+                normalize_xml_response(item) if isinstance(item, dict) else item
+                for item in value
             ]
 
     return normalized

namecheap/_api/dns.py

@@ -35,7 +35,9 @@ class DNSRecordBuilder:
             Self for chaining
         """
         self._records.append(
-            DNSRecord.model_validate({"@Name": name, "@Type": "A", "@Address": ip, "@TTL": ttl})
+            DNSRecord.model_validate(
+                {"@Name": name, "@Type": "A", "@Address": ip, "@TTL": ttl}
+            )
         )
         return self
 
@@ -94,7 +96,13 @@ class DNSRecordBuilder:
         """
         self._records.append(
             DNSRecord.model_validate(
-                {"@Name": name, "@Type": "MX", "@Address": server, "@TTL": ttl, "@MXPref": priority}
+                {
+                    "@Name": name,
+                    "@Type": "MX",
+                    "@Address": server,
+                    "@TTL": ttl,
+                    "@MXPref": priority,
+                }
             )
         )
         return self

namecheap/_api/domains.py

@@ -17,7 +17,9 @@ from .base import BaseAPI
 class DomainsAPI(BaseAPI):
     """Domain management operations."""
 
-    def check(self, *domains: str, include_pricing: bool = False) -> builtins.list[DomainCheck]:
+    def check(
+        self, *domains: str, include_pricing: bool = False
+    ) -> builtins.list[DomainCheck]:
         """
         Check domain availability.
 
@@ -158,7 +160,9 @@ class DomainsAPI(BaseAPI):
 
         # Add contact info if provided
         if contact:
-            contact_data = contact.model_dump() if isinstance(contact, Contact) else contact
+            contact_data = (
+                contact.model_dump() if isinstance(contact, Contact) else contact
+            )
             # Add contact fields for all types (Registrant, Tech, Admin, AuxBilling)
             for contact_type in ["Registrant", "Tech", "Admin", "AuxBilling"]:
                 for field, value in contact_data.items():
@@ -284,7 +288,9 @@ class DomainsAPI(BaseAPI):
         assert isinstance(result, dict)
         return bool(result)
 
-    def _get_pricing(self, domains: builtins.list[str]) -> dict[str, dict[str, Decimal | None]]:
+    def _get_pricing(
+        self, domains: builtins.list[str]
+    ) -> dict[str, dict[str, Decimal | None]]:
         """
         Get pricing information for domains.
 
@@ -362,7 +368,9 @@ class DomainsAPI(BaseAPI):
                             if not isinstance(products, list):
                                 products = [products] if products else []
 
-                            logger.debug(f"Found {len(products)} products in REGISTER category")
+                            logger.debug(
+                                f"Found {len(products)} products in REGISTER category"
+                            )
 
                             # Find the product matching our TLD
                             for product in products:
@@ -370,7 +378,9 @@ class DomainsAPI(BaseAPI):
                                     continue
 
                                 product_name = product.get("@Name", "")
-                                logger.debug(f"Checking product: {product_name} vs {tld}")
+                                logger.debug(
+                                    f"Checking product: {product_name} vs {tld}"
+                                )
 
                                 if product_name.lower() == tld.lower():
                                     # Get price list
@@ -378,7 +388,9 @@ class DomainsAPI(BaseAPI):
                                     if not isinstance(price_info, list):
                                         price_info = [price_info] if price_info else []
 
-                                    logger.debug(f"Found {len(price_info)} price entries for {tld}")
+                                    logger.debug(
+                                        f"Found {len(price_info)} price entries for {tld}"
+                                    )
 
                                     # Find 1 year price
                                     for price in price_info:
@@ -405,13 +417,17 @@ class DomainsAPI(BaseAPI):
                                             # Apply to all domains with this TLD
                                             for domain in domain_list:
                                                 pricing[domain] = {
-                                                    "regular_price": Decimal(regular_price)
+                                                    "regular_price": Decimal(
+                                                        regular_price
+                                                    )
                                                     if regular_price
                                                     else None,
                                                     "your_price": Decimal(your_price)
                                                     if your_price
                                                     else None,
-                                                    "retail_price": Decimal(retail_price)
+                                                    "retail_price": Decimal(
+                                                        retail_price
+                                                    )
                                                     if retail_price
                                                     else None,
                                                 }

namecheap/logging.py

@@ -74,13 +74,21 @@ class ErrorDisplay:
 
             if hasattr(error, "_ip_help") and error._ip_help is not None:
                 console.print("\n[yellow]🔍 IP Configuration Issue[/yellow]")
-                console.print(f"   Your current IP: [cyan]{error._ip_help['actual_ip']}[/cyan]")
-                console.print(f"   Configured IP:  [cyan]{error._ip_help['configured_ip']}[/cyan]")
+                console.print(
+                    f"   Your current IP: [cyan]{error._ip_help['actual_ip']}[/cyan]"
+                )
+                console.print(
+                    f"   Configured IP:  [cyan]{error._ip_help['configured_ip']}[/cyan]"
+                )
                 console.print("\n[yellow]💡 To fix this:[/yellow]")
-                console.print("   1. Log in to [link=https://www.namecheap.com]Namecheap[/link]")
+                console.print(
+                    "   1. Log in to [link=https://www.namecheap.com]Namecheap[/link]"
+                )
                 console.print("   2. Go to Profile → Tools → API Access")
                 actual_ip = error._ip_help["actual_ip"]
-                console.print(f"   3. Add this IP to whitelist: [cyan]{actual_ip}[/cyan]")
+                console.print(
+                    f"   3. Add this IP to whitelist: [cyan]{actual_ip}[/cyan]"
+                )
                 console.print(
                     f"   4. Update your .env file: [cyan]NAMECHEAP_CLIENT_IP={actual_ip}[/cyan]"
                 )

namecheap/models.py

@@ -89,7 +89,9 @@ class DomainCheck(XMLModel):
     """
 
     domain: str = Field(alias="@Domain", description="Domain name checked")
-    available: bool = Field(alias="@Available", description="Whether domain is available")
+    available: bool = Field(
+        alias="@Available", description="Whether domain is available"
+    )
     premium: bool = Field(
         default=False,
         alias="@IsPremiumName",
@@ -182,8 +184,8 @@ class DNSRecord(XMLModel):
     """A DNS record."""
 
     name: str = Field(alias="@Name", default="@")
-    type: Literal["A", "AAAA", "CNAME", "MX", "NS", "TXT", "URL", "URL301", "FRAME"] = Field(
-        alias="@Type"
+    type: Literal["A", "AAAA", "CNAME", "MX", "NS", "TXT", "URL", "URL301", "FRAME"] = (
+        Field(alias="@Type")
     )
     value: str = Field(alias="@Address")
     ttl: int = Field(alias="@TTL", default=1800)

namecheap_cli/__main__.py

@@ -23,8 +23,26 @@ from .completion import get_completion_script
 
 console = Console()
 
+
 # Configuration
-CONFIG_DIR = Path.home() / ".namecheap"
+def get_config_dir() -> Path:
+    """Get config directory, using XDG on Unix-like systems."""
+    import os
+    import sys
+
+    if sys.platform == "win32":
+        # Windows: use platformdirs for proper Windows paths
+        from platformdirs import user_config_dir
+
+        return Path(user_config_dir("namecheap"))
+    # Linux/macOS: use XDG
+    xdg_config = os.environ.get("XDG_CONFIG_HOME")
+    if xdg_config:
+        return Path(xdg_config) / "namecheap"
+    return Path.home() / ".config" / "namecheap"
+
+
+CONFIG_DIR = get_config_dir()
 CONFIG_FILE = CONFIG_DIR / "config.yaml"
 
 
@@ -54,9 +72,33 @@ class Config:
         if self.client:
             return self.client
 
+        # Check if config file exists
+        if not CONFIG_FILE.exists():
+            console.print("[red]❌ Configuration not found![/red]")
+            console.print(
+                "\nPlease run [bold cyan]namecheap-cli config init[/bold cyan] to set up your configuration."
+            )
+            console.print(
+                f"\nThis will create a config file at: [dim]{CONFIG_FILE}[/dim]"
+            )
+            sys.exit(1)
+
         config = self.load_config()
         profile_config = config.get("profiles", {}).get(self.profile, {})
 
+        # Check if profile exists
+        if not profile_config:
+            console.print(
+                f"[red]❌ Profile '{self.profile}' not found in configuration![/red]"
+            )
+            console.print(
+                f"\nAvailable profiles: {', '.join(config.get('profiles', {}).keys()) or 'none'}"
+            )
+            console.print(
+                "\nRun [bold cyan]namecheap-cli config init[/bold cyan] to create a new profile."
+            )
+            sys.exit(1)
+
         # Override sandbox if specified
         if self.sandbox is not None:
             profile_config["sandbox"] = self.sandbox
@@ -65,7 +107,21 @@ class Config:
             self.client = Namecheap(**profile_config)
             return self.client
         except Exception as e:
-            console.print(f"[red]❌ Error initializing client: {e}[/red]")
+            # Check for common configuration errors
+            error_msg = str(e)
+            if (
+                "Parameter APIUser is missing" in error_msg
+                or "Parameter APIKey is missing" in error_msg
+            ):
+                console.print("[red]❌ Invalid or incomplete configuration![/red]")
+                console.print(
+                    "\nYour configuration appears to be missing required fields."
+                )
+                console.print(
+                    "Please run [bold cyan]namecheap-cli config init[/bold cyan] to reconfigure."
+                )
+            else:
+                console.print(f"[red]❌ Error initializing client: {e}[/red]")
             sys.exit(1)
 
 
@@ -93,7 +149,9 @@ def output_formatter(data: Any, format: str, headers: list[str] | None = None) -
 
 
 @click.group()
-@click.option("--config", "config_path", type=click.Path(exists=True), help="Config file path")
+@click.option(
+    "--config", "config_path", type=click.Path(exists=True), help="Config file path"
+)
 @click.option("--profile", default="default", help="Config profile to use")
 @click.option("--sandbox", is_flag=True, help="Use sandbox API")
 @click.option(
@@ -108,7 +166,9 @@ def output_formatter(data: Any, format: str, headers: list[str] | None = None) -
 @click.option("--verbose", "-v", is_flag=True, help="Verbose output")
 @click.version_option()
 @pass_config
-def cli(config: Config, config_path, profile, sandbox, output, no_color, quiet, verbose) -> None:
+def cli(
+    config: Config, config_path, profile, sandbox, output, no_color, quiet, verbose
+) -> None:
     """Namecheap CLI - Manage domains and DNS records."""
     config.output_format = output
     config.no_color = no_color
@@ -129,10 +189,14 @@ def domain_group() -> None:
 
 @domain_group.command("list")
 @click.option("--status", type=click.Choice(["active", "expired", "locked"]))
-@click.option("--sort", type=click.Choice(["name", "expires", "created"]), default="name")
+@click.option(
+    "--sort", type=click.Choice(["name", "expires", "created"]), default="name"
+)
 @click.option("--expiring-in", type=int, help="Show domains expiring within N days")
 @pass_config
-def domain_list(config: Config, status: str | None, sort: str, expiring_in: int | None) -> None:
+def domain_list(
+    config: Config, status: str | None, sort: str, expiring_in: int | None
+) -> None:
     """List all domains."""
     nc = config.init_client()
 
@@ -213,9 +277,8 @@ def domain_list(config: Config, status: str | None, sort: str, expiring_in: int
 @domain_group.command("check")
 @click.argument("domains", nargs=-1, required=False)
 @click.option("--file", "-f", type=click.File("r"), help="File with domains to check")
-@click.option("--pricing", "-p", is_flag=True, help="Include pricing information")
 @pass_config
-def domain_check(config: Config, domains: tuple[str, ...], file, pricing: bool) -> None:
+def domain_check(config: Config, domains: tuple[str, ...], file) -> None:
     """Check domain availability."""
     nc = config.init_client()
 
@@ -235,39 +298,30 @@ def domain_check(config: Config, domains: tuple[str, ...], file, pricing: bool)
             transient=True,
         ) as progress:
             progress.add_task(f"Checking {len(domain_list)} domains...", total=None)
-            results = nc.domains.check(*domain_list, include_pricing=pricing)
+            results = nc.domains.check(*domain_list, include_pricing=True)
 
         # Output
         if config.output_format == "table":
             table = Table(title="Domain Availability")
             table.add_column("Domain", style="cyan")
             table.add_column("Available", style="green")
-            if pricing:
-                table.add_column("Price", style="yellow")
-                table.add_column("Total", style="yellow")
+            table.add_column("Price (USD/year)", style="yellow")
 
             for result in results:
                 available_text = "✅ Available" if result.available else "❌ Taken"
                 available_style = "green" if result.available else "red"
 
+                if result.available and result.price:
+                    price_text = f"${result.price:.2f}"
+                else:
+                    price_text = "-"
+
                 row = [
                     result.domain,
                     f"[{available_style}]{available_text}[/{available_style}]",
+                    price_text,
                 ]
 
-                if pricing and result.available:
-                    if result.price:
-                        price_text = f"${result.price:.2f}"
-                        total_text = (
-                            f"${result.total_price:.2f}" if result.total_price else price_text
-                        )
-                    else:
-                        price_text = "N/A"
-                        total_text = "N/A"
-                    row.extend([price_text, total_text])
-                elif pricing:
-                    row.extend(["-", "-"])
-
                 table.add_row(*row)
 
             console.print(table)
@@ -293,16 +347,11 @@ def domain_check(config: Config, domains: tuple[str, ...], file, pricing: bool)
                     "domain": result.domain,
                     "available": result.available,
                 }
-                if pricing and result.available and result.price:
+                if result.available and result.price:
                     item["price"] = float(result.price)
-                    item["total_price"] = (
-                        float(result.total_price) if result.total_price else float(result.price)
-                    )
                 data.append(item)
 
-            headers = ["domain", "available"]
-            if pricing:
-                headers.extend(["price", "total_price"])
+            headers = ["domain", "available", "price"]
             output_formatter(data, config.output_format, headers)
 
     except NamecheapError as e:
@@ -331,12 +380,18 @@ def domain_info(config: Config, domain: str) -> None:
                 f"[bold]Status:[/bold] "
                 f"{'Active' if not domain_obj.is_expired else '[red]Expired[/red]'}"
             )
-            console.print(f"[bold]Created:[/bold] {domain_obj.created.strftime('%Y-%m-%d')}")
-            console.print(f"[bold]Expires:[/bold] {domain_obj.expires.strftime('%Y-%m-%d')}")
+            console.print(
+                f"[bold]Created:[/bold] {domain_obj.created.strftime('%Y-%m-%d')}"
+            )
+            console.print(
+                f"[bold]Expires:[/bold] {domain_obj.expires.strftime('%Y-%m-%d')}"
+            )
             console.print(
                 f"[bold]Auto-Renew:[/bold] {'✓ Enabled' if domain_obj.auto_renew else '✗ Disabled'}"
             )
-            console.print(f"[bold]Locked:[/bold] {'🔒 Yes' if domain_obj.is_locked else '🔓 No'}")
+            console.print(
+                f"[bold]Locked:[/bold] {'🔒 Yes' if domain_obj.is_locked else '🔓 No'}"
+            )
             console.print(
                 f"[bold]WHOIS Guard:[/bold] "
                 f"{'✓ Enabled' if domain_obj.whois_guard else '✗ Disabled'}"
@@ -345,7 +400,9 @@ def domain_info(config: Config, domain: str) -> None:
             # Calculate days until expiration
             days_left = (domain_obj.expires - datetime.now()).days
             if days_left < 30:
-                console.print(f"\n⚠️  [yellow]Domain expires in {days_left} days![/yellow]")
+                console.print(
+                    f"\n⚠️  [yellow]Domain expires in {days_left} days![/yellow]"
+                )
             elif days_left < 60:
                 console.print(f"\n📅 Domain expires in {days_left} days")
 
@@ -478,7 +535,9 @@ def dns_add(
 
     try:
         # Create the new record
-        new_record = DNSRecord(name=name, type=record_type, value=value, ttl=ttl, priority=priority)
+        new_record = DNSRecord(
+            name=name, type=record_type, value=value, ttl=ttl, priority=priority
+        )
 
         # Get existing records
         if not config.quiet:
@@ -549,7 +608,9 @@ def dns_delete(
     nc = config.init_client()
 
     if all and not (type or name or value) and not yes:
-        console.print(f"[red]⚠️  Warning: This will delete ALL DNS records for {domain}[/red]")
+        console.print(
+            f"[red]⚠️  Warning: This will delete ALL DNS records for {domain}[/red]"
+        )
         if not Confirm.ask("Are you sure?", default=False):
             console.print("[yellow]Cancelled[/yellow]")
             return
@@ -586,7 +647,9 @@ def dns_delete(
 
             # Show what will be deleted
             if not yes and not config.quiet:
-                console.print(f"[yellow]Will delete {len(records_to_delete)} record(s):[/yellow]")
+                console.print(
+                    f"[yellow]Will delete {len(records_to_delete)} record(s):[/yellow]"
+                )
                 for r in records_to_delete:
                     console.print(f"  • {r.type} {r.name} → {r.value}")
 
@@ -641,7 +704,9 @@ def dns_delete(
     default="yaml",
     help="Export format",
 )
-@click.option("--output", "-o", type=click.File("w"), help="Output file (default: stdout)")
+@click.option(
+    "--output", "-o", type=click.File("w"), help="Output file (default: stdout)"
+)
 @pass_config
 def dns_export(config: Config, domain: str, format: str, output) -> None:
     """Export DNS records."""
@@ -656,7 +721,9 @@ def dns_export(config: Config, domain: str, format: str, output) -> None:
 
             for r in sorted(records, key=lambda x: (x.type, x.name)):
                 if r.type == "MX":
-                    lines.append(f"{r.name}\t{r.ttl}\tIN\t{r.type}\t{r.priority}\t{r.value}")
+                    lines.append(
+                        f"{r.name}\t{r.ttl}\tIN\t{r.type}\t{r.priority}\t{r.value}"
+                    )
                 else:
                     lines.append(f"{r.name}\t{r.ttl}\tIN\t{r.type}\t{r.value}")
 
@@ -698,7 +765,9 @@ def dns_export(config: Config, domain: str, format: str, output) -> None:
         if output:
             output.write(content)
             if not config.quiet:
-                console.print(f"[green]✅ Exported {len(records)} records to {output.name}[/green]")
+                console.print(
+                    f"[green]✅ Exported {len(records)} records to {output.name}[/green]"
+                )
         else:
             click.echo(content)
 
@@ -721,7 +790,9 @@ def account_balance(config: Config) -> None:
 
     try:
         # This would need to be implemented in the SDK
-        console.print("[yellow]Account balance check not yet implemented in SDK[/yellow]")
+        console.print(
+            "[yellow]Account balance check not yet implemented in SDK[/yellow]"
+        )
         console.print("This feature requires the users.getBalances API method")
 
     except NamecheapError as e:
@@ -748,6 +819,14 @@ def config_init() -> None:
 
     console.print("\n[bold cyan]Namecheap CLI Configuration Wizard[/bold cyan]\n")
 
+    console.print("[dim]To get your API key:[/dim]")
+    console.print(
+        "1. Go to [link=https://ap.www.namecheap.com/settings/tools/apiaccess/]https://ap.www.namecheap.com/settings/tools/apiaccess/[/link]"
+    )
+    console.print("2. Enable API access")
+    console.print("3. Whitelist your IP address")
+    console.print("4. Generate your API key\n")
+
     # Get configuration values
     api_key = Prompt.ask("API Key", password=True)
     username = Prompt.ask("Username")
@@ -783,7 +862,9 @@ def config_init() -> None:
 
     console.print(f"\n[green]✅ Configuration saved to {CONFIG_FILE}[/green]")
     console.print("\n💡 Tips:")
-    console.print("  • You can also use environment variables (NAMECHEAP_API_KEY, etc.)")
+    console.print(
+        "  • You can also use environment variables (NAMECHEAP_API_KEY, etc.)"
+    )
     console.print("  • Add more profiles with: nc config add-profile <name>")
     console.print("  • Use a profile with: nc --profile <name> <command>")
 
@@ -810,7 +891,9 @@ def completion(shell: str) -> None:
         console.print("[dim]nc completion zsh >> ~/.zshrc[/dim]")
     elif shell == "fish":
         console.print("[dim]# Add to fish config:[/dim]")
-        console.print("[dim]nc completion fish > ~/.config/fish/completions/nc.fish[/dim]")
+        console.print(
+            "[dim]nc completion fish > ~/.config/fish/completions/nc.fish[/dim]"
+        )
 
 
 def main() -> None:

namecheap_dns_tui/__main__.py

@@ -189,7 +189,9 @@ class AddRecordModal(ModalScreen):
             with ScrollableContainer(id="form-scroll"):
                 with Vertical(classes="field-group"):
                     yield Label("Record Type:")
-                    initial_type = self.editing_record.type if self.editing_record else "A"
+                    initial_type = (
+                        self.editing_record.type if self.editing_record else "A"
+                    )
                     yield Select(
                         [
                             ("A - IPv4 Address", "A"),
@@ -208,7 +210,9 @@ class AddRecordModal(ModalScreen):
 
                 with Vertical(classes="field-group"):
                     yield Label("Name:")
-                    initial_name = self.editing_record.name if self.editing_record else "@"
+                    initial_name = (
+                        self.editing_record.name if self.editing_record else "@"
+                    )
                     yield Input(
                         placeholder="@ for root or subdomain",
                         id="record-name",
@@ -217,7 +221,9 @@ class AddRecordModal(ModalScreen):
 
                 with Vertical(classes="field-group"):
                     yield Label("Value:")
-                    initial_value = self.editing_record.value if self.editing_record else ""
+                    initial_value = (
+                        self.editing_record.value if self.editing_record else ""
+                    )
                     yield Input(
                         placeholder="Enter value based on record type",
                         id="record-value",
@@ -226,7 +232,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"
+                    initial_ttl = (
+                        str(self.editing_record.ttl) if self.editing_record else "1800"
+                    )
                     yield Input(placeholder="1800", id="record-ttl", value=initial_ttl)
 
                 with Vertical(classes="field-group", id="priority-group"):
@@ -236,7 +244,9 @@ class AddRecordModal(ModalScreen):
                         if self.editing_record and self.editing_record.priority
                         else ""
                     )
-                    yield Input(placeholder="10", id="record-priority", value=initial_priority)
+                    yield Input(
+                        placeholder="10", id="record-priority", value=initial_priority
+                    )
 
             with Horizontal(classes="button-row"):
                 button_text = "Save Changes" if self.editing_record else "Add Record"
@@ -482,7 +492,9 @@ class DNSManagerApp(App):
                 str(record.priority) if record.priority else "-",
             )
 
-        self.update_status(f"Loaded {len(self.records)} records for {self.current_domain}")
+        self.update_status(
+            f"Loaded {len(self.records)} records for {self.current_domain}"
+        )
 
     def action_refresh(self) -> None:
         """Refresh records."""
@@ -623,7 +635,9 @@ class DNSManagerApp(App):
                                     )
                                     builder._records[
                                         -1
-                                    ].type = "URL"  # Override to use URL instead of URL301
+                                    ].type = (
+                                        "URL"  # Override to use URL instead of URL301
+                                    )
                                 elif rec.type == "URL301":
                                     builder.url(
                                         rec.name,
@@ -674,7 +688,9 @@ class DNSManagerApp(App):
             def handle_confirm(confirmed: bool) -> None:
                 """Handle delete confirmation."""
                 if confirmed:
-                    self.update_status(f"Deleting {record.type} record '{record.name}'...")
+                    self.update_status(
+                        f"Deleting {record.type} record '{record.name}'..."
+                    )
 
                     def delete() -> None:
                         try:
@@ -711,7 +727,9 @@ class DNSManagerApp(App):
                                     )
                                     builder._records[
                                         -1
-                                    ].type = "URL"  # Override to use URL instead of URL301
+                                    ].type = (
+                                        "URL"  # Override to use URL instead of URL301
+                                    )
                                 elif rec.type == "URL301":
                                     builder.url(
                                         rec.name,

{namecheap_python-1.0.0.dist-info → namecheap_python-1.0.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: namecheap-python
-Version: 1.0.0
+Version: 1.0.2
 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
@@ -26,21 +26,17 @@ Requires-Dist: tldextract>=5.0.0
 Requires-Dist: xmltodict>=0.13.0
 Provides-Extra: all
 Requires-Dist: click>=8.1.0; extra == 'all'
+Requires-Dist: platformdirs>=4.0.0; extra == 'all'
 Requires-Dist: pyyaml>=6.0.0; extra == 'all'
 Requires-Dist: rich>=13.0.0; extra == 'all'
 Requires-Dist: textual>=0.47.0; extra == 'all'
 Provides-Extra: cli
 Requires-Dist: click>=8.1.0; extra == 'cli'
+Requires-Dist: platformdirs>=4.0.0; extra == 'cli'
 Requires-Dist: pyyaml>=6.0.0; extra == 'cli'
 Requires-Dist: rich>=13.0.0; extra == 'cli'
 Provides-Extra: dev
-Requires-Dist: mypy>=1.11.0; extra == 'dev'
-Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
-Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
-Requires-Dist: pytest-httpx>=0.30.0; extra == 'dev'
-Requires-Dist: pytest>=8.0.0; extra == 'dev'
 Requires-Dist: ruff>=0.7.0; extra == 'dev'
-Requires-Dist: types-xmltodict>=0.13.0; extra == 'dev'
 Provides-Extra: tui
 Requires-Dist: textual>=0.47.0; extra == 'tui'
 Description-Content-Type: text/markdown
@@ -60,26 +56,17 @@ A modern, friendly Python SDK for the Namecheap API with comprehensive CLI and T
 - **Comprehensive logging** with beautiful colored output
 - **Sandbox support** for safe testing
 
-## 📦 Installation
-
-```bash
-# Core SDK only
-pip install namecheap-python
+## 🎯 Quick Start
 
-# With CLI tool
-pip install namecheap-python[cli]
+**Requires Python 3.12 or higher**
 
-# With TUI tool  
-pip install namecheap-python[tui]
+### `namecheap-python`: Core Python SDK Library
 
-# Everything
-pip install namecheap-python[all]
+```bash
+# Add as a dependency to your project
+uv add namecheap-python
 ```
 
-## 🎯 Quick Start
-
-### SDK Usage
-
 ```python
 from namecheap import Namecheap
 
@@ -107,18 +94,22 @@ nc.dns.set("example.com",
 )
 ```
 
-### CLI Usage
+### `namecheap-cli`: CLI tool
 
-```bash
-# Configure CLI
-uv run namecheap-cli config init
+It was meant as a proof of concept to showcase `namecheap-python`, but it is a tool that I use
 
+```bash
 # List domains with beautiful table output
-uv run namecheap-cli domain list
-```
 
-Output:
-```
+# Run it without install with:
+uvx --from 'namecheap-python[cli]' namecheap-cli domain list
+
+# Or install it permanently with:
+uv tool install --python 3.12 'namecheap-python[cli]'
+
+# Then run
+namecheap-cli domain list
+
                     Domains (4 total)
 ┏━━━━━━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━┓
 ┃ Domain            ┃ Status ┃ Expires    ┃ Auto-Renew ┃ Locked ┃
@@ -130,22 +121,42 @@ Output:
 └───────────────────┴────────┴────────────┴────────────┴────────┘
 ```
 
+Configure it before first use:
+
+```bash
+# Interactive setup
+namecheap-cli config init
+
+# Creates config file at:
+# - Linux/macOS: $XDG_CONFIG_HOME/namecheap/config.yaml (or ~/.config/namecheap/config.yaml)
+# - Windows: %APPDATA%\namecheap\config.yaml
+```
+Check domain availability and pricing:
+
 ```bash
 # Check domain availability
-uv run namecheap-cli domain check myawesome.com coolstartup.io
+❯ namecheap-cli domain check myawesome.com coolstartup.io
+                Domain Availability
+┏━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━┓
+┃ Domain         ┃ Available    ┃ Price (USD/year) ┃
+┡━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━┩
+│ myawesome.com  │ ❌ Taken     │ -                │
+│ coolstartup.io │ ✅ Available │ $34.98           │
+└────────────────┴──────────────┴──────────────────┘
+
+💡 Suggestions for taken domains:
+  • myawesome.com → myawesome.net, myawesome.io, getmyawesome.com
+```
+
+Manage DNS records:
 
-# Manage DNS records
-uv run namecheap-cli dns list example.com
-uv run namecheap-cli dns add example.com A www 192.0.2.1
-uv run namecheap-cli dns export example.com --format yaml
+In this example I'll set up GitHub Pages for my domain `tdo.garden`
 
-# Setup GitHub Pages (example: tdo.garden)
+```bash
 # First, check current DNS records (before setup)
-uv run namecheap-cli dns list tdo.garden
-```
+namecheap-cli dns list tdo.garden
 
-Initial state (Namecheap default parking page):
-```
+# Initial state (Namecheap default parking page):
                          DNS Records for tdo.garden (2 total)
 ┏━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┓
 ┃ Type     ┃ Name                 ┃ Value                      ┃ TTL      ┃ Priority ┃
@@ -153,40 +164,34 @@ Initial state (Namecheap default parking page):
 │ CNAME    │ www                  │ parkingpage.namecheap.com. │ 1800     │ 10       │
 │ URL      │ @                    │ http://www.tdo.garden/     │ 1800     │ 10       │
 └──────────┴──────────────────────┴────────────────────────────┴──────────┴──────────┘
-```
 
-```bash
 # Add GitHub Pages A records for apex domain
-❯ uv run namecheap-cli dns add tdo.garden A @ 185.199.108.153
-      Built namecheap-python @ file:///Users/adrian/Developer/namecheap-python
-Uninstalled 1 package in 0.77ms
-Installed 1 package in 1ms
+❯ namecheap-cli dns add tdo.garden A @ 185.199.108.153
 Adding A record to tdo.garden...
 ✅ Added A record successfully!
 
-❯ uv run namecheap-cli dns add tdo.garden A @ 185.199.109.153
+❯ namecheap-cli dns add tdo.garden A @ 185.199.109.153
 Adding A record to tdo.garden...
 ✅ Added A record successfully!
 
-❯ uv run namecheap-cli dns add tdo.garden A @ 185.199.110.153
+❯ namecheap-cli dns add tdo.garden A @ 185.199.110.153
 Adding A record to tdo.garden...
 ✅ Added A record successfully!
 
-❯ uv run namecheap-cli dns add tdo.garden A @ 185.199.111.153
+❯ namecheap-cli dns add tdo.garden A @ 185.199.111.153
 Adding A record to tdo.garden...
 ✅ Added A record successfully!
 
 # Add CNAME for www subdomain
-❯ uv run namecheap-cli dns add tdo.garden CNAME www adriangalilea.github.io
+❯ namecheap-cli dns add tdo.garden CNAME www adriangalilea.github.io
 Adding CNAME record to tdo.garden...
 ✅ Added CNAME record successfully!
 
 # Verify the setup
-❯ uv run namecheap-cli dns list tdo.garden
-```
+❯ namecheap-cli dns list tdo.garden
 
-Final state (with GitHub Pages + old records still present):
-```
+# Final state with GitHub Pages + old records still present that you may want to remove:
+```bash
                          DNS Records for tdo.garden (7 total)
 ┏━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┓
 ┃ Type     ┃ Name                 ┃ Value                      ┃ TTL      ┃ Priority ┃
@@ -201,18 +206,27 @@ Final state (with GitHub Pages + old records still present):
 └──────────┴──────────────────────┴────────────────────────────┴──────────┴──────────┘
 ```
 
-Note: You may want to remove the old parking page records after confirming GitHub Pages works.
-```
 
-### TUI Usage
+You can also export DNS records:
+
+```bash
+namecheap-cli dns export example.com --format yaml
+```
+### `namecheap-dns-tui`: TUI for DNS management
 
 ```bash
 # Launch interactive DNS manager
-uv run namecheap-dns-tui
+namecheap-dns-tui
 ```
 
 ![DNS Manager TUI](src/namecheap_dns_tui/assets/screenshot2.png)
 
+## Install both the CLI and TUI
+
+```bash
+uv tool install --python 3.12 'namecheap-python[all]'
+```
+
 ## 📖 Documentation
 
 - **[Examples Overview](examples/README.md)** - Quick examples for all tools
@@ -251,15 +265,6 @@ nc = Namecheap(
 )
 ```
 
-### CLI Configuration
-
-```bash
-# Interactive setup
-uv run namecheap-cli config init
-
-# Creates ~/.namecheap/config.yaml with profiles
-```
-
 ## 🔧 Advanced SDK Usage
 
 ### DNS Builder Pattern
@@ -376,4 +381,4 @@ 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.
+Contributions are welcome! Please feel free to submit a Pull Request. See the [Development Guide](docs/dev/README.md) for setup instructions and guidelines.

{namecheap_python-1.0.0.dist-info → namecheap_python-1.0.2.dist-info}/RECORD

@@ -1,25 +1,25 @@
 namecheap/__init__.py,sha256=4UD1BF-qTulQicElN3CmB5hUeKnlLPvtpbJD08YZp94,666
 namecheap/client.py,sha256=wnhCA5zeZMGypD1uNHbMYCGoP9paaZjtYZucBUsEY6k,6441
 namecheap/errors.py,sha256=5bGbV1e4_jkK8YXZXbLF6GJCVUTKw1CtMl9-mz7ogZg,5010
-namecheap/logging.py,sha256=craqZaxecjoxFL6SD6iyvj09VXx8QeivHHYWTeYhhbQ,3244
-namecheap/models.py,sha256=rOtPFeEwGaGwA7H0CCbjGSrzrF-wuiaqShV7f-LDgCY,11894
+namecheap/logging.py,sha256=lMR1fr1dWWz3z2NFEY-vl8b52FmmhH76R2NjyifSdYA,3396
+namecheap/models.py,sha256=IUNi103jcQ7T_WgfcqXuXsZokkjUDRNYkPwtr7KJ_qU,11910
 namecheap/_api/__init__.py,sha256=ymQxKCySphoeoo4s_J0tLziXttLNhOQ8AZbCzFcuAHs,36
-namecheap/_api/base.py,sha256=vC0d8csUGMIUEZ1SWLLqJpT3xlQ-2FfJMKs_aFbu4pY,6075
-namecheap/_api/dns.py,sha256=Yvx91QIWrDx3ZxxmH_NLo_M9MP55aL71CJ6mXyJZUT0,10813
-namecheap/_api/domains.py,sha256=EUXV7R5wQyPHQHfDITe2IWRlPF7V-df-K0q2XnrvshI,16113
+namecheap/_api/base.py,sha256=FoczO1Q860PaFUFv-S3IoIV2xaGVJAlchkWnmTI6dlw,6121
+namecheap/_api/dns.py,sha256=Eibn3NzR1o3p_ukxUFDeaKTrJYgBnIomMBKsp881ZrE,10962
+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=OyE_oKtBXxWzxF-yGJQy9IbQL5FJ-5rP5ElrKS4Yu8E,28733
+namecheap_cli/__main__.py,sha256=08iIreRm_30z-mmcvqd-qFEaoGWgOJJsCT7UPk7EZ-E,30768
 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=xGn07jj7krv_y-WaXWXUafK2R2P1oeFEwDw1L8NLiC4,29568
+namecheap_dns_tui/__main__.py,sha256=DSSNcLAjJvQYlrVtdfped9wwM28kdisbFEZ6oPfD8jA,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.0.dist-info/METADATA,sha256=wq_qAcQp7Tv5YuqypDFVpomVr1djHhfCc_FRBXR3RpM,13101
-namecheap_python-1.0.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-namecheap_python-1.0.0.dist-info/entry_points.txt,sha256=AyhiXroLUpM0Vdo_-RvH0S8o4XDPsDlsEl_65vm6DEk,96
-namecheap_python-1.0.0.dist-info/licenses/LICENSE,sha256=pemTblFP6BBje3bBv_yL_sr2iAqB2H0-LdWMvVIR42o,1062
-namecheap_python-1.0.0.dist-info/RECORD,,
+namecheap_python-1.0.2.dist-info/METADATA,sha256=h9P8gDpU73MAIShvep6h74ideSuHTdvodKjdJvNmvjQ,13831
+namecheap_python-1.0.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+namecheap_python-1.0.2.dist-info/entry_points.txt,sha256=AyhiXroLUpM0Vdo_-RvH0S8o4XDPsDlsEl_65vm6DEk,96
+namecheap_python-1.0.2.dist-info/licenses/LICENSE,sha256=pemTblFP6BBje3bBv_yL_sr2iAqB2H0-LdWMvVIR42o,1062
+namecheap_python-1.0.2.dist-info/RECORD,,