equipment 1.1.0

The root of your next python project

Equipment: Python Project Scaffolding Framework

🚀 Simplify Your Python Project Setup

Equipment is a comprehensive scaffolding framework designed to streamline Python project development. It provides a robust, flexible foundation that adapts to projects of any scale - from simple scripts to complex enterprise applications.

🌟 Key Features

🔧 Dependency Injection Made Simple

• Intuitive dependency management
• Support for class-based and function-based dependencies
• Reduces boilerplate code and improves modularity

🏗️ Project Initialization

• One-command project creation: equipment new my-app
• Standardized project structure
• Consistent setup across different project types

📝 Advanced Logging

• Configurable logging system
• Multiple log channels and custom formatters
• Easy-to-use logging API

⏰ Task Scheduling

• Built-in task scheduler
• Support for periodic and recurring tasks
• Seamless queue system integration

📦 Queue Management

• Synchronous and Redis-based queue support
• Asynchronous task processing
• Simple task enqueuing and scheduling

💾 Database Integration

• SQLAlchemy ORM integration
• Multi-database driver support
• Automatic migration handling via Alembic

💽 Flexible Storage Management

• Filesystem abstraction layer
• Local and cloud storage support
• Easily extensible storage configuration

🔍 Why Equipment?

Equipment is built with developer experience in mind. It solves common Python project challenges:

• Eliminates repetitive configuration
• Provides a consistent project structure
• Supports scalability from small scripts to large applications
• Integrates seamlessly with popular Python tools and frameworks

🛠️ Tech Stack

Equipment leverages industry-standard libraries to provide a robust development experience:

• Dependency Injector for dependency management
• SQLAlchemy as the ORM
• Alembic for database migrations
• Redis for advanced queuing
• FastAPI as the web framework

🚀 Quick Start

# Install Equipment
pip install equipment

# Generate a new project
equipment new my-app

# Install dependencies
cd my-app && pip install .

# Run the main application
py main.py

🤝 Community

We welcome contributions, feedback, and suggestions! Join our GitHub Discussions to connect with the Equipment community.

📄 License

This project is open-sourced software licensed under the MIT license.

Equipment icons created by Freepik - Flaticon

Author

Roger Vilà