Release v1.0.0 - Complete rewrite with CLI and TUI tools

- Modern SDK with Pydantic models and type hints
- Comprehensive CLI tool (namecheap-cli)
- Interactive DNS TUI manager
- Smart DNS builder with fluent interface
- Auto-configuration from environment
- Helpful error messages
- Full documentation and examples

Author: adriangalilea

.env.example

@@ -10,5 +10,5 @@
 NAMECHEAP_API_USER=your_username  # Your Namecheap account username
 NAMECHEAP_API_KEY=your_api_key    # From API Access page
 NAMECHEAP_USERNAME=your_username  # Same as API_USER
-NAMECHEAP_CLIENT_IP=your_whitelisted_ip  # Your whitelisted IP
-NAMECHEAP_USE_SANDBOX=True  # Use sandbox for testing
+NAMECHEAP_CLIENT_IP=your_whitelisted_ip  # Your whitelisted IP (optional - will auto-detect)
+NAMECHEAP_SANDBOX=true  # Set to "false" for production API (default: true for safety)

.github/workflows/lint.yml

@@ -10,26 +10,24 @@ jobs:
   lint:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v3
-    - name: Set up Python
-      uses: actions/setup-python@v4
+    - uses: actions/checkout@v4
+    
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
       with:
-        python-version: '3.x'
+        enable-cache: true
+        
+    - name: Set up Python
+      run: uv python install 3.12
+    
     - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install poetry
-        poetry install
-    - name: Lint with Black
-      run: |
-        poetry run black --check .
-    - name: Lint with isort
-      run: |
-        pip install isort==6.0.1
-        isort --check .
+      run: uv sync --all-extras
+    
+    - name: Run ruff check
+      run: uv run ruff check
+    
+    - name: Run ruff format check
+      run: uv run ruff format --check
+    
     - name: Type check with mypy
-      run: |
-        poetry run mypy namecheap
-    - name: Lint with Ruff
-      run: |
-        poetry run ruff check .
+      run: uv run mypy src/namecheap

.github/workflows/publish.yml

@@ -17,15 +17,16 @@ jobs:
       id-token: write  # IMPORTANT: this permission is mandatory for trusted publishing
 
     steps:
-    - uses: actions/checkout@v3
-    - name: Set up Python
-      uses: actions/setup-python@v4
+    - uses: actions/checkout@v4
+    
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
       with:
-        python-version: '3.x'
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install build poetry
+        enable-cache: true
+        
+    - name: Set up Python
+      run: uv python install 3.12
+    
     - name: Set version from tag (if triggered by tag)
       if: startsWith(github.ref, 'refs/tags/')
       run: |
@@ -34,9 +35,11 @@ jobs:
         VERSION=${TAG_NAME#v}
         echo "Using version from tag: ${VERSION}"
         
-        # Set version in pyproject.toml (single source of truth)
-        poetry version ${VERSION}
+        # Update version in pyproject.toml
+        sed -i "s/^version = .*/version = \"${VERSION}\"/" pyproject.toml
+    
     - name: Build package
-      run: python -m build
+      run: uv build
+    
     - name: Publish package
       uses: pypa/gh-action-pypi-publish@release/v1

.github/workflows/release.yml

@@ -24,19 +24,17 @@ jobs:
       id-token: write  # Needed for PyPI trusted publishing
 
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
       with:
         fetch-depth: 0
 
-    - name: Set up Python
-      uses: actions/setup-python@v4
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
       with:
-        python-version: '3.x'
-    
-    - name: Install dependencies
-      run: |
-        python -m pip install --upgrade pip
-        pip install poetry build
+        enable-cache: true
+        
+    - name: Set up Python
+      run: uv python install 3.12
 
     - name: Configure Git
       run: |
@@ -46,11 +44,37 @@ jobs:
     - name: Bump version
       id: bump_version
       run: |
-        # Bump version using Poetry (single source of truth)
-        poetry version ${{ github.event.inputs.version_part }}
-        NEW_VERSION=$(poetry version -s)
+        # Get current version
+        CURRENT_VERSION=$(grep '^version = ' pyproject.toml | cut -d'"' -f2)
+        
+        # Calculate new version
+        IFS='.' read -ra VERSION_PARTS <<< "$CURRENT_VERSION"
+        MAJOR=${VERSION_PARTS[0]}
+        MINOR=${VERSION_PARTS[1]}
+        PATCH=${VERSION_PARTS[2]}
+        
+        case "${{ github.event.inputs.version_part }}" in
+          major)
+            MAJOR=$((MAJOR + 1))
+            MINOR=0
+            PATCH=0
+            ;;
+          minor)
+            MINOR=$((MINOR + 1))
+            PATCH=0
+            ;;
+          patch)
+            PATCH=$((PATCH + 1))
+            ;;
+        esac
+        
+        NEW_VERSION="${MAJOR}.${MINOR}.${PATCH}"
+        
+        # Update version in pyproject.toml
+        sed -i "s/^version = .*/version = \"${NEW_VERSION}\"/" pyproject.toml
+        
         echo "NEW_VERSION=${NEW_VERSION}" >> $GITHUB_ENV
-        echo "Bumped version to ${NEW_VERSION}"
+        echo "Bumped version from ${CURRENT_VERSION} to ${NEW_VERSION}"
     
     - name: Commit version changes
       run: |
@@ -64,7 +88,7 @@ jobs:
         git push origin "v${NEW_VERSION}"
     
     - name: Build package
-      run: python -m build
+      run: uv build
 
     - name: Create GitHub Release
       uses: actions/create-release@v1

.gitignore

@@ -126,4 +126,41 @@ poetry.lock
 
 # PyPI auth
 .pypirc
-.pypirc.template
+.pypirc.template# Created by https://www.toptal.com/developers/gitignore/api/ptyhon,macos
+# Edit at https://www.toptal.com/developers/gitignore?templates=ptyhon,macos
+
+### macOS ###
+# General
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+### macOS Patch ###
+# iCloud generated files
+*.icloud
+
+#!! ERROR: ptyhon is undefined. Use list command to see defined gitignore types !!#
+
+# End of https://www.toptal.com/developers/gitignore/api/ptyhon,macos

.pre-commit-config.yaml

@@ -1,23 +1,32 @@
 repos:
-- repo: https://github.com/pre-commit/pre-commit-hooks
-  rev: v4.5.0
-  hooks:
-  - id: check-yaml
-  - id: end-of-file-fixer
-  - id: trailing-whitespace
-  - id: check-toml
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+      - id: check-json
+      - id: check-toml
+      - id: check-merge-conflict
+      - id: debug-statements
 
-- repo: https://github.com/astral-sh/ruff-pre-commit
-  rev: v0.5.0
-  hooks:
-    - id: ruff
-      args: [--fix]
-    - id: ruff-format
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.7.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
 
-- repo: https://github.com/pre-commit/mirrors-mypy
-  rev: v1.9.0
-  hooks:
-  - id: mypy
-    files: ^namecheap/
-    additional_dependencies:
-      - types-requests
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.11.0
+    hooks:
+      - id: mypy
+        args: [--strict]
+        additional_dependencies:
+          - pydantic>=2.5.0
+          - httpx>=0.27.0
+          - types-xmltodict>=0.13.0
+          - python-dotenv>=1.0.0
+          - tldextract>=5.0.0
+        files: ^src/