wayscloud 0.1.0__tar.gz

wayscloud-0.1.0/LICENSE

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

wayscloud-0.1.0/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: wayscloud
+Version: 0.1.0
+Summary: Official Python SDK for the WAYSCloud API
+Home-page: https://wayscloud.services
+License: MIT
+Project-URL: Homepage, https://wayscloud.services
+Project-URL: Documentation, https://docs.wayscloud.services
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.25
+Dynamic: license-file
+
+# WAYSCloud Python SDK
+
+Official Python SDK for the [WAYSCloud](https://wayscloud.services) API.
+
+## Installation
+
+```bash
+pip install wayscloud
+```
+
+## Authentication
+
+```python
+from wayscloud import WaysCloudClient
+
+# Personal Access Token
+client = WaysCloudClient(token="wayscloud_pat_...")
+
+# API key
+client = WaysCloudClient(api_key="wayscloud_api_...")
+
+# Environment variables (WAYSCLOUD_TOKEN or WAYSCLOUD_API_KEY)
+client = WaysCloudClient()
+```
+
+Priority: explicit arguments > environment variables.
+
+## Usage
+
+```python
+# VPS
+for vm in client.vps.list():
+    print(vm["hostname"], vm["status"])
+
+# DNS
+client.dns.create_record(
+    "example.com",
+    record_type="A",
+    name="www",
+    value="192.0.2.1",
+)
+
+# Database
+db = client.database.create(name="prod", db_type="postgresql")
+
+# Apps
+app = client.apps.create(name="my-app", region="eu")
+
+# Storage
+client.storage.create_bucket("my-bucket")
+
+# SMS
+client.sms.send(to="+4712345678", message="Hello from WAYSCloud")
+```
+
+## Error handling
+
+```python
+from wayscloud import NotFoundError, AuthenticationError
+
+try:
+    client.vps.get("id")
+except NotFoundError:
+    print("Not found")
+except AuthenticationError:
+    print("Invalid credentials")
+```
+
+All exceptions inherit from `WaysCloudError`.
+
+## Configuration
+
+| Parameter | Environment variable | Default |
+|-----------|---------------------|---------|
+| `token` | `WAYSCLOUD_TOKEN` | — |
+| `api_key` | `WAYSCLOUD_API_KEY` | — |
+| `base_url` | `WAYSCLOUD_API_URL` | `https://api.wayscloud.services` |
+| `timeout` | — | `30.0` |
+
+## Retries
+
+Automatic retries on 429, 502, 503, 504 with exponential backoff. Respects `Retry-After` headers.
+
+## Requirements
+
+- Python 3.10+
+- httpx
+
+## License
+
+MIT — see [LICENSE](LICENSE).

wayscloud-0.1.0/README.md

@@ -0,0 +1,91 @@
+# WAYSCloud Python SDK
+
+Official Python SDK for the [WAYSCloud](https://wayscloud.services) API.
+
+## Installation
+
+```bash
+pip install wayscloud
+```
+
+## Authentication
+
+```python
+from wayscloud import WaysCloudClient
+
+# Personal Access Token
+client = WaysCloudClient(token="wayscloud_pat_...")
+
+# API key
+client = WaysCloudClient(api_key="wayscloud_api_...")
+
+# Environment variables (WAYSCLOUD_TOKEN or WAYSCLOUD_API_KEY)
+client = WaysCloudClient()
+```
+
+Priority: explicit arguments > environment variables.
+
+## Usage
+
+```python
+# VPS
+for vm in client.vps.list():
+    print(vm["hostname"], vm["status"])
+
+# DNS
+client.dns.create_record(
+    "example.com",
+    record_type="A",
+    name="www",
+    value="192.0.2.1",
+)
+
+# Database
+db = client.database.create(name="prod", db_type="postgresql")
+
+# Apps
+app = client.apps.create(name="my-app", region="eu")
+
+# Storage
+client.storage.create_bucket("my-bucket")
+
+# SMS
+client.sms.send(to="+4712345678", message="Hello from WAYSCloud")
+```
+
+## Error handling
+
+```python
+from wayscloud import NotFoundError, AuthenticationError
+
+try:
+    client.vps.get("id")
+except NotFoundError:
+    print("Not found")
+except AuthenticationError:
+    print("Invalid credentials")
+```
+
+All exceptions inherit from `WaysCloudError`.
+
+## Configuration
+
+| Parameter | Environment variable | Default |
+|-----------|---------------------|---------|
+| `token` | `WAYSCLOUD_TOKEN` | — |
+| `api_key` | `WAYSCLOUD_API_KEY` | — |
+| `base_url` | `WAYSCLOUD_API_URL` | `https://api.wayscloud.services` |
+| `timeout` | — | `30.0` |
+
+## Retries
+
+Automatic retries on 429, 502, 503, 504 with exponential backoff. Respects `Retry-After` headers.
+
+## Requirements
+
+- Python 3.10+
+- httpx
+
+## License
+
+MIT — see [LICENSE](LICENSE).

wayscloud-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[project]
+name = "wayscloud"
+version = "0.1.0"
+description = "Official Python SDK for the WAYSCloud API"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.10"
+dependencies = ["httpx>=0.25"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+[project.urls]
+Homepage = "https://wayscloud.services"
+Documentation = "https://docs.wayscloud.services"
+
+[tool.setuptools.packages.find]
+include = ["wayscloud*"]
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"

wayscloud-0.1.0/setup.cfg

@@ -0,0 +1,33 @@
+[metadata]
+name = wayscloud
+version = 0.1.0
+description = Official Python SDK for the WAYSCloud API
+long_description = file: README.md
+long_description_content_type = text/markdown
+license = MIT
+url = https://wayscloud.services
+classifiers = 
+	Development Status :: 4 - Beta
+	Intended Audience :: Developers
+	License :: OSI Approved :: MIT License
+	Programming Language :: Python :: 3
+	Programming Language :: Python :: 3.10
+	Programming Language :: Python :: 3.11
+	Programming Language :: Python :: 3.12
+
+[options]
+packages = find:
+python_requires = >=3.10
+install_requires = 
+	httpx>=0.25
+
+[options.packages.find]
+include = wayscloud*
+
+[options.package_data]
+wayscloud = py.typed
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

wayscloud-0.1.0/tests/test_smoke.py

@@ -0,0 +1,241 @@
+"""SDK smoke tests — verify public API surface, auth, lifecycle, and error handling."""
+
+import os
+
+import httpx
+import pytest
+import respx
+
+from wayscloud import (
+    WaysCloudClient,
+    WaysCloudError,
+    AuthenticationError,
+    NotFoundError,
+    ValidationError,
+    ServerError,
+    __version__,
+)
+
+
+# ── Import & version ────────────────────────────────────────────
+
+def test_version_is_string():
+    assert isinstance(__version__, str)
+    assert "." in __version__
+
+
+# ── Auth: explicit args ─────────────────────────────────────────
+
+def test_token_sets_bearer_header():
+    c = WaysCloudClient(token="wayscloud_pat_test123")
+    assert c._headers["Authorization"] == "Bearer wayscloud_pat_test123"
+    c.close()
+
+
+def test_api_key_token_sets_x_api_key():
+    c = WaysCloudClient(token="wayscloud_api_test123")
+    assert c._headers["X-API-Key"] == "wayscloud_api_test123"
+    assert "Authorization" not in c._headers
+    c.close()
+
+
+def test_explicit_api_key_sets_header():
+    c = WaysCloudClient(api_key="wayscloud_api_abc")
+    assert c._headers["X-API-Key"] == "wayscloud_api_abc"
+    c.close()
+
+
+def test_both_token_and_api_key():
+    c = WaysCloudClient(token="wayscloud_pat_x", api_key="wayscloud_api_y")
+    assert c._headers["Authorization"] == "Bearer wayscloud_pat_x"
+    assert c._headers["X-API-Key"] == "wayscloud_api_y"
+    c.close()
+
+
+# ── Auth: env var fallback ──────────────────────────────────────
+
+def test_env_var_token(monkeypatch):
+    monkeypatch.setenv("WAYSCLOUD_TOKEN", "wayscloud_pat_env")
+    monkeypatch.delenv("WAYSCLOUD_API_KEY", raising=False)
+    c = WaysCloudClient()
+    assert c._headers["Authorization"] == "Bearer wayscloud_pat_env"
+    c.close()
+
+
+def test_env_var_api_key(monkeypatch):
+    monkeypatch.delenv("WAYSCLOUD_TOKEN", raising=False)
+    monkeypatch.setenv("WAYSCLOUD_API_KEY", "wayscloud_api_env")
+    c = WaysCloudClient()
+    assert c._headers["X-API-Key"] == "wayscloud_api_env"
+    c.close()
+
+
+def test_env_var_base_url(monkeypatch):
+    monkeypatch.setenv("WAYSCLOUD_API_URL", "https://custom.example.com")
+    c = WaysCloudClient(token="t")
+    assert c.base_url == "https://custom.example.com"
+    c.close()
+
+
+def test_explicit_overrides_env(monkeypatch):
+    monkeypatch.setenv("WAYSCLOUD_TOKEN", "wayscloud_pat_env")
+    c = WaysCloudClient(token="wayscloud_pat_explicit")
+    assert c._headers["Authorization"] == "Bearer wayscloud_pat_explicit"
+    c.close()
+
+
+# ── Client lifecycle ────────────────────────────────────────────
+
+def test_context_manager():
+    with WaysCloudClient(token="t") as c:
+        assert c._http is not None
+    assert c._http.is_closed
+
+
+def test_close():
+    c = WaysCloudClient(token="t")
+    assert not c._http.is_closed
+    c.close()
+    assert c._http.is_closed
+
+
+# ── Service properties ──────────────────────────────────────────
+
+def test_all_services_instantiate():
+    c = WaysCloudClient(token="t")
+    services = [c.vps, c.dns, c.storage, c.database, c.redis, c.apps, c.iot, c.sms, c.account]
+    assert len(services) == 9
+    assert all(s is not None for s in services)
+    # Lazy — same instance on second access
+    assert c.vps is c.vps
+    c.close()
+
+
+# ── HTTP: success ───────────────────────────────────────────────
+
+@respx.mock
+def test_get_returns_json():
+    respx.get("https://api.wayscloud.services/api/v1/dashboard/vps").mock(
+        return_value=httpx.Response(200, json={"instances": []})
+    )
+    with WaysCloudClient(token="t") as c:
+        result = c.vps.list()
+    assert result == []
+
+
+@respx.mock
+def test_post_sends_json_body():
+    route = respx.post("https://api.wayscloud.services/api/v1/dashboard/dns/zones").mock(
+        return_value=httpx.Response(201, json={"id": "z1", "name": "example.com"})
+    )
+    with WaysCloudClient(token="t") as c:
+        result = c.dns.create_zone("example.com")
+    assert result["name"] == "example.com"
+    assert route.calls[0].request.headers["content-type"] == "application/json"
+
+
+@respx.mock
+def test_get_does_not_send_content_type():
+    route = respx.get("https://api.wayscloud.services/api/v1/dashboard/vps").mock(
+        return_value=httpx.Response(200, json={"instances": []})
+    )
+    with WaysCloudClient(token="t") as c:
+        c.vps.list()
+    assert "content-type" not in route.calls[0].request.headers
+
+
+@respx.mock
+def test_204_returns_ok():
+    respx.delete("https://api.wayscloud.services/api/v1/dashboard/vps/abc").mock(
+        return_value=httpx.Response(204)
+    )
+    with WaysCloudClient(token="t") as c:
+        result = c.vps.delete("abc")
+    assert result == {"status": "ok"}
+
+
+# ── HTTP: error mapping ────────────────────────────────────────
+
+@respx.mock
+def test_401_raises_authentication_error():
+    respx.get("https://api.wayscloud.services/api/v1/dashboard/vps").mock(
+        return_value=httpx.Response(401, json={"detail": "Invalid token"})
+    )
+    with WaysCloudClient(token="t") as c:
+        with pytest.raises(AuthenticationError) as exc:
+            c.vps.list()
+    assert exc.value.status_code == 401
+
+
+@respx.mock
+def test_404_raises_not_found():
+    respx.get("https://api.wayscloud.services/api/v1/dashboard/vps/bad").mock(
+        return_value=httpx.Response(404, json={"detail": "Not found"})
+    )
+    with WaysCloudClient(token="t") as c:
+        with pytest.raises(NotFoundError):
+            c.vps.get("bad")
+
+
+@respx.mock
+def test_422_raises_validation_error():
+    respx.post("https://api.wayscloud.services/api/v1/dashboard/dns/zones").mock(
+        return_value=httpx.Response(422, json={"detail": "Invalid zone name"})
+    )
+    with WaysCloudClient(token="t") as c:
+        with pytest.raises(ValidationError):
+            c.dns.create_zone("")
+
+
+@respx.mock
+def test_500_raises_server_error():
+    respx.get("https://api.wayscloud.services/api/v1/dashboard/vps").mock(
+        return_value=httpx.Response(500, json={"detail": "Internal error"})
+    )
+    with WaysCloudClient(token="t") as c:
+        with pytest.raises(ServerError):
+            c.vps.list()
+
+
+# ── HTTP: retry ─────────────────────────────────────────────────
+
+@respx.mock
+def test_retries_on_429_then_succeeds():
+    route = respx.get("https://api.wayscloud.services/api/v1/dashboard/vps").mock(
+        side_effect=[
+            httpx.Response(429),
+            httpx.Response(200, json={"instances": [{"hostname": "ok"}]}),
+        ]
+    )
+    with WaysCloudClient(token="t") as c:
+        c.BACKOFF_FACTOR = 0.01  # Speed up test
+        result = c.vps.list()
+    assert len(result) == 1
+    assert route.call_count == 2
+
+
+# ── Service method signatures ───────────────────────────────────
+
+def test_dns_create_record_uses_record_type():
+    """Verify renamed param — no Python builtin shadow."""
+    import inspect
+    from wayscloud.services.dns import DNSService
+    sig = inspect.signature(DNSService.create_record)
+    assert "record_type" in sig.parameters
+    assert "type" not in sig.parameters
+
+
+def test_database_create_uses_db_type():
+    import inspect
+    from wayscloud.services.database import DatabaseService
+    sig = inspect.signature(DatabaseService.create)
+    assert "db_type" in sig.parameters
+    assert "type" not in sig.parameters
+
+
+def test_iot_create_rule_uses_rule_type():
+    import inspect
+    from wayscloud.services.iot import IoTService
+    sig = inspect.signature(IoTService.create_rule)
+    assert "rule_type" in sig.parameters
+    assert "type" not in sig.parameters

wayscloud-0.1.0/wayscloud/__init__.py

@@ -0,0 +1,5 @@
+from .client import WaysCloudClient
+from .exceptions import WaysCloudError, AuthenticationError, NotFoundError, ValidationError, ServerError
+from ._version import __version__
+
+__all__ = ["WaysCloudClient", "WaysCloudError", "AuthenticationError", "NotFoundError", "ValidationError", "ServerError", "__version__"]

wayscloud-0.1.0/wayscloud/_version.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"