poelis-sdk 0.3.2__py3-none-any.whl → 0.3.4__py3-none-any.whl

poelis_sdk/__init__.py

@@ -7,7 +7,7 @@ metadata so it stays in sync with ``pyproject.toml`` without manual edits.
 from importlib import metadata
 
 from .client import PoelisClient
-from .logging import configure_logging, quiet_logging, verbose_logging, debug_logging, get_logger
+from .logging import configure_logging, debug_logging, get_logger, quiet_logging, verbose_logging
 
 __all__ = ["PoelisClient", "__version__", "configure_logging", "quiet_logging", "verbose_logging", "debug_logging", "get_logger"]
 

poelis_sdk/_transport.py

@@ -1,12 +1,20 @@
 from __future__ import annotations
 
-from typing import Any, Dict, Mapping, Optional
 import os
-import time
 import random
+import time
+from typing import Any, Dict, Mapping, Optional
+
 import httpx
 
-from .exceptions import ClientError, HTTPError, NotFoundError, RateLimitError, ServerError, UnauthorizedError
+from .exceptions import (
+    ClientError,
+    HTTPError,
+    NotFoundError,
+    RateLimitError,
+    ServerError,
+    UnauthorizedError,
+)
 
 """HTTP transport abstraction for the Poelis SDK.
 

poelis_sdk/browser.py

@@ -1,9 +1,9 @@
 from __future__ import annotations
 
-from typing import Any, Dict, List, Optional
-from types import MethodType
 import re
 import time
+from types import MethodType
+from typing import Any, Dict, List, Optional
 
 from .org_validation import get_organization_context_message
 
@@ -140,39 +140,77 @@ class _Node:
             self._props_loaded_at = time.time()
             return self._props_cache
         # Try direct properties(itemId: ...) first; fallback to searchProperties
-        q = (
-            "query($iid: ID!) {\n"
+        # Attempt 1: query with parsedValue support
+        q_parsed = (
+            "query($iid: ID!) \n"
             "  properties(itemId: $iid) {\n"
             "    __typename\n"
-            "    ... on NumericProperty { integerPart exponent category }\n"
-            "    ... on TextProperty { value }\n"
-            "    ... on DateProperty { value }\n"
+            "    ... on NumericProperty { id name category value parsedValue }\n"
+            "    ... on TextProperty { id name value parsedValue }\n"
+            "    ... on DateProperty { id name value }\n"
             "  }\n"
             "}"
         )
         try:
-            r = self._client._transport.graphql(q, {"iid": self._id})
+            r = self._client._transport.graphql(q_parsed, {"iid": self._id})
             r.raise_for_status()
             data = r.json()
             if "errors" in data:
-                raise RuntimeError(data["errors"])  # trigger fallback
+                raise RuntimeError(data["errors"])  # try value-only shape
             self._props_cache = data.get("data", {}).get("properties", []) or []
             self._props_loaded_at = time.time()
         except Exception:
-            q2 = (
-                "query($iid: ID!, $limit: Int!, $offset: Int!) {\n"
-                "  searchProperties(q: \"*\", itemId: $iid, limit: $limit, offset: $offset) {\n"
-                "    hits { id workspaceId productId itemId propertyType name category value owner }\n"
+            # Attempt 2: value-only, legacy compatible
+            q_value_only = (
+                "query($iid: ID!) \n"
+                "  properties(itemId: $iid) {\n"
+                "    __typename\n"
+                "    ... on NumericProperty { id name category value }\n"
+                "    ... on TextProperty { id name value }\n"
+                "    ... on DateProperty { id name value }\n"
                 "  }\n"
                 "}"
             )
-            r2 = self._client._transport.graphql(q2, {"iid": self._id, "limit": 100, "offset": 0})
-            r2.raise_for_status()
-            data2 = r2.json()
-            if "errors" in data2:
-                raise RuntimeError(data2["errors"])  # propagate
-            self._props_cache = data2.get("data", {}).get("searchProperties", {}).get("hits", []) or []
-            self._props_loaded_at = time.time()
+            try:
+                r = self._client._transport.graphql(q_value_only, {"iid": self._id})
+                r.raise_for_status()
+                data = r.json()
+                if "errors" in data:
+                    raise RuntimeError(data["errors"])  # trigger fallback to search
+                self._props_cache = data.get("data", {}).get("properties", []) or []
+                self._props_loaded_at = time.time()
+            except Exception:
+                # Fallback to searchProperties
+                q2_parsed = (
+                    "query($iid: ID!, $limit: Int!, $offset: Int!) {\n"
+                    "  searchProperties(q: \"*\", itemId: $iid, limit: $limit, offset: $offset) {\n"
+                    "    hits { id workspaceId productId itemId propertyType name category value parsedValue owner }\n"
+                    "  }\n"
+                    "}"
+                )
+                try:
+                    r2 = self._client._transport.graphql(q2_parsed, {"iid": self._id, "limit": 100, "offset": 0})
+                    r2.raise_for_status()
+                    data2 = r2.json()
+                    if "errors" in data2:
+                        raise RuntimeError(data2["errors"])  # try minimal
+                    self._props_cache = data2.get("data", {}).get("searchProperties", {}).get("hits", []) or []
+                    self._props_loaded_at = time.time()
+                except Exception:
+                    q2_min = (
+                        "query($iid: ID!, $limit: Int!, $offset: Int!) {\n"
+                        "  searchProperties(q: \"*\", itemId: $iid, limit: $limit, offset: $offset) {\n"
+                        "    hits { id workspaceId productId itemId propertyType name category value owner }\n"
+                        "  }\n"
+                        "}"
+                    )
+                    r3 = self._client._transport.graphql(q2_min, {"iid": self._id, "limit": 100, "offset": 0})
+                    r3.raise_for_status()
+                    data3 = r3.json()
+                    if "errors" in data3:
+                        raise RuntimeError(data3["errors"])  # propagate
+                    self._props_cache = data3.get("data", {}).get("searchProperties", {}).get("hits", []) or []
+                    self._props_loaded_at = time.time()
         return self._props_cache
 
     def _props_key_map(self) -> Dict[str, Dict[str, Any]]:
@@ -419,6 +457,10 @@ class _PropWrapper:
     @property
     def value(self) -> Any:  # type: ignore[override]
         p = self._raw
+        # Use parsedValue if available (new backend feature)
+        if "parsedValue" in p:
+            return p["parsedValue"]
+        # Fallback to legacy parsing logic for backward compatibility
         # searchProperties shape
         if "numericValue" in p and p.get("numericValue") is not None:
             return p["numericValue"]

poelis_sdk/client.py

@@ -1,16 +1,17 @@
 from __future__ import annotations
 
-from typing import Optional
 import os
+from typing import Optional
 
 from pydantic import BaseModel, Field, HttpUrl
+
 from ._transport import Transport
-from .products import ProductsClient
+from .browser import Browser
 from .items import ItemsClient
+from .logging import quiet_logging
+from .products import ProductsClient
 from .search import SearchClient
 from .workspaces import WorkspacesClient
-from .browser import Browser
-from .logging import quiet_logging
 
 """Core client for the Poelis Python SDK.
 

poelis_sdk/items.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import Generator, Any, Optional, Dict, List
+from typing import Any, Dict, Generator, List, Optional
 
 from ._transport import Transport
 

poelis_sdk/models.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import Optional
+from typing import Any, List, Optional, Union
 
 from pydantic import BaseModel, Field
 
@@ -25,3 +25,106 @@ class PaginatedProducts(BaseModel):
     offset: int
 
 
+class PropertyValue(BaseModel):
+    """Base class for property values with typed access."""
+    
+    raw_value: str = Field(alias="value")
+    parsed_value: Optional[Any] = Field(alias="parsedValue", default=None)
+    
+    @property
+    def value(self) -> Any:
+        """Get the properly typed value, falling back to raw string if parsing failed."""
+        return self.parsed_value if self.parsed_value is not None else self.raw_value
+
+
+class NumericProperty(BaseModel):
+    """Numeric property representation."""
+    
+    id: str = Field(min_length=1)
+    item_id: str = Field(alias="itemId", min_length=1)
+    position: float
+    name: str = Field(min_length=1)
+    value: str
+    category: str
+    display_unit: Optional[str] = Field(alias="displayUnit", default=None)
+    owner: str = Field(min_length=1)
+    type: str = Field(min_length=1)
+    parsed_value: Optional[Union[int, float, List[Any], str]] = Field(alias="parsedValue", default=None)
+    
+    @property
+    def typed_value(self) -> Union[int, float, List[Any], str]:
+        """Get the properly typed value, falling back to raw string if parsing failed."""
+        return self.parsed_value if self.parsed_value is not None else self.value
+
+
+class TextProperty(BaseModel):
+    """Text property representation."""
+    
+    id: str = Field(min_length=1)
+    item_id: str = Field(alias="itemId", min_length=1)
+    position: float
+    name: str = Field(min_length=1)
+    value: str
+    owner: str = Field(min_length=1)
+    type: str = Field(min_length=1)
+    parsed_value: Optional[Union[int, float, List[Any], str]] = Field(alias="parsedValue", default=None)
+    
+    @property
+    def typed_value(self) -> Union[int, float, List[Any], str]:
+        """Get the properly typed value, falling back to raw string if parsing failed."""
+        return self.parsed_value if self.parsed_value is not None else self.value
+
+
+class DateProperty(BaseModel):
+    """Date property representation."""
+    
+    id: str = Field(min_length=1)
+    item_id: str = Field(alias="itemId", min_length=1)
+    position: float
+    name: str = Field(min_length=1)
+    value: str
+    owner: str = Field(min_length=1)
+    type: str = Field(min_length=1)
+    parsed_value: Optional[str] = Field(alias="parsedValue", default=None)
+    
+    @property
+    def typed_value(self) -> str:
+        """Get the properly typed value, falling back to raw string if parsing failed."""
+        return self.parsed_value if self.parsed_value is not None else self.value
+
+
+class PropertySearchResult(BaseModel):
+    """Property search result with unified fields across all property types."""
+    
+    id: str = Field(min_length=1)
+    workspace_id: str = Field(alias="workspaceId", min_length=1)
+    product_id: str = Field(alias="productId", min_length=1)
+    item_id: str = Field(alias="itemId", min_length=1)
+    property_type: str = Field(alias="propertyType", min_length=1)
+    name: str = Field(min_length=1)
+    category: Optional[str] = None
+    display_unit: Optional[str] = Field(alias="displayUnit", default=None)
+    value: Any  # Raw value from GraphQL
+    parsed_value: Optional[Union[int, float, List[Any], str]] = Field(alias="parsedValue", default=None)
+    owner: str = Field(min_length=1)
+    created_by: str = Field(alias="createdBy", min_length=1)
+    created_at: str = Field(alias="createdAt", min_length=1)
+    updated_at: str = Field(alias="updatedAt", min_length=1)
+    
+    @property
+    def typed_value(self) -> Union[int, float, List[Any], str]:
+        """Get the properly typed value, falling back to raw string if parsing failed."""
+        return self.parsed_value if self.parsed_value is not None else self.value
+
+
+class PropertySearchResponse(BaseModel):
+    """Response for property search queries."""
+    
+    query: str
+    hits: List[PropertySearchResult]
+    total: int
+    limit: int
+    offset: int
+    processing_time_ms: int = Field(alias="processingTimeMs")
+
+

poelis_sdk/products.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from typing import Generator, Optional, TYPE_CHECKING
+from typing import TYPE_CHECKING, Generator, Optional
 
 from ._transport import Transport
 from .models import PaginatedProducts, Product

poelis_sdk/search.py

@@ -54,7 +54,7 @@ class SearchClient:
             "query($q: String!, $ws: ID, $pid: ID, $iid: ID, $ptype: String, $cat: String, $limit: Int!, $offset: Int!, $sort: String) {\n"
             "  searchProperties(q: $q, workspaceId: $ws, productId: $pid, itemId: $iid, propertyType: $ptype, category: $cat, limit: $limit, offset: $offset, sort: $sort) {\n"
             "    query total limit offset processingTimeMs\n"
-            "    hits { id workspaceId productId itemId propertyType name category value owner }\n"
+            "    hits { id workspaceId productId itemId propertyType name category value parsedValue owner }\n"
             "  }\n"
             "}"
         )

poelis_sdk/workspaces.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 from typing import Any, Dict, List, Optional
 
 from ._transport import Transport
-from .org_validation import validate_workspace_organization, filter_by_organization
+from .org_validation import filter_by_organization, validate_workspace_organization
 
 """Workspaces GraphQL client."""
 

{poelis_sdk-0.3.2.dist-info → poelis_sdk-0.3.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: poelis-sdk
-Version: 0.3.2
+Version: 0.3.4
 Summary: Official Python SDK for Poelis
 Project-URL: Homepage, https://poelis.com
 Project-URL: Source, https://github.com/PoelisTechnologies/poelis-python-sdk

poelis_sdk-0.3.4.dist-info/RECORD

@@ -0,0 +1,16 @@
+poelis_sdk/__init__.py,sha256=7nLSHnIDePEtOM3-QFIvcahcbqXmemtctMuOWcKp-zo,924
+poelis_sdk/_transport.py,sha256=w-NHjo355JXK2JfL4rDqfosT-9LGiPsnPQrvaOFjhdM,7099
+poelis_sdk/browser.py,sha256=wRW93EwxLUz8ivcxgQgKfnabskxXHbCggeuyySk3Vic,25229
+poelis_sdk/client.py,sha256=Oc2Bs1SDuW6brkMb50XeQh1pIWRdvT20DYuIPOSj1vw,3873
+poelis_sdk/exceptions.py,sha256=qX5kpAr8ozJUOW-CNhmspWVIE-bvUZT_PUnimYuBxNY,1101
+poelis_sdk/items.py,sha256=IH5RFl-kN_uv0n30A7Np0A9NvJRad8UhflqJVePJDLQ,2575
+poelis_sdk/logging.py,sha256=zmg8Us-7qjDl0n_NfOSvDolLopy7Dc_hQ-pcrC63dY8,2442
+poelis_sdk/models.py,sha256=_M4qiOu-kNSI_J5aPMXzQuXGUNnymAjgYMvpQVytCQE,4478
+poelis_sdk/org_validation.py,sha256=c4fB6ySTvcovWxG4F1wU_OBlP-FyuIaAUzCwqgJKzBE,5607
+poelis_sdk/products.py,sha256=wmh0Jh1_k9SNN_w2M_dMy1cpu56LGesAFKF99kOIuNU,3240
+poelis_sdk/search.py,sha256=3DqFd7ilTpizjOYgWplR7MTslnY89Q8AmUfn865TnKc,4113
+poelis_sdk/workspaces.py,sha256=_6cic97ByvNckmbaaTUS-5QpgvQcZZfBY-wMwsuTTxU,2383
+poelis_sdk-0.3.4.dist-info/METADATA,sha256=P9pr7_d9freOu4mlAyuJ7fJbbXJl0cv-cDQhoUzbeB0,2968
+poelis_sdk-0.3.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+poelis_sdk-0.3.4.dist-info/licenses/LICENSE,sha256=EEmE_r8wk_pdXB8CWp1LG6sBOl7--hNSS2kV94cI6co,1075
+poelis_sdk-0.3.4.dist-info/RECORD,,

poelis_sdk-0.3.2.dist-info/RECORD

@@ -1,16 +0,0 @@
-poelis_sdk/__init__.py,sha256=vRKuvnMGtq2_6SYDPNpckSPYXTgMDD1vBAfZ1bXlHL0,924
-poelis_sdk/_transport.py,sha256=Na1neuS9JyLwHqhWkqwpQiGdbRtS0EJlWd587kQ88-s,7069
-poelis_sdk/browser.py,sha256=Ornhl821UtoGXttCF5yJnDluu2BXNOG5VJPP5Fc0vjI,22913
-poelis_sdk/client.py,sha256=10__5po-foX36ZCCduQmzdoh9NNS320kyaqztUNtPvo,3872
-poelis_sdk/exceptions.py,sha256=qX5kpAr8ozJUOW-CNhmspWVIE-bvUZT_PUnimYuBxNY,1101
-poelis_sdk/items.py,sha256=vomXn43gcUlX2iUro3mpb8Qicmmt4sWFB2vXXxIfLsM,2575
-poelis_sdk/logging.py,sha256=zmg8Us-7qjDl0n_NfOSvDolLopy7Dc_hQ-pcrC63dY8,2442
-poelis_sdk/models.py,sha256=tpL7f66dsCobapKp3_rt-w6oiyYvWtoehLvCfjTDLl4,538
-poelis_sdk/org_validation.py,sha256=c4fB6ySTvcovWxG4F1wU_OBlP-FyuIaAUzCwqgJKzBE,5607
-poelis_sdk/products.py,sha256=bwV2mOPvBriy83F3BxWww1oSsyLZFQvh4XOiIE9fI1s,3240
-poelis_sdk/search.py,sha256=KQbdnu2khQDewddSJHR7JWysH1f2M7swK6MR-ZwrLAE,4101
-poelis_sdk/workspaces.py,sha256=hpmRl-Hswr4YDvObQdyVpegIYjUWno7A_BiVBz-AQGc,2383
-poelis_sdk-0.3.2.dist-info/METADATA,sha256=W834FuqvtAm2s2M-og9gt4gTttkkkj3NRJSxY1xAJVE,2968
-poelis_sdk-0.3.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-poelis_sdk-0.3.2.dist-info/licenses/LICENSE,sha256=EEmE_r8wk_pdXB8CWp1LG6sBOl7--hNSS2kV94cI6co,1075
-poelis_sdk-0.3.2.dist-info/RECORD,,