schemabind 0.1.0__py3-none-any.whl

schemabind/__init__.py

@@ -0,0 +1 @@
+from schemabind.core import bind

schemabind/core.py

@@ -0,0 +1,45 @@
+class BoundRow:
+    def __init__(self, data):
+        self._data = data
+        self._normalized_keys = {}
+
+        for key in data.keys():
+            normalized_key = key.lower().replace(" ", "_")
+            if normalized_key in self._normalized_keys:
+                raise ValueError(
+                    f"Duplicate normalized key '{normalized_key}' for original keys "
+                    f"'{self._normalized_keys[normalized_key]}' and '{key}'"
+                )
+            self._normalized_keys[normalized_key] = key
+
+    def __getattr__(self, name):
+        if name not in self._normalized_keys:
+            available_fields = ", ".join(self._data.keys())
+            raise AttributeError(
+                f"Field '{name}' not found. " f"Available fields: {available_fields}"
+            )
+
+        original_key = self._normalized_keys[name]
+        return self._data[original_key]
+
+    def __repr__(self):
+        return f"BoundRow(keys={list(self._data.keys())})"
+
+    def keys(self):
+        return self._data.keys()
+
+    def values(self):
+        return self._data.values()
+
+    def items(self):
+        return self._data.items()
+
+    def get(self, key, default=None):
+        return self._data.get(key, default)
+
+
+def bind(data):
+    if not isinstance(data, dict):
+        raise TypeError(f"Expected dict, got {type(data).__name__}")
+
+    return BoundRow(data)

schemabind-0.1.0.dist-info/METADATA

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: schemabind
+Version: 0.1.0
+Summary: Expose existing dictionary fields as readable Python attributes.
+Author: Adam
+License-Expression: MIT
+Project-URL: Repository, https://github.com/adamhx2/SchemaBind
+Project-URL: Issues, https://github.com/adamhx2/SchemaBind/issues
+Keywords: dictionary,attributes,csv,schema,developer-tools
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# SchemaBind
+
+SchemaBind reduces repetitive dictionary lookup boilerplate by exposing existing fields as readable Python attributes.
+
+Instead of:
+
+```python
+first_name = row["first_name"]
+email = row["email_address"]
+phone = row.get("phone_number")
+```
+
+Use:
+
+```python
+from schemabind import bind
+
+customer = bind(row)
+
+customer.first_name
+customer.email_address
+customer.phone_number
+```
+
+SchemaBind is currently focused on dictionaries, including rows produced by `csv.DictReader`.
+
+It does not create schemas, validate data, transform values, or infer new fields. It simply provides a cleaner way to access fields that already exist.
+
+## Example
+
+```python
+import csv
+from schemabind import bind
+
+with open("samples/csv/customer.csv") as f:
+    rows = list(csv.DictReader(f))
+
+customer = bind(rows[0])
+
+print(customer.first_name)
+print(customer.email_address)
+print(customer.phone_number)
+```
+
+Missing attributes raise `AttributeError` instead of silently returning `None`, which helps catch typos in field names.
+
+## Field Normalization
+
+SchemaBind supports simple field-name normalization for attribute access.
+
+For example:
+
+```python
+customer = bind({"First Name": "Kaladin"})
+
+print(customer.first_name)
+```
+
+The original dictionary keys are preserved for dictionary-style helpers:
+
+```python
+customer.keys()
+customer.get("First Name")
+```
+
+If multiple fields normalize to the same attribute name, SchemaBind raises `ValueError` instead of guessing which field to use.
+
+For example:
+
+```python
+bind({
+    "First Name": "Dalinar",
+    "first_name": "Shallan",
+})
+```
+
+Both fields would normalize to `first_name`, so the binding is rejected as ambiguous.

schemabind-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+schemabind/__init__.py,sha256=CGMdtSwFIF0554pzUDHjvlVbS4UZ_UPCAMPC3ojLZVE,34
+schemabind/core.py,sha256=4wrsaYA-oCBgAVkTj6eqV26rMX1D95jiEbqQgg0-DlQ,1421
+schemabind-0.1.0.dist-info/METADATA,sha256=mQzWK3BVaD5XHW1X5Uj_ypALd2QmflXoXT73A1jkjBw,2464
+schemabind-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+schemabind-0.1.0.dist-info/top_level.txt,sha256=ZOSVrFNBAbOQL6ub6H2Ngzpch4X-GZ3PjADGFzB6LYw,11
+schemabind-0.1.0.dist-info/RECORD,,

schemabind-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

schemabind-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+schemabind