safepath 0.1.0a3

A Python library providing null-safe attribute and key access through a simple chaining API

safepath

A Python library providing null-safe attribute and key access through a simple chaining API.

Installation

pip install safepath

Usage

from safepath import sp

# Basic usage
data = {"user": {"name": "John"}}
name = sp(data)["user"]["name"]()  # Returns "John"
missing = sp(data)["user"]["age"]()  # Returns None

# Object attribute access
class User:
    def __init__(self):
        self.name = "John"
        self.address = None

user = User()
name = sp(user).name()  # Returns "John"
city = sp(user).address.city()  # Returns None

# Chaining
data = {
    "users": [
        {"profile": {"address": {"city": "New York"}}}
    ]
}
city = sp(data)["users"][0]["profile"]["address"]["city"]()  # Returns "New York"
missing = sp(data)["users"][1]["profile"]["address"]["city"]()  # Returns None

Features

• Null-safe attribute access
• Null-safe dictionary/list access
• Method chaining
• Immutable wrapper objects
• Type hints support
• Zero dependencies

License

MIT License

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.