upp-python 0.1.0__py3-none-any.whl

upp_python-0.1.0.dist-info/METADATA

@@ -0,0 +1,137 @@
+Metadata-Version: 2.4
+Name: upp-python
+Version: 0.1.0
+Summary: Python reference implementation of the Universal Personalization Protocol (UPP) data models
+Project-URL: Homepage, https://github.com/Contextually-AI/upp
+Project-URL: Documentation, https://github.com/Contextually-AI/upp/tree/main/spec
+Project-URL: Repository, https://github.com/Contextually-AI/upp
+Project-URL: Issues, https://github.com/Contextually-AI/upp/issues
+Project-URL: Changelog, https://github.com/Contextually-AI/upp/blob/main/CHANGELOG.md
+Author: UPP Protocol Authors
+License-Expression: MIT
+Keywords: json-rpc,personalization,protocol,pydantic,user-profile
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# UPP Python — Reference Implementation
+
+Python reference implementation of the [Universal Personalization Protocol (UPP)](../../spec/01-overview.md) data models, backends, and client.
+
+## Installation
+
+```bash
+pip install upp-python
+```
+
+### Development
+
+```bash
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```python
+from upp import Event, StoredEvent, SourceType, EventStatus
+from upp import LabelDefinition, OntologyUserV1, UPPClient
+
+# Create an event (pre-storage)
+event = Event(
+    value="I work as a senior software engineer at Anthropic",
+    labels=["what_occupation"],
+    confidence=0.95,
+    source_type=SourceType.USER_STATED,
+)
+
+# Use with a client (requires backend implementations)
+import asyncio
+
+async def demo():
+    client = UPPClient(
+        ingest=my_ingest_backend,
+        retriever=my_retriever_backend,
+        ontology=OntologyUserV1(),
+    )
+    stored = await client.ingest("user-123", [event])
+    print(f"Stored: {stored[0].value} (id={stored[0].id})")
+
+    # Retrieve events
+    events = await client.get_events("user-123")
+    print(f"Total events: {len(events)}")
+
+asyncio.run(demo())
+```
+
+## Package Structure
+
+```
+src/upp/
+├── __init__.py              # Top-level exports
+├── client.py                # UPPClient — high-level protocol client
+├── models/
+│   ├── __init__.py           # Model re-exports
+│   ├── client.py             # UPPClientProtocol
+│   ├── enums.py              # EventStatus, SourceType, SensitivityTier, Cardinality, Durability
+│   ├── events.py             # Event, StoredEvent
+│   └── labels.py             # LabelDefinition
+├── backends/
+│   ├── __init__.py           # Backend re-exports
+│   ├── ingest.py             # IngestBackend protocol
+│   ├── retriever.py          # RetrieverBackend protocol
+│   └── ontology.py           # OntologyBackend protocol
+├── ontologies/
+│   ├── __init__.py
+│   └── user_v1.py            # OntologyUserV1 — loads ontologies/user/v1.json
+└── rpc/
+    ├── __init__.py           # RPC re-exports
+    ├── methods.py            # UPP_INGEST, UPP_RETRIEVE, etc.
+    ├── errors.py             # Error codes and UppError
+    ├── messages.py           # JSON-RPC types + operation request/response models
+    └── codec.py              # JSON-RPC encode/decode
+```
+
+## Protocol Operations
+
+The UPP protocol defines 8 operations:
+
+| Operation | Type | Description |
+|---|---|---|
+| `upp/ingest` | Core (write) | Extract and ingest events from text |
+| `upp/retrieve` | Core (read) | Intelligent retrieval of relevant events |
+| `upp/events` | Core (read) | List all stored events |
+| `upp/delete` | Core (write) | Delete events (GDPR compliance) |
+| `upp/info` | Discovery | Server metadata |
+| `upp/labels` | Discovery | Label definitions from an ontology |
+| `upp/export` | Portability | Export events for migration |
+| `upp/import` | Portability | Import events from another server |
+
+## Requirements
+
+- Python >= 3.11
+- Pydantic >= 2.0.0
+
+## Testing
+
+```bash
+pytest tests/ -v
+```
+
+## License
+
+MIT — See [LICENSE](../../LICENSE) for details.

upp_python-0.1.0.dist-info/RECORD

@@ -0,0 +1,25 @@
+upp/__init__.py,sha256=GH_qofYAA4EcWIuweG_0DEZnOPCmyxktwApMX9gFOtw,3818
+upp/client.py,sha256=NwLzPzcHk2aazyXNCPrToVbssLwfmkB03dyg8MmOZPo,5590
+upp/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+upp/backends/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+upp/backends/__init__.py,sha256=Yq-B_MD44wdPKD_zvuqYWsrO01ZYF36rqLGPlz4HxD4,699
+upp/backends/ingest.py,sha256=u7PEtjgB7H1JmukKFFY6SB_GKVej55a-BbR6aOCbZ5k,3472
+upp/backends/ontology.py,sha256=oAqMjFEULLXNXaM1hVz4jlOqvF3crpqmGbUNKIDmoXA,1011
+upp/backends/retriever.py,sha256=oUqT_JxSoD6PYfAMz4yHTAKo8RSvun74szH4B1ABpEU,2011
+upp/models/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+upp/models/__init__.py,sha256=Y9ZKFP7kt1KzLSwH_6yKh8JYYfSvr7Vq0ePv4hCo6y8,831
+upp/models/client.py,sha256=HlPuh1ubc7NR8fZoK86Ufg_Npd81yrMQueeYv5txEkI,3998
+upp/models/enums.py,sha256=XQMoLo58BA0Crm85Tb1lK_66VdzG40Zj9wx5R0MmzHs,3294
+upp/models/events.py,sha256=RiyLh9STmi-tjRYwxYnnihUyJhhBGJbmnojcHUGolmM,4098
+upp/models/labels.py,sha256=4jV6nMyTvINe65XAvFimdiKmaIytN7106kiQw_TY_wI,2592
+upp/ontologies/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+upp/ontologies/user_v1.py,sha256=kIrGU8LPmjO6nRAlYvimIOrBezTSD-zzPxBHEMx1x6A,3666
+upp/rpc/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+upp/rpc/__init__.py,sha256=U_k8RmSwXLdfbyx0B0O_6S1Mhv0NE0yON0KHH2y2nUs,3088
+upp/rpc/codec.py,sha256=k22IZphOEOvGCuCvjlpQL_YN3ckdx9GElvEJh9gvpbo,3012
+upp/rpc/errors.py,sha256=Gi3L_mXPyna7AWPtD7yDd7xQCH4UmjU5GXLmazsKxiE,3625
+upp/rpc/messages.py,sha256=Kg6_REn2_S2FjWs94edI_m7sAwpuMBWR9Mby_O5Ak1E,10447
+upp/rpc/methods.py,sha256=50M1arxkqNicqqBUTlHwZPtG3VeEo2A1G9tWLU_VJy4,1643
+upp_python-0.1.0.dist-info/METADATA,sha256=ob27uRTMimS5nB4M8jIXEoReq_8_TXYc9QoBkGyEhrs,4580
+upp_python-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+upp_python-0.1.0.dist-info/RECORD,,

upp_python-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any