conoha-dns-cli 0.1.0__tar.gz

conoha_dns_cli-0.1.0/PKG-INFO

@@ -0,0 +1,205 @@
+Metadata-Version: 2.4
+Name: conoha-dns-cli
+Version: 0.1.0
+Summary: A CLI tool to manage ConoHa DNS.
+Author-email: haturatu <taro@eyes4you.org>
+License-Expression: BSD-3-Clause
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: python-dotenv
+Requires-Dist: requests
+Requires-Dist: xxhash
+
+# ConoHa DNS CLI
+
+ConoHa DNSをコマンドラインから操作するためのツールです。
+
+デフォルトでは見やすいテーブル形式で一覧表示し、`--output csv` オプションを指定することでCSV形式で標準出力することもできます。
+
+```bash
+$ conoha-dns -h
+usage: main.py [-h]
+               (--auth | -l [DOMAIN] | -ad NAME EMAIL | -dd DOMAIN | -ar DOMAIN NAME TYPE DATA | -ur DOMAIN RECORD_ID | -dr DOMAIN RECORD_ID)
+               [-t TTL] [-o {csv}] [--new-name NEW_NAME] [--new-type NEW_TYPE]
+               [--new-data NEW_DATA] [--new-ttl NEW_TTL]
+
+ConoHa DNS API (v1) を操作するCLIツール
+
+options:
+  -h, --help            show this help message and exit
+  --auth                APIトークンを認証・取得する
+  -l [DOMAIN], --list [DOMAIN]
+                        ドメイン一覧または指定ドメインのレコード一覧表示
+  -ad NAME EMAIL, --add-domain NAME EMAIL
+                        ドメイン追加
+  -dd DOMAIN, --delete-domain DOMAIN
+                        ドメインを名前またはIDで削除
+  -ar DOMAIN NAME TYPE DATA, --add-record DOMAIN NAME TYPE DATA
+                        レコード追加
+  -ur DOMAIN RECORD_ID, --update-record DOMAIN RECORD_ID
+                        レコード更新
+  -dr DOMAIN RECORD_ID, --delete-record DOMAIN RECORD_ID
+                        レコード削除
+  -t TTL, --ttl TTL     レコード追加時のTTL(秒)。デフォルト: 300
+  -o {csv}, --output {csv}
+                        出力形式をCSVにします。'-l'での一覧表示時のみ有効です。
+  --new-name NEW_NAME   更新後のレコード名
+  --new-type NEW_TYPE   更新後のレコードタイプ
+  --new-data NEW_DATA   更新後のレコードデータ
+  --new-ttl NEW_TTL     更新後のTTL
+
+使用例:
+  # APIトークンを認証・取得
+  conoha-dns --auth
+
+  # ドメイン一覧表示
+  conoha-dns -l
+
+  # レコード一覧をCSV形式で標準出力
+  conoha-dns -l example.com --output csv > records.csv
+
+  # Aレコード追加 (サブドメインtestを補完してtest.example.comを追加)
+  conoha-dns -ar example.com @ A 192.0.2.1
+  conoha-dns -ar example.com test A 192.0.2.1
+
+  # レコード更新 (レコードIDを指定し、新しいIPアドレスを設定)
+  conoha-dns -ur example.com <record_id> --new-data 192.0.2.2
+
+  # レコード削除 (レコードIDは -l example.com で確認)
+  conoha-dns -dr example.com <record_id>
+```
+
+## インストール
+
+はじめに、ConoHaの認証情報を記述した`~/.conoha-env`ファイルをホームディレクトリに作成します。
+APIエンドポイントはConoHaのリージョンによって異なるため、適宜変更してください。
+[ConoHaコントロールパネル](https://cp.conoha.jp/VPS/API/) の「API情報」から確認できます。
+
+**~/.conoha-env**:
+```
+CONOHA_USER_ID="your_user_id"                             # API ユーザー: ユーザID
+CONOHA_PASSWORD="your_password"                           # API ユーザー: パスワード
+TENANT_ID="your_tenant_id"                                # テナント情報: テナントID
+CONOHA_AUTH_URL="https://identity.sample.conoha.io"       # エンドポイント: Identity Service URL
+CONOHA_DNS_API_URL="https://dns-service.sample.conoha.io" # エンドポイント: DNS Service URL
+```
+
+次に、Makefileを使ってビルドとインストールを実行します。
+
+```bash
+make install
+```
+
+これにより、`conoha-dns`コマンドがインストールされます。
+
+## 使い方
+
+このコマンドは、実行したい操作をフラグで指定します。一度に指定できる操作は1つだけです。
+ドメインを指定する引数 (DOMAIN) には、ドメイン名 (`example.com`) またはドメインID (`ba9b5b9d`など) の両方を使用できます。
+
+### 一般的なコマンド
+
+**ヘルプ表示**
+```bash
+conoha-dns -h
+```
+
+**認証**
+認証情報を使って新しいAPIトークンを取得し、`~/.conoha-env`ファイルに保存します。  
+なお、ConoHa APIトークンの有効期限は24時間です。  
+```bash
+conoha-dns --auth
+```
+
+### ドメイン・レコード管理
+
+**ドメイン一覧・レコード一覧**
+
+`-l` フラグを使用すると、一覧がテーブル形式で表示されます。
+
+```bash
+# ドメイン一覧
+conoha-dns -l
+
+# レコード一覧 (ドメイン名またはIDで指定)
+conoha-dns -l <ドメイン名/ID>
+```
+*実行例:*
+```bash
+$ conoha-dns -l
+  ID         Name
+  0e6f0695   soulminingrig.com.
+  4fb208de   eyes4you.org.
+  ...
+```
+
+**CSV形式での標準出力**
+
+`--output csv` オプションを追加すると、一覧をCSV形式で標準出力します。リダイレクト(`>`)を使えばファイルに保存できます。
+
+```bash
+# ドメイン一覧をCSVで標準出力
+conoha-dns -l --output csv
+
+# レコード一覧をCSVファイルとして保存
+conoha-dns -l <ドメイン名/ID> --output csv > records.csv
+```
+*実行例:*
+```bash
+$ conoha-dns -l example.com --output csv
+ID,Name,Type,Data,TTL
+5057adde,eye4u.org.,SOA,"a.conoha-dns.com. taro.eyes4you.org. 1757833524 3600 600 86400 3600",3600
+2eff1245,eye4u.org.,NS,a.conoha-dns.com.,3600
+...
+```
+
+**ドメイン追加**
+```bash
+conoha-dns -ad <ドメイン名> <メールアドレス>
+```
+
+**ドメイン削除**
+```bash
+conoha-dns -dd <ドメイン名/ID>
+```
+
+### レコード管理
+
+内部的に、ConoHa APIから取得したレコードIDは長いため、xxhashを用いて短いハッシュ値に変換して表示・利用しています。
+
+**レコード追加**
+```bash
+conoha-dns -ar <ドメイン名/ID> <レコード名> <種別> <値> [--ttl <秒数>]
+```
+
+**レコード更新**
+`record_id`（`conoha-dns -l <ドメイン名/ID>`で確認可能）と、少なくとも1つの`--new-*`オプションを指定する必要があります。
+```bash
+conoha-dns -ur <ドメイン名/ID> <record_id> [--new-name <名前>] [--new-type <種別>] [--new-data <値>] [--new-ttl <TTL>]
+```
+
+**レコード削除**
+```bash
+conoha-dns -dr <ドメイン名/ID> <record_id>
+```
+
+## 応用例：xargsを使った一括操作
+
+`xargs`と組み合わせることで、ファイルに記載されたドメインリストに対して一括で操作を実行できます。
+
+例えば、以下のようなドメインリストが書かれた`domain-list.txt`があるとします。
+
+**domain-list.txt**
+```
+example1.com
+example2.com
+example3.com
+```
+
+このファイル内の各ドメインに対して、一括でルートAレコードを追加するには、以下のコマンドを実行します。
+
+```bash
+cat domain-list.txt | xargs -I{} conoha-dns -ar {} @ A 192.0.2.1
+```
+
+これにより、`domain-list.txt`の各行が`{}`に代入され、ドメインごとにレコード追加コマンドが実行されます。

conoha_dns_cli-0.1.0/README.md

@@ -0,0 +1,193 @@
+# ConoHa DNS CLI
+
+ConoHa DNSをコマンドラインから操作するためのツールです。
+
+デフォルトでは見やすいテーブル形式で一覧表示し、`--output csv` オプションを指定することでCSV形式で標準出力することもできます。
+
+```bash
+$ conoha-dns -h
+usage: main.py [-h]
+               (--auth | -l [DOMAIN] | -ad NAME EMAIL | -dd DOMAIN | -ar DOMAIN NAME TYPE DATA | -ur DOMAIN RECORD_ID | -dr DOMAIN RECORD_ID)
+               [-t TTL] [-o {csv}] [--new-name NEW_NAME] [--new-type NEW_TYPE]
+               [--new-data NEW_DATA] [--new-ttl NEW_TTL]
+
+ConoHa DNS API (v1) を操作するCLIツール
+
+options:
+  -h, --help            show this help message and exit
+  --auth                APIトークンを認証・取得する
+  -l [DOMAIN], --list [DOMAIN]
+                        ドメイン一覧または指定ドメインのレコード一覧表示
+  -ad NAME EMAIL, --add-domain NAME EMAIL
+                        ドメイン追加
+  -dd DOMAIN, --delete-domain DOMAIN
+                        ドメインを名前またはIDで削除
+  -ar DOMAIN NAME TYPE DATA, --add-record DOMAIN NAME TYPE DATA
+                        レコード追加
+  -ur DOMAIN RECORD_ID, --update-record DOMAIN RECORD_ID
+                        レコード更新
+  -dr DOMAIN RECORD_ID, --delete-record DOMAIN RECORD_ID
+                        レコード削除
+  -t TTL, --ttl TTL     レコード追加時のTTL(秒)。デフォルト: 300
+  -o {csv}, --output {csv}
+                        出力形式をCSVにします。'-l'での一覧表示時のみ有効です。
+  --new-name NEW_NAME   更新後のレコード名
+  --new-type NEW_TYPE   更新後のレコードタイプ
+  --new-data NEW_DATA   更新後のレコードデータ
+  --new-ttl NEW_TTL     更新後のTTL
+
+使用例:
+  # APIトークンを認証・取得
+  conoha-dns --auth
+
+  # ドメイン一覧表示
+  conoha-dns -l
+
+  # レコード一覧をCSV形式で標準出力
+  conoha-dns -l example.com --output csv > records.csv
+
+  # Aレコード追加 (サブドメインtestを補完してtest.example.comを追加)
+  conoha-dns -ar example.com @ A 192.0.2.1
+  conoha-dns -ar example.com test A 192.0.2.1
+
+  # レコード更新 (レコードIDを指定し、新しいIPアドレスを設定)
+  conoha-dns -ur example.com <record_id> --new-data 192.0.2.2
+
+  # レコード削除 (レコードIDは -l example.com で確認)
+  conoha-dns -dr example.com <record_id>
+```
+
+## インストール
+
+はじめに、ConoHaの認証情報を記述した`~/.conoha-env`ファイルをホームディレクトリに作成します。
+APIエンドポイントはConoHaのリージョンによって異なるため、適宜変更してください。
+[ConoHaコントロールパネル](https://cp.conoha.jp/VPS/API/) の「API情報」から確認できます。
+
+**~/.conoha-env**:
+```
+CONOHA_USER_ID="your_user_id"                             # API ユーザー: ユーザID
+CONOHA_PASSWORD="your_password"                           # API ユーザー: パスワード
+TENANT_ID="your_tenant_id"                                # テナント情報: テナントID
+CONOHA_AUTH_URL="https://identity.sample.conoha.io"       # エンドポイント: Identity Service URL
+CONOHA_DNS_API_URL="https://dns-service.sample.conoha.io" # エンドポイント: DNS Service URL
+```
+
+次に、Makefileを使ってビルドとインストールを実行します。
+
+```bash
+make install
+```
+
+これにより、`conoha-dns`コマンドがインストールされます。
+
+## 使い方
+
+このコマンドは、実行したい操作をフラグで指定します。一度に指定できる操作は1つだけです。
+ドメインを指定する引数 (DOMAIN) には、ドメイン名 (`example.com`) またはドメインID (`ba9b5b9d`など) の両方を使用できます。
+
+### 一般的なコマンド
+
+**ヘルプ表示**
+```bash
+conoha-dns -h
+```
+
+**認証**
+認証情報を使って新しいAPIトークンを取得し、`~/.conoha-env`ファイルに保存します。  
+なお、ConoHa APIトークンの有効期限は24時間です。  
+```bash
+conoha-dns --auth
+```
+
+### ドメイン・レコード管理
+
+**ドメイン一覧・レコード一覧**
+
+`-l` フラグを使用すると、一覧がテーブル形式で表示されます。
+
+```bash
+# ドメイン一覧
+conoha-dns -l
+
+# レコード一覧 (ドメイン名またはIDで指定)
+conoha-dns -l <ドメイン名/ID>
+```
+*実行例:*
+```bash
+$ conoha-dns -l
+  ID         Name
+  0e6f0695   soulminingrig.com.
+  4fb208de   eyes4you.org.
+  ...
+```
+
+**CSV形式での標準出力**
+
+`--output csv` オプションを追加すると、一覧をCSV形式で標準出力します。リダイレクト(`>`)を使えばファイルに保存できます。
+
+```bash
+# ドメイン一覧をCSVで標準出力
+conoha-dns -l --output csv
+
+# レコード一覧をCSVファイルとして保存
+conoha-dns -l <ドメイン名/ID> --output csv > records.csv
+```
+*実行例:*
+```bash
+$ conoha-dns -l example.com --output csv
+ID,Name,Type,Data,TTL
+5057adde,eye4u.org.,SOA,"a.conoha-dns.com. taro.eyes4you.org. 1757833524 3600 600 86400 3600",3600
+2eff1245,eye4u.org.,NS,a.conoha-dns.com.,3600
+...
+```
+
+**ドメイン追加**
+```bash
+conoha-dns -ad <ドメイン名> <メールアドレス>
+```
+
+**ドメイン削除**
+```bash
+conoha-dns -dd <ドメイン名/ID>
+```
+
+### レコード管理
+
+内部的に、ConoHa APIから取得したレコードIDは長いため、xxhashを用いて短いハッシュ値に変換して表示・利用しています。
+
+**レコード追加**
+```bash
+conoha-dns -ar <ドメイン名/ID> <レコード名> <種別> <値> [--ttl <秒数>]
+```
+
+**レコード更新**
+`record_id`（`conoha-dns -l <ドメイン名/ID>`で確認可能）と、少なくとも1つの`--new-*`オプションを指定する必要があります。
+```bash
+conoha-dns -ur <ドメイン名/ID> <record_id> [--new-name <名前>] [--new-type <種別>] [--new-data <値>] [--new-ttl <TTL>]
+```
+
+**レコード削除**
+```bash
+conoha-dns -dr <ドメイン名/ID> <record_id>
+```
+
+## 応用例：xargsを使った一括操作
+
+`xargs`と組み合わせることで、ファイルに記載されたドメインリストに対して一括で操作を実行できます。
+
+例えば、以下のようなドメインリストが書かれた`domain-list.txt`があるとします。
+
+**domain-list.txt**
+```
+example1.com
+example2.com
+example3.com
+```
+
+このファイル内の各ドメインに対して、一括でルートAレコードを追加するには、以下のコマンドを実行します。
+
+```bash
+cat domain-list.txt | xargs -I{} conoha-dns -ar {} @ A 192.0.2.1
+```
+
+これにより、`domain-list.txt`の各行が`{}`に代入され、ドメインごとにレコード追加コマンドが実行されます。

conoha_dns_cli-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "conoha-dns-cli"
+version = "0.1.0"
+description = "A CLI tool to manage ConoHa DNS."
+readme = "README.md"
+requires-python = ">=3.8"
+authors = [
+  {name = "haturatu", email = "taro@eyes4you.org"},
+]
+license = "BSD-3-Clause"
+
+dependencies = [
+  "python-dotenv",
+  "requests",
+  "xxhash",
+]
+
+[project.scripts]
+conoha-dns = "conoha_dns_cli.main:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+packages = ["conoha_dns_cli"]

conoha_dns_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

conoha_dns_cli-0.1.0/src/conoha_dns_cli/client.py

@@ -0,0 +1,107 @@
+import os
+import requests
+import json
+from functools import lru_cache
+from .utils import handle_api_error
+
+class ConohaDNSClient:
+    def __init__(self, renew=False):
+        self.api_base_url = os.getenv("CONOHA_DNS_API_URL", "https://dns-service.c3j1.conoha.io")
+        self.token = self._get_api_token(renew)
+
+    def _get_api_token(self, renew=False):
+        if not renew:
+            token = os.getenv("CONOHA_TOKEN") or os.getenv("API_TOKEN")
+            if token:
+                return token
+
+        user_id = os.getenv("CONOHA_USER_ID")
+        password = os.getenv("CONOHA_PASSWORD")
+        project_id = os.getenv("TENANT_ID")
+
+        if not all([user_id, password, project_id]):
+            raise ValueError("APIトークンが見つからず、認証情報 (~/.conoha-envの CONOHA_USER_ID, CONOHA_PASSWORD, TENANT_ID) も不完全です。")
+
+        auth_base_url = os.getenv("CONOHA_AUTH_URL", "https://identity.c3j1.conoha.io")
+        auth_url = f"{auth_base_url.rstrip('/')}/v3/auth/tokens"
+
+        payload = {
+            "auth": {
+                "identity": {
+                    "methods": ["password"],
+                    "password": {
+                        "user": {"id": user_id, "password": password}
+                    }
+                },
+                "scope": {"project": {"id": project_id}}
+            }
+        }
+        headers = {"Accept": "application/json", "Content-Type": "application/json"}
+
+        print("認証して新しいAPIトークンを取得します...")
+        try:
+            response = requests.post(auth_url, headers=headers, json=payload)
+            new_token = response.headers.get("X-Subject-Token")
+
+            if response.status_code == 201 and new_token:
+                print("新しいAPIトークンを取得しました。")
+                try:
+                    env_path = os.path.expanduser("~/.conoha-env")
+                    lines = []
+                    if os.path.exists(env_path):
+                        with open(env_path, "r") as f:
+                            lines = f.readlines()
+                    
+                    with open(env_path, "w") as f:
+                        for line in lines:
+                            if not line.startswith("CONOHA_TOKEN="):
+                                f.write(line)
+                        f.write(f"CONOHA_TOKEN={new_token}\n")
+                    print(f"{env_path}ファイルにCONOHA_TOKENを更新しました。")
+
+                except IOError as e:
+                    print(f"警告: {env_path}ファイルへの書き込みに失敗しました。手動でトークンを保存してください。エラー: {e}")
+                os.environ['CONOHA_TOKEN'] = new_token
+                return new_token
+            else:
+                error_message = f"APIトークンの取得に失敗しました。ステータスコード: {response.status_code}"
+                try:
+                    error_details = response.json()
+                    error_message += f"\nレスポンス: {json.dumps(error_details, indent=2, ensure_ascii=False)}"
+                except json.JSONDecodeError:
+                    error_message += f"\nレスポンス: {response.text}"
+                raise ValueError(error_message)
+        except requests.exceptions.RequestException as e:
+            handle_api_error(e)
+            raise ValueError("APIトークン取得リクエスト中にエラーが発生しました。")
+
+    @lru_cache(maxsize=None)
+    def get_headers(self):
+        return {"Accept": "application/json", "X-Auth-Token": self.token}
+
+    def get(self, path):
+        url = f"{self.api_base_url}{path}"
+        response = requests.get(url, headers=self.get_headers())
+        response.raise_for_status()
+        return response.json()
+
+    def post(self, path, payload):
+        url = f"{self.api_base_url}{path}"
+        response = requests.post(url, headers=self.get_headers(), json=payload)
+        response.raise_for_status()
+        return response.json()
+
+    def delete(self, path):
+        url = f"{self.api_base_url}{path}"
+        response = requests.delete(url, headers=self.get_headers())
+        response.raise_for_status()
+        # DELETEはボディが空のことがある
+        if response.status_code == 204:
+            return None
+        return response.json()
+
+    def put(self, path, payload):
+        url = f"{self.api_base_url}{path}"
+        response = requests.put(url, headers=self.get_headers(), json=payload)
+        response.raise_for_status()
+        return response.json()

conoha_dns_cli-0.1.0/src/conoha_dns_cli/domain.py

@@ -0,0 +1,104 @@
+from functools import lru_cache
+from .client import ConohaDNSClient
+from .utils import normalize_domain, handle_api_error
+import requests
+import sys
+import csv
+
+from .id_converter import get_short_id
+
+def is_short_id(s: str) -> bool:
+    """短いID（8文字の16進数文字列）かどうかを判定する"""
+    if len(s) != 8:
+        return False
+    try:
+        int(s, 16)
+        return True
+    except ValueError:
+        return False
+
+class DomainManager:
+    def __init__(self, client: ConohaDNSClient):
+        self.client = client
+
+    @lru_cache(maxsize=1)
+    def _fetch_all_domains(self):
+        """全ドメインの情報をAPIから取得する（キャッシュ付き）"""
+        return self.client.get("/v1/domains").get("domains", [])
+
+    def get_domain_id(self, identifier: str) -> str:
+        """ドメイン名またはIDからドメインID(uuid)を検索して返す"""
+        domains = self._fetch_all_domains()
+
+        # 1. IDとして一致するものを探す
+        if is_short_id(identifier):
+            for domain in domains:
+                if get_short_id(domain['uuid']) == identifier:
+                    return domain['uuid']
+
+        # 2. ドメイン名として一致するものを探す
+        normalized_name = normalize_domain(identifier)
+        for domain in domains:
+            if domain['name'] == normalized_name:
+                return domain['uuid']
+
+        raise ValueError(f"ドメイン '{identifier}' が見つかりませんでした。")
+
+    def get_domain_name_from_id(self, domain_id: str) -> str:
+        """ドメインID(uuid)からドメイン名を検索して返す"""
+        domains = self._fetch_all_domains()
+        for domain in domains:
+            if domain['uuid'] == domain_id:
+                return domain['name']
+        raise ValueError(f"ドメインID '{domain_id}' が見つかりませんでした。")
+
+    def list_domains(self, output_format: str = None):
+        try:
+            domains = self._fetch_all_domains()
+
+            if output_format == 'csv':
+                print("ドメイン一覧をCSV形式で出力します...", file=sys.stderr)
+                if not domains:
+                    print("  (ドメインはありません)", file=sys.stderr)
+                    return
+                writer = csv.writer(sys.stdout)
+                writer.writerow(['ID', 'Name'])
+                for domain in domains:
+                    short_id = get_short_id(domain['uuid'])
+                    writer.writerow([short_id, domain['name']])
+            else:
+                if not domains:
+                    print("  (ドメインはありません)")
+                    return
+
+                header = f"  {'ID':<10} {'Name':<30}"
+                print(header)
+                for domain in domains:
+                    short_id = get_short_id(domain['uuid'])
+                    print(f"  {short_id:<10} {domain['name']:<30}")
+
+        except requests.exceptions.RequestException as e:
+            handle_api_error(e)
+        except IOError as e:
+            print(f"ファイル書き込みエラー: {e}", file=sys.stderr)
+
+    def add_domain(self, name: str, email: str):
+        normalized_name = normalize_domain(name)
+        print(f"ドメイン '{normalized_name}' を追加しています...")
+        payload = {"name": normalized_name, "email": email}
+        try:
+            domain = self.client.post("/v1/domains", payload)
+            print("ドメインが正常に追加されました。")
+            print(f"  ID: {domain['uuid']}, Name: {domain['name']}")
+        except requests.exceptions.RequestException as e:
+            handle_api_error(e)
+
+    def delete_domain(self, identifier: str):
+        try:
+            domain_id = self.get_domain_id(identifier)
+            domain_name = self.get_domain_name_from_id(domain_id)
+            print(f"ドメイン '{domain_name}' (ID: {domain_id}) を削除しています...")
+            self.client.delete(f"/v1/domains/{domain_id}")
+            print("ドメインが正常に削除されました。")
+        except (ValueError, requests.exceptions.RequestException) as e:
+            handle_api_error(e) if isinstance(e, requests.exceptions.RequestException) else print(f"エラー: {e}")

conoha_dns_cli-0.1.0/src/conoha_dns_cli/id_converter.py

@@ -0,0 +1,12 @@
+import xxhash
+
+def get_short_id(uuid: str) -> str:
+    """UUIDから短いハッシュIDを生成する"""
+    return xxhash.xxh64(uuid).hexdigest()[:8] # 8文字に短縮
+
+def find_full_uuid(items: list, short_id: str) -> str:
+    """アイテムのリストからshort_idに一致する完全なUUIDを見つける"""
+    for item in items:
+        if get_short_id(item['uuid']) == short_id:
+            return item['uuid']
+    raise ValueError(f"指定されたID '{short_id}' に一致するアイテムが見つかりませんでした。")

conoha_dns_cli-0.1.0/src/conoha_dns_cli/main.py

@@ -0,0 +1,118 @@
+import argparse
+import os
+import sys
+from dotenv import load_dotenv
+from .client import ConohaDNSClient
+from .domain import DomainManager
+from .record import RecordManager
+
+def main():
+    load_dotenv(dotenv_path=os.path.expanduser("~/.conoha-env"))
+    epilog_text = """
+使用例:
+  # APIトークンを認証・取得
+  conoha-dns --auth
+
+  # APIトークンを強制的に再認証・更新
+  conoha-dns --renew
+
+  # ドメイン一覧表示
+  conoha-dns -l
+
+  # レコード一覧をCSV形式で標準出力
+  conoha-dns -l example.com --output csv > records.csv
+
+  # Aレコード追加 (サブドメインtestを補完してtest.example.comを追加)
+  conoha-dns -ar example.com @ A 192.0.2.1
+  conoha-dns -ar example.com test A 192.0.2.1
+
+  # レコード更新 (レコードIDを指定し、新しいIPアドレスを設定)
+  conoha-dns -ur example.com <record_id> --new-data 192.0.2.2
+
+  # レコード削除 (レコードIDは -l example.com で確認)
+  conoha-dns -dr example.com <record_id>
+"""
+    parser = argparse.ArgumentParser(
+        description="ConoHa DNS API (v1) を操作するCLIツール",
+        epilog=epilog_text,
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    group = parser.add_mutually_exclusive_group(required=True)
+
+    # Actions
+    group.add_argument("--auth", action="store_true", help="APIトークンを認証・取得する")
+    group.add_argument("--renew", action="store_true", help="APIトークンを強制的に再認証・更新する")
+    group.add_argument("-l", "--list", nargs='?', const=True, default=None, metavar="DOMAIN", help="ドメイン一覧または指定ドメインのレコード一覧表示")
+    group.add_argument("-ad", "--add-domain", nargs=2, metavar=("NAME", "EMAIL"), help="ドメイン追加")
+    group.add_argument("-dd", "--delete-domain", metavar="DOMAIN", help="ドメインを名前またはIDで削除")
+    group.add_argument("-ar", "--add-record", nargs=4, metavar=("DOMAIN", "NAME", "TYPE", "DATA"), help="レコード追加")
+    group.add_argument("-ur", "--update-record", nargs=2, metavar=("DOMAIN", "RECORD_ID"), help="レコード更新")
+    group.add_argument("-dr", "--delete-record", nargs=2, metavar=("DOMAIN", "RECORD_ID"), help="レコード削除")
+    
+    # General options
+    parser.add_argument("-t", "--ttl", type=int, default=300, help="レコード追加時のTTL(秒)。デフォルト: 300")
+    parser.add_argument("-o", "--output", choices=['csv'], help="出力形式をCSVにします。'-l'での一覧表示時のみ有効です。")
+
+    # Options for --update-record
+    parser.add_argument("--new-name", help="更新後のレコード名")
+    parser.add_argument("--new-type", help="更新後のレコードタイプ")
+    parser.add_argument("--new-data", help="更新後のレコードデータ")
+    parser.add_argument("--new-ttl", type=int, help="更新後のTTL")
+
+    args = parser.parse_args()
+
+    try:
+        if args.renew:
+            client = ConohaDNSClient(renew=True)
+            if client.token:
+                print("APIトークンが正常に更新されました。")
+            return
+
+        if args.auth:
+            client = ConohaDNSClient()
+            if client.token:
+                print("認証に成功し、APIトークンが利用可能です。")
+            return
+
+        client = ConohaDNSClient()
+        domain_manager = DomainManager(client)
+        record_manager = RecordManager(client, domain_manager)
+
+        if args.list is not None:
+            output_format = args.output
+            if output_format and output_format != 'csv':
+                 parser.error("現在サポートしている出力形式は'csv'のみです。")
+
+            if args.list is True:
+                domain_manager.list_domains(output_format=output_format)
+            else:
+                record_manager.list_records(args.list, output_format=output_format)
+        elif args.add_domain:
+            domain_manager.add_domain(args.add_domain[0], args.add_domain[1])
+        elif args.delete_domain:
+            domain_manager.delete_domain(args.delete_domain)
+        elif args.add_record:
+            record_manager.add_record(args.add_record[0], args.add_record[1], args.add_record[2], args.add_record[3], args.ttl)
+        elif args.update_record:
+            if not any([args.new_name, args.new_type, args.new_data, args.new_ttl is not None]):
+                parser.error("--update-recordには、--new-name, --new-type, --new-data, --new-ttl のいずれか1つ以上の指定が必要です。")
+            record_manager.update_record(
+                args.update_record[0],
+                args.update_record[1],
+                new_name=args.new_name,
+                new_type=args.new_type,
+                new_data=args.new_data,
+                new_ttl=args.new_ttl
+            )
+        elif args.delete_record:
+            record_manager.delete_record(args.delete_record[0], args.delete_record[1])
+            
+    except ValueError as e:
+        print(f"エラー: {e}", file=sys.stderr)
+        sys.exit(3)
+    except Exception as e:
+        print(f"予期せぬエラーが発生しました: {e}", file=sys.stderr)
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()

conoha_dns_cli-0.1.0/src/conoha_dns_cli/record.py

@@ -0,0 +1,118 @@
+from .client import ConohaDNSClient
+from .domain import DomainManager
+from .utils import normalize_record_name, handle_api_error
+from .id_converter import get_short_id, find_full_uuid
+import requests
+import sys
+import csv
+
+class RecordManager:
+    def __init__(self, client: ConohaDNSClient, domain_manager: DomainManager):
+        self.client = client
+        self.domain_manager = domain_manager
+
+    def _get_all_records(self, domain_id: str) -> list:
+        return self.client.get(f"/v1/domains/{domain_id}/records").get("records", [])
+
+    def list_records(self, identifier: str, output_format: str = None):
+        try:
+            domain_id = self.domain_manager.get_domain_id(identifier)
+            domain_name = self.domain_manager.get_domain_name_from_id(domain_id).rstrip('.')
+            records = self._get_all_records(domain_id)
+
+            if output_format == 'csv':
+                if not records:
+                    print("  (レコードはありません)", file=sys.stderr)
+                    return
+                writer = csv.writer(sys.stdout)
+                writer.writerow(['ID', 'Name', 'Type', 'Data', 'TTL'])
+                for record in records:
+                    short_id = get_short_id(record['uuid'])
+                    writer.writerow([short_id, record['name'], record['type'], record['data'], record['ttl']])
+            else:
+                if not records:
+                    print("  (レコードはありません)")
+                    return
+
+                # カラムの最大幅を計算 (データは省略しない)
+                max_name = max(len(r['name']) for r in records) if records else 4
+                max_type = max(len(r['type']) for r in records) if records else 4
+                max_data = max(len(str(r['data'])) for r in records) if records else 4
+
+                header = f"  {'ID':<10} {'Name':<{max_name}}   {'Type':<{max_type}}   {'TTL':<6}   {'Data'}"
+                print(header)
+
+                for record in records:
+                    short_id = get_short_id(record['uuid'])
+                    print(f"  {short_id:<10} {record['name']:<{max_name}}   {record['type']:<{max_type}}   {str(record['ttl']):<6}   {record['data']}")
+
+        except (ValueError, requests.exceptions.RequestException) as e:
+            handle_api_error(e) if isinstance(e, requests.exceptions.RequestException) else print(f"エラー: {e}", file=sys.stderr)
+        except IOError as e:
+            print(f"ファイル書き込みエラー: {e}", file=sys.stderr)
+
+    def add_record(self, identifier: str, name: str, type: str, data: str, ttl: int):
+        try:
+            domain_id = self.domain_manager.get_domain_id(identifier)
+            domain_name = self.domain_manager.get_domain_name_from_id(domain_id)
+            normalized_name = normalize_record_name(domain_name, name)
+            
+            print(f"ドメイン '{domain_name}' にレコード '{normalized_name}' を追加しています...")
+            payload = {"name": normalized_name, "type": type, "data": data, "ttl": ttl}
+            record = self.client.post(f"/v1/domains/{domain_id}/records", payload)
+            short_id = get_short_id(record['uuid'])
+            print("レコードが正常に追加されました。")
+            print(f"  ID: {short_id}, Name: {record['name']}, Type: {record['type']}, Data: {record['data']}")
+        except (ValueError, requests.exceptions.RequestException) as e:
+            handle_api_error(e) if isinstance(e, requests.exceptions.RequestException) else print(f"エラー: {e}")
+
+    def delete_record(self, identifier: str, short_record_id: str):
+        try:
+            domain_id = self.domain_manager.get_domain_id(identifier)
+            domain_name = self.domain_manager.get_domain_name_from_id(domain_id)
+            all_records = self._get_all_records(domain_id)
+            full_record_id = find_full_uuid(all_records, short_record_id)
+            
+            print(f"ドメイン '{domain_name}' からレコードID '{short_record_id}' (UUID: {full_record_id}) を削除しています...")
+            self.client.delete(f"/v1/domains/{domain_id}/records/{full_record_id}")
+            print("レコードが正常に削除されました。")
+        except (ValueError, requests.exceptions.RequestException) as e:
+            handle_api_error(e) if isinstance(e, requests.exceptions.RequestException) else print(f"エラー: {e}")
+
+    def get_record(self, domain_id: str, record_id: str):
+        return self.client.get(f"/v1/domains/{domain_id}/records/{record_id}")
+
+    def update_record(self, identifier: str, short_record_id: str, new_name: str = None, new_type: str = None, new_data: str = None, new_ttl: int = None):
+        try:
+            domain_id = self.domain_manager.get_domain_id(identifier)
+            domain_name = self.domain_manager.get_domain_name_from_id(domain_id)
+            all_records = self._get_all_records(domain_id)
+            full_record_id = find_full_uuid(all_records, short_record_id)
+            
+            print(f"レコードID '{short_record_id}' (UUID: {full_record_id}) の現在の情報を取得しています...")
+            current_record = self.get_record(domain_id, full_record_id)
+            
+            name_to_update = new_name if new_name is not None else current_record['name']
+            normalized_name = normalize_record_name(domain_name, name_to_update)
+
+            payload = {
+                "name": normalized_name,
+                "type": new_type if new_type is not None else current_record['type'],
+                "data": new_data if new_data is not None else current_record['data'],
+                "ttl": new_ttl if new_ttl is not None else current_record.get('ttl'),
+                "description": current_record.get('description'),
+                "priority": current_record.get('priority')
+            }
+            
+            if payload['ttl'] is None:
+                del payload['ttl']
+
+            print(f"レコードID '{short_record_id}' を更新しています...")
+            updated_record = self.client.put(f"/v1/domains/{domain_id}/records/{full_record_id}", payload)
+            
+            short_id = get_short_id(updated_record['uuid'])
+            print("レコードが正常に更新されました。")
+            print(f"  ID: {short_id}, Name: {updated_record['name']}, Type: {updated_record['type']}, Data: {updated_record['data']}, TTL: {updated_record.get('ttl')}")
+
+        except (ValueError, requests.exceptions.RequestException) as e:
+            handle_api_error(e) if isinstance(e, requests.exceptions.RequestException) else print(f"エラー: {e}")

conoha_dns_cli-0.1.0/src/conoha_dns_cli/utils.py

@@ -0,0 +1,36 @@
+import json
+import sys
+import requests
+
+def normalize_domain(domain_name: str) -> str:
+    """ドメイン名の末尾にドットを追加する"""
+    if not domain_name.endswith('.'):
+        return domain_name + '.'
+    return domain_name
+
+def normalize_record_name(domain_name: str, record_name: str) -> str:
+    """レコード名を正規化する"""
+    if record_name == '@':
+        return normalize_domain(domain_name)
+
+    clean_domain_name = domain_name.rstrip('.')
+    if not record_name.endswith(clean_domain_name):
+        record_name = f"{record_name}.{clean_domain_name}"
+
+    return normalize_domain(record_name)
+
+def handle_api_error(e):
+    """APIエラーを処理し、情報を出力する"""
+    print(f"エラー: 要求に失敗しました。", file=sys.stderr)
+    if isinstance(e, requests.exceptions.RequestException):
+        if hasattr(e, 'response') and e.response is not None:
+            print(f"ステータスコード: {e.response.status_code}", file=sys.stderr)
+            try:
+                print(f"レスポンス: {json.dumps(e.response.json(), indent=2, ensure_ascii=False)}", file=sys.stderr)
+            except json.JSONDecodeError:
+                print(f"レスポンス: {e.response.text}", file=sys.stderr)
+        else:
+            print(e, file=sys.stderr)
+    else:
+        print(e, file=sys.stderr)
+    sys.exit(4)

conoha_dns_cli-0.1.0/src/conoha_dns_cli.egg-info/PKG-INFO

@@ -0,0 +1,205 @@
+Metadata-Version: 2.4
+Name: conoha-dns-cli
+Version: 0.1.0
+Summary: A CLI tool to manage ConoHa DNS.
+Author-email: haturatu <taro@eyes4you.org>
+License-Expression: BSD-3-Clause
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: python-dotenv
+Requires-Dist: requests
+Requires-Dist: xxhash
+
+# ConoHa DNS CLI
+
+ConoHa DNSをコマンドラインから操作するためのツールです。
+
+デフォルトでは見やすいテーブル形式で一覧表示し、`--output csv` オプションを指定することでCSV形式で標準出力することもできます。
+
+```bash
+$ conoha-dns -h
+usage: main.py [-h]
+               (--auth | -l [DOMAIN] | -ad NAME EMAIL | -dd DOMAIN | -ar DOMAIN NAME TYPE DATA | -ur DOMAIN RECORD_ID | -dr DOMAIN RECORD_ID)
+               [-t TTL] [-o {csv}] [--new-name NEW_NAME] [--new-type NEW_TYPE]
+               [--new-data NEW_DATA] [--new-ttl NEW_TTL]
+
+ConoHa DNS API (v1) を操作するCLIツール
+
+options:
+  -h, --help            show this help message and exit
+  --auth                APIトークンを認証・取得する
+  -l [DOMAIN], --list [DOMAIN]
+                        ドメイン一覧または指定ドメインのレコード一覧表示
+  -ad NAME EMAIL, --add-domain NAME EMAIL
+                        ドメイン追加
+  -dd DOMAIN, --delete-domain DOMAIN
+                        ドメインを名前またはIDで削除
+  -ar DOMAIN NAME TYPE DATA, --add-record DOMAIN NAME TYPE DATA
+                        レコード追加
+  -ur DOMAIN RECORD_ID, --update-record DOMAIN RECORD_ID
+                        レコード更新
+  -dr DOMAIN RECORD_ID, --delete-record DOMAIN RECORD_ID
+                        レコード削除
+  -t TTL, --ttl TTL     レコード追加時のTTL(秒)。デフォルト: 300
+  -o {csv}, --output {csv}
+                        出力形式をCSVにします。'-l'での一覧表示時のみ有効です。
+  --new-name NEW_NAME   更新後のレコード名
+  --new-type NEW_TYPE   更新後のレコードタイプ
+  --new-data NEW_DATA   更新後のレコードデータ
+  --new-ttl NEW_TTL     更新後のTTL
+
+使用例:
+  # APIトークンを認証・取得
+  conoha-dns --auth
+
+  # ドメイン一覧表示
+  conoha-dns -l
+
+  # レコード一覧をCSV形式で標準出力
+  conoha-dns -l example.com --output csv > records.csv
+
+  # Aレコード追加 (サブドメインtestを補完してtest.example.comを追加)
+  conoha-dns -ar example.com @ A 192.0.2.1
+  conoha-dns -ar example.com test A 192.0.2.1
+
+  # レコード更新 (レコードIDを指定し、新しいIPアドレスを設定)
+  conoha-dns -ur example.com <record_id> --new-data 192.0.2.2
+
+  # レコード削除 (レコードIDは -l example.com で確認)
+  conoha-dns -dr example.com <record_id>
+```
+
+## インストール
+
+はじめに、ConoHaの認証情報を記述した`~/.conoha-env`ファイルをホームディレクトリに作成します。
+APIエンドポイントはConoHaのリージョンによって異なるため、適宜変更してください。
+[ConoHaコントロールパネル](https://cp.conoha.jp/VPS/API/) の「API情報」から確認できます。
+
+**~/.conoha-env**:
+```
+CONOHA_USER_ID="your_user_id"                             # API ユーザー: ユーザID
+CONOHA_PASSWORD="your_password"                           # API ユーザー: パスワード
+TENANT_ID="your_tenant_id"                                # テナント情報: テナントID
+CONOHA_AUTH_URL="https://identity.sample.conoha.io"       # エンドポイント: Identity Service URL
+CONOHA_DNS_API_URL="https://dns-service.sample.conoha.io" # エンドポイント: DNS Service URL
+```
+
+次に、Makefileを使ってビルドとインストールを実行します。
+
+```bash
+make install
+```
+
+これにより、`conoha-dns`コマンドがインストールされます。
+
+## 使い方
+
+このコマンドは、実行したい操作をフラグで指定します。一度に指定できる操作は1つだけです。
+ドメインを指定する引数 (DOMAIN) には、ドメイン名 (`example.com`) またはドメインID (`ba9b5b9d`など) の両方を使用できます。
+
+### 一般的なコマンド
+
+**ヘルプ表示**
+```bash
+conoha-dns -h
+```
+
+**認証**
+認証情報を使って新しいAPIトークンを取得し、`~/.conoha-env`ファイルに保存します。  
+なお、ConoHa APIトークンの有効期限は24時間です。  
+```bash
+conoha-dns --auth
+```
+
+### ドメイン・レコード管理
+
+**ドメイン一覧・レコード一覧**
+
+`-l` フラグを使用すると、一覧がテーブル形式で表示されます。
+
+```bash
+# ドメイン一覧
+conoha-dns -l
+
+# レコード一覧 (ドメイン名またはIDで指定)
+conoha-dns -l <ドメイン名/ID>
+```
+*実行例:*
+```bash
+$ conoha-dns -l
+  ID         Name
+  0e6f0695   soulminingrig.com.
+  4fb208de   eyes4you.org.
+  ...
+```
+
+**CSV形式での標準出力**
+
+`--output csv` オプションを追加すると、一覧をCSV形式で標準出力します。リダイレクト(`>`)を使えばファイルに保存できます。
+
+```bash
+# ドメイン一覧をCSVで標準出力
+conoha-dns -l --output csv
+
+# レコード一覧をCSVファイルとして保存
+conoha-dns -l <ドメイン名/ID> --output csv > records.csv
+```
+*実行例:*
+```bash
+$ conoha-dns -l example.com --output csv
+ID,Name,Type,Data,TTL
+5057adde,eye4u.org.,SOA,"a.conoha-dns.com. taro.eyes4you.org. 1757833524 3600 600 86400 3600",3600
+2eff1245,eye4u.org.,NS,a.conoha-dns.com.,3600
+...
+```
+
+**ドメイン追加**
+```bash
+conoha-dns -ad <ドメイン名> <メールアドレス>
+```
+
+**ドメイン削除**
+```bash
+conoha-dns -dd <ドメイン名/ID>
+```
+
+### レコード管理
+
+内部的に、ConoHa APIから取得したレコードIDは長いため、xxhashを用いて短いハッシュ値に変換して表示・利用しています。
+
+**レコード追加**
+```bash
+conoha-dns -ar <ドメイン名/ID> <レコード名> <種別> <値> [--ttl <秒数>]
+```
+
+**レコード更新**
+`record_id`（`conoha-dns -l <ドメイン名/ID>`で確認可能）と、少なくとも1つの`--new-*`オプションを指定する必要があります。
+```bash
+conoha-dns -ur <ドメイン名/ID> <record_id> [--new-name <名前>] [--new-type <種別>] [--new-data <値>] [--new-ttl <TTL>]
+```
+
+**レコード削除**
+```bash
+conoha-dns -dr <ドメイン名/ID> <record_id>
+```
+
+## 応用例：xargsを使った一括操作
+
+`xargs`と組み合わせることで、ファイルに記載されたドメインリストに対して一括で操作を実行できます。
+
+例えば、以下のようなドメインリストが書かれた`domain-list.txt`があるとします。
+
+**domain-list.txt**
+```
+example1.com
+example2.com
+example3.com
+```
+
+このファイル内の各ドメインに対して、一括でルートAレコードを追加するには、以下のコマンドを実行します。
+
+```bash
+cat domain-list.txt | xargs -I{} conoha-dns -ar {} @ A 192.0.2.1
+```
+
+これにより、`domain-list.txt`の各行が`{}`に代入され、ドメインごとにレコード追加コマンドが実行されます。

conoha_dns_cli-0.1.0/src/conoha_dns_cli.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+README.md
+pyproject.toml
+src/conoha_dns_cli/__init__.py
+src/conoha_dns_cli/client.py
+src/conoha_dns_cli/domain.py
+src/conoha_dns_cli/id_converter.py
+src/conoha_dns_cli/main.py
+src/conoha_dns_cli/record.py
+src/conoha_dns_cli/utils.py
+src/conoha_dns_cli.egg-info/PKG-INFO
+src/conoha_dns_cli.egg-info/SOURCES.txt
+src/conoha_dns_cli.egg-info/dependency_links.txt
+src/conoha_dns_cli.egg-info/entry_points.txt
+src/conoha_dns_cli.egg-info/requires.txt
+src/conoha_dns_cli.egg-info/top_level.txt

conoha_dns_cli-0.1.0/src/conoha_dns_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

conoha_dns_cli-0.1.0/src/conoha_dns_cli.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+conoha-dns = conoha_dns_cli.main:main

conoha_dns_cli-0.1.0/src/conoha_dns_cli.egg-info/requires.txt

@@ -0,0 +1,3 @@
+python-dotenv
+requests
+xxhash

conoha_dns_cli-0.1.0/src/conoha_dns_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+conoha_dns_cli