Metadata-Version: 2.4
Name: brydebug
Version: 0.1.0
Summary: Lightweight debugging utilities for Python development
Project-URL: Homepage, https://github.com/YOUR_USERNAME/brydebug
Project-URL: Repository, https://github.com/YOUR_USERNAME/brydebug
License: MIT
License-File: LICENSE
Keywords: debugging,development,introspection,utilities
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.12
Requires-Dist: build>=1.4.0
Requires-Dist: twine>=6.2.0
Description-Content-Type: text/markdown

# brydebug

A collection of lightweight debugging utilities for Python development.

## Installation

```bash
pip install brydebug
```

## Features

### Attribute Path Finding

Ever had a complex nested object and needed to figure out how to access a deeply buried attribute? `brydebug` helps you navigate object hierarchies during debugging sessions.

#### `find_attr_path(obj, target_attr)`

Find the path to a specific attribute within nested objects.

```python
from brydebug import find_attr_path

# Returns a string like "obj.some_nested.attribute_name"
path = find_attr_path(my_complex_object, "attribute_name")
print(path)
```

#### `find_attr_paths_containing(obj, substring, case_sensitive=False)`

Find all attribute paths that contain a specific substring.

```python
from brydebug import find_attr_paths_containing

# Returns a list of paths like ["obj.config.db_host", "obj.settings.db_port"]
paths = find_attr_paths_containing(my_object, "db")
for path in paths:
    print(path)
```

## Use Case

This tool is designed for quick debugging sessions. Install it temporarily when you need to introspect complex objects, then remove it once you're done debugging.

```bash
# Quick install for debugging
pip install brydebug

# Your debugging session...

# Clean up when done
pip uninstall brydebug
```

## License

MIT
