cvec 1.5.0__tar.gz → 1.5.2__tar.gz

cvec-1.5.2/.claude/settings.json

@@ -0,0 +1,51 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "uv run python-claude session start"
+          },
+          {
+            "type": "command",
+            "command": "uv run python-claude git status"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "uv run python-claude ruff format"
+          },
+          {
+            "type": "command",
+            "command": "uv run python-claude ruff check"
+          },
+          {
+            "type": "command",
+            "command": "uv run python-claude mypy"
+          },
+          {
+            "type": "command",
+            "command": "uv run python-claude pytest"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "uv run python-claude edited"
+          }
+        ]
+      }
+    ]
+  }
+}

cvec-1.5.2/.claude/settings.local.json

@@ -0,0 +1,28 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(chmod:*)",
+      "Bash(python:*)",
+      "Bash(git commit:*)",
+      "Bash(pytest:*)",
+      "Bash(python3 -m pytest:*)",
+      "Bash(poetry run pytest:*)",
+      "Bash(git add:*)",
+      "Bash(poetry run mypy:*)",
+      "Bash(git checkout:*)",
+      "Bash(poetry run ruff:*)",
+      "Bash(poetry install:*)",
+      "Bash(tree:*)",
+      "Bash(git mv:*)",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:pypi.org)",
+      "Bash(poetry run python:*)",
+      "Bash(poetry add:*)",
+      "Bash(git fetch:*)",
+      "Bash(git rebase:*)",
+      "Bash(git rm:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

cvec-1.5.2/.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: Continuous Integration
+
+on:
+  pull_request:
+    paths:
+      - .github/workflows/ci.yml
+      - uv.lock
+      - pyproject.toml
+      - src/**
+      - tests/**
+  push:
+    paths:
+      - .github/workflows/ci.yml
+      - uv.lock
+      - pyproject.toml
+      - src/**
+      - tests/**
+
+jobs:
+  build:
+    runs-on: ubuntu-24.04
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+
+      - uses: CVector-Energy/python-test@uv
+        with:
+          python-version: ${{ matrix.python-version }}
+          src-dirs: .

cvec-1.5.2/.github/workflows/license-check-python.yml

@@ -0,0 +1,17 @@
+name: Python License Check
+
+on:
+  push:
+
+jobs:
+  license-check:
+    runs-on: ubuntu-24.04
+
+    steps:
+      - uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3 # v6.0.0
+
+      - name: Check Python licenses
+        uses: CVector-Energy/pyproject-license-check@main
+        with:
+          app-id: ${{ vars.APP_ID }}
+          app-private-key: ${{ secrets.APP_PRIVATE_KEY }}

cvec-1.5.2/.github/workflows/pyproject-license-check.yml

@@ -0,0 +1,17 @@
+name: Python License Check
+
+on:
+  push:
+
+jobs:
+  license-check:
+    runs-on: ubuntu-24.04
+
+    steps:
+      - uses: actions/checkout@1af3b93b6815bc44a9784bd300feb67ff0d1eeb3 # v6.0.0
+
+      - name: Check Python licenses
+        uses: CVector-Energy/pyproject-license-check@main
+        with:
+          app-id: ${{ vars.APP_ID }}
+          app-private-key: ${{ secrets.APP_PRIVATE_KEY }}

cvec-1.5.2/.gitignore

@@ -0,0 +1,177 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+.aider*
+
+.vscode/

cvec-1.5.2/CLAUDE.md

@@ -0,0 +1 @@
+- Name files for their main export, transforming Python names from PascalCase to underscore_case. For example, the file that defines the EAVFilter class should be named eav_filter.py.

{cvec-1.5.0 → cvec-1.5.2}/PKG-INFO

@@ -1,22 +1,23 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: cvec
-Version: 1.5.0
+Version: 1.5.2
 Summary: SDK for CVector Energy
-License: MIT
-Author: CVector
-Author-email: support@cvector.energy
-Requires-Python: >=3.10
+Author-email: CVector <support@cvector.energy>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Intended Audience :: Developers
 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-Dist: pyarrow (>=22.0.0)
-Requires-Dist: pydantic (>=2.12.0)
+Requires-Python: >=3.10
+Requires-Dist: brotli<2,>=1.2.0
+Requires-Dist: pyarrow>=22.0.0
+Requires-Dist: pydantic>=2.12.0
 Description-Content-Type: text/markdown
 
 # CVec Client Library
@@ -404,4 +405,3 @@ rows = cvec.select_from_eav_id(
 for row in rows:
     print(f"ID: {row['id']}, Values: {row}")
 ```
-

cvec-1.5.2/examples/add_agent_post_example.py

@@ -0,0 +1,52 @@
+import os
+import uuid
+
+from cvec import CVec
+from cvec.models.agent_post import AgentPostRecommendation, AgentPostTag, Severity
+
+
+def main() -> None:
+    # Initialize CVec client
+    cvec = CVec(
+        host=os.environ.get("CVEC_HOST", "https://your-subdomain.cvector.dev"),
+        api_key=os.environ.get("CVEC_API_KEY", "your-api-key"),
+    )
+
+    recommendations = [
+        AgentPostRecommendation(
+            content="Critical recommendation",
+            severity=Severity.CRITICAL,
+        ),
+        AgentPostRecommendation(
+            content="Warning recommendation",
+            severity=Severity.WARNING,
+        ),
+        AgentPostRecommendation(
+            content="Info recommendation",
+            severity=Severity.INFO,
+        ),
+    ]
+
+    tags = [
+        AgentPostTag(
+            content="urgent",
+            severity=Severity.CRITICAL,
+        ),
+        AgentPostTag(
+            content="monitoring",
+            severity=Severity.INFO,
+        ),
+    ]
+
+    cvec.add_agent_post(
+        title="Test post",
+        author="Operational Agent",
+        image_id=str(uuid.uuid4()),  # Replace with actual image UUID uploaded to S3
+        content="SDK add post test.",
+        recommendations=recommendations,
+        tags=tags,
+    )
+
+
+if __name__ == "__main__":
+    main()

cvec-1.5.2/examples/add_metric_data_arrow_example.py

@@ -0,0 +1,34 @@
+from cvec import CVec
+from cvec.models.metric import MetricDataPoint
+from datetime import datetime, timezone
+import random
+import os
+
+
+def main() -> None:
+    cvec = CVec(
+        host=os.environ.get("CVEC_HOST", "https://your-subdomain.cvector.dev"),
+        api_key=os.environ.get("CVEC_API_KEY", "your-api-key"),
+    )
+    test_metric_name = "python-sdk/test"
+    print("\nAdding new metric data using Arrow...")
+    new_data = [
+        MetricDataPoint(
+            name=test_metric_name,
+            time=datetime.now(timezone.utc),
+            value_double=random.random() * 100.0,
+            value_string=None,
+        ),
+        MetricDataPoint(
+            name=test_metric_name,
+            time=datetime.now(timezone.utc),
+            value_double=random.random() * 100.0,
+            value_string=None,
+        ),
+    ]
+    cvec.add_metric_data(new_data, use_arrow=True)
+    print("Data added successfully")
+
+
+if __name__ == "__main__":
+    main()

cvec-1.5.2/examples/add_metric_data_example.py

@@ -0,0 +1,34 @@
+from cvec import CVec
+from cvec.models.metric import MetricDataPoint
+from datetime import datetime, timezone
+import random
+import os
+
+
+def main() -> None:
+    cvec = CVec(
+        host=os.environ.get("CVEC_HOST", "https://your-subdomain.cvector.dev"),
+        api_key=os.environ.get("CVEC_API_KEY", "your-api-key"),
+    )
+    test_metric_name = "python-sdk/test"
+    print("\nAdding new metric data...")
+    new_data = [
+        MetricDataPoint(
+            name=test_metric_name,
+            time=datetime.now(timezone.utc),
+            value_double=random.random() * 100.0,
+            value_string=None,
+        ),
+        MetricDataPoint(
+            name=test_metric_name,
+            time=datetime.now(timezone.utc),
+            value_double=random.random() * 100.0,
+            value_string=None,
+        ),
+    ]
+    cvec.add_metric_data(new_data, use_arrow=False)
+    print("Data added successfully")
+
+
+if __name__ == "__main__":
+    main()

cvec-1.5.2/examples/add_multiple_metrics_and_get_spans_for_them.py

@@ -0,0 +1,127 @@
+import random
+from cvec import CVec
+from datetime import datetime, timedelta, timezone
+import os
+import io
+import pyarrow.ipc as ipc  # type: ignore[import-untyped]
+
+from cvec.models.metric import MetricDataPoint
+
+
+def main() -> None:
+    cvec = CVec(
+        host=os.environ.get("CVEC_HOST", "https://your-subdomain.cvector.dev"),
+        api_key=os.environ.get("CVEC_API_KEY", "your-api-key"),
+    )
+    test_metric_name = ""
+
+    # fetch & pick metrics
+    metrics = cvec.get_metrics(
+        start_at=datetime(2025, 7, 14, 10, 0, 0),
+        end_at=datetime(2025, 7, 14, 11, 0, 0),
+    )
+    print(f"Found {len(metrics)} metrics")
+    for metric in metrics:
+        print(f"- {metric.name} - {metric.id}")
+    if metrics:
+        found_metric_name = next((m.name for m in metrics if "Sensor_" in m.name))
+        assert found_metric_name, "No suitable metric found"
+        test_metric_name = found_metric_name
+    print(f"\nUsing metric: {test_metric_name}")
+
+    # Add metric non-Arrow data
+    random_number_nonarrow = random.randint(10000, 20000)
+    print(
+        f"\nAdding new metric data point with non-Arrow format for metric "
+        f"'{test_metric_name}' and values {random_number_nonarrow}..."
+    )
+    new_data = [
+        MetricDataPoint(
+            name=test_metric_name,
+            time=datetime.now(timezone.utc),
+            value_double=random_number_nonarrow,
+            value_string=None,
+        ),
+        MetricDataPoint(
+            name=test_metric_name,
+            time=datetime.now(timezone.utc),
+            value_double=None,
+            value_string=str(random_number_nonarrow),
+        ),
+    ]
+    cvec.add_metric_data(new_data, use_arrow=False)
+    print("Non-Arrow Data added successfully")
+
+    # Add metric Arrow data
+
+    random_number_arrow = random.randint(10000, 20000)
+    print(
+        f"\nAdding new metric data point with Arrow format for metric "
+        f"'{test_metric_name}' and value {random_number_arrow}..."
+    )
+    new_data = [
+        MetricDataPoint(
+            name=test_metric_name,
+            time=datetime.now(timezone.utc),
+            value_double=random_number_arrow,
+            value_string=None,
+        ),
+    ]
+    cvec.add_metric_data(new_data, use_arrow=True)
+    print("Arrow Data added successfully")
+
+    # Fetch and print metric data - non-Arrow
+    data_points = cvec.get_metric_data(
+        start_at=datetime.now(timezone.utc) - timedelta(minutes=1),
+        end_at=datetime.now(timezone.utc),
+        names=[test_metric_name],
+    )
+    assert len(data_points) > 0, "No data points found for the metric"
+    assert any(dp.value_double == random_number_nonarrow for dp in data_points), (
+        "No data point found with the expected non-Arrow value"
+    )
+    assert any(dp.value_string == str(random_number_nonarrow) for dp in data_points), (
+        "No data point found with the expected non-Arrow string value"
+    )
+    assert any(dp.value_double == random_number_arrow for dp in data_points), (
+        "No data point found with the expected Arrow value"
+    )
+    print(f"\nFound {len(data_points)} data points for metric '{test_metric_name}'")
+    for point in data_points:
+        print(
+            f"- {point.name}: {point.value_double or point.value_string} at {point.time}"
+        )
+
+    # Fetch and print metric data - Arrow
+    arrow_data = cvec.get_metric_arrow(
+        start_at=datetime.now(timezone.utc) - timedelta(minutes=1),
+        end_at=datetime.now(timezone.utc),
+        names=[test_metric_name],
+    )
+    reader = ipc.open_file(io.BytesIO(arrow_data))
+    table = reader.read_all()
+    assert len(table) > 0, "No data found in Arrow format"
+    print(f"Arrow table shape: {len(table)} rows")
+    print("\nFirst few rows:")
+    for i in range(min(5, len(table))):
+        print(
+            f"- {table['name'][i].as_py()}: {table['value_double'][i].as_py() or table['value_string'][i].as_py()} at {table['time'][i].as_py()}"
+        )
+
+    # spans
+    spans = cvec.get_spans(
+        start_at=datetime.now(timezone.utc) - timedelta(minutes=1),
+        end_at=datetime.now(timezone.utc),
+        name=test_metric_name,
+        limit=5,
+    )
+    assert len(spans) > 0, "No spans found for the metric"
+    print(f"Found {len(spans)} spans")
+    for span in spans:
+        print(f"- Value: {span.value} from {span.raw_start_at} to {span.raw_end_at}")
+
+    print("\nAll operations completed successfully.")
+
+
+if __name__ == "__main__":
+    main()

cvec-1.5.2/examples/eav_example.py

@@ -0,0 +1,29 @@
+import os
+
+from cvec import CVec, EAVFilter
+
+
+def main() -> None:
+    cvec = CVec(
+        host=os.environ.get(
+            "CVEC_HOST", "https://your-subdomain.cvector.dev"
+        ),  # Replace with your API host
+        api_key=os.environ.get("CVEC_API_KEY", "your-api-key"),
+    )
+
+    # Example: Query with numeric range filter
+    print("\nQuerying with numeric range filter...")
+    rows = cvec.select_from_eav_id(
+        table_id="00000000-0000-0000-0000-000000000000",
+        column_ids=["abcd", "defg", "hijk"],
+        filters=[
+            EAVFilter(column_id="abcd", numeric_min=45992, numeric_max=45993),
+        ],
+    )
+    print(f"Found {len(rows)} rows with abcd in range [45992, 45993)")
+    for row in rows:
+        print(f"- {row}")
+
+
+if __name__ == "__main__":
+    main()

cvec-1.5.2/examples/get_metric_arrow_example.py

@@ -0,0 +1,26 @@
+from cvec import CVec
+import io
+import pyarrow.ipc as ipc  # type: ignore[import-untyped]
+import os
+
+
+def main() -> None:
+    cvec = CVec(
+        host=os.environ.get("CVEC_HOST", "https://your-subdomain.cvector.dev"),
+        api_key=os.environ.get("CVEC_API_KEY", "your-api-key"),
+    )
+    test_metric_name = "python-sdk/test"
+    print("\nGetting metric data as Arrow...")
+    arrow_data = cvec.get_metric_arrow(names=[test_metric_name])
+    reader = ipc.open_file(io.BytesIO(arrow_data))
+    table = reader.read_all()
+    print(f"Arrow table shape: {len(table)} rows")
+    print("\nFirst few rows:")
+    for i in range(min(5, len(table))):
+        print(
+            f"- {table['name'][i].as_py()}: {table['value_double'][i].as_py() or table['value_string'][i].as_py()} at {table['time'][i].as_py()}"
+        )
+
+
+if __name__ == "__main__":
+    main()

cvec-1.5.2/examples/get_metric_data_objects_example.py

@@ -0,0 +1,21 @@
+from cvec import CVec
+import os
+
+
+def main() -> None:
+    cvec = CVec(
+        host=os.environ.get("CVEC_HOST", "https://your-subdomain.cvector.dev"),
+        api_key=os.environ.get("CVEC_API_KEY", "your-api-key"),
+    )
+    test_metric_name = "python-sdk/test"
+    print("\nGetting metric data as objects...")
+    data_points = cvec.get_metric_data(names=[test_metric_name])
+    print(f"Found {len(data_points)} data points")
+    for point in data_points[:3]:
+        print(
+            f"- {point.name}: {point.value_double or point.value_string} at {point.time}"
+        )
+
+
+if __name__ == "__main__":
+    main()