vbase-api 0.1.3__tar.gz → 0.1.4__tar.gz

vbase_api-0.1.4/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+All notable changes are documented here, following
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+Versions follow [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+Earlier releases were not tracked in this file; see the
+[commit history](https://github.com/validityBase/vbase-api-py/commits/main/)
+for prior changes.
+
+## [Unreleased]
+
+## [0.1.4] - 2026-10-26
+
+### Added
+
+- Compatibility test matrix for Python 3.8, 3.11, and 3.12.

{vbase_api-0.1.3 → vbase_api-0.1.4}/MANIFEST.in

@@ -1 +1,2 @@
 include requirements.in
+include CHANGELOG.md

{vbase_api-0.1.3/src/vbase_api.egg-info → vbase_api-0.1.4}/PKG-INFO

@@ -1,13 +1,16 @@
 Metadata-Version: 2.4
 Name: vbase-api
-Version: 0.1.3
+Version: 0.1.4
 Summary: vBase REST API Python Client
 Author-email: vBase <tech@vbase.com>
-License-Expression: Apache-2.0
+License: Apache-2.0
 Project-URL: Homepage, https://github.com/validityBase/vbase-api-py
 Project-URL: Documentation, https://docs.vbase.com/
 Keywords: vbase,stamping,web3,blockchain,validation
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
@@ -20,6 +23,8 @@ Dynamic: license-file
 
 vBase REST API Python Client
 
+Requires Python 3.11 or newer.
+
 See [documentation](https://docs.vbase.com/) and the [Swagger UI](https://app.vbase.com/swagger/) for more details.
 
 ---

{vbase_api-0.1.3 → vbase_api-0.1.4}/README.md

@@ -2,6 +2,8 @@
 
 vBase REST API Python Client
 
+Requires Python 3.11 or newer.
+
 See [documentation](https://docs.vbase.com/) and the [Swagger UI](https://app.vbase.com/swagger/) for more details.
 
 ---

{vbase_api-0.1.3 → vbase_api-0.1.4}/pyproject.toml

@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools >= 77.0.3"]
+requires = ["setuptools >= 62.6"]
 build-backend = "setuptools.build_meta"
 
 [project]
@@ -8,7 +8,7 @@ dynamic = ["version", "dependencies"]
 description = "vBase REST API Python Client"
 readme = "README.md"
 requires-python = ">=3.8"
-license = "Apache-2.0"
+license = {text = "Apache-2.0"}
 authors = [
   { name = "vBase", email = "tech@vbase.com" }
 ]
@@ -16,6 +16,9 @@ authors = [
 keywords = ["vbase", "stamping", "web3", "blockchain", "validation"]
 classifiers = [
   "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
   "Operating System :: OS Independent",
 ]
 

vbase_api-0.1.4/src/vbase_api/_version.py

@@ -0,0 +1 @@
+__version__ = "0.1.4"

{vbase_api-0.1.3 → vbase_api-0.1.4/src/vbase_api.egg-info}/PKG-INFO

@@ -1,13 +1,16 @@
 Metadata-Version: 2.4
 Name: vbase-api
-Version: 0.1.3
+Version: 0.1.4
 Summary: vBase REST API Python Client
 Author-email: vBase <tech@vbase.com>
-License-Expression: Apache-2.0
+License: Apache-2.0
 Project-URL: Homepage, https://github.com/validityBase/vbase-api-py
 Project-URL: Documentation, https://docs.vbase.com/
 Keywords: vbase,stamping,web3,blockchain,validation
 Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
@@ -20,6 +23,8 @@ Dynamic: license-file
 
 vBase REST API Python Client
 
+Requires Python 3.11 or newer.
+
 See [documentation](https://docs.vbase.com/) and the [Swagger UI](https://app.vbase.com/swagger/) for more details.
 
 ---

{vbase_api-0.1.3 → vbase_api-0.1.4}/src/vbase_api.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+CHANGELOG.md
 LICENSE.txt
 MANIFEST.in
 NOTICE.txt
@@ -13,4 +14,5 @@ src/vbase_api.egg-info/SOURCES.txt
 src/vbase_api.egg-info/dependency_links.txt
 src/vbase_api.egg-info/requires.txt
 src/vbase_api.egg-info/top_level.txt
+tests/test_api_client.py
 tests/test_file_integrity_e2e.py

vbase_api-0.1.4/tests/test_api_client.py

@@ -0,0 +1,107 @@
+"""Client request/response contracts that run without live services."""
+
+import json
+import tempfile
+import unittest
+from pathlib import Path
+from unittest.mock import patch
+
+import requests
+
+import vbase_api
+
+
+class APIClientTests(unittest.TestCase):
+    def setUp(self):
+        self.client = vbase_api.VBaseAPIClient(
+            api_key="test-only-key", base_url="https://example.invalid", timeout=7
+        )
+        self.addCleanup(self.client.close)
+        self.receipt = {
+            "transaction_hash": "0xtransaction",
+            "user_address": "0xuser",
+            "set_cid": "0xset",
+            "object_cid": "0xobject",
+            "timestamp": "2026-10-26T00:00:00Z",
+            "chain_id": 1,
+        }
+
+    @staticmethod
+    def response(status, payload):
+        response = requests.Response()
+        response.status_code = status
+        response._content = json.dumps(payload).encode("utf-8")
+        return response
+
+    def test_collection_request_and_response(self):
+        payload = {
+            "id": 1,
+            "name": "Example",
+            "cid": "0xset",
+            "is_pinned": True,
+            "is_public": False,
+            "created_at": "2026-10-26T00:00:00Z",
+            "description": "Example collection",
+        }
+        with patch.object(
+            self.client.session, "post", return_value=self.response(201, payload)
+        ) as post:
+            collection = self.client.create_collection("Example", "Example collection")
+        self.assertEqual(collection.cid, "0xset")
+        self.assertEqual(collection.name, "Example")
+        post.assert_called_once_with(
+            "https://example.invalid/api/v1/collections",
+            json={
+                "name": "Example",
+                "cid": None,
+                "description": "Example collection",
+                "is_pinned": True,
+            },
+            timeout=7,
+        )
+
+    def test_stamp_response_types(self):
+        for status, expected in [
+            (200, vbase_api.IdempotentStampResponse),
+            (201, vbase_api.StampCreatedResponse),
+        ]:
+            with self.subTest(status=status):
+                with patch.object(
+                    self.client.session,
+                    "post",
+                    return_value=self.response(
+                        status, {"commitment_receipt": self.receipt}
+                    ),
+                ):
+                    stamp = self.client.create_stamp(data_cid="0xobject")
+                    self.assertIsInstance(stamp, expected)
+                    self.assertEqual(stamp.commitment_receipt.object_cid, "0xobject")
+
+    def test_upload_closes_file_after_request(self):
+        with tempfile.TemporaryDirectory() as directory:
+            path = Path(directory) / "example.bin"
+            path.write_bytes(b"example")
+            with patch.object(
+                self.client.session,
+                "post",
+                return_value=self.response(201, {"commitment_receipt": self.receipt}),
+            ) as post:
+                result = self.client.upload_stamped_file("Example", path)
+            uploaded = post.call_args.kwargs["files"]["file"][1]
+            self.assertTrue(uploaded.closed)
+            self.assertEqual(result.commitment_receipt.object_cid, "0xobject")
+
+    def test_api_error_preserves_status_and_message(self):
+        with patch.object(
+            self.client.session,
+            "get",
+            return_value=self.response(403, {"error": "Access denied"}),
+        ):
+            with self.assertRaises(vbase_api.VBaseAPIError) as raised:
+                self.client.get_collections()
+        self.assertEqual(raised.exception.status_code, 403)
+        self.assertEqual(str(raised.exception), "[403] Access denied")
+
+
+if __name__ == "__main__":
+    unittest.main()

{vbase_api-0.1.3 → vbase_api-0.1.4}/tests/test_file_integrity_e2e.py

@@ -9,6 +9,7 @@ environment variables.
 from __future__ import annotations
 
 import hashlib
+import importlib.metadata as metadata
 import os
 import tempfile
 import time
@@ -26,6 +27,7 @@ except ImportError as exc:  # pragma: no cover
         "Install requirements/e2e.txt to run live file-integrity E2E tests."
     ) from exc
 
+import vbase_api
 from vbase_api import VBaseAPIClient, VBaseAPIError
 
 
@@ -54,6 +56,48 @@ def _int_env(name: str, default: int) -> int:
         ) from None
 
 
+def _log_and_assert_package_source() -> None:
+    install_source = _first_env("VBASE_API_PACKAGE_SOURCE")
+    if not install_source:
+        return
+
+    package_path = Path(vbase_api.__file__).resolve()
+    package_version = getattr(vbase_api, "__version__", "unknown")
+    try:
+        distribution_version = metadata.version("vbase-api")
+    except metadata.PackageNotFoundError:
+        distribution_version = "not installed"
+    print(
+        "vbase-api "
+        f"package_version={package_version} "
+        f"distribution_version={distribution_version} "
+        f"imported from {package_path}"
+    )
+
+    repo_root_raw = _first_env("GITHUB_WORKSPACE")
+    if not repo_root_raw:
+        return
+
+    repo_root = Path(repo_root_raw).resolve()
+    try:
+        package_path.relative_to(repo_root)
+        package_in_repo = True
+    except ValueError:
+        package_in_repo = False
+
+    if install_source == "source":
+        if not package_in_repo:
+            raise AssertionError(
+                "Source-install E2E run imported vbase_api outside the checkout: "
+                f"{package_path}"
+            )
+    elif install_source == "pypi" and package_in_repo:
+        raise AssertionError(
+            "PyPI-install E2E run imported vbase_api from the checkout instead of "
+            f"site-packages: {package_path}"
+        )
+
+
 @dataclass(frozen=True)
 class LiveE2EConfig:
     """Configuration needed for live app/API file-integrity tests."""
@@ -119,6 +163,7 @@ class VBaseAPIClientFileIntegrityE2ETests(unittest.TestCase):
 
     @classmethod
     def setUpClass(cls) -> None:
+        _log_and_assert_package_source()
         cls.config = LiveE2EConfig.from_env()
         cls.client = VBaseAPIClient(
             api_key=cls.config.api_key,

vbase_api-0.1.3/src/vbase_api/_version.py

@@ -1 +0,0 @@
-__version__ = "0.1.3"