facilapp-sql-sdk 1.0.127__tar.gz

facilapp_sql_sdk-1.0.127/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.4
+Name: facilapp-sql-sdk
+Version: 1.0.127
+Summary: SDK oficial em Python para a FacilApp SQL API
+Author: FacilApp
+Keywords: facilapp,sql,api,oauth2
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# FacilApp SQL SDK para Python
+
+```python
+from facilapp_sql import FacilAppSqlClient
+api = FacilAppSqlClient()
+login = api.login_client_secret("CLIENT_ID", "CLIENT_SECRET")
+resultado = api.executar({"funcao": "consultar_sqlserver", "banco": "BANCO", "tabela": "TABELA"})
+```
+
+SDK oficial para Python 3.9+, sem dependências externas. Documentação: https://sql.facilapp.com.br/docs/.

facilapp_sql_sdk-1.0.127/README.md

@@ -0,0 +1,10 @@
+# FacilApp SQL SDK para Python
+
+```python
+from facilapp_sql import FacilAppSqlClient
+api = FacilAppSqlClient()
+login = api.login_client_secret("CLIENT_ID", "CLIENT_SECRET")
+resultado = api.executar({"funcao": "consultar_sqlserver", "banco": "BANCO", "tabela": "TABELA"})
+```
+
+SDK oficial para Python 3.9+, sem dependências externas. Documentação: https://sql.facilapp.com.br/docs/.

facilapp_sql_sdk-1.0.127/pyproject.toml

@@ -0,0 +1,16 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "facilapp-sql-sdk"
+version = "1.0.127"
+description = "SDK oficial em Python para a FacilApp SQL API"
+readme = "README.md"
+requires-python = ">=3.9"
+authors = [{name = "FacilApp"}]
+keywords = ["facilapp", "sql", "api", "oauth2"]
+classifiers = ["Programming Language :: Python :: 3", "License :: Other/Proprietary License", "Operating System :: OS Independent"]
+
+[tool.setuptools.packages.find]
+where = ["src"]

facilapp_sql_sdk-1.0.127/setup.cfg

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

facilapp_sql_sdk-1.0.127/src/facilapp_sql/__init__.py

@@ -0,0 +1,4 @@
+from .client import FacilAppApiError, FacilAppSqlClient
+
+__all__ = ["FacilAppSqlClient", "FacilAppApiError"]
+__version__ = "1.0.127"

facilapp_sql_sdk-1.0.127/src/facilapp_sql/client.py

@@ -0,0 +1,51 @@
+"""Cliente oficial, sem dependências externas, para a FacilApp SQL API."""
+from __future__ import annotations
+import json
+from typing import Any
+from urllib.error import HTTPError, URLError
+from urllib.parse import urlencode
+from urllib.request import Request, urlopen
+
+class FacilAppApiError(RuntimeError):
+    def __init__(self, status_code: int, response_body: str):
+        self.status_code, self.response_body = status_code, response_body
+        super().__init__(f"FacilApp SQL API retornou HTTP {status_code}: {response_body}")
+
+class FacilAppSqlClient:
+    def __init__(self, base_url: str = "https://sql.facilapp.com.br", timeout: float = 30.0):
+        self.base_url, self.timeout, self.access_token = base_url.rstrip("/"), timeout, None
+
+    def status(self) -> dict[str, Any]: return self.request("GET", "/status", authenticated=False)
+    def openapi(self) -> dict[str, Any]: return self.request("GET", "/swagger/v1/swagger.json", authenticated=False)
+
+    def login_client_secret(self, client_id: str, client_secret: str, scope: str | None = None) -> dict[str, Any]:
+        result = self.request("POST", "/oauth/login-simples", json_body={"client_id": client_id, "client_secret": client_secret, "scope": scope}, authenticated=False)
+        self.access_token = result.get("access_token")
+        return result
+
+    def oauth_token(self, client_id: str, client_secret: str, scope: str | None = None) -> dict[str, Any]:
+        form = urlencode({"grant_type": "client_credentials", "client_id": client_id, "client_secret": client_secret, "scope": scope or ""}).encode()
+        result = self.request("POST", "/oauth/token", data=form, content_type="application/x-www-form-urlencoded", authenticated=False)
+        self.access_token = result.get("access_token")
+        return result
+
+    def executar(self, pedido: dict[str, Any]) -> dict[str, Any]: return self.request("POST", "/executar", json_body=pedido)
+
+    def request(self, method: str, path: str, *, json_body: Any = None, data: bytes | None = None,
+                content_type: str = "application/json", authenticated: bool = True) -> Any:
+        headers = {"Accept": "application/json"}
+        if json_body is not None: data = json.dumps(json_body, ensure_ascii=False).encode("utf-8")
+        if data is not None: headers["Content-Type"] = content_type
+        if authenticated:
+            if not self.access_token: raise RuntimeError("Faça o login ou informe access_token antes da chamada autenticada.")
+            headers["Authorization"] = f"Bearer {self.access_token}"
+        req = Request(f"{self.base_url}/{path.lstrip('/')}", data=data, headers=headers, method=method.upper())
+        try:
+            with urlopen(req, timeout=self.timeout) as response:
+                raw = response.read().decode("utf-8")
+                return json.loads(raw) if raw else None
+        except HTTPError as error:
+            body = error.read().decode("utf-8", errors="replace")
+            raise FacilAppApiError(error.code, body) from error
+        except URLError as error:
+            raise ConnectionError(f"Não foi possível acessar {self.base_url}: {error.reason}") from error

facilapp_sql_sdk-1.0.127/src/facilapp_sql_sdk.egg-info/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.4
+Name: facilapp-sql-sdk
+Version: 1.0.127
+Summary: SDK oficial em Python para a FacilApp SQL API
+Author: FacilApp
+Keywords: facilapp,sql,api,oauth2
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# FacilApp SQL SDK para Python
+
+```python
+from facilapp_sql import FacilAppSqlClient
+api = FacilAppSqlClient()
+login = api.login_client_secret("CLIENT_ID", "CLIENT_SECRET")
+resultado = api.executar({"funcao": "consultar_sqlserver", "banco": "BANCO", "tabela": "TABELA"})
+```
+
+SDK oficial para Python 3.9+, sem dependências externas. Documentação: https://sql.facilapp.com.br/docs/.

facilapp_sql_sdk-1.0.127/src/facilapp_sql_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+pyproject.toml
+src/facilapp_sql/__init__.py
+src/facilapp_sql/client.py
+src/facilapp_sql_sdk.egg-info/PKG-INFO
+src/facilapp_sql_sdk.egg-info/SOURCES.txt
+src/facilapp_sql_sdk.egg-info/dependency_links.txt
+src/facilapp_sql_sdk.egg-info/top_level.txt

facilapp_sql_sdk-1.0.127/src/facilapp_sql_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

facilapp_sql_sdk-1.0.127/src/facilapp_sql_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+facilapp_sql