Python Resource Manager

A powerful Python library for efficiently managing and resolving resources with dependency management.

Features

• Resource dependency resolution
• Link management between resources
• Custom exception handling for resource conflicts
• Flexible resource definition and manipulation
• Thread-safe resource management

Installation

pip install resource_manager

Or using Poetry:

poetry add resource_manager

Quick Start

from resource_manager import ResourceManager

# Create a resource manager
rm = ResourceManager()

# Define resources
rm.add_resource("database", {
    "host": "localhost",
    "port": 5432,
    "username": "user",
    "password": "password"
})

rm.add_resource("web_app", {
    "port": 8080,
    "depends_on": ["database"]
})

# Resolve resources
resolved = rm.resolve()

# Access resources
database = resolved.get("database")
web_app = resolved.get("web_app")

Documentation

Complete documentation can be found at https://mrjk.github.io/python-resource-manager/

Examples

The examples/ directory contains various usage examples:

• Basic resource management
• Dependency resolution
• Error handling
• Advanced configurations

Core Concepts

Resources

Resources are the basic building blocks managed by this library. Each resource has:

• A unique identifier
• Properties and attributes
• Optional dependencies on other resources

Links

Links define relationships between resources, allowing for complex dependency graphs and resource hierarchies.

Resolver

The resolver is responsible for analyzing resource dependencies and providing a consistent, resolved view of all resources.

Development

Prerequisites

• Python 3.9+
• Poetry

Setup Development Environment

# Clone the repository
git clone https://github.com/mrjk/python-resource-manager.git
cd python-resource-manager

# Install dependencies
poetry install

Running Tests

poetry run pytest

Code Quality

# Run linters
poetry run black resource_manager tests
poetry run pylint resource_manager

License

This project is licensed under the GNU General Public License v3 (GPLv3) - see the LICENSE file for details.

Contributing

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

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Changelog

See CHANGELOG.md for details on version history and changes.

Authors

• mrjk - GitHub

Acknowledgments

• Thanks to all contributors who have helped shape this project
• Inspired by dependency resolution systems in various software ecosystems