konnektr-graph 0.1.1__tar.gz

konnektr_graph-0.1.1/LICENSE

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

konnektr_graph-0.1.1/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: konnektr-graph
+Version: 0.1.1
+Summary: Konnektr Graph SDK for Python
+Author-email: Konnektr <info@konnektr.io>
+Project-URL: Homepage, https://github.com/konnektr-io/graph-client-sdk-python
+Project-URL: Bug Tracker, https://github.com/konnektr-io/graph-client-sdk-python/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: aiohttp>=3.8.0
+Dynamic: license-file
+
+# Konnektr Graph SDK for Python
+
+A powerful, Python SDK for [Konnektr Graph](https://konnektr.io), fully compatible with the Azure Digital Twins API but optimized for the Konnektr ecosystem.
+
+## Features
+
+- **Azure-Free**: No dependencies on Azure libraries.
+- **Synchronous & Asynchronous**: High-performance clients for both threaded and async workflows.
+- **Modular Auth**: Supports OAuth 2.0 Client Credentials, Device Code Flow, and Static Tokens.
+- **Auto-Pagination**: Seamlessly iterate through large query results and resource lists.
+- **Data Models**: Typed dataclasses for Digital Twins, Models, Relationships, and Jobs.
+
+## Installation
+
+```bash
+pip install konnektr-graph
+```
+
+## Quick Start
+
+### Synchronous Client
+
+```python
+from konnektr_graph import KonnektrGraphClient
+from konnektr_graph.auth import ClientSecretCredential
+
+# Authenticate
+cred = ClientSecretCredential(
+    domain="auth.konnektr.io",
+    audience="https://graph.konnektr.io",
+    client_id="YOUR_CLIENT_ID",
+    client_secret="YOUR_CLIENT_SECRET"
+)
+
+# Initialize Client
+client = KonnektrGraphClient("https://your-graph-endpoint.konnektr.io", cred)
+
+# Get a Digital Twin
+twin = client.get_digital_twin("my-twin-id")
+print(twin)
+
+# Query Twins with auto-pagination
+for twin in client.query_twins("SELECT * FROM digitaltwins"):
+    print(twin)
+```
+
+### Asynchronous Client
+
+```python
+import asyncio
+from konnektr_graph.aio import KonnektrGraphClient
+from konnektr_graph.auth import AsyncClientSecretCredential
+
+async def main():
+    cred = AsyncClientSecretCredential(
+        domain="auth.konnektr.io",
+        audience="https://graph.konnektr.io",
+        client_id="...",
+        client_secret="..."
+    )
+    
+    async with KonnektrGraphClient("https://your-graph-endpoint.konnektr.io", cred) as client:
+        twin = await client.get_digital_twin("my-twin-id")
+        print(twin)
+
+asyncio.run(main())
+```
+
+## Authentication Options
+
+- `ClientSecretCredential` / `AsyncClientSecretCredential`: Ideal for server-to-server scenarios.
+- `DeviceCodeCredential` / `AsyncDeviceCodeCredential`: Best for interactive CLI tools.
+- `StaticTokenCredential`: Use when you already have a valid access token.
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

konnektr_graph-0.1.1/README.md

@@ -0,0 +1,77 @@
+# Konnektr Graph SDK for Python
+
+A powerful, Python SDK for [Konnektr Graph](https://konnektr.io), fully compatible with the Azure Digital Twins API but optimized for the Konnektr ecosystem.
+
+## Features
+
+- **Azure-Free**: No dependencies on Azure libraries.
+- **Synchronous & Asynchronous**: High-performance clients for both threaded and async workflows.
+- **Modular Auth**: Supports OAuth 2.0 Client Credentials, Device Code Flow, and Static Tokens.
+- **Auto-Pagination**: Seamlessly iterate through large query results and resource lists.
+- **Data Models**: Typed dataclasses for Digital Twins, Models, Relationships, and Jobs.
+
+## Installation
+
+```bash
+pip install konnektr-graph
+```
+
+## Quick Start
+
+### Synchronous Client
+
+```python
+from konnektr_graph import KonnektrGraphClient
+from konnektr_graph.auth import ClientSecretCredential
+
+# Authenticate
+cred = ClientSecretCredential(
+    domain="auth.konnektr.io",
+    audience="https://graph.konnektr.io",
+    client_id="YOUR_CLIENT_ID",
+    client_secret="YOUR_CLIENT_SECRET"
+)
+
+# Initialize Client
+client = KonnektrGraphClient("https://your-graph-endpoint.konnektr.io", cred)
+
+# Get a Digital Twin
+twin = client.get_digital_twin("my-twin-id")
+print(twin)
+
+# Query Twins with auto-pagination
+for twin in client.query_twins("SELECT * FROM digitaltwins"):
+    print(twin)
+```
+
+### Asynchronous Client
+
+```python
+import asyncio
+from konnektr_graph.aio import KonnektrGraphClient
+from konnektr_graph.auth import AsyncClientSecretCredential
+
+async def main():
+    cred = AsyncClientSecretCredential(
+        domain="auth.konnektr.io",
+        audience="https://graph.konnektr.io",
+        client_id="...",
+        client_secret="..."
+    )
+    
+    async with KonnektrGraphClient("https://your-graph-endpoint.konnektr.io", cred) as client:
+        twin = await client.get_digital_twin("my-twin-id")
+        print(twin)
+
+asyncio.run(main())
+```
+
+## Authentication Options
+
+- `ClientSecretCredential` / `AsyncClientSecretCredential`: Ideal for server-to-server scenarios.
+- `DeviceCodeCredential` / `AsyncDeviceCodeCredential`: Best for interactive CLI tools.
+- `StaticTokenCredential`: Use when you already have a valid access token.
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.

konnektr_graph-0.1.1/konnektr_graph/__init__.py

@@ -0,0 +1,35 @@
+# konnektr_graph/__init__.py
+"""
+Konnektr Graph SDK (Azure-free).
+"""
+from .client import KonnektrGraphClient
+from .exceptions import (
+    KonnektrGraphError,
+    HttpResponseError,
+    ResourceNotFoundError,
+    ResourceExistsError,
+    AuthenticationError,
+    ValidationError,
+)
+from .models import (
+    ImportJob,
+    DeleteJob,
+    DigitalTwinsModelData,
+    IncomingRelationship,
+    QueryResult,
+)
+
+__all__ = [
+    "KonnektrGraphClient",
+    "KonnektrGraphError",
+    "HttpResponseError",
+    "ResourceNotFoundError",
+    "ResourceExistsError",
+    "AuthenticationError",
+    "ValidationError",
+    "ImportJob",
+    "DeleteJob",
+    "DigitalTwinsModelData",
+    "IncomingRelationship",
+    "QueryResult",
+]

konnektr_graph-0.1.1/konnektr_graph/aio/__init__.py

@@ -0,0 +1,7 @@
+# konnektr_graph/aio/__init__.py
+"""
+Async Konnektr Graph SDK.
+"""
+from .client import KonnektrGraphClient
+
+__all__ = ["KonnektrGraphClient"]