poelis-sdk 0.1.8__py3-none-any.whl → 0.2.0__py3-none-any.whl

poelis_sdk/browser.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from typing import Any, Dict, List, Optional
+from types import MethodType
 import re
 
 from .org_validation import get_organization_context_message
@@ -12,6 +13,10 @@ with optional property listing on items. Designed for notebook UX.
 """
 
 
+# Internal guard to avoid repeated completer installation
+_AUTO_COMPLETER_INSTALLED: bool = False
+
+
 class _Node:
     def __init__(self, client: Any, level: str, parent: Optional["_Node"], node_id: Optional[str], name: Optional[str]) -> None:
         self._client = client
@@ -33,34 +38,37 @@ class _Node:
     def __dir__(self) -> List[str]:  # pragma: no cover - notebook UX
         # Ensure children are loaded so TAB shows options immediately
         self._load_children()
-        keys = list(self._children_cache.keys()) + ["properties", "id", "name", "refresh", "names", "props"]
+        keys = list(self._children_cache.keys())
         if self._level == "item":
             # Include property names directly on item for suggestions
             prop_keys = list(self._props_key_map().keys())
             keys.extend(prop_keys)
-        return sorted(keys)
+        return sorted(set(keys))
 
-    @property
-    def id(self) -> Optional[str]:
-        return self._id
-
-    @property
-    def name(self) -> Optional[str]:
-        return self._name
-
-    def refresh(self) -> "_Node":
+    # Intentionally no public id/name/refresh to keep suggestions minimal
+    def _refresh(self) -> "_Node":
         self._children_cache.clear()
         self._props_cache = None
         return self
 
-    def names(self) -> List[str]:
-        """Return display names of children at this level (forces a lazy load)."""
+    def _names(self) -> List[str]:
+        """Return display names of children at this level (internal)."""
         self._load_children()
         return [child._name or "" for child in self._children_cache.values()]
 
+    def _suggest(self) -> List[str]:
+        """Return suggested attribute names for interactive usage.
+
+        Only child keys are returned; for item level, property keys are also included.
+        """
+        self._load_children()
+        suggestions: List[str] = list(self._children_cache.keys())
+        if self._level == "item":
+            suggestions.extend(list(self._props_key_map().keys()))
+        return sorted(set(suggestions))
+
     def __getattr__(self, attr: str) -> Any:
-        if attr in {"properties", "id", "name", "refresh"}:
-            return object.__getattribute__(self, attr)
+        # No public properties/id/name/refresh
         if attr == "props":  # item-level properties pseudo-node
             if self._level != "item":
                 raise AttributeError("props")
@@ -92,18 +100,17 @@ class _Node:
             return self._children_cache[safe]
         raise KeyError(key)
 
-    @property
-    def properties(self) -> List[Dict[str, Any]]:
+    def _properties(self) -> List[Dict[str, Any]]:
         if self._props_cache is not None:
             return self._props_cache
         if self._level != "item":
             self._props_cache = []
             return self._props_cache
-        # Try direct properties(item_id: ...) first; fallback to searchProperties
+        # Try direct properties(itemId: ...) first; fallback to searchProperties
         q = (
             "query($iid: ID!) {\n"
-            "  properties(item_id: $iid) {\n"
-            "    __typename id name owner\n"
+            "  properties(itemId: $iid) {\n"
+            "    __typename\n"
             "    ... on NumericProperty { integerPart exponent category }\n"
             "    ... on TextProperty { value }\n"
             "    ... on DateProperty { value }\n"
@@ -121,7 +128,7 @@ class _Node:
             q2 = (
                 "query($iid: ID!, $limit: Int!, $offset: Int!) {\n"
                 "  searchProperties(q: \"*\", itemId: $iid, limit: $limit, offset: $offset) {\n"
-                "    hits { id name propertyType category textValue numericValue dateValue owner }\n"
+                "    hits { id workspaceId productId itemId propertyType name category value owner }\n"
                 "  }\n"
                 "}"
             )
@@ -138,10 +145,20 @@ class _Node:
         out: Dict[str, Dict[str, Any]] = {}
         if self._level != "item":
             return out
-        props = self.properties
-        for pr in props:
-            display = pr.get("name") or pr.get("id")
+        props = self._properties()
+        used_names: Dict[str, int] = {}
+        for i, pr in enumerate(props):
+            # Try to get name from various possible fields
+            display = pr.get("name") or pr.get("id") or pr.get("category") or f"property_{i}"
             safe = _safe_key(str(display))
+            
+            # Handle duplicate names by adding a suffix
+            if safe in used_names:
+                used_names[safe] += 1
+                safe = f"{safe}_{used_names[safe]}"
+            else:
+                used_names[safe] = 0
+                
             out[safe] = _PropWrapper(pr)
         return out
 
@@ -178,7 +195,7 @@ class _Node:
                 return
             q = (
                 "query($pid: ID!, $parent: ID!, $limit: Int!, $offset: Int!) {\n"
-                "  items(productId: $pid, parentItemId: $parent, limit: $limit, offset: $offset) { id name code description productId parentId owner }\n"
+                "  items(productId: $pid, parentItemId: $parent, limit: $limit, offset: $offset) { id name code description productId parentId owner position }\n"
                 "}"
             )
             r = self._client._transport.graphql(q, {"pid": pid, "parent": self._id, "limit": 1000, "offset": 0})
@@ -201,6 +218,15 @@ class Browser:
 
     def __init__(self, client: Any) -> None:
         self._root = _Node(client, "root", None, None, None)
+        # Best-effort: auto-enable curated completion in interactive shells
+        global _AUTO_COMPLETER_INSTALLED
+        if not _AUTO_COMPLETER_INSTALLED:
+            try:
+                if enable_dynamic_completion():
+                    _AUTO_COMPLETER_INSTALLED = True
+            except Exception:
+                # Non-interactive or IPython not available; ignore silently
+                pass
 
     def __getattr__(self, attr: str) -> Any:  # pragma: no cover - notebook UX
         return getattr(self._root, attr)
@@ -217,7 +243,15 @@ class Browser:
     def __dir__(self) -> list[str]:  # pragma: no cover - notebook UX
         # Ensure children are loaded so TAB shows options
         self._root._load_children()
-        return sorted([*self._root._children_cache.keys(), "names"]) 
+        return sorted([*self._root._children_cache.keys()]) 
+
+    def _names(self) -> List[str]:
+        """Return display names of root-level children (workspaces)."""
+        return self._root._names()
+
+    # keep suggest internal so it doesn't appear in help/dir
+    def _suggest(self) -> List[str]:
+        return self._root._suggest()
 
 
 def _safe_key(name: str) -> str:
@@ -245,16 +279,28 @@ class _PropsNode:
     def _ensure_loaded(self) -> None:
         if self._children_cache:
             return
-        props = self._item.properties
-        for pr in props:
-            display = pr.get("name") or pr.get("id")
+        props = self._item._properties()
+        used_names: Dict[str, int] = {}
+        names_list = []
+        for i, pr in enumerate(props):
+            # Try to get name from various possible fields
+            display = pr.get("name") or pr.get("id") or pr.get("category") or f"property_{i}"
             safe = _safe_key(str(display))
+            
+            # Handle duplicate names by adding a suffix
+            if safe in used_names:
+                used_names[safe] += 1
+                safe = f"{safe}_{used_names[safe]}"
+            else:
+                used_names[safe] = 0
+                
             self._children_cache[safe] = _PropWrapper(pr)
-        self._names = [p.get("name") or p.get("id") for p in props]
+            names_list.append(display)
+        self._names = names_list
 
     def __dir__(self) -> List[str]:  # pragma: no cover - notebook UX
         self._ensure_loaded()
-        return sorted(list(self._children_cache.keys()) + ["names"]) 
+        return sorted(list(self._children_cache.keys())) 
 
     def names(self) -> List[str]:
         self._ensure_loaded()
@@ -272,13 +318,21 @@ class _PropsNode:
             return self._children_cache[key]
         # match by display name
         for safe, data in self._children_cache.items():
-            if data.raw.get("name") == key:
-                return data
+            try:
+                if getattr(data, "_raw", {}).get("name") == key:  # type: ignore[arg-type]
+                    return data
+            except Exception:
+                continue
         safe = _safe_key(key)
         if safe in self._children_cache:
             return self._children_cache[safe]
         raise KeyError(key)
 
+    # keep suggest internal so it doesn't appear in help/dir
+    def _suggest(self) -> List[str]:
+        self._ensure_loaded()
+        return sorted(list(self._children_cache.keys()))
+
 
 class _PropWrapper:
     """Lightweight accessor for a property dict, exposing `.value` and `.raw`.
@@ -289,10 +343,6 @@ class _PropWrapper:
     def __init__(self, prop: Dict[str, Any]) -> None:
         self._raw = prop
 
-    @property
-    def raw(self) -> Dict[str, Any]:
-        return self._raw
-
     @property
     def value(self) -> Any:  # type: ignore[override]
         p = self._raw
@@ -315,8 +365,123 @@ class _PropWrapper:
             return p.get("value")
         return None
 
+    @property
+    def category(self) -> Optional[str]:
+        p = self._raw
+        cat = p.get("category")
+        return str(cat) if cat is not None else None
+
+    def __dir__(self) -> List[str]:  # pragma: no cover - notebook UX
+        # Expose only the minimal attributes for browsing
+        return ["value", "category"]
+
     def __repr__(self) -> str:  # pragma: no cover - notebook UX
         name = self._raw.get("name") or self._raw.get("id")
         return f"<property {name}: {self.value}>"
 
 
+
+def enable_dynamic_completion() -> bool:
+    """Enable dynamic attribute completion in IPython/Jupyter environments.
+
+    This helper attempts to configure IPython to use runtime-based completion
+    (disabling Jedi) so that our dynamic `__dir__` and `suggest()` methods are
+    respected by TAB completion. Returns True if an interactive shell was found
+    and configured, False otherwise.
+    """
+
+    try:
+        # Deferred import to avoid hard dependency
+        from IPython import get_ipython  # type: ignore
+    except Exception:
+        return False
+
+    ip = None
+    try:
+        ip = get_ipython()  # type: ignore[assignment]
+    except Exception:
+        ip = None
+    if ip is None:
+        return False
+
+    enabled = False
+    # Best-effort configuration: rely on IPython's fallback (non-Jedi) completer
+    try:
+        if hasattr(ip, "Completer") and hasattr(ip.Completer, "use_jedi"):
+            # Disable Jedi to let IPython consult __dir__ dynamically
+            ip.Completer.use_jedi = False  # type: ignore[assignment]
+            # Greedy completion improves attribute completion depth
+            if hasattr(ip.Completer, "greedy"):
+                ip.Completer.greedy = True  # type: ignore[assignment]
+            enabled = True
+    except Exception:
+        pass
+
+    # Additionally, install a lightweight attribute completer that uses suggest()
+    try:
+        comp = getattr(ip, "Completer", None)
+        if comp is not None and hasattr(comp, "attr_matches"):
+            orig_attr_matches = comp.attr_matches  # type: ignore[attr-defined]
+
+            def _poelis_attr_matches(self: Any, text: str) -> List[str]:  # pragma: no cover - interactive behavior
+                try:
+                    # text is like "client.browser.uh2.pr" → split at last dot
+                    obj_expr, _, prefix = text.rpartition(".")
+                    if not obj_expr:
+                        return orig_attr_matches(text)  # type: ignore[operator]
+                    # Evaluate the object in the user namespace
+                    ns = getattr(self, "namespace", {})
+                    obj_val = eval(obj_expr, ns, ns)
+
+                    # For Poelis browser objects, show ONLY our curated suggestions
+                    from_types = (Browser, _Node, _PropsNode, _PropWrapper)
+                    if isinstance(obj_val, from_types):
+                        # Build suggestion list
+                        if isinstance(obj_val, _PropWrapper):
+                            sugg: List[str] = ["value", "category"]
+                        elif hasattr(obj_val, "_suggest"):
+                            sugg = list(getattr(obj_val, "_suggest")())  # type: ignore[no-untyped-call]
+                        else:
+                            sugg = list(dir(obj_val))
+                        # Filter by prefix and format matches as full attribute paths
+                        out: List[str] = []
+                        for s in sugg:
+                            if not prefix or str(s).startswith(prefix):
+                                out.append(f"{obj_expr}.{s}")
+                        return out
+
+                    # Otherwise, fall back to default behavior
+                    return orig_attr_matches(text)  # type: ignore[operator]
+                except Exception:
+                    # fall back to original on any error
+                    return orig_attr_matches(text)  # type: ignore[operator]
+
+            comp.attr_matches = MethodType(_poelis_attr_matches, comp)  # type: ignore[assignment]
+            enabled = True
+    except Exception:
+        pass
+
+    # Also register as a high-priority matcher in IPCompleter.matchers
+    try:
+        comp = getattr(ip, "Completer", None)
+        if comp is not None and hasattr(comp, "matchers") and not getattr(comp, "_poelis_matcher_installed", False):
+            orig_attr_matches = comp.attr_matches  # type: ignore[attr-defined]
+
+            def _poelis_matcher(self: Any, text: str) -> List[str]:  # pragma: no cover - interactive behavior
+                # Delegate to our attribute logic for dotted expressions; otherwise empty
+                if "." in text:
+                    try:
+                        return self.attr_matches(text)  # type: ignore[operator]
+                    except Exception:
+                        return orig_attr_matches(text)  # type: ignore[operator]
+                return []
+
+            # Prepend our matcher so it's consulted early
+            comp.matchers.insert(0, MethodType(_poelis_matcher, comp))  # type: ignore[arg-type]
+            setattr(comp, "_poelis_matcher_installed", True)
+            enabled = True
+    except Exception:
+        pass
+
+    return bool(enabled)
+

poelis_sdk/items.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 from typing import Generator, Any, Optional, Dict, List
 
 from ._transport import Transport
-from .org_validation import validate_item_organization, filter_by_organization
 
 """Items resource client."""
 
@@ -22,7 +21,7 @@ class ItemsClient:
 
         query = (
             "query($pid: ID!, $q: String, $limit: Int!, $offset: Int!) {\n"
-            "  items(productId: $pid, q: $q, limit: $limit, offset: $offset) { id name code description productId parentId owner orgId }\n"
+            "  items(productId: $pid, q: $q, limit: $limit, offset: $offset) { id name code description productId parentId owner position }\n"
             "}"
         )
         variables = {"pid": product_id, "q": q, "limit": int(limit), "offset": int(offset)}
@@ -34,11 +33,7 @@ class ItemsClient:
         
         items = payload.get("data", {}).get("items", [])
         
-        # Client-side organization filtering as backup protection
-        expected_org_id = self._t._org_id
-        filtered_items = filter_by_organization(items, expected_org_id, "items")
-        
-        return filtered_items
+        return items
 
     def get(self, item_id: str) -> Dict[str, Any]:
         """Get a single item by id via GraphQL.
@@ -48,7 +43,7 @@ class ItemsClient:
 
         query = (
             "query($id: ID!) {\n"
-            "  item(id: $id) { id name code description productId parentId owner orgId }\n"
+            "  item(id: $id) { id name code description productId parentId owner position }\n"
             "}"
         )
         resp = self._t.graphql(query=query, variables={"id": item_id})
@@ -61,10 +56,6 @@ class ItemsClient:
         if item is None:
             raise RuntimeError(f"Item with id '{item_id}' not found")
         
-        # Validate that the item belongs to the configured organization
-        expected_org_id = self._t._org_id
-        validate_item_organization(item, expected_org_id)
-        
         return item
 
     def iter_all_by_product(self, *, product_id: str, q: Optional[str] = None, page_size: int = 100) -> Generator[dict, None, None]:

poelis_sdk/search.py

@@ -14,11 +14,11 @@ class SearchClient:
         self._t = transport
 
     def products(self, *, q: str, workspace_id: str, limit: int = 20, offset: int = 0) -> Dict[str, Any]:
-        """Search/list products via GraphQL products(workspace_id, q)."""
+        """Search/list products via GraphQL products(workspaceId, q)."""
 
         query = (
             "query($ws: ID!, $q: String, $limit: Int!, $offset: Int!) {\n"
-            "  products(workspace_id: $ws, q: $q, limit: $limit, offset: $offset) { id name code description workspace_id }\n"
+            "  products(workspaceId: $ws, q: $q, limit: $limit, offset: $offset) { id name code description workspaceId }\n"
             "}"
         )
         variables = {"ws": workspace_id, "q": q, "limit": int(limit), "offset": int(offset)}
@@ -35,7 +35,7 @@ class SearchClient:
 
         query = (
             "query($pid: ID!, $q: String, $parent: ID, $limit: Int!, $offset: Int!) {\n"
-            "  items(productId: $pid, q: $q, parentItemId: $parent, limit: $limit, offset: $offset) { id name code description productId parentId owner }\n"
+            "  items(productId: $pid, q: $q, parentItemId: $parent, limit: $limit, offset: $offset) { id name code description productId parentId owner position }\n"
             "}"
         )
         variables = {"pid": product_id, "q": q, "parent": parent_item_id, "limit": int(limit), "offset": int(offset)}

{poelis_sdk-0.1.8.dist-info → poelis_sdk-0.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: poelis-sdk
-Version: 0.1.8
+Version: 0.2.0
 Summary: Official Python SDK for Poelis
 Project-URL: Homepage, https://poelis.com
 Project-URL: Source, https://github.com/PoelisTechnologies/poelis-python-sdk
@@ -42,22 +42,6 @@ client = PoelisClient(
     api_key="poelis_live_A1B2C3...",    # Organization Settings → API Keys
     org_id="tenant_uci_001",            # same section
 )
-
-# Workspaces → Products
-workspaces = client.workspaces.list(limit=10, offset=0)
-ws_id = workspaces[0]["id"]
-
-page = client.products.list_by_workspace(workspace_id=ws_id, limit=10, offset=0)
-print([p.name for p in page.data])
-
-# Items for a product
-pid = page.data[0].id
-items = client.items.list_by_product(product_id=pid, limit=10, offset=0)
-print([i.get("name") for i in items])
-
-# Property search
-props = client.search.properties(q="*", workspace_id=ws_id, limit=10, offset=0)
-print(props["total"], len(props["hits"]))
 ```
 
 ## Configuration
@@ -73,7 +57,6 @@ print(props["total"], len(props["hits"]))
 ```bash
 export POELIS_API_KEY=poelis_live_A1B2C3...
 export POELIS_ORG_ID=tenant_id_001
-# POELIS_BASE_URL is optional - defaults to the managed GCP endpoint
 ```
 
 

{poelis_sdk-0.1.8.dist-info → poelis_sdk-0.2.0.dist-info}/RECORD

@@ -1,17 +1,17 @@
 poelis_sdk/__init__.py,sha256=vRKuvnMGtq2_6SYDPNpckSPYXTgMDD1vBAfZ1bXlHL0,924
 poelis_sdk/_transport.py,sha256=F5EX0EJFHJPAE638nKzlX5zLSU6FIMzMemqgh05_V6U,6061
 poelis_sdk/auth0.py,sha256=VDZHCv9YpsW55H-PLINKMq74UhevP6OWyBHQyEFIpvw,3163
-poelis_sdk/browser.py,sha256=i3j2G2eDCD8JPPtRnU-z_AOup0aBGIKisilVmJuqb-w,12645
+poelis_sdk/browser.py,sha256=D-9Xgj1SBy4DQa6Ow8gQ1DOWhy373WqYJMYIiXFXlgM,19803
 poelis_sdk/client.py,sha256=10__5po-foX36ZCCduQmzdoh9NNS320kyaqztUNtPvo,3872
 poelis_sdk/exceptions.py,sha256=qX5kpAr8ozJUOW-CNhmspWVIE-bvUZT_PUnimYuBxNY,1101
-poelis_sdk/items.py,sha256=laRHVCaTkMmNQyXs6_IVrsyj6whMxSN8Qi6aPQ4dN00,3036
+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=JYLz4yV3GZPlif05OqYK2xPoAD1b4XKTmriil4NHTOs,4095
+poelis_sdk/search.py,sha256=KQbdnu2khQDewddSJHR7JWysH1f2M7swK6MR-ZwrLAE,4101
 poelis_sdk/workspaces.py,sha256=hpmRl-Hswr4YDvObQdyVpegIYjUWno7A_BiVBz-AQGc,2383
-poelis_sdk-0.1.8.dist-info/METADATA,sha256=vTAHh3-5wdnTWEylMj8sUIx_nIpvuFZ5D7jv9rU8YN8,2813
-poelis_sdk-0.1.8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-poelis_sdk-0.1.8.dist-info/licenses/LICENSE,sha256=EEmE_r8wk_pdXB8CWp1LG6sBOl7--hNSS2kV94cI6co,1075
-poelis_sdk-0.1.8.dist-info/RECORD,,
+poelis_sdk-0.2.0.dist-info/METADATA,sha256=zV8xPL_4dDRJ8QfzuX2zMswzDi_huEg2DdsFaB32kZ0,2219
+poelis_sdk-0.2.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+poelis_sdk-0.2.0.dist-info/licenses/LICENSE,sha256=EEmE_r8wk_pdXB8CWp1LG6sBOl7--hNSS2kV94cI6co,1075
+poelis_sdk-0.2.0.dist-info/RECORD,,