kotharcomputing 0.101.5__tar.gz → 0.103.0__tar.gz

{kotharcomputing-0.101.5/src/kotharcomputing.egg-info → kotharcomputing-0.103.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kotharcomputing
-Version: 0.101.5
+Version: 0.103.0
 Summary: Python SDK for the Kothar API
 Author: Kothar Computing
 License-Expression: Apache-2.0

{kotharcomputing-0.101.5 → kotharcomputing-0.103.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "kotharcomputing"
-version = "0.101.5"
+version = "0.103.0"
 description = "Python SDK for the Kothar API"
 readme = "README.md"
 requires-python = ">=3.11"

{kotharcomputing-0.101.5 → kotharcomputing-0.103.0}/src/kotharcomputing/__init__.py

@@ -71,6 +71,15 @@ from .client import (
     KotharClientOptions,
     RawResponse,
 )
+from .content_types import (
+    DEFAULT_CONTENT_TYPE,
+    GENERIC_CONTENT_TYPES,
+    KOTHAR_CONTENT_TYPES,
+    LEGACY_ALEPH_CONTENT_TYPE,
+    content_type_for_path,
+    content_type_for_path_or_default,
+    is_generic_content_type,
+)
 from .credits import (
     CreditBalance,
     CreditTransaction,
@@ -213,6 +222,14 @@ __all__ = [
     "KotharClient",
     "KotharClientOptions",
     "RawResponse",
+    # Content Types
+    "DEFAULT_CONTENT_TYPE",
+    "GENERIC_CONTENT_TYPES",
+    "KOTHAR_CONTENT_TYPES",
+    "LEGACY_ALEPH_CONTENT_TYPE",
+    "content_type_for_path",
+    "content_type_for_path_or_default",
+    "is_generic_content_type",
     # Credits
     "CreditBalance",
     "CreditTransaction",

kotharcomputing-0.103.0/src/kotharcomputing/content_types.py

@@ -0,0 +1,53 @@
+DEFAULT_CONTENT_TYPE = "application/octet-stream"
+LEGACY_ALEPH_CONTENT_TYPE = "application/x-aleph"
+
+KOTHAR_CONTENT_TYPES = {
+    "aleph": "application/vnd.kothar.aleph",
+    "figure": "application/vnd.kothar.figure+json",
+    "lattice_model": "application/vnd.kothar.lattice-model+json",
+}
+
+GENERIC_CONTENT_TYPES = (
+    DEFAULT_CONTENT_TYPE,
+    "application/json",
+    "text/plain",
+)
+
+_CONTENT_TYPES_BY_EXTENSION = {
+    ".aleph": KOTHAR_CONTENT_TYPES["aleph"],
+    ".figure": KOTHAR_CONTENT_TYPES["figure"],
+    ".lattice_model": KOTHAR_CONTENT_TYPES["lattice_model"],
+    ".qasm": "application/qasm",
+}
+_GENERIC_CONTENT_TYPE_SET = set(GENERIC_CONTENT_TYPES)
+
+
+def content_type_for_path(path: str) -> str | None:
+    filename = path.replace("\\", "/").rsplit("/", 1)[-1]
+    extension_index = filename.rfind(".")
+    if extension_index <= 0 or extension_index == len(filename) - 1:
+        return None
+
+    return _CONTENT_TYPES_BY_EXTENSION.get(filename[extension_index:].lower())
+
+
+def is_generic_content_type(content_type: str) -> bool:
+    normalized = content_type.split(";", 1)[0].strip().lower()
+    return normalized in _GENERIC_CONTENT_TYPE_SET
+
+
+def content_type_for_path_or_default(path: str, fallback: str | None = None) -> str:
+    path_content_type = content_type_for_path(path)
+    if path_content_type is None:
+        return fallback or DEFAULT_CONTENT_TYPE
+    if not fallback:
+        return path_content_type
+
+    fallback_type = fallback.split(";", 1)[0].strip().lower()
+    if (
+        fallback_type == LEGACY_ALEPH_CONTENT_TYPE
+        or fallback_type in _GENERIC_CONTENT_TYPE_SET
+    ):
+        return path_content_type
+
+    return fallback

{kotharcomputing-0.101.5 → kotharcomputing-0.103.0}/src/kotharcomputing/files.py

@@ -53,6 +53,8 @@ class FileContent:
     etag: str | None = None
     version_id: str | None = None
     mime_type: str | None = None
+    user_id: str | None = None
+    username: str | None = None
 
     def text(self, encoding: str = "utf-8") -> str:
         return self.data.decode(encoding)
@@ -88,6 +90,8 @@ class FileByPathClient:
             etag=response.headers.get("etag"),
             version_id=response.headers.get("x-kothar-file-version-id"),
             mime_type=response.headers.get("content-type"),
+            user_id=response.headers.get("x-kothar-file-user-id"),
+            username=response.headers.get("x-kothar-file-username"),
         )
 
     def create(
@@ -206,6 +210,8 @@ class FileByPathVersionClient:
             etag=response.headers.get("etag"),
             version_id=response.headers.get("x-kothar-file-version-id"),
             mime_type=response.headers.get("content-type"),
+            user_id=response.headers.get("x-kothar-file-user-id"),
+            username=response.headers.get("x-kothar-file-username"),
         )
 
     def download_url(self) -> str:

{kotharcomputing-0.101.5 → kotharcomputing-0.103.0/src/kotharcomputing.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kotharcomputing
-Version: 0.101.5
+Version: 0.103.0
 Summary: Python SDK for the Kothar API
 Author: Kothar Computing
 License-Expression: Apache-2.0

{kotharcomputing-0.101.5 → kotharcomputing-0.103.0}/src/kotharcomputing.egg-info/SOURCES.txt

@@ -8,6 +8,7 @@ src/kotharcomputing/aleph_language_server.py
 src/kotharcomputing/api_tokens.py
 src/kotharcomputing/client.py
 src/kotharcomputing/common.py
+src/kotharcomputing/content_types.py
 src/kotharcomputing/credits.py
 src/kotharcomputing/errors.py
 src/kotharcomputing/executions.py

{kotharcomputing-0.101.5 → kotharcomputing-0.103.0}/tests/test_fetch_url_building.py

@@ -131,6 +131,8 @@ def test_files_client_exposes_resolved_version_id_from_get_header() -> None:
                 headers={
                     "content-disposition": "inline; filename=file.txt",
                     "x-kothar-file-version-id": "version-1",
+                    "x-kothar-file-user-id": "user-1",
+                    "x-kothar-file-username": "Ada Lovelace",
                 },
                 body=b"content",
             )
@@ -141,6 +143,8 @@ def test_files_client_exposes_resolved_version_id_from_get_header() -> None:
 
     assert file is not None
     assert file.version_id == "version-1"
+    assert file.user_id == "user-1"
+    assert file.username == "Ada Lovelace"
 
 
 def test_files_client_restores_versions_from_base_path_client() -> None:

{kotharcomputing-0.101.5 → kotharcomputing-0.103.0}/tests/test_public_api.py

@@ -82,6 +82,14 @@ def test_package_import_and_public_exports() -> None:
         "KotharClient",
         "KotharClientOptions",
         "RawResponse",
+        # Content Types
+        "DEFAULT_CONTENT_TYPE",
+        "GENERIC_CONTENT_TYPES",
+        "KOTHAR_CONTENT_TYPES",
+        "LEGACY_ALEPH_CONTENT_TYPE",
+        "content_type_for_path",
+        "content_type_for_path_or_default",
+        "is_generic_content_type",
         # Credits
         "CreditBalance",
         "CreditTransaction",
@@ -161,3 +169,35 @@ def test_kothar_client_uses_default_base_url() -> None:
     client = module.KotharClient()
 
     assert client._transport.base_url == "https://api.kotharcomputing.com/"
+
+
+def test_content_type_helpers_are_exported() -> None:
+    module = importlib.import_module("kotharcomputing")
+
+    assert module.KOTHAR_CONTENT_TYPES["aleph"] == "application/vnd.kothar.aleph"
+    assert (
+        module.content_type_for_path("src/main.aleph")
+        == module.KOTHAR_CONTENT_TYPES["aleph"]
+    )
+    assert (
+        module.content_type_for_path("plot.figure")
+        == module.KOTHAR_CONTENT_TYPES["figure"]
+    )
+    assert (
+        module.content_type_for_path("models/hubbard.lattice_model")
+        == module.KOTHAR_CONTENT_TYPES["lattice_model"]
+    )
+    assert module.content_type_for_path("circuits/bell.qasm") == "application/qasm"
+    assert module.content_type_for_path("notes.txt") is None
+    assert (
+        module.content_type_for_path_or_default("src/main.aleph", "application/x-aleph")
+        == module.KOTHAR_CONTENT_TYPES["aleph"]
+    )
+    assert (
+        module.content_type_for_path_or_default(
+            "plot.figure", "application/vnd.example.figure"
+        )
+        == "application/vnd.example.figure"
+    )
+    assert module.is_generic_content_type("text/plain; charset=UTF-8")
+    assert not module.is_generic_content_type("application/vnd.example.asset")