python-bunch 0.1.9

A lightweight Python class that behaves like a dict but supports attribute-style access.

Bunch

A simple Python class that allows dictionary-style and attribute-style access to data interchangeably. Think of it as a lightweight object wrapper for dictionaries — great for config objects, JSON responses, or anything else you'd normally throw in a dict.

Features

• Access keys as attributes or like a dictionary
• Convert from regular dictionaries
• Pretty-printed JSON representation
• Check if a value exists
• Fully compatible with in, .keys(), .items(), etc.

Installation

You can install this package via PIP: pip install python-bunch

Usage

# - 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

# From Dictionary
my_dict = {'name': 'Bob', 'age': 25}
my_bunch_from_dict = Bunch.from_dict(my_dict)
print(my_bunch_from_dict)  # Output: {'name': 'Bob', 'age': 25}

# - Immutable Bunch -
from bunch.immutable_bunch import ImmutableBunch

my_immutable_bunch = ImmutableBunch(name='John', age=35)
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

# From Dictionary
my_dict = {'name': 'Alice', 'age': 40}
my_bunch_from_dict = Bunch.from_dict(my_dict, recursive=True)
print(my_bunch_from_dict)  # Output: {'name': 'Alice', 'age': 40}