dinahosting-cli 0.1.0__tar.gz

dinahosting_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dinacli contributors
+
+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.

dinahosting_cli-0.1.0/PKG-INFO

@@ -0,0 +1,261 @@
+Metadata-Version: 2.4
+Name: dinahosting-cli
+Version: 0.1.0
+Summary: Python client for the Dinahosting API
+Author: Dinacli contributors
+License-Expression: MIT
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+<p align="center">
+  <img src="https://img.shields.io/badge/dinahosting--cli-Dinahosting%20API-blue?style=for-the-badge" alt="dinahosting-cli">
+</p>
+
+<h1 align="center">dinahosting-cli</h1>
+
+<p align="center">
+  <strong>Python 3.14 client and command-line interface for the Dinahosting API</strong>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/dinahosting-cli/"><img src="https://img.shields.io/pypi/v/dinahosting-cli?style=flat-square&logo=pypi&logoColor=white" alt="PyPI Version"></a>
+  <a href="https://pypi.org/project/dinahosting-cli/"><img src="https://img.shields.io/pypi/pyversions/dinahosting-cli?style=flat-square&logo=python&logoColor=white" alt="Python Versions"></a>
+  <a href="https://github.com/seifreed/dinacli/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="License"></a>
+  <a href="https://github.com/seifreed/dinacli/stargazers"><img src="https://img.shields.io/github/stars/seifreed/dinacli?style=flat-square" alt="GitHub Stars"></a>
+  <a href="https://github.com/seifreed/dinacli/issues"><img src="https://img.shields.io/github/issues/seifreed/dinacli?style=flat-square" alt="GitHub Issues"></a>
+  <a href="https://buymeacoffee.com/seifreed"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-support-yellow?style=flat-square&logo=buy-me-a-coffee&logoColor=white" alt="Buy Me a Coffee"></a>
+</p>
+
+---
+
+## Overview
+
+**dinahosting-cli** is a Python library and CLI for the Dinahosting API. It exposes the 485 documented API commands, validates their documented parameters, sends form-encoded requests through HTTPS, and returns typed responses.
+
+### Key Features
+
+| Feature | Description |
+|---------|-------------|
+| **Complete command catalogue** | Access all 485 documented Dinahosting API commands |
+| **CLI + library** | Automate from `dinacli` or use `DinaClient` in Python |
+| **Parameter validation** | Required and optional parameters are checked before requests are sent |
+| **JSON output** | Commands, descriptions, responses, and optional errors are machine-readable |
+| **Configuration sources** | Credentials and connection settings from flags, environment variables, or TOML |
+| **Secure transport** | HTTPS is required for remote endpoints; HTTP is limited to loopback integration tests |
+| **Typed failures** | Configuration, connection, protocol, and API errors have distinct exception types |
+
+### Supported Interfaces
+
+```text
+CLI              commands, describe, call
+Configuration    command-line flags, DINA_* environment variables, TOML
+Response data    JSON output and DinaResponse objects
+Python access    exact API names and hierarchical namespaces
+```
+
+---
+
+## Installation
+
+### From PyPI
+
+After publication, install the package with:
+
+```bash
+python -m pip install dinahosting-cli
+```
+
+### From Source
+
+```bash
+git clone https://github.com/seifreed/dinacli.git
+cd dinacli
+python3 -m venv venv
+source venv/bin/activate  # Windows: venv\Scripts\activate
+python -m pip install -e .
+```
+
+Development tooling is declared in `pyproject.toml` alongside the package metadata.
+
+---
+
+## Quick Start
+
+```bash
+# List every documented API command
+dinacli commands
+
+# Inspect parameters before executing a command
+dinacli describe Domain_Zone_AddTypeA
+
+# Execute a simulated request
+dinacli --user mi_usuario --password mi_contrasena \
+  call Domain_Zone_AddTypeA \
+  --param domain=example.com \
+  --param hostname=www \
+  --param ip=192.0.2.10 \
+  --simulate
+```
+
+---
+
+## Usage
+
+### Command Line Interface
+
+```bash
+# List commands as JSON
+dinacli --output json commands
+
+# Display required and optional parameters
+dinacli describe Vps_PowerStatus_Restart
+
+# Pass strings, numbers, booleans, arrays, or objects with --param
+dinacli --user mi_usuario --password mi_contrasena \
+  call Domain_Zone_AddTypeA \
+  --param domain=example.com \
+  --param hostname=www \
+  --param ip=192.0.2.10 \
+  --simulate
+```
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `dinacli commands` | List the 485 documented API command names |
+| `dinacli describe COMANDO` | Show a command's required and optional parameters |
+| `dinacli call COMANDO` | Validate and execute a documented API command |
+
+### Global Options
+
+| Option | Description |
+|--------|-------------|
+| `--config ARCHIVO` | TOML file with a `[dina]` section |
+| `--user USUARIO` | Dinahosting API user |
+| `--password CLAVE` | Dinahosting API password |
+| `--endpoint URL` | Override the default API endpoint |
+| `--timeout SEGUNDOS` | Request timeout; defaults to 20 seconds |
+| `--output json` | JSON array for `commands` and JSON errors on stderr |
+| `--version` | Print the installed package version |
+
+Global options must precede the subcommand. `call` accepts `--param NOMBRE=VALOR` repeatedly. Valid JSON values are decoded before sending; other values are sent as text. `--simulate` sends the API `SIMULATE` parameter.
+
+### Configuration
+
+`DINA_USER` and `DINA_PASSWORD` are required when creating a client from the environment. The optional variables are `DINA_ENDPOINT` and `DINA_TIMEOUT`.
+
+```toml
+[dina]
+user = "mi_usuario"
+password = "mi_contrasena"
+endpoint = "https://dinahosting.com/special/api.php"
+timeout = 20
+```
+
+Command-line flags take precedence over `DINA_*` variables, which take precedence over TOML values. Prefer environment variables or a protected TOML file over passing a password directly on the command line.
+
+---
+
+## Python Library
+
+### Basic Usage
+
+```python
+from dinacli import DinaClient
+
+client = DinaClient.from_environment()
+domains = client.call("Services_GetDomains").data
+```
+
+### Documented Commands
+
+```python
+from dinacli import DinaClient
+
+client = DinaClient("mi_usuario", "mi_contrasena")
+
+client.api.domain.zone.add_type_a(
+    domain="example.com",
+    hostname="www",
+    ip="192.0.2.10",
+)
+
+client.api["Vps_PowerStatus_Restart"](serverName="vps.example.com")
+```
+
+Every documented command validates its required and optional parameters. Successful calls return `DinaResponse`; non-success API codes raise `DinaApiError`.
+
+---
+
+## Requirements
+
+- Python 3.14+
+- No runtime dependencies
+
+See [pyproject.toml](pyproject.toml) for package metadata and development tooling.
+
+---
+
+## Releases
+
+CI runs the full quality and security gate on the latest Linux, Windows, and
+macOS runners using Python 3.14. Push a version tag that matches the package
+version to publish a release:
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+PyPI publishing uses GitHub Actions OIDC Trusted Publishing and does not use a
+stored PyPI token. Before the first release, register a pending publisher in
+PyPI with the following values:
+
+```text
+Project:     dinahosting-cli
+Owner:       seifreed
+Repository:  dinacli
+Workflow:    release.yml
+Environment: pypi
+```
+
+Configure the optional `pypi` GitHub environment with required reviewers when
+manual release approval is desired.
+
+---
+
+## Contributing
+
+1. Fork the repository.
+2. Create a feature branch.
+3. Run the quality and security gates from `AGENTS.md`.
+4. Commit and push the change.
+5. Open a pull request.
+
+---
+
+## Support the Project
+
+<a href="https://buymeacoffee.com/seifreed" target="_blank">
+  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="50">
+</a>
+
+---
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).
+
+**Repository:** [github.com/seifreed/dinacli](https://github.com/seifreed/dinacli)
+
+---
+
+<p align="center">
+  <sub>Built for reliable Dinahosting API automation</sub>
+</p>

dinahosting_cli-0.1.0/README.md

@@ -0,0 +1,247 @@
+<p align="center">
+  <img src="https://img.shields.io/badge/dinahosting--cli-Dinahosting%20API-blue?style=for-the-badge" alt="dinahosting-cli">
+</p>
+
+<h1 align="center">dinahosting-cli</h1>
+
+<p align="center">
+  <strong>Python 3.14 client and command-line interface for the Dinahosting API</strong>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/dinahosting-cli/"><img src="https://img.shields.io/pypi/v/dinahosting-cli?style=flat-square&logo=pypi&logoColor=white" alt="PyPI Version"></a>
+  <a href="https://pypi.org/project/dinahosting-cli/"><img src="https://img.shields.io/pypi/pyversions/dinahosting-cli?style=flat-square&logo=python&logoColor=white" alt="Python Versions"></a>
+  <a href="https://github.com/seifreed/dinacli/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="License"></a>
+  <a href="https://github.com/seifreed/dinacli/stargazers"><img src="https://img.shields.io/github/stars/seifreed/dinacli?style=flat-square" alt="GitHub Stars"></a>
+  <a href="https://github.com/seifreed/dinacli/issues"><img src="https://img.shields.io/github/issues/seifreed/dinacli?style=flat-square" alt="GitHub Issues"></a>
+  <a href="https://buymeacoffee.com/seifreed"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-support-yellow?style=flat-square&logo=buy-me-a-coffee&logoColor=white" alt="Buy Me a Coffee"></a>
+</p>
+
+---
+
+## Overview
+
+**dinahosting-cli** is a Python library and CLI for the Dinahosting API. It exposes the 485 documented API commands, validates their documented parameters, sends form-encoded requests through HTTPS, and returns typed responses.
+
+### Key Features
+
+| Feature | Description |
+|---------|-------------|
+| **Complete command catalogue** | Access all 485 documented Dinahosting API commands |
+| **CLI + library** | Automate from `dinacli` or use `DinaClient` in Python |
+| **Parameter validation** | Required and optional parameters are checked before requests are sent |
+| **JSON output** | Commands, descriptions, responses, and optional errors are machine-readable |
+| **Configuration sources** | Credentials and connection settings from flags, environment variables, or TOML |
+| **Secure transport** | HTTPS is required for remote endpoints; HTTP is limited to loopback integration tests |
+| **Typed failures** | Configuration, connection, protocol, and API errors have distinct exception types |
+
+### Supported Interfaces
+
+```text
+CLI              commands, describe, call
+Configuration    command-line flags, DINA_* environment variables, TOML
+Response data    JSON output and DinaResponse objects
+Python access    exact API names and hierarchical namespaces
+```
+
+---
+
+## Installation
+
+### From PyPI
+
+After publication, install the package with:
+
+```bash
+python -m pip install dinahosting-cli
+```
+
+### From Source
+
+```bash
+git clone https://github.com/seifreed/dinacli.git
+cd dinacli
+python3 -m venv venv
+source venv/bin/activate  # Windows: venv\Scripts\activate
+python -m pip install -e .
+```
+
+Development tooling is declared in `pyproject.toml` alongside the package metadata.
+
+---
+
+## Quick Start
+
+```bash
+# List every documented API command
+dinacli commands
+
+# Inspect parameters before executing a command
+dinacli describe Domain_Zone_AddTypeA
+
+# Execute a simulated request
+dinacli --user mi_usuario --password mi_contrasena \
+  call Domain_Zone_AddTypeA \
+  --param domain=example.com \
+  --param hostname=www \
+  --param ip=192.0.2.10 \
+  --simulate
+```
+
+---
+
+## Usage
+
+### Command Line Interface
+
+```bash
+# List commands as JSON
+dinacli --output json commands
+
+# Display required and optional parameters
+dinacli describe Vps_PowerStatus_Restart
+
+# Pass strings, numbers, booleans, arrays, or objects with --param
+dinacli --user mi_usuario --password mi_contrasena \
+  call Domain_Zone_AddTypeA \
+  --param domain=example.com \
+  --param hostname=www \
+  --param ip=192.0.2.10 \
+  --simulate
+```
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `dinacli commands` | List the 485 documented API command names |
+| `dinacli describe COMANDO` | Show a command's required and optional parameters |
+| `dinacli call COMANDO` | Validate and execute a documented API command |
+
+### Global Options
+
+| Option | Description |
+|--------|-------------|
+| `--config ARCHIVO` | TOML file with a `[dina]` section |
+| `--user USUARIO` | Dinahosting API user |
+| `--password CLAVE` | Dinahosting API password |
+| `--endpoint URL` | Override the default API endpoint |
+| `--timeout SEGUNDOS` | Request timeout; defaults to 20 seconds |
+| `--output json` | JSON array for `commands` and JSON errors on stderr |
+| `--version` | Print the installed package version |
+
+Global options must precede the subcommand. `call` accepts `--param NOMBRE=VALOR` repeatedly. Valid JSON values are decoded before sending; other values are sent as text. `--simulate` sends the API `SIMULATE` parameter.
+
+### Configuration
+
+`DINA_USER` and `DINA_PASSWORD` are required when creating a client from the environment. The optional variables are `DINA_ENDPOINT` and `DINA_TIMEOUT`.
+
+```toml
+[dina]
+user = "mi_usuario"
+password = "mi_contrasena"
+endpoint = "https://dinahosting.com/special/api.php"
+timeout = 20
+```
+
+Command-line flags take precedence over `DINA_*` variables, which take precedence over TOML values. Prefer environment variables or a protected TOML file over passing a password directly on the command line.
+
+---
+
+## Python Library
+
+### Basic Usage
+
+```python
+from dinacli import DinaClient
+
+client = DinaClient.from_environment()
+domains = client.call("Services_GetDomains").data
+```
+
+### Documented Commands
+
+```python
+from dinacli import DinaClient
+
+client = DinaClient("mi_usuario", "mi_contrasena")
+
+client.api.domain.zone.add_type_a(
+    domain="example.com",
+    hostname="www",
+    ip="192.0.2.10",
+)
+
+client.api["Vps_PowerStatus_Restart"](serverName="vps.example.com")
+```
+
+Every documented command validates its required and optional parameters. Successful calls return `DinaResponse`; non-success API codes raise `DinaApiError`.
+
+---
+
+## Requirements
+
+- Python 3.14+
+- No runtime dependencies
+
+See [pyproject.toml](pyproject.toml) for package metadata and development tooling.
+
+---
+
+## Releases
+
+CI runs the full quality and security gate on the latest Linux, Windows, and
+macOS runners using Python 3.14. Push a version tag that matches the package
+version to publish a release:
+
+```bash
+git tag v0.1.0
+git push origin v0.1.0
+```
+
+PyPI publishing uses GitHub Actions OIDC Trusted Publishing and does not use a
+stored PyPI token. Before the first release, register a pending publisher in
+PyPI with the following values:
+
+```text
+Project:     dinahosting-cli
+Owner:       seifreed
+Repository:  dinacli
+Workflow:    release.yml
+Environment: pypi
+```
+
+Configure the optional `pypi` GitHub environment with required reviewers when
+manual release approval is desired.
+
+---
+
+## Contributing
+
+1. Fork the repository.
+2. Create a feature branch.
+3. Run the quality and security gates from `AGENTS.md`.
+4. Commit and push the change.
+5. Open a pull request.
+
+---
+
+## Support the Project
+
+<a href="https://buymeacoffee.com/seifreed" target="_blank">
+  <img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" height="50">
+</a>
+
+---
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).
+
+**Repository:** [github.com/seifreed/dinacli](https://github.com/seifreed/dinacli)
+
+---
+
+<p align="center">
+  <sub>Built for reliable Dinahosting API automation</sub>
+</p>

dinahosting_cli-0.1.0/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["setuptools>=80"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "dinahosting-cli"
+version = "0.1.0"
+description = "Python client for the Dinahosting API"
+readme = "README.md"
+requires-python = ">=3.14"
+license = "MIT"
+authors = [{ name = "Dinacli contributors" }]
+classifiers = [
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Operating System :: OS Independent",
+]
+
+[project.scripts]
+dinacli = "dinacli.cli:main"
+
+[dependency-groups]
+dev = [
+    "bandit>=1.8.0",
+    "black>=26.0.0",
+    "build>=1.3.0",
+    "mypy>=1.19.0",
+    "pip-audit>=2.10.0",
+    "pytest>=9.0.0",
+    "pytest-cov>=7.0.0",
+    "ruff>=0.14.0",
+    "twine>=6.2.0",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+addopts = "--cov=dinacli --cov-branch --cov-fail-under=100"
+testpaths = ["tests"]
+
+[tool.coverage.run]
+branch = true
+source = ["dinacli"]
+
+[tool.coverage.report]
+show_missing = true
+
+[tool.mypy]
+strict = true
+packages = ["dinacli"]
+
+[tool.ruff]
+target-version = "py314"
+
+[tool.black]
+target-version = ["py314"]

dinahosting_cli-0.1.0/setup.cfg

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

dinahosting_cli-0.1.0/src/dinacli/__init__.py

@@ -0,0 +1,27 @@
+"""Python client for the Dinahosting API."""
+
+from .bootstrap import DinaClient
+from .commands import COMMANDS
+from .models import (
+    CommandSpec,
+    DinaApiError,
+    DinaConfigurationError,
+    DinaConnectionError,
+    DinaError,
+    DinaProtocolError,
+    DinaResponse,
+)
+from .settings import DEFAULT_ENDPOINT
+
+__all__ = [
+    "COMMANDS",
+    "DEFAULT_ENDPOINT",
+    "CommandSpec",
+    "DinaApiError",
+    "DinaClient",
+    "DinaConfigurationError",
+    "DinaConnectionError",
+    "DinaError",
+    "DinaProtocolError",
+    "DinaResponse",
+]