agent-gandi-cli 0.1.0__tar.gz

agent_gandi_cli-0.1.0/.claude/settings.local.json

@@ -0,0 +1,32 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(agent-browser:*)",
+      "Bash(ls -lh /Users/kyle/Projects/lyhcode/gandi-cli/docs/*.md)",
+      "Bash(python3:*)",
+      "Bash(gandi:*)",
+      "Bash(agent-browser eval:*)",
+      "Bash(pip install:*)",
+      "Bash(export:*)",
+      "Bash(uvx:*)",
+      "Bash(python:*)",
+      "Bash(git push:*)",
+      "Bash(mkdir -p /Users/kyle/Projects/lyhcode/gandi-cli-go)",
+      "Read(//Users/kyle/Projects/lyhcode/**)",
+      "Bash(source:*)",
+      "Bash(go version:*)",
+      "Bash(brew install:*)",
+      "Bash(go mod:*)",
+      "Bash(curl:*)",
+      "Bash(go build:*)",
+      "Bash(./gandi:*)",
+      "Bash(gh repo:*)",
+      "Bash(op item:*)",
+      "WebSearch",
+      "WebFetch(domain:docs.gandi.net)",
+      "Bash(git:*)",
+      "Bash(pip show:*)",
+      "Bash(pip index:*)"
+    ]
+  }
+}

agent_gandi_cli-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+.env
+.pytest_cache/
+.coverage
+htmlcov/
+docs/

agent_gandi_cli-0.1.0/CLAUDE.md

@@ -0,0 +1,15 @@
+# Claude Code Project Instructions
+
+## Skills & API Reference
+Refer to `skills/` directory for Gandi API skills and development patterns:
+- `skills/gandi-cli-command-pattern.md` — How to add new CLI commands
+- `skills/gandi-api-*.md` — API endpoint reference with business rules
+- `skills/api-reference.md` — Complete Gandi API v5 endpoint index (208 endpoints)
+
+## Gandi Reference Documentation Sources
+- User docs: https://docs.gandi.net/en/
+- API docs: https://api.gandi.net/docs/
+
+## Important Rules
+- Never commit official documentation files downloaded from Gandi
+- Workflow: download official docs → update skills/summaries → remove originals

agent_gandi_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kyle Lin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agent_gandi_cli-0.1.0/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: agent-gandi-cli
+Version: 0.1.0
+Summary: CLI tool for Gandi.net API
+Project-URL: Homepage, https://github.com/lyhcode/gandi-cli
+Project-URL: Repository, https://github.com/lyhcode/gandi-cli
+Project-URL: Issues, https://github.com/lyhcode/gandi-cli/issues
+Author: Kyle Lin
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,dns,domain,gandi
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: Name Service (DNS)
+Classifier: Topic :: System :: Systems Administration
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: platformdirs>=3.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: rich>=13.0
+Requires-Dist: tomli-w>=1.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest-httpx>=0.30.0; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# gandi-cli
+
+CLI tool for [Gandi.net](https://www.gandi.net/) API.
+
+- Manage domains, DNS records, email, SSL certificates, and organizations
+- Multiple output formats: table, JSON, plain text
+- Sandbox mode for safe testing
+- Config file or environment variable authentication
+
+## Quick Start
+
+Run directly without installing:
+
+```bash
+uvx --from git+https://github.com/lyhcode/gandi-cli gandi --help
+```
+
+## Install
+
+```bash
+pip install agent-gandi-cli
+```
+
+## Authentication
+
+Set your [Gandi Personal Access Token (PAT)](https://admin.gandi.net/organizations/account/pat):
+
+```bash
+export GANDI_PAT=your-token-here
+```
+
+Or save it to config:
+
+```bash
+gandi auth login
+gandi auth status      # verify authentication
+gandi auth set-org     # set default organization
+gandi auth logout      # remove saved token
+```
+
+## Usage
+
+```bash
+# Domains
+gandi domain list
+gandi domain info example.com
+gandi domain check myname.com
+
+# DNS Records
+gandi dns list example.com
+gandi dns list example.com --type A --name www
+gandi dns get example.com www A
+gandi dns create example.com www A 1.2.3.4
+gandi dns update example.com www A --value 5.6.7.8
+gandi dns delete example.com www A
+gandi dns export example.com
+
+# Email Forwarding
+gandi email forward list example.com
+gandi email forward create example.com info user@gmail.com
+gandi email forward delete example.com info
+
+# Mailboxes
+gandi email mailbox list example.com
+gandi email mailbox info example.com <mailbox-id>
+
+# SSL Certificates
+gandi cert list
+gandi cert info <cert-id>
+
+# Organizations
+gandi org list
+gandi org info <org-id>
+gandi org whoami
+
+# Output formats
+gandi -o json domain list
+gandi -o plain domain list
+gandi -o table domain list   # default
+```
+
+## Sandbox
+
+Use `--sandbox` to test against the [Gandi Sandbox API](https://api.sandbox.gandi.net/docs/):
+
+```bash
+gandi --sandbox domain list
+```
+
+## Configuration
+
+Config file: `~/.config/gandi-cli/config.toml`
+
+```toml
+[auth]
+pat = "your-token"
+
+[defaults]
+output = "table"
+sharing_id = "your-org-id"
+```
+
+## Claude Code Skills
+
+The `skills/` directory contains [Claude Code](https://claude.com/claude-code) skill files for developing and extending this CLI. They include API endpoint references, command patterns, and business rules for each Gandi API area.
+
+## License
+
+MIT

agent_gandi_cli-0.1.0/README.md

@@ -0,0 +1,109 @@
+# gandi-cli
+
+CLI tool for [Gandi.net](https://www.gandi.net/) API.
+
+- Manage domains, DNS records, email, SSL certificates, and organizations
+- Multiple output formats: table, JSON, plain text
+- Sandbox mode for safe testing
+- Config file or environment variable authentication
+
+## Quick Start
+
+Run directly without installing:
+
+```bash
+uvx --from git+https://github.com/lyhcode/gandi-cli gandi --help
+```
+
+## Install
+
+```bash
+pip install agent-gandi-cli
+```
+
+## Authentication
+
+Set your [Gandi Personal Access Token (PAT)](https://admin.gandi.net/organizations/account/pat):
+
+```bash
+export GANDI_PAT=your-token-here
+```
+
+Or save it to config:
+
+```bash
+gandi auth login
+gandi auth status      # verify authentication
+gandi auth set-org     # set default organization
+gandi auth logout      # remove saved token
+```
+
+## Usage
+
+```bash
+# Domains
+gandi domain list
+gandi domain info example.com
+gandi domain check myname.com
+
+# DNS Records
+gandi dns list example.com
+gandi dns list example.com --type A --name www
+gandi dns get example.com www A
+gandi dns create example.com www A 1.2.3.4
+gandi dns update example.com www A --value 5.6.7.8
+gandi dns delete example.com www A
+gandi dns export example.com
+
+# Email Forwarding
+gandi email forward list example.com
+gandi email forward create example.com info user@gmail.com
+gandi email forward delete example.com info
+
+# Mailboxes
+gandi email mailbox list example.com
+gandi email mailbox info example.com <mailbox-id>
+
+# SSL Certificates
+gandi cert list
+gandi cert info <cert-id>
+
+# Organizations
+gandi org list
+gandi org info <org-id>
+gandi org whoami
+
+# Output formats
+gandi -o json domain list
+gandi -o plain domain list
+gandi -o table domain list   # default
+```
+
+## Sandbox
+
+Use `--sandbox` to test against the [Gandi Sandbox API](https://api.sandbox.gandi.net/docs/):
+
+```bash
+gandi --sandbox domain list
+```
+
+## Configuration
+
+Config file: `~/.config/gandi-cli/config.toml`
+
+```toml
+[auth]
+pat = "your-token"
+
+[defaults]
+output = "table"
+sharing_id = "your-org-id"
+```
+
+## Claude Code Skills
+
+The `skills/` directory contains [Claude Code](https://claude.com/claude-code) skill files for developing and extending this CLI. They include API endpoint references, command patterns, and business rules for each Gandi API area.
+
+## License
+
+MIT

agent_gandi_cli-0.1.0/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agent-gandi-cli"
+version = "0.1.0"
+description = "CLI tool for Gandi.net API"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+authors = [{ name = "Kyle Lin" }]
+keywords = ["gandi", "cli", "domain", "dns"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Internet :: Name Service (DNS)",
+    "Topic :: System :: Systems Administration",
+]
+dependencies = [
+    "typer>=0.9.0",
+    "rich>=13.0",
+    "httpx>=0.25.0",
+    "pydantic>=2.0",
+    "platformdirs>=3.0",
+    "tomli-w>=1.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/lyhcode/gandi-cli"
+Repository = "https://github.com/lyhcode/gandi-cli"
+Issues = "https://github.com/lyhcode/gandi-cli/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/gandi_cli"]
+
+[project.scripts]
+gandi = "gandi_cli.main:app"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-httpx>=0.30.0",
+    "pytest-cov>=4.0",
+]