sweb-api 0.1.2__tar.gz

sweb_api-0.1.2/LICENSE

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

sweb_api-0.1.2/PKG-INFO

@@ -0,0 +1,184 @@
+Metadata-Version: 2.4
+Name: sweb-api
+Version: 0.1.2
+Summary: Python client for Sweb.ru API
+Author-email: zullusa <zullusa@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/zullusa/sweb-api
+Project-URL: Repository, https://github.com/zullusa/sweb-api
+Keywords: api,sweb,hosting,vps,domains,json-rpc
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: urllib3>=1.26.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: types-requests; extra == "dev"
+Dynamic: license-file
+
+# SwebClient - Python клиент для API Sweb.ru
+
+Python-клиент для работы с API Sweb.ru через протокол JSON-RPC 2.0.
+
+## Установка
+
+```bash
+pip install sweb-api
+```
+
+## Быстрый старт
+
+```python
+from sweb_api import SwebClient
+
+# Создание клиента с авторизацией
+client = SwebClient("ваш_логин", "ваш_пароль")
+
+# Теперь можно использовать доступные методы
+domains = client.domains.index()
+```
+
+## Конструктор
+
+```python
+SwebClient(login: str, password: str, timeout: int = 30)
+```
+
+Параметры:
+- `login` - логин от личного кабинета Sweb.ru
+- `password` - пароль от личного кабинета Sweb.ru
+- `timeout` - таймаут запросов в секундах (по умолчанию 30)
+
+## Доступные методы
+
+### Виртуальный хостинг
+
+| Свойство | Описание | API раздел |
+|----------|----------|------------|
+| `client.domains` | Управление доменами | domains |
+| `client.domains_bonus` | Доменные бонусы | domains/bonus |
+| `client.domains_persons` | Доменные персоны | domains/persons |
+| `client.domains_dns` | Управление DNS | domains/dns |
+| `client.sites` | Управление сайтами | sites |
+| `client.hosting` | Базы данных (MySQL/PostgreSQL) | vh/hosting |
+| `client.backup` | Резервные копии | vh/backup |
+| `client.mail` | Почтовый сервис | vh/mail |
+| `client.ssl` | SSL-сертификаты | vh/ssl |
+| `client.tariff` | Информация о тарифе | tariff |
+| `client.load` | Нагрузка на сервер | vh/load |
+| `client.utils` | SSH-доступ | vh/utils |
+| `client.cron` | Планировщик задач | vh/cron |
+| `client.disk_usage` | Использование диска | vh/utils/diskUsage |
+| `client.ddg` | Защита от DDOS | vh/ddg |
+
+### VPS
+
+| Свойство | Описание | API раздел |
+|----------|----------|------------|
+| `client.vps` | Управление VPS | vps |
+| `client.vps_backup` | Резервные копии VPS | vps/backup |
+| `client.vps_ssl` | SSL-сертификаты для VPS | vps/ssl |
+| `client.vps_ip` | Локальная сеть | vps/ip |
+| `client.vps_protected_ip` | Защищённые IP-адреса | vps/protected-ip |
+| `client.vps_dbaas` | DBaaS ( Managed PostgreSQL) | vps/dbaas |
+| `client.vps_balancer` | Балансировщик | vps/balancer |
+| `client.vps_remote_backup` | Облачные бэкапы | vps/remote-backup |
+| `client.vps_monitoring` | Мониторинг | vps/monitoring |
+| `client.vps_monitoring_checks` | Проверки мониторинга | vps/monitoring/checks |
+| `client.vps_monitoring_contacts` | Контакты мониторинга | vps/monitoring/contacts |
+
+### Оплата и финансы
+
+| Свойство | Описание | API раздел |
+|----------|----------|------------|
+| `client.pay` | Баланс и платежи | pay |
+
+## Примеры использования
+
+### Получение списка доменов
+
+```python
+from sweb_api import SwebClient
+
+client = SwebClient("логин", "пароль")
+domains = client.domains.index()
+print(domains)
+```
+
+### Информация о тарифе
+
+```python
+client = SwebClient("логин", "пароль")
+tariff_info = client.tariff.serverInfo()
+print(tariff_info)
+```
+
+### Управление VPS
+
+```python
+client = SwebClient("логин", "пароль")
+
+# Получить список VPS
+vps_list = client.vps.index()
+
+# Включить VPS
+client.vps.powerOn(vps_id=123)
+
+# Выключить VPS
+client.vps.powerOff(vps_id=123)
+```
+
+### Работа с базами данных
+
+```python
+client = SwebClient("логин", "пароль")
+
+# Список баз данных
+databases = client.hosting.databaseGetList()
+
+# Создать базу данных
+client.hosting.databaseMysqlCreatedbname="new_db", user="user", password="pass")
+```
+
+### Работа с почтой
+
+```python
+client = SwebClient("логин", "пароль")
+
+# Список почтовых ящиков
+mailboxes = client.mail.getMailboxesList()
+
+# Создать почтовый ящик
+client.mail.createMbox(name="info", domain="example.ru", password="secret")
+```
+
+## Обработка ошибок
+
+```python
+from sweb_api import SwebClient
+from sweb_api.exceptions import AuthenticationError
+
+try:
+    client = SwebClient("логин", "пароль")
+except AuthenticationError as e:
+    print(f"Ошибка авторизации: {e}")
+```
+
+## Требования
+
+- Python 3.8+
+- requests >= 2.28.0
+- urllib3 >= 1.26.0

sweb_api-0.1.2/README.md

@@ -0,0 +1,153 @@
+# SwebClient - Python клиент для API Sweb.ru
+
+Python-клиент для работы с API Sweb.ru через протокол JSON-RPC 2.0.
+
+## Установка
+
+```bash
+pip install sweb-api
+```
+
+## Быстрый старт
+
+```python
+from sweb_api import SwebClient
+
+# Создание клиента с авторизацией
+client = SwebClient("ваш_логин", "ваш_пароль")
+
+# Теперь можно использовать доступные методы
+domains = client.domains.index()
+```
+
+## Конструктор
+
+```python
+SwebClient(login: str, password: str, timeout: int = 30)
+```
+
+Параметры:
+- `login` - логин от личного кабинета Sweb.ru
+- `password` - пароль от личного кабинета Sweb.ru
+- `timeout` - таймаут запросов в секундах (по умолчанию 30)
+
+## Доступные методы
+
+### Виртуальный хостинг
+
+| Свойство | Описание | API раздел |
+|----------|----------|------------|
+| `client.domains` | Управление доменами | domains |
+| `client.domains_bonus` | Доменные бонусы | domains/bonus |
+| `client.domains_persons` | Доменные персоны | domains/persons |
+| `client.domains_dns` | Управление DNS | domains/dns |
+| `client.sites` | Управление сайтами | sites |
+| `client.hosting` | Базы данных (MySQL/PostgreSQL) | vh/hosting |
+| `client.backup` | Резервные копии | vh/backup |
+| `client.mail` | Почтовый сервис | vh/mail |
+| `client.ssl` | SSL-сертификаты | vh/ssl |
+| `client.tariff` | Информация о тарифе | tariff |
+| `client.load` | Нагрузка на сервер | vh/load |
+| `client.utils` | SSH-доступ | vh/utils |
+| `client.cron` | Планировщик задач | vh/cron |
+| `client.disk_usage` | Использование диска | vh/utils/diskUsage |
+| `client.ddg` | Защита от DDOS | vh/ddg |
+
+### VPS
+
+| Свойство | Описание | API раздел |
+|----------|----------|------------|
+| `client.vps` | Управление VPS | vps |
+| `client.vps_backup` | Резервные копии VPS | vps/backup |
+| `client.vps_ssl` | SSL-сертификаты для VPS | vps/ssl |
+| `client.vps_ip` | Локальная сеть | vps/ip |
+| `client.vps_protected_ip` | Защищённые IP-адреса | vps/protected-ip |
+| `client.vps_dbaas` | DBaaS ( Managed PostgreSQL) | vps/dbaas |
+| `client.vps_balancer` | Балансировщик | vps/balancer |
+| `client.vps_remote_backup` | Облачные бэкапы | vps/remote-backup |
+| `client.vps_monitoring` | Мониторинг | vps/monitoring |
+| `client.vps_monitoring_checks` | Проверки мониторинга | vps/monitoring/checks |
+| `client.vps_monitoring_contacts` | Контакты мониторинга | vps/monitoring/contacts |
+
+### Оплата и финансы
+
+| Свойство | Описание | API раздел |
+|----------|----------|------------|
+| `client.pay` | Баланс и платежи | pay |
+
+## Примеры использования
+
+### Получение списка доменов
+
+```python
+from sweb_api import SwebClient
+
+client = SwebClient("логин", "пароль")
+domains = client.domains.index()
+print(domains)
+```
+
+### Информация о тарифе
+
+```python
+client = SwebClient("логин", "пароль")
+tariff_info = client.tariff.serverInfo()
+print(tariff_info)
+```
+
+### Управление VPS
+
+```python
+client = SwebClient("логин", "пароль")
+
+# Получить список VPS
+vps_list = client.vps.index()
+
+# Включить VPS
+client.vps.powerOn(vps_id=123)
+
+# Выключить VPS
+client.vps.powerOff(vps_id=123)
+```
+
+### Работа с базами данных
+
+```python
+client = SwebClient("логин", "пароль")
+
+# Список баз данных
+databases = client.hosting.databaseGetList()
+
+# Создать базу данных
+client.hosting.databaseMysqlCreatedbname="new_db", user="user", password="pass")
+```
+
+### Работа с почтой
+
+```python
+client = SwebClient("логин", "пароль")
+
+# Список почтовых ящиков
+mailboxes = client.mail.getMailboxesList()
+
+# Создать почтовый ящик
+client.mail.createMbox(name="info", domain="example.ru", password="secret")
+```
+
+## Обработка ошибок
+
+```python
+from sweb_api import SwebClient
+from sweb_api.exceptions import AuthenticationError
+
+try:
+    client = SwebClient("логин", "пароль")
+except AuthenticationError as e:
+    print(f"Ошибка авторизации: {e}")
+```
+
+## Требования
+
+- Python 3.8+
+- requests >= 2.28.0
+- urllib3 >= 1.26.0

sweb_api-0.1.2/pyproject.toml

@@ -0,0 +1,68 @@
+[build-system]
+requires = ["setuptools>=65.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sweb-api"
+version = "0.1.2"
+description = "Python client for Sweb.ru API"
+readme = "README.md"
+authors = [
+    {name = "zullusa", email = "zullusa@gmail.com"}
+]
+license = "MIT"
+requires-python = ">=3.8"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+keywords = ["api", "sweb", "hosting", "vps", "domains", "json-rpc"]
+dependencies = [
+    "requests>=2.28.0",
+    "urllib3>=1.26.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "black>=23.0.0",
+    "flake8>=6.0.0",
+    "mypy>=1.0.0",
+    "types-requests",
+]
+
+[project.urls]
+Homepage = "https://github.com/zullusa/sweb-api"
+Repository = "https://github.com/zullusa/sweb-api"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["sweb_api*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = "test_*.py"
+python_classes = "Test*"
+python_functions = "test_*"
+addopts = "-v --tb=short"
+
+[tool.black]
+line-length = 100
+
+[tool.flake8]
+max-line-length = 100
+target-version = ["py310", "py311", "py312", "py313", "py314"]
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false
+ignore_missing_imports = true

sweb_api-0.1.2/setup.cfg

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

sweb_api-0.1.2/sweb_api/__init__.py

@@ -0,0 +1,164 @@
+from typing import Any
+
+from sweb_api.http.client import JSONRPCClient
+from sweb_api.api.domains import DomainsAPI, DomainsBonusAPI, DomainsPersonsAPI, DomainsDNSAPI
+from sweb_api.api.vh import (
+    SitesAPI,
+    HostingAPI,
+    BackupAPI,
+    MailAPI,
+    SSLAPI,
+    TariffAPI,
+    LoadAPI,
+    UtilsAPI,
+    CronAPI,
+    DDGAPI,
+    DiskUsageAPI,
+)
+from sweb_api.api.vps import (
+    VPSAPI,
+    VPSBackupAPI,
+    VPSSSLAPI,
+    VPSIPAPI,
+    VPSProtectedIPAPI,
+    VPSDBaaSAPI,
+    VPSBalancerAPI,
+    VPSRemoteBackupAPI,
+    VPSMonitoringAPI,
+    VPSMonitoringChecksAPI,
+    VPSMonitoringContactsAPI,
+)
+from sweb_api.api.pay import PayAPI
+from sweb_api.exceptions.exceptions import AuthenticationError
+
+
+class SwebClient:
+    BASE_URL = "https://api.sweb.ru"
+
+    def __init__(self, login: str, password: str, timeout: int = 30):
+        self._login = login
+        self._password = password
+        self._client = JSONRPCClient(self.BASE_URL, timeout)
+        self._token = self._authenticate()
+        self._client.set_token(self._token)
+
+    def _authenticate(self) -> Any:
+        client = JSONRPCClient(f"{self.BASE_URL}/notAuthorized")
+        try:
+            params = {"login": self._login, "password": self._password}
+            result = client.call("getToken", params)  # type: ignore[arg-type]
+            if not result or not isinstance(result, str):
+                raise AuthenticationError("Invalid token received")
+            return result
+        except Exception as e:
+            if isinstance(e, AuthenticationError):
+                raise
+            raise AuthenticationError(f"Failed to authenticate: {e}")
+
+    @property
+    def domains(self) -> DomainsAPI:
+        return DomainsAPI(self._client, "domains")
+
+    @property
+    def domains_bonus(self) -> DomainsBonusAPI:
+        return DomainsBonusAPI(self._client, "domains/bonus")
+
+    @property
+    def domains_persons(self) -> DomainsPersonsAPI:
+        return DomainsPersonsAPI(self._client, "domains/persons")
+
+    @property
+    def domains_dns(self) -> DomainsDNSAPI:
+        return DomainsDNSAPI(self._client, "domains/dns")
+
+    @property
+    def sites(self) -> SitesAPI:
+        return SitesAPI(self._client, "sites")
+
+    @property
+    def hosting(self) -> HostingAPI:
+        return HostingAPI(self._client, "vh/hosting")
+
+    @property
+    def backup(self) -> BackupAPI:
+        return BackupAPI(self._client, "vh/backup")
+
+    @property
+    def mail(self) -> MailAPI:
+        return MailAPI(self._client, "vh/mail")
+
+    @property
+    def ssl(self) -> SSLAPI:
+        return SSLAPI(self._client, "vh/ssl")
+
+    @property
+    def tariff(self) -> TariffAPI:
+        return TariffAPI(self._client, "tariff")
+
+    @property
+    def load(self) -> LoadAPI:
+        return LoadAPI(self._client, "vh/load")
+
+    @property
+    def utils(self) -> UtilsAPI:
+        return UtilsAPI(self._client, "vh/utils")
+
+    @property
+    def cron(self) -> CronAPI:
+        return CronAPI(self._client, "vh/cron")
+
+    @property
+    def disk_usage(self) -> DiskUsageAPI:
+        return DiskUsageAPI(self._client, "vh/utils/diskUsage")
+
+    @property
+    def ddg(self) -> DDGAPI:
+        return DDGAPI(self._client, "vh/ddg")
+
+    @property
+    def vps(self) -> VPSAPI:
+        return VPSAPI(self._client, "vps")
+
+    @property
+    def vps_backup(self) -> VPSBackupAPI:
+        return VPSBackupAPI(self._client, "vps/backup")
+
+    @property
+    def vps_ssl(self) -> VPSSSLAPI:
+        return VPSSSLAPI(self._client, "vps/ssl")
+
+    @property
+    def vps_ip(self) -> VPSIPAPI:
+        return VPSIPAPI(self._client, "vps/ip")
+
+    @property
+    def vps_protected_ip(self) -> VPSProtectedIPAPI:
+        return VPSProtectedIPAPI(self._client, "vps/protected-ip")
+
+    @property
+    def vps_dbaas(self) -> VPSDBaaSAPI:
+        return VPSDBaaSAPI(self._client, "vps/dbaas")
+
+    @property
+    def vps_balancer(self) -> VPSBalancerAPI:
+        return VPSBalancerAPI(self._client, "vps/balancer")
+
+    @property
+    def vps_remote_backup(self) -> VPSRemoteBackupAPI:
+        return VPSRemoteBackupAPI(self._client, "vps/remote-backup")
+
+    @property
+    def vps_monitoring(self) -> VPSMonitoringAPI:
+        return VPSMonitoringAPI(self._client, "vps/monitoring")
+
+    @property
+    def vps_monitoring_checks(self) -> VPSMonitoringChecksAPI:
+        return VPSMonitoringChecksAPI(self._client, "vps/monitoring/checks")
+
+    @property
+    def vps_monitoring_contacts(self) -> VPSMonitoringContactsAPI:
+        return VPSMonitoringContactsAPI(self._client, "vps/monitoring/contacts")
+
+    @property
+    def pay(self) -> PayAPI:
+        return PayAPI(self._client, "pay")

sweb_api-0.1.2/sweb_api/api/base.py

@@ -0,0 +1,14 @@
+from typing import Any, Optional
+from sweb_api.http.client import JSONRPCClient
+
+
+class BaseAPI:
+    def __init__(self, client: JSONRPCClient, endpoint: str):
+        self._client = client
+        self._endpoint = endpoint
+
+    def _call(self, method: str, params: Optional[dict] = None) -> Any:
+        return self._client.call(self._endpoint, method, params)
+
+    def index(self, params: Optional[dict] = None) -> Any:
+        return self._call("index", params)