SCPYTSDK 0.1.0__tar.gz

scpytsdk-0.1.0/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.3
+Name: SCPYTSDK
+Version: 0.1.0
+Summary: Super Cool Python SDK for Turso Platform API
+Author: FrancyAngy
+Author-email: FrancyAngy <francesco@scsdc-co.org>
+Requires-Dist: pyjwt>=2.13.0
+Requires-Dist: requests>=2.34.2
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+
+# PYTSDK
+This is an sdk for the [Turso Platform API](https://docs.turso.tech/api-reference/introduction) which I decided to make since there previously was none.

scpytsdk-0.1.0/README.md

@@ -0,0 +1,2 @@
+# PYTSDK
+This is an sdk for the [Turso Platform API](https://docs.turso.tech/api-reference/introduction) which I decided to make since there previously was none.

scpytsdk-0.1.0/pyproject.toml

@@ -0,0 +1,18 @@
+[project]
+name = "SCPYTSDK"
+version = "0.1.0"
+description = "Super Cool Python SDK for Turso Platform API"
+readme = "README.md"
+requires-python = ">=3.14"
+dependencies = [
+    "pyjwt>=2.13.0",
+    "requests>=2.34.2",
+]
+
+[[project.authors]]
+name = "FrancyAngy"
+email = "francesco@scsdc-co.org"
+
+[build-system]
+requires = ["uv_build>=0.12.5,<0.13.0"]
+build-backend = "uv_build"

scpytsdk-0.1.0/pyproject.toml.orig

@@ -0,0 +1,17 @@
+[project]
+name = "SCPYTSDK"
+version = "0.1.0"
+description = "Super Cool Python SDK for Turso Platform API"
+readme = "README.md"
+authors = [
+    { name = "FrancyAngy", email = "francesco@scsdc-co.org" }
+]
+requires-python = ">=3.14"
+dependencies = [
+    "pyjwt>=2.13.0",
+    "requests>=2.34.2",
+]
+
+[build-system]
+requires = ["uv_build>=0.12.5,<0.13.0"]
+build-backend = "uv_build"

scpytsdk-0.1.0/src/scpytsdk/__init__.py

@@ -0,0 +1,92 @@
+import requests
+from scpytsdk.classes import Database
+from scpytsdk.exceptions import InvalidApikey, InvalidOrganization, DatabaseNotFound
+
+class SCPYTSDK:
+    _endpoint: str = "https://api.turso.tech"
+    _apikey: str = ""
+    _organization: str = ""
+    _headers: dict = {}
+
+    def __init__(self, apikey: str, organization_slug: str, endpoint: str = "https://api.turso.tech"):
+        if apikey == "":
+            raise InvalidApikey
+
+        if organization_slug == "":
+            raise InvalidOrganization
+
+        self._endpoint = endpoint
+
+        r = requests.get(f"{endpoint}/v1/auth/validate", headers={"Authorization": f"Bearer {apikey}"})
+
+        if r.status_code != 200:
+            print(r.status_code)
+            print(dict(r.json()))
+            raise InvalidApikey
+
+        self._apikey = apikey
+
+        if requests.get(f"{endpoint}/v1/organizations/{organization_slug}", headers={"Authorization": f"Bearer {apikey}"}).status_code != 200:
+            raise InvalidOrganization
+        
+        self._organization = organization_slug
+
+        self._headers = {"Authorization": f"Bearer {apikey}"}
+
+    def list_dbs(self, group_filter: str | None = None, schema_filter: str | None = None, parent_filter: str | Database | None = None) -> list[Database]:
+        filters = ""
+
+        if group_filter:
+            filters += f"?group={group_filter}"
+
+        if schema_filter:
+            if filters == "":
+                filters += "?"
+            else:
+                filters += "&"
+
+            filters += f"schema={schema_filter}"
+
+        if parent_filter:
+            if filters == "":
+                filters += "?"
+            else:
+                filters += "&"
+
+            if isinstance(parent_filter, Database):
+                filters += f"parent={parent_filter.DbId}"
+            else:
+                filters += f"parent={parent_filter}"
+
+        r = requests.get(f"{self._endpoint}/v1/organizations/{self._organization}/databases{filters}", headers=self._headers)
+        
+        json = r.json()
+
+        dbs: list[Database] = []
+
+        for db_json in json["databases"]:
+            dbs += [Database(**db_json)]
+
+        return dbs
+
+    def delete_db(self, database: str | Database) -> None:
+        r = requests.Response()
+        
+        if isinstance(database, Database):
+            r = requests.delete(f"https://api.turso.tech/v1/organizations/{self._organization}/databases/{database.Name}", headers=self._headers)
+        else:
+            r = requests.delete(f"https://api.turso.tech/v1/organizations/{self._organization}/databases/{database}", headers=self._headers)
+
+        if r.status_code == 404:
+            raise DatabaseNotFound()
+
+        return
+
+    def retreive_db(self, database: str | Database) -> Database:
+        r = requests.Response()
+        if isinstance(database, Database):
+            r = requests.get(f"{self._endpoint}/v1/organizations/{self._organization}/databases/{database.Name}")
+        else:
+            r = requests.get(f"{self._endpoint}/v1/organizations/{self._organization}/databases/{database.Name}")
+
+        return Database(r.json()["database"])

scpytsdk-0.1.0/src/scpytsdk/classes.py

@@ -0,0 +1,47 @@
+from uuid import UUID
+from dataclasses import dataclass, fields
+from scpytsdk.enums import Region
+from enum import Enum
+from typing import get_args, get_origin, get_type_hints
+
+def _convert_value(value, target_type):
+    if isinstance(target_type, type) and issubclass(target_type, Enum):
+        if not isinstance(value, target_type):
+            return target_type(value)
+        return value
+
+    origin = get_origin(target_type)
+    args = get_args(target_type)
+
+    if origin is list and args:
+        item_type = args[0]
+        return [_convert_value(item, item_type) for item in value]
+
+    return value
+
+@dataclass(init=False)
+class Database:
+    Name: str
+    DbId: UUID
+    Hostname: str
+    block_reads: bool
+    block_writes: bool
+    delete_protection: bool
+    regions: list[Region]
+    primaryRegion: Region
+    group: str
+
+    def __init__(self, **kwargs):
+        type_hints = get_type_hints(type(self))
+
+        for field in fields(self):
+            if field.name not in kwargs:
+                continue
+
+            value = kwargs[field.name]
+            field_type = type_hints.get(field.name, field.type)
+
+            value = _convert_value(value, field_type)
+
+            setattr(self, field.name, value)
+

scpytsdk-0.1.0/src/scpytsdk/enums.py

@@ -0,0 +1,16 @@
+from enum import Enum
+
+class Region(str, Enum):
+    AWS_TOKYO    = "aws-ap-northeast-1"
+    AWS_MUMBAI   = "aws-ap-south-1"
+    AWS_IRELAND  = "aws-eu-west-1"
+    AWS_VIRGINIA = "aws-us-east-1"
+    AWS_OHIO     = "aws-us-east-2"
+    AWS_OREGON   = "aws-us-west-1"
+
+    @classmethod
+    def _missing_(cls, value):
+        unknown = str.__new__(cls, value)
+        unknown._name_ = "UNKNOWN"
+        unknown._value_ = value
+        return unknown

scpytsdk-0.1.0/src/scpytsdk/exceptions.py

@@ -0,0 +1,8 @@
+class DatabaseNotFound(Exception):
+    pass
+
+class InvalidApikey(Exception):
+    pass
+
+class InvalidOrganization(Exception):
+    pass