matchescu-reference-store 0.1.0__tar.gz

matchescu_reference_store-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 matchescu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

matchescu_reference_store-0.1.0/PKG-INFO

@@ -0,0 +1,43 @@
+Metadata-Version: 2.1
+Name: matchescu-reference-store
+Version: 0.1.0
+Summary: Storage options for entity references
+License: MIT
+Author: Andrei Olar
+Author-email: andrei.olar@samlex.ro
+Requires-Python: >=3.12,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: matchescu-base (>=0.11.0,<0.12.0)
+Description-Content-Type: text/markdown
+
+# Reference Store
+
+The entity reference store's main job is to keep entity references known by the system.
+Depending on the entity resolution model being used, it may persist relations between
+entity references.
+
+The entity reference store logically organizes the data it stores in workspaces.
+Each workspace corresponds to an entity resolution problem domain. For example,
+users might have one workspace for resolving publications across multiple data sources
+and another workspace for resolving e-commerce products across vendor databases.
+
+# Development
+
+First, ensure that the package builds locally and that the automated test suite runs
+fine.
+
+```shell
+$ make bootstrap
+$ make test
+```
+
+Then follow the coding guidelines to submit new contributions.
+
+# Usage
+
+This package is meant to be used as a subsystem in a larger entity resolution pipeline.
+The functionalities should be imported and used as per the pipeline's requirements.
+

matchescu_reference_store-0.1.0/README.md

@@ -0,0 +1,27 @@
+# Reference Store
+
+The entity reference store's main job is to keep entity references known by the system.
+Depending on the entity resolution model being used, it may persist relations between
+entity references.
+
+The entity reference store logically organizes the data it stores in workspaces.
+Each workspace corresponds to an entity resolution problem domain. For example,
+users might have one workspace for resolving publications across multiple data sources
+and another workspace for resolving e-commerce products across vendor databases.
+
+# Development
+
+First, ensure that the package builds locally and that the automated test suite runs
+fine.
+
+```shell
+$ make bootstrap
+$ make test
+```
+
+Then follow the coding guidelines to submit new contributions.
+
+# Usage
+
+This package is meant to be used as a subsystem in a larger entity resolution pipeline.
+The functionalities should be imported and used as per the pipeline's requirements.

matchescu_reference_store-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[tool.poetry]
+name = "matchescu-reference-store"
+version = "0.1.0"
+description = "Storage options for entity references"
+authors = ["Andrei Olar <andrei.olar@samlex.ro>"]
+license = "MIT"
+readme = "README.md"
+packages = [{include="matchescu", from="src"}]
+
+[tool.poetry.dependencies]
+python = "^3.12"
+matchescu-base = "^0.11.0"
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[tool.poetry.group.dev.dependencies]
+black = "^25.1.0"
+ruff = "^0.11.1"
+mypy = "^1.15.0"
+pytest = "^8.3.5"
+

matchescu_reference_store-0.1.0/src/matchescu/reference_store/_exceptions.py

@@ -0,0 +1,8 @@
+from matchescu.typing import EntityReferenceIdentifier
+
+
+class EntityReferenceNotFound(Exception):
+    def __init__(self, identifier: EntityReferenceIdentifier) -> None:
+        super().__init__(
+            f"Entity reference with label '{identifier.label}' from source '{identifier.source}' not found"
+        )

matchescu_reference_store-0.1.0/src/matchescu/reference_store/id_table/_in_memory.py

@@ -0,0 +1,36 @@
+from functools import partial
+from typing import Iterable, Hashable
+
+from matchescu.reference_store._exceptions import EntityReferenceNotFound
+from matchescu.typing import EntityReference, EntityReferenceIdentifier
+
+
+class InMemoryIdTable(object):
+    def __init__(self):
+        self._id_table = {}
+
+    def __len__(self) -> int:
+        return len(self._id_table)
+
+    def __iter__(self) -> Iterable[EntityReference]:
+        return iter(self._id_table.values())
+
+    def put(self, ref: EntityReference) -> None:
+        if ref is None:
+            return
+        self._id_table[ref.id] = ref
+
+    def get(self, source: str, label: Hashable) -> EntityReference:
+        identifier = EntityReferenceIdentifier(label, source)
+        if identifier not in self._id_table:
+            raise EntityReferenceNotFound(identifier)
+        return self._id_table[identifier]
+
+    @staticmethod
+    def __has_source(identifier: EntityReferenceIdentifier, source: str) -> bool:
+        return identifier.source == source
+
+    def get_by_source(self, source: str) -> Iterable[EntityReference]:
+        has_source = partial(self.__has_source, source=source)
+        ids_with_source = filter(has_source, self._id_table.keys())
+        return map(self._id_table.get, ids_with_source)