hexdb 2.2.0__tar.gz → 2.3.0__tar.gz

{hexdb-2.2.0 → hexdb-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hexdb
-Version: 2.2.0
+Version: 2.3.0
 Summary: Client for HexDB, the hexagonal document database.
 Author: Dream In Hex
 License-Expression: Apache-2.0

{hexdb-2.2.0 → hexdb-2.3.0}/hexdb/__init__.py

@@ -26,7 +26,7 @@ import urllib.request
 from typing import Any, BinaryIO, Callable, Dict, Iterator, List, Optional, Sequence, Tuple, Union
 
 __all__ = ["HexDB", "HexDBError", "Tessellation", "Stream", "Files"]
-__version__ = "2.2.0"
+__version__ = "2.3.0"
 
 Json = Any
 Document = Dict[str, Any]
@@ -305,6 +305,11 @@ class Tessellation:
         """Insert or replace documents matched by key fields."""
         return self.db.request("POST", f"{self.path}/_upsert", {"key": key if isinstance(key, str) else list(key), "documents": list(docs)}, _idem(idempotency_key))
 
+    def detokenize(self, tokens: Sequence[str]) -> Dict[str, Optional[str]]:
+        """The values behind vault tokens of tokenized fields (up to 1,000; needs the
+        detokenize permission; audited). One-way and unknown tokens map to None."""
+        return self.db.request("POST", f"/tessellations/{_quote(self.name)}/detokenize", {"tokens": list(tokens)})["values"]
+
     def update_where(self, filter: Dict[str, Any], update: Dict[str, Any]) -> Dict[str, int]:
         return self.db.request("POST", f"{self.path}/_update", {"filter": filter, "update": update})
 

{hexdb-2.2.0 → hexdb-2.3.0}/hexdb.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hexdb
-Version: 2.2.0
+Version: 2.3.0
 Summary: Client for HexDB, the hexagonal document database.
 Author: Dream In Hex
 License-Expression: Apache-2.0

{hexdb-2.2.0 → hexdb-2.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hexdb"
-version = "2.2.0"
+version = "2.3.0"
 description = "Client for HexDB, the hexagonal document database."
 readme = "README.md"
 requires-python = ">=3.9"

{hexdb-2.2.0 → hexdb-2.3.0}/tests/test_client.py

@@ -86,6 +86,15 @@ class ClientTest(unittest.TestCase):
         thread.join(timeout=35)
         self.assertEqual(received[0]["id"], doc["id"])
 
+    def test_tokenized_fields(self):
+        accounts = self.tess("accounts")
+        accounts.insert({"card": "0000000000000000"})
+        self.db.request("POST", f"/tessellations/{accounts.name}/schemas", {"fields": {"card": {"type": "string", "tokenize": "vault"}}})
+        doc = accounts.insert({"card": "4111111111111111"})
+        self.assertTrue(doc["card"].startswith("tok_") and doc["card"].endswith("_1111"), doc["card"])
+        self.assertEqual(accounts.query({"card": "4111111111111111"})["documents"][0]["id"], doc["id"])
+        self.assertEqual(accounts.detokenize([doc["card"]])[doc["card"]], "4111111111111111")
+
     def test_streams(self):
         name = f"{self.prefix}-events"
         self.db.request("POST", "/streams", {"name": name})