xarra-sdk 1.0.0__tar.gz

xarra_sdk-1.0.0/LICENSE

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

xarra_sdk-1.0.0/PKG-INFO

@@ -0,0 +1,47 @@
+Metadata-Version: 2.4
+Name: xarra-sdk
+Version: 1.0.0
+Summary: Python SDK for the Xarra Analytics Platform
+Home-page: https://xarra.dev
+Author: Xarra Team
+Author-email: Xarra Team <support@xarra.dev>
+License: MIT
+Project-URL: Homepage, https://xarra.dev
+Project-URL: Documentation, https://docs.xarra.dev
+Project-URL: Repository, https://github.com/xarra/xarra-sdk
+Project-URL: Issues, https://github.com/xarra/xarra-sdk/issues
+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.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: isort>=5.10.0; extra == "dev"
+Requires-Dist: mypy>=0.990; extra == "dev"
+Provides-Extra: pandas
+Requires-Dist: pandas>=1.3.0; extra == "pandas"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# dataergy-flux
+
+Python SDK for the Dataergy Dashy Analytics Platform.
+
+## Installation
+
+```bash
+pip install dataergy-flux

xarra_sdk-1.0.0/README.md

@@ -0,0 +1,8 @@
+# dataergy-flux
+
+Python SDK for the Dataergy Dashy Analytics Platform.
+
+## Installation
+
+```bash
+pip install dataergy-flux

xarra_sdk-1.0.0/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "xarra-sdk"
+version = "1.0.0"
+description = "Python SDK for the Xarra Analytics Platform"
+readme = "README.md"
+authors = [
+    {name = "Xarra Team", email = "support@xarra.dev"}
+]
+license = {text = "MIT"}
+requires-python = ">=3.8"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "requests>=2.25.0",
+]
+
+[project.urls]
+Homepage = "https://xarra.dev"
+Documentation = "https://docs.xarra.dev"
+Repository = "https://github.com/xarra/xarra-sdk"
+Issues = "https://github.com/xarra/xarra-sdk/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "black>=22.0.0",
+    "isort>=5.10.0",
+    "mypy>=0.990",
+]
+pandas = ["pandas>=1.3.0"]
+
+[tool.setuptools.packages.find]
+include = ["xarra_sdk*"]
+exclude = ["examples*", "test*", "test_*"]
+
+[tool.black]
+line-length = 100
+target-version = ["py38", "py39", "py310", "py311", "py312"]
+
+[tool.isort]
+profile = "black"
+line_length = 100
+
+[tool.mypy]
+python_version = "3.8"
+warn_return_any = true
+warn_unused_configs = true
+ignore_missing_imports = true

xarra_sdk-1.0.0/setup.cfg

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

xarra_sdk-1.0.0/setup.py

@@ -0,0 +1,41 @@
+# setup.py
+from setuptools import setup, find_packages
+
+setup(
+    name="xarra-sdk",
+    version="1.0.0",
+    description="Python SDK for the Xarra Analytics Platform",
+    author="Xarra Team",
+    author_email="support@xarra.dev",
+    url="https://xarra.dev",
+    packages=find_packages(include=["xarra_sdk*"]),
+    package_dir={"": "."},
+    install_requires=[
+        "requests>=2.25.0",
+    ],
+    extras_require={
+        "dev": [
+            "pytest>=7.0.0",
+            "pytest-cov>=4.0.0",
+            "black>=22.0.0",
+            "isort>=5.10.0",
+            "mypy>=0.990",
+        ],
+        "pandas": ["pandas>=1.3.0"],
+    },
+    python_requires=">=3.8",
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+    ],
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+)

xarra_sdk-1.0.0/xarra_sdk/__init__.py

@@ -0,0 +1,101 @@
+# src/xarra_sdk/__init__.py
+
+"""
+Xarra SDK - Python client for the Xarra Analytics Platform.
+
+The Xarra SDK provides a simple Python interface for:
+- Querying analytics data (product models)
+- Querying XRM models (custom data models)
+- Natural language queries (NLQ) for both XPM and XRM
+- Ingesting events
+- Managing apps and API keys
+- Accessing model definitions and documentation
+
+Example:
+    from xarra_sdk import XarraClient
+
+    client = XarraClient(api_key="xr_tst_xxx")
+
+    # XPM Query (Product Models)
+    result = client.xpm_query(
+        app="app_key",
+        model="transactions",
+        query="amount:sum;currency:group"
+    )
+
+    # XRM Query (Relational Models)
+    result = client.xrm_query(
+        model_id="550e8400-e29b-41d4-a716-446655440000",
+        query="orders.amount:sum"
+    )
+
+    # XPM Natural Language Query
+    result = client.xpm_nlq(
+        app="app_key",
+        model="transactions",
+        query="Why did my revenue drop last month?"
+    )
+
+    # XRM Natural Language Query
+    result = client.xrm_nlq(
+        model_id="550e8400-e29b-41d4-a716-446655440000",
+        query="Which customers generated the most revenue this quarter?"
+    )
+
+    for row in result.rows:
+        print(row)
+"""
+
+from .client import XarraClient
+from .models import (
+    QueryResult,
+    BatchQueryResult,
+    App,
+    IngestionResult,
+    ModelDefinition,
+    Column,
+    Aggregator,
+    XRMModel,
+    RateLimitInfo,
+    NLQResult,
+)
+from .exceptions import (
+    XarraError,
+    AuthenticationError,
+    RateLimitError,
+    ValidationError,
+    NotFoundError,
+    ServerError,
+    TimeoutError,
+    IngestionError,
+    QueryError,
+    NLQError,
+)
+
+__version__ = "1.0.0"
+__all__ = [
+    # Client
+    "XarraClient",
+    # Models
+    "QueryResult",
+    "BatchQueryResult",
+    "App",
+    "IngestionResult",
+    "ModelDefinition",
+    "Column",
+    "Aggregator",
+    "XRMModel",
+    "RateLimitInfo",
+    "NLQResult",
+    # Exceptions
+    "XarraError",
+    "AuthenticationError",
+    "RateLimitError",
+    "ValidationError",
+    "NotFoundError",
+    "ServerError",
+    "TimeoutError",
+    "IngestionError",
+    "QueryError",
+    "NLQError",
+]