namecheap-python 0.1.5__tar.gz → 0.2.0__tar.gz

{namecheap_python-0.1.5 → namecheap_python-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: namecheap-python
-Version: 0.1.5
+Version: 0.2.0
 Summary: A Python SDK for the Namecheap API
 License: MIT
 Keywords: namecheap,domain,dns,api,sdk
@@ -130,19 +130,45 @@ client = NamecheapClient(
 client = NamecheapClient()  # Automatically loads credentials from environment
 ```
 
+### Client Structure
+
+The SDK provides two ways to interact with the Namecheap API:
+
+1. **Direct API mapping**: Access the API endpoints directly using the same structure as the Namecheap API documentation.
+   ```python
+   # Direct API mapping - matches the Namecheap API documentation
+   result = client.domains.check(["example.com", "example.net"])
+   ```
+
+2. **Enhanced functionality**: Access enhanced methods that combine multiple API calls and provide additional features.
+   ```python
+   # Enhanced functionality with improved data structure
+   result = client.enhanced.domains.check_with_pricing(["example.com", "example.net"])
+   ```
+
 ### Check Domain Availability
 
 ```python
 try:
-    # Check multiple domains at once (up to 50)
+    # Standard API - Check multiple domains at once (up to 50)
     domains_to_check = ["example.com", "example.net", "example.org"]
-    result = client.domains_check(domains_to_check)
+    result = client.domains.check(domains_to_check)
     
     # Process results
     for domain in result.get("DomainCheckResult", []):
         print(f"{domain['Domain']}: {'Available' if domain['Available'] else 'Not available'}")
         if domain['IsPremiumName']:
             print(f"  Premium Domain - Price: {domain['PremiumRegistrationPrice']}")
+            
+    # Enhanced API - Check with comprehensive pricing information
+    result = client.enhanced.domains.check_with_pricing(domains_to_check)
+    
+    for domain in result.get("DomainCheckResult", []):
+        if domain['Available']:
+            print(f"{domain['Domain']}: Available - Price: ${domain['Price']:.2f}")
+        else:
+            print(f"{domain['Domain']}: Not available")
+            
 except NamecheapException as e:
     print(f"API Error: {e}")
 ```
@@ -152,14 +178,12 @@ except NamecheapException as e:
 Running the check_domain.py example produces output like the following:
 
 ```
-Checking availability for: example.com, something123unique.com
-
 Results:
 ------------------------------------------------------------
 Domain                         Available    Premium    Price
 ------------------------------------------------------------
 example.com                    No           No         N/A
-something123unique.com         Yes          No         N/A
+something123unique.com         Yes          No         $11.28
 ```
 
 ### List Your Domains
@@ -301,20 +325,43 @@ Namecheap API has the following rate limits:
 
 The SDK currently supports the following Namecheap API endpoints:
 
-### Domains
-- `domains_check` - Check domain availability
-- `domains_get_list` - Get list of domains in your account
-- `domains_get_contacts` - Get contact information for a domain
-- `domains_create` - Register a new domain
-- `domains_renew` - Renew a domain
-- `domains_get_info` - Get detailed information about a domain
-- `domains_get_tld_list` - Get list of available TLDs
-
-### DNS
-- `domains_dns_set_custom` - Set custom nameservers for a domain
-- `domains_dns_set_default` - Set default nameservers for a domain
-- `domains_dns_get_hosts` - Get DNS host records for a domain
-- `domains_dns_set_hosts` - Set DNS host records for a domain
+### Standard API
+
+#### Domains
+- `domains.check` - Check domain availability
+- `domains.get_list` - Get list of domains in your account
+- `domains.get_contacts` - Get contact information for a domain
+- `domains.create` - Register a new domain
+- `domains.renew` - Renew a domain
+- `domains.get_info` - Get detailed information about a domain
+- `domains.get_tld_list` - Get list of available TLDs
+
+#### DNS
+- `domains.dns.set_custom` - Set custom nameservers for a domain
+- `domains.dns.set_default` - Set default nameservers for a domain
+- `domains.dns.get_hosts` - Get DNS host records for a domain
+- `domains.dns.set_hosts` - Set DNS host records for a domain
+
+#### Users
+- `users.get_pricing` - Get pricing information for Namecheap products
+- `users.get_balances` - Get account balances
+
+#### SSL
+- `ssl.activate` - Activate an SSL certificate
+- `ssl.get_list` - Get list of SSL certificates
+- `ssl.create` - Purchase an SSL certificate
+- `ssl.get_info` - Get information about an SSL certificate
+
+### Enhanced API
+
+The SDK also provides enhanced functionality that combines multiple API calls:
+
+#### Domains
+- `enhanced.domains.check_with_pricing` - Check domain availability with comprehensive pricing information
+- `enhanced.domains.search_available` - Search for available domains based on a keyword
+
+#### DNS
+- `enhanced.dns.update_records` - Update specific DNS records without affecting others
 
 Additional endpoints from the Namecheap API may be added in future releases based on user needs and contributions.
 
@@ -398,6 +445,16 @@ This project uses an automated release workflow for versioning and publishing to
    - `major`: for backwards incompatible changes (0.2.0 -> 1.0.0)
 6. Click "Run workflow" to start the process
 
+Alternatively, you can use the GitHub CLI to bump the version directly from your terminal:
+
+```bash
+# Using GitHub CLI directly
+gh workflow run "Bump Version and Release" -f release-type=patch|minor|major
+
+# Or using the provided utility script
+python utils/bump-version.py patch|minor|major
+```
+
 ### What Happens Automatically
 
 The workflow will:
@@ -415,7 +472,7 @@ This project is licensed under the MIT License - see the LICENSE file for detail
 
 ## Disclaimer
 
-All this code was produced in a single sitting vibe coding with `claude code` for 2 hours and ~$25.
+All this code was produced in a single vibe coding session with `claude code` for 2 hours and ~$30.
 
 Excuse the occasional AI slop, if you spot it let me know.
 

{namecheap_python-0.1.5 → namecheap_python-0.2.0}/README.md

@@ -101,19 +101,45 @@ client = NamecheapClient(
 client = NamecheapClient()  # Automatically loads credentials from environment
 ```
 
+### Client Structure
+
+The SDK provides two ways to interact with the Namecheap API:
+
+1. **Direct API mapping**: Access the API endpoints directly using the same structure as the Namecheap API documentation.
+   ```python
+   # Direct API mapping - matches the Namecheap API documentation
+   result = client.domains.check(["example.com", "example.net"])
+   ```
+
+2. **Enhanced functionality**: Access enhanced methods that combine multiple API calls and provide additional features.
+   ```python
+   # Enhanced functionality with improved data structure
+   result = client.enhanced.domains.check_with_pricing(["example.com", "example.net"])
+   ```
+
 ### Check Domain Availability
 
 ```python
 try:
-    # Check multiple domains at once (up to 50)
+    # Standard API - Check multiple domains at once (up to 50)
     domains_to_check = ["example.com", "example.net", "example.org"]
-    result = client.domains_check(domains_to_check)
+    result = client.domains.check(domains_to_check)
     
     # Process results
     for domain in result.get("DomainCheckResult", []):
         print(f"{domain['Domain']}: {'Available' if domain['Available'] else 'Not available'}")
         if domain['IsPremiumName']:
             print(f"  Premium Domain - Price: {domain['PremiumRegistrationPrice']}")
+            
+    # Enhanced API - Check with comprehensive pricing information
+    result = client.enhanced.domains.check_with_pricing(domains_to_check)
+    
+    for domain in result.get("DomainCheckResult", []):
+        if domain['Available']:
+            print(f"{domain['Domain']}: Available - Price: ${domain['Price']:.2f}")
+        else:
+            print(f"{domain['Domain']}: Not available")
+            
 except NamecheapException as e:
     print(f"API Error: {e}")
 ```
@@ -123,14 +149,12 @@ except NamecheapException as e:
 Running the check_domain.py example produces output like the following:
 
 ```
-Checking availability for: example.com, something123unique.com
-
 Results:
 ------------------------------------------------------------
 Domain                         Available    Premium    Price
 ------------------------------------------------------------
 example.com                    No           No         N/A
-something123unique.com         Yes          No         N/A
+something123unique.com         Yes          No         $11.28
 ```
 
 ### List Your Domains
@@ -272,20 +296,43 @@ Namecheap API has the following rate limits:
 
 The SDK currently supports the following Namecheap API endpoints:
 
-### Domains
-- `domains_check` - Check domain availability
-- `domains_get_list` - Get list of domains in your account
-- `domains_get_contacts` - Get contact information for a domain
-- `domains_create` - Register a new domain
-- `domains_renew` - Renew a domain
-- `domains_get_info` - Get detailed information about a domain
-- `domains_get_tld_list` - Get list of available TLDs
-
-### DNS
-- `domains_dns_set_custom` - Set custom nameservers for a domain
-- `domains_dns_set_default` - Set default nameservers for a domain
-- `domains_dns_get_hosts` - Get DNS host records for a domain
-- `domains_dns_set_hosts` - Set DNS host records for a domain
+### Standard API
+
+#### Domains
+- `domains.check` - Check domain availability
+- `domains.get_list` - Get list of domains in your account
+- `domains.get_contacts` - Get contact information for a domain
+- `domains.create` - Register a new domain
+- `domains.renew` - Renew a domain
+- `domains.get_info` - Get detailed information about a domain
+- `domains.get_tld_list` - Get list of available TLDs
+
+#### DNS
+- `domains.dns.set_custom` - Set custom nameservers for a domain
+- `domains.dns.set_default` - Set default nameservers for a domain
+- `domains.dns.get_hosts` - Get DNS host records for a domain
+- `domains.dns.set_hosts` - Set DNS host records for a domain
+
+#### Users
+- `users.get_pricing` - Get pricing information for Namecheap products
+- `users.get_balances` - Get account balances
+
+#### SSL
+- `ssl.activate` - Activate an SSL certificate
+- `ssl.get_list` - Get list of SSL certificates
+- `ssl.create` - Purchase an SSL certificate
+- `ssl.get_info` - Get information about an SSL certificate
+
+### Enhanced API
+
+The SDK also provides enhanced functionality that combines multiple API calls:
+
+#### Domains
+- `enhanced.domains.check_with_pricing` - Check domain availability with comprehensive pricing information
+- `enhanced.domains.search_available` - Search for available domains based on a keyword
+
+#### DNS
+- `enhanced.dns.update_records` - Update specific DNS records without affecting others
 
 Additional endpoints from the Namecheap API may be added in future releases based on user needs and contributions.
 
@@ -369,6 +416,16 @@ This project uses an automated release workflow for versioning and publishing to
    - `major`: for backwards incompatible changes (0.2.0 -> 1.0.0)
 6. Click "Run workflow" to start the process
 
+Alternatively, you can use the GitHub CLI to bump the version directly from your terminal:
+
+```bash
+# Using GitHub CLI directly
+gh workflow run "Bump Version and Release" -f release-type=patch|minor|major
+
+# Or using the provided utility script
+python utils/bump-version.py patch|minor|major
+```
+
 ### What Happens Automatically
 
 The workflow will:
@@ -386,6 +443,6 @@ This project is licensed under the MIT License - see the LICENSE file for detail
 
 ## Disclaimer
 
-All this code was produced in a single sitting vibe coding with `claude code` for 2 hours and ~$25.
+All this code was produced in a single vibe coding session with `claude code` for 2 hours and ~$30.
 
 Excuse the occasional AI slop, if you spot it let me know.

{namecheap_python-0.1.5 → namecheap_python-0.2.0}/namecheap/__init__.py

@@ -1,5 +1,5 @@
 """
-Namecheap Python API client
+Namecheap API Python client
 
 A Python wrapper for interacting with the Namecheap API.
 
@@ -36,17 +36,9 @@ from .utils import (
     test_api_connection,
 )
 
-try:
-    # Get version from package metadata (installed package)
-    from importlib.metadata import version
-
-    __version__ = version("namecheap-python")
-except ImportError:
-    # Default version if importlib.metadata is not available (Python < 3.8)
-    __version__ = "0.1.2"
-except Exception:
-    # If package is not installed or version can't be determined
-    __version__ = "0.1.2"
+__version__ = "0.2.0"
+__author__ = "Adrian Galilea"
+
 __all__ = [
     "NamecheapClient",
     "NamecheapException",

namecheap_python-0.2.0/namecheap/api/__init__.py

@@ -0,0 +1,10 @@
+"""
+API module for direct 1:1 mapping to Namecheap API endpoints
+"""
+
+# Import all API modules to make them available through the api namespace
+from .domains import DomainsAPI
+from .ssl import SslAPI
+from .users import UsersAPI
+
+__all__ = ["DomainsAPI", "UsersAPI", "SslAPI"]

namecheap_python-0.2.0/namecheap/api/domains/__init__.py

@@ -0,0 +1,30 @@
+"""
+Domains API namespace
+"""
+
+from typing import Any
+
+from .base import DomainsBaseAPI
+from .dns import DnsAPI
+from .ns import NsAPI
+from .transfer import TransferAPI
+
+
+class DomainsAPI(DomainsBaseAPI):
+    """
+    Domains API client providing access to all domains-related API endpoints
+
+    This includes:
+    - Basic domain operations (check, getList, etc.)
+    - DNS management operations through the dns namespace
+    - Nameserver operations through the ns namespace
+    - Transfer operations through the transfer namespace
+    """
+
+    def __init__(self, client: Any) -> None:
+        super().__init__(client)
+
+        # Initialize subnamespaces
+        self.dns = DnsAPI(client)
+        self.ns = NsAPI(client)
+        self.transfer = TransferAPI(client)