python-bunch 0.1.0__tar.gz → 0.1.1__tar.gz

{python_bunch-0.1.0 → python_bunch-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-bunch
-Version: 0.1.0
+Version: 0.1.1
 Summary: A lightweight Python class that behaves like a dict but supports attribute-style access.
 Author-email: Your Name <your.email@example.com>
 License: MIT
@@ -32,10 +32,21 @@ You can install this package via PIP: _pip install bunch_
 ### <ins> Usage </ins>
 
 ```python
-from bunch import Bunch
+# - Mutable Bunch -
+from bunch.bunch import Bunch
 
 my_bunch = Bunch({'name': 'Jane', 'age': 30})
 
 print(my_bunch.name)  # Output: Jane
 print(my_bunch['age'])  # Output: 30
+
+# - Immutable Bunch -
+from bunch.immutable_bunch import ImmutableBunch
+
+my_immutable_bunch = ImmutableBunch({'name': 'John', 'age': 25})
+print(my_immutable_bunch.name)  # Output: John
+print(my_immutable_bunch['age'])  # Output: 35
+
+# Attempting to modify an ImmutableBunch will raise an Exception
+my_immutable_bunch.name = 'Alice'  # Raises ImmutableBunchException
 ```

{python_bunch-0.1.0 → python_bunch-0.1.1}/README.md

@@ -17,10 +17,21 @@ You can install this package via PIP: _pip install bunch_
 ### <ins> Usage </ins>
 
 ```python
-from bunch import Bunch
+# - Mutable Bunch -
+from bunch.bunch import Bunch
 
 my_bunch = Bunch({'name': 'Jane', 'age': 30})
 
 print(my_bunch.name)  # Output: Jane
 print(my_bunch['age'])  # Output: 30
+
+# - Immutable Bunch -
+from bunch.immutable_bunch import ImmutableBunch
+
+my_immutable_bunch = ImmutableBunch({'name': 'John', 'age': 25})
+print(my_immutable_bunch.name)  # Output: John
+print(my_immutable_bunch['age'])  # Output: 35
+
+# Attempting to modify an ImmutableBunch will raise an Exception
+my_immutable_bunch.name = 'Alice'  # Raises ImmutableBunchException
 ```

python_bunch-0.1.1/bunch/bunch.py

@@ -0,0 +1,70 @@
+import json
+from typing import Any
+
+
+class Bunch:
+    def __init__(self, *args, **kwargs):
+        for arg in args:
+            if not isinstance(arg, dict):
+                kwargs[arg] = None
+        self.__dict__.update(kwargs)
+
+    def __getitem__(self, key: Any) -> Any or None:
+        return self.__dict__.get(key, None)
+
+    def __setitem__(self, key: Any, value: Any) -> None:
+        self.__dict__[key] = value
+
+    def __delitem__(self, key: Any) -> None:
+        del self.__dict__[key]
+
+    def __contains__(self, key: Any) -> bool:
+        return key in self.__dict__
+
+    def __str__(self) -> str:
+        return json.dumps(self.__dict__, sort_keys=False)
+
+    def __repr__(self) -> str:
+        return self.__str__()
+
+    def __getattr__(self, key: Any) -> Any or None:
+        if key in self.__dict__:
+            return self.__dict__[key]
+        return None
+
+    def __setattr__(self, name: str, value: Any) -> None:
+        self.__dict__[name] = value
+
+    def __delattr__(self, name) -> None:
+        del self.__dict__[name]
+
+    def contains_value(self, value: Any) -> bool:
+        return value in self.__dict__.values()
+
+    def clear(self) -> None:
+        self.__dict__.clear()
+
+    def pop(self, key: Any, default: Any = None) -> Any or None:
+        return self.__dict__.pop(key, default)
+
+    def popitem(self) -> Any or None:
+        return self.__dict__.popitem()
+
+    def update(self, other: dict) -> None:
+        self.__dict__.update(other)
+
+    def setdefault(self, key: Any, default: Any = None) -> Any or None:
+        return self.__dict__.setdefault(key, default)
+
+    def keys(self):
+        return self.__dict__.keys()
+
+    def values(self):
+        return self.__dict__.values()
+
+    def items(self):
+        return self.__dict__.items()
+
+    @staticmethod
+    def from_dict(dictionary: dict) -> Any:
+        return Bunch(**dictionary)

python_bunch-0.1.1/bunch/immutable_bunch.py

@@ -0,0 +1,75 @@
+import json
+from typing import Any
+
+
+class ImmutableBunchException(Exception):
+    def __init__(self, message: str) -> None:
+        super().__init__(message)
+
+
+class ImmutableBunch:
+    def __init__(self, *args, **kwargs):
+        for arg in args:
+            if not isinstance(arg, dict):
+                kwargs[arg] = None
+        self.__dict__.update(kwargs)
+
+    def __getitem__(self, key: Any) -> Any or None:
+        return self.__dict__.get(key, None)
+
+    def __setitem__(self, key: Any, value: Any) -> None:
+        raise ImmutableBunchException('ImmutableBunch does not support item assignment')
+
+    def __delitem__(self, key: Any) -> None:
+        raise ImmutableBunchException('ImmutableBunch does not support item deletion')
+
+    def __contains__(self, key: Any) -> bool:
+        return key in self.__dict__
+
+    def __str__(self) -> str:
+        return json.dumps(self.__dict__, sort_keys=False)
+
+    def __repr__(self) -> str:
+        return self.__str__()
+
+    def __getattr__(self, key: Any) -> Any or None:
+        if key in self.__dict__:
+            return self.__dict__[key]
+        return None
+
+    def __setattr__(self, name: str, value: Any) -> None:
+        raise ImmutableBunchException('ImmutableBunch does not support attribute assignment')
+
+    def __delattr__(self, name) -> None:
+        raise ImmutableBunchException('ImmutableBunch does not support attribute deletion')
+
+    def contains_value(self, value: Any) -> bool:
+        return value in self.__dict__.values()
+
+    def clear(self) -> None:
+        raise ImmutableBunchException('ImmutableBunch does not support clearing')
+
+    def pop(self, key: Any, default: Any = None) -> Any or None:
+        raise ImmutableBunchException('ImmutableBunch does not support popping')
+
+    def popitem(self) -> Any or None:
+        raise ImmutableBunchException('ImmutableBunch does not support popitem')
+
+    def update(self, other: dict) -> None:
+        raise ImmutableBunchException('ImmutableBunch does not support update')
+
+    def setdefault(self, key: Any, default: Any = None) -> Any or None:
+        raise ImmutableBunchException('ImmutableBunch does not support setdefault')
+
+    def keys(self):
+        return self.__dict__.keys()
+
+    def values(self):
+        return self.__dict__.values()
+
+    def items(self):
+        return self.__dict__.items()
+
+    @staticmethod
+    def from_dict(dictionary: dict) -> Any:
+        return ImmutableBunch(**dictionary)

{python_bunch-0.1.0 → python_bunch-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-bunch"
-version = "0.1.0"
+version = "0.1.1"
 description = "A lightweight Python class that behaves like a dict but supports attribute-style access."
 readme = "README.md"
 requires-python = ">=3.7"

{python_bunch-0.1.0 → python_bunch-0.1.1}/python_bunch.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-bunch
-Version: 0.1.0
+Version: 0.1.1
 Summary: A lightweight Python class that behaves like a dict but supports attribute-style access.
 Author-email: Your Name <your.email@example.com>
 License: MIT
@@ -32,10 +32,21 @@ You can install this package via PIP: _pip install bunch_
 ### <ins> Usage </ins>
 
 ```python
-from bunch import Bunch
+# - Mutable Bunch -
+from bunch.bunch import Bunch
 
 my_bunch = Bunch({'name': 'Jane', 'age': 30})
 
 print(my_bunch.name)  # Output: Jane
 print(my_bunch['age'])  # Output: 30
+
+# - Immutable Bunch -
+from bunch.immutable_bunch import ImmutableBunch
+
+my_immutable_bunch = ImmutableBunch({'name': 'John', 'age': 25})
+print(my_immutable_bunch.name)  # Output: John
+print(my_immutable_bunch['age'])  # Output: 35
+
+# Attempting to modify an ImmutableBunch will raise an Exception
+my_immutable_bunch.name = 'Alice'  # Raises ImmutableBunchException
 ```

{python_bunch-0.1.0 → python_bunch-0.1.1}/python_bunch.egg-info/SOURCES.txt

@@ -3,8 +3,10 @@ README.md
 pyproject.toml
 bunch/__init__.py
 bunch/bunch.py
+bunch/immutable_bunch.py
 python_bunch.egg-info/PKG-INFO
 python_bunch.egg-info/SOURCES.txt
 python_bunch.egg-info/dependency_links.txt
 python_bunch.egg-info/top_level.txt
-tests/test_bunch.py
+tests/test_bunch.py
+tests/test_immutable_bunch.py

python_bunch-0.1.1/tests/test_bunch.py

@@ -0,0 +1,108 @@
+import json
+import unittest
+from collections import Counter
+
+from bunch.bunch import Bunch
+
+
+class TestBunch(unittest.TestCase):
+    def test_getitem(self):
+        b = Bunch(name='Alice', age=30)
+        self.assertEqual(b['name'], 'Alice')
+
+    def test_setitem(self):
+        b = Bunch(name='Alice')
+        b['age'] = 30
+        self.assertEqual(b.age, 30)
+
+    def test_delitem(self):
+        b = Bunch(name='Alice', age=30)
+        del b['name']
+        self.assertEqual(b.name, None)
+
+    def test_contains(self):
+        b = Bunch(name='Alice', age=30)
+        self.assertTrue('name' in b)
+        self.assertFalse('location' in b)
+
+    def test_str(self):
+        b = Bunch(name='Alice', age=30)
+        expected_str = json.dumps({'name': 'Alice', 'age': 30})
+        self.assertEqual(b.__str__(), expected_str)
+
+    def test_repr(self):
+        b = Bunch(name='Alice', age=30)
+        expected_repr = json.dumps({'name': 'Alice', 'age': 30})
+        self.assertEqual(b.__repr__(), expected_repr)
+
+    def test_getattr(self):
+        b = Bunch(name='Alice', age=30)
+        self.assertEqual(b.age, 30)
+
+    def test_setattr(self):
+        b = Bunch(name='Alice', age=30)
+        b.age = 40
+        b.location = 'New York'
+        self.assertEqual(b.age, 40)
+        self.assertEqual(b.location, 'New York')
+
+    def test_delattr(self):
+        b = Bunch(name='Alice', age=30)
+        del b.age
+        self.assertEqual(b.age, None)
+
+    def test_contains_value(self):
+        b = Bunch(name='Alice', age=30)
+        self.assertTrue(b.contains_value('Alice'))
+        self.assertFalse(b.contains_value('Bob'))
+
+    def test_clear(self):
+        b = Bunch(name='Alice', age=30)
+        b.clear()
+        self.assertEqual(len(b.keys()), 0)
+
+    def test_pop(self):
+        b = Bunch(name='Alice', age=30)
+        popped_value = b.pop('name')
+        self.assertEqual(popped_value, 'Alice')
+        self.assertEqual(b.name, None)
+
+    def test_popitem(self):
+        b = Bunch(name='Alice', age=30)
+        popped_value = b.popitem()
+        self.assertEqual(popped_value, ('age', 30))
+        self.assertEqual(b.age, None)
+
+    def test_update(self):
+        b = Bunch(name='Alice', age=30)
+        d = {'name': 'Bob', 'age': 35}
+        b.update(d)
+        self.assertEqual(d['name'], 'Bob')
+        self.assertEqual(d['age'], 35)
+
+    def test_setdefault(self):
+        b = Bunch(name='Alice', age=30)
+        b.setdefault('location')
+        self.assertEqual(b.location, None)
+
+    def test_keys(self):
+        b = Bunch(name='Alice', age=30)
+        self.assertEqual(Counter(b.keys()), Counter(['name', 'age']))
+
+    def test_values(self):
+        b = Bunch(name='Alice', age=30)
+        self.assertEqual(Counter(b.values()), Counter(['Alice', 30]))
+
+    def test_items(self):
+        b = Bunch(name='Alice', age=30)
+        self.assertEqual(Counter(b.items()), Counter([('name', 'Alice'), ('age', 30)]))
+
+    def test_from_dict(self):
+        data = {'fruit': 'apple', 'color': 'red'}
+        b = Bunch.from_dict(data)
+        self.assertEqual(b.fruit, 'apple')
+        self.assertEqual(b.color, 'red')
+
+
+if __name__ == '__main__':
+    unittest.main()

python_bunch-0.1.1/tests/test_immutable_bunch.py

@@ -0,0 +1,114 @@
+import json
+import unittest
+from collections import Counter
+from contextlib import contextmanager
+
+from bunch.immutable_bunch import ImmutableBunch, ImmutableBunchException
+
+
+@contextmanager
+def raise_immutable_exception():
+    try:
+        yield
+    except ImmutableBunchException:
+        pass
+    else:
+        raise Exception('ImmutableBunchException not raised as expected')
+
+
+class TestBunch(unittest.TestCase):
+    def test_getitem(self):
+        ib = ImmutableBunch(name='Alice', age=30)
+        self.assertEqual(ib['name'], 'Alice')
+
+    def test_setitem(self):
+        ib = ImmutableBunch(name='Alice')
+        with raise_immutable_exception():
+            ib['age'] = 30
+
+    def test_delitem(self):
+        ib = ImmutableBunch(name='Alice', age=30)
+        with raise_immutable_exception():
+            del ib['name']
+
+    def test_contains(self):
+        ib = ImmutableBunch(name='Alice', age=30)
+        self.assertTrue('name' in ib)
+        self.assertFalse('location' in ib)
+
+    def test_str(self):
+        ib = ImmutableBunch(name='Alice', age=30)
+        expected_str = json.dumps({'name': 'Alice', 'age': 30})
+        self.assertEqual(ib.__str__(), expected_str)
+
+    def test_repr(self):
+        ib = ImmutableBunch(name='Alice', age=30)
+        expected_repr = json.dumps({'name': 'Alice', 'age': 30})
+        self.assertEqual(ib.__repr__(), expected_repr)
+
+    def test_getattr(self):
+        ib = ImmutableBunch(name='Alice', age=30)
+        self.assertEqual(ib.age, 30)
+
+    def test_setattr(self):
+        ib = ImmutableBunch(name='Alice', age=30)
+        with raise_immutable_exception():
+            ib.age = 40
+
+    def test_delattr(self):
+        ib = ImmutableBunch(name='Alice', age=30)
+        with raise_immutable_exception():
+            del ib.age
+
+    def test_contains_value(self):
+        ib = ImmutableBunch(name='Alice', age=30)
+        self.assertTrue(ib.contains_value('Alice'))
+        self.assertFalse(ib.contains_value('Bob'))
+
+    def test_clear(self):
+        ib = ImmutableBunch(name='Alice', age=30)
+        with raise_immutable_exception():
+            ib.clear()
+
+    def test_pop(self):
+        ib = ImmutableBunch(name='Alice', age=30)
+        with raise_immutable_exception():
+            ib.pop('name')
+
+    def test_popitem(self):
+        ib = ImmutableBunch(name='Alice', age=30)
+        with raise_immutable_exception():
+            ib.popitem()
+
+    def test_update(self):
+        ib = ImmutableBunch(name='Alice', age=30)
+        d = {'name': 'Bob', 'age': 35}
+        with raise_immutable_exception():
+            ib.update(d)
+
+    def test_setdefault(self):
+        ib = ImmutableBunch(name='Alice', age=30)
+        with raise_immutable_exception():
+            ib.setdefault('location')
+
+    def test_keys(self):
+        ib = ImmutableBunch(name='Alice', age=30)
+        self.assertEqual(Counter(ib.keys()), Counter(['name', 'age']))
+
+    def test_values(self):
+        ib = ImmutableBunch(name='Alice', age=30)
+        self.assertEqual(Counter(ib.values()), Counter(['Alice', 30]))
+
+    def test_items(self):
+        ib = ImmutableBunch(name='Alice', age=30)
+        self.assertEqual(Counter(ib.items()), Counter([('name', 'Alice'), ('age', 30)]))
+
+    def test_from_dict(self):
+        data = {'fruit': 'apple', 'color': 'red'}
+        ib = ImmutableBunch.from_dict(data)
+        self.assertEqual(ib.fruit, 'apple')
+        self.assertEqual(ib.color, 'red')
+
+
+if __name__ == '__main__':
+    unittest.main()

python_bunch-0.1.0/bunch/bunch.py

@@ -1,44 +0,0 @@
-import json
-from typing import Any
-
-
-class Bunch:
-    def __init__(self, *args, **kwargs):
-        for arg in args:
-            if not isinstance(arg, dict):
-                kwargs[arg] = None
-        self.__dict__.update(kwargs)
-
-    def __getitem__(self, key):
-        return self.__dict__[key]
-
-    def __setitem__(self, key, value):
-        self.__dict__[key] = value
-
-    def __contains__(self, key):
-        return key in self.__dict__
-
-    def __str__(self):
-        return json.dumps(self.__dict__, indent=4, sort_keys=False)
-
-    def __repr__(self):
-        return self.__str__()
-
-    def __delitem__(self, key):
-        del self.__dict__[key]
-
-    def contains_value(self, value):
-        return value in self.__dict__.values()
-
-    def keys(self):
-        return self.__dict__.keys()
-
-    def values(self):
-        return self.__dict__.values()
-
-    def items(self):
-        return self.__dict__.items()
-
-    @staticmethod
-    def from_dict(dictionary: dict) -> Any:
-        return Bunch(**dictionary)

python_bunch-0.1.0/tests/test_bunch.py

@@ -1,37 +0,0 @@
-import unittest
-from bunch.bunch import Bunch
-
-class TestBunch(unittest.TestCase):
-    def test_init(self):
-        b = Bunch(name='Alice', age=30)
-        self.assertEqual(b.name, 'Alice')
-        self.assertEqual(b.age, 30)
-
-    def test_getitem(self):
-        b = Bunch(name='Alice', age=30)
-        self.assertEqual(b['name'], 'Alice')
-
-    def test_setitem(self):
-        b = Bunch(name='Alice')
-        b['age'] = 30
-        self.assertEqual(b.age, 30)
-
-    def test_contains(self):
-        b = Bunch(name='Alice', age=30)
-        self.assertTrue('name' in b)
-        self.assertFalse('location' in b)
-
-    def test_contains_value(self):
-        b = Bunch(name='Alice', age=30)
-        self.assertTrue(b.contains_value('Alice'))
-        self.assertFalse(b.contains_value('Bob'))
-
-    def test_from_dict(self):
-        # Test from_dict static method
-        data = {'fruit': 'apple', 'color': 'red'}
-        b = Bunch.from_dict(data)
-        self.assertEqual(b.fruit, 'apple')
-        self.assertEqual(b.color, 'red')
-
-if __name__ == '__main__':
-    unittest.main()