{"id":42828790,"url":"https://github.com/yasmramos/warmup-framework","last_synced_at":"2026-01-30T11:03:09.401Z","repository":{"id":327079617,"uuid":"1105965996","full_name":"yasmramos/warmup-framework","owner":"yasmramos","description":"Ultra-fast Java DI container with O(1) bean resolution, sub-millisecond startup, and intelligent caching for modern applications.","archived":false,"fork":false,"pushed_at":"2026-01-26T00:09:53.000Z","size":1990,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-01-26T15:30:53.212Z","etag":null,"topics":["aop","bytecode-generation","caching","cloud-native","dependency-injection","fast-startup","high-performance","ioc-container","java","lightweight","microservices","modern-java","spring-alternative","sub-millisecond"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yasmramos.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-28T12:20:30.000Z","updated_at":"2026-01-26T00:09:59.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/yasmramos/warmup-framework","commit_stats":null,"previous_names":["yasmramos/warmup-framework"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/yasmramos/warmup-framework","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yasmramos%2Fwarmup-framework","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yasmramos%2Fwarmup-framework/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yasmramos%2Fwarmup-framework/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yasmramos%2Fwarmup-framework/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yasmramos","download_url":"https://codeload.github.com/yasmramos/warmup-framework/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yasmramos%2Fwarmup-framework/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28911819,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-30T08:15:08.179Z","status":"ssl_error","status_checked_at":"2026-01-30T08:14:31.507Z","response_time":66,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aop","bytecode-generation","caching","cloud-native","dependency-injection","fast-startup","high-performance","ioc-container","java","lightweight","microservices","modern-java","spring-alternative","sub-millisecond"],"created_at":"2026-01-30T11:03:04.357Z","updated_at":"2026-01-30T11:03:09.394Z","avatar_url":"https://github.com/yasmramos.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Warmup Framework\n\n[![Java](https://img.shields.io/badge/Java-8%2B-orange.svg)](https://www.oracle.com/java/)\n[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)]()\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/yasmramos/warmup-framework)\n\n**A high-performance, lightweight dependency injection and IoC container with O(1) bean resolution, sub-millisecond startup times, and intelligent caching mechanisms for modern Java applications.**\n\nWarmup Framework provides lightning-fast startup times, advanced bytecode generation, and intelligent caching mechanisms while maintaining full compatibility with standard Java frameworks and GraalVM native image support.\n\nWarmup Framework is designed for high-performance Java applications requiring ultra-fast startup and efficient dependency resolution.\n\n## 🚀 Key Features\n\n### ⚡ Ultra-Fast Performance\n- **O(1) Bean Registry**: Constant-time bean lookup and dependency resolution\n- **Intelligent JIT Compilation**: On-the-fly bytecode generation for optimal performance\n- **Advanced Caching**: Multi-level caching system with automatic invalidation\n- **Benchmark Results**: Sub-millisecond startup times and dependency resolution\n\n### 🔧 Modern Dependency Injection\n- **@Primary \u0026 @Alternative Annotations**: Intelligent bean selection and priority management\n- **Constructor Injection**: Full support for dependency injection via constructors\n- **Field Injection**: Support for field-level dependency injection\n- **Method Injection**: Configurable method injection with parameter resolution\n- **Profile-Based Configuration**: Conditional bean registration based on active profiles\n\n### 🎯 Advanced Scoping\n- **Singleton Scope**: Default lifecycle for shared instances\n- **Prototype Scope**: Per-request bean creation\n- **Request Scope**: Web request-specific bean lifecycle\n- **Session Scope**: HTTP session-specific bean management\n- **Custom Scopes**: Extensible scope management system\n\n### 🔍 Aspect-Oriented Programming (AOP)\n- **Method Interception**: Advanced AOP capabilities for cross-cutting concerns\n- **Performance Metrics**: Built-in performance monitoring and measurement\n- **Runtime Optimization**: Dynamic bytecode enhancement and optimization\n- **Configuration Processing**: Intelligent configuration bean processing\n\n### 🏗️ Modular Architecture\n- **Plugin System**: Extensible architecture with plugin support\n- **Multi-Module Support**: Modular project organization\n- **Spring Integration**: Seamless integration with Spring Boot ecosystem\n- **Third-Party Compatibility**: Support for Dagger, Guice, and other frameworks\n\n## 📦 Architecture Overview\n\n```\nwarmup-framework/\n├── warmup-core/           # Core IoC container and dependency injection\n├── warmup-aop/           # Aspect-oriented programming implementation\n├── warmup-processor/     # Annotation processing and code generation\n├── warmup-examples/      # Usage examples and demonstrations\n├── warmup-integration/   # Integration with external frameworks\n├── warmup-benchmark/     # Performance benchmarks and comparisons\n└── warmup-test/          # Testing utilities and support\n```\n\n## 🛠️ Quick Start\n\n### Maven Dependencies\n\nAdd to your `pom.xml`:\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003eio.warmup.framework\u003c/groupId\u003e\n    \u003cartifactId\u003ewarmup-core\u003c/artifactId\u003e\n    \u003cversion\u003e1.0.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n### Basic Usage\n\n```java\nimport io.warmup.framework.core.Warmup;\nimport jakarta.inject.Inject;\nimport jakarta.inject.Singleton;\n\n// Define your interface and implementation\npublic interface GreetingService {\n    String greet(String name);\n}\n\n@Singleton\npublic class GreetingServiceImpl implements GreetingService {\n    @Override\n    public String greet(String name) {\n        return \"Hello, \" + name + \"!\";\n    }\n}\n\n// Configure your application\npublic class Application {\n    public static void main(String[] args) throws Exception {\n        // Use Warmup as the main entry point\n        Warmup warmup = Warmup.create()\n            .scanPackages(\"com.company.application\")\n            .withProfile(\"development\")\n            .start();\n        \n        // Resolve dependencies through the fluent API\n        GreetingService service = warmup.getBean(GreetingService.class);\n        String result = service.greet(\"World\");\n        \n        System.out.println(result); // Output: Hello, World!\n        \n        warmup.stop();\n    }\n}\n```\n\n### Advanced Configuration with @Primary\n\n```java\npublic interface Logger {\n    void log(String message);\n}\n\n@Primary\n@Singleton\npublic class ConsoleLogger implements Logger {\n    @Override\n    public void log(String message) {\n        System.out.println(\"[CONSOLE] \" + message);\n    }\n}\n\n@Alternative\n@Singleton  \npublic class FileLogger implements Logger {\n    @Override\n    public void log(String message) {\n        // File logging implementation\n    }\n}\n\n// Using profiles\n@Profile(\"production\")\n@Primary\n@Singleton\npublic class DatabaseLogger implements Logger {\n    // Production logging\n}\n\n// Application configuration with Warmup\npublic class Application {\n    public static void main(String[] args) {\n        Warmup warmup = Warmup.runWithProfile(\"production\");\n        Logger logger = warmup.getBean(Logger.class);\n        logger.log(\"Application started\");\n    }\n}\n```\n\n### Request and Session Scoped Beans\n\n```java\nimport io.warmup.framework.annotations.*;\n\n@RequestScope\npublic class RequestContext {\n    private String requestId;\n    private long startTime;\n    \n    public RequestContext() {\n        this.requestId = UUID.randomUUID().toString();\n        this.startTime = System.currentTimeMillis();\n    }\n}\n\n@SessionScope\npublic class UserSession {\n    private String userId;\n    private String sessionData;\n}\n```\n\n## 🎯 Use Cases\n\n### 1. **Microservices Architecture**\n```java\n// Lightweight service container\n@Singleton\npublic class Microservice {\n    @Inject\n    private DatabaseService db;\n    \n    @Inject  \n    private MessageQueue queue;\n    \n    public void start() {\n        // Ultra-fast startup for microservices\n    }\n}\n\n// Microservice bootstrap\npublic class MicroserviceApplication {\n    public static void main(String[] args) {\n        Warmup warmup = Warmup.create()\n            .scanPackages(\"com.company.microservice\")\n            .withProfile(\"production\")\n            .start();\n            \n        Microservice service = warmup.getBean(Microservice.class);\n        service.start();\n    }\n}\n```\n\n### 2. **High-Performance APIs**\n```java\n// Optimized for low-latency requirements\n@Singleton\npublic class HighPerformanceAPI {\n    @Inject\n    private CacheService cache;\n    \n    @Inject\n    private ComputationService computation;\n}\n\n// API bootstrap\npublic class APIApplication {\n    public static void main(String[] args) {\n        Warmup warmup = Warmup.quickStart();\n        HighPerformanceAPI api = warmup.getBean(HighPerformanceAPI.class);\n        // Ready for high-frequency requests\n    }\n}\n```\n\n### 3. **Complex Configuration Management**\n```java\n@Profile(\"development\")\n@Singleton\npublic class DevelopmentConfig {\n    @Bean\n    public DatabaseConfig devDatabase() {\n        return new DatabaseConfig(\"localhost\", 5432);\n    }\n}\n\n@Profile(\"production\")\n@Singleton\npublic class ProductionConfig {\n    @Bean\n    public DatabaseConfig prodDatabase() {\n        return new DatabaseConfig(\"prod-db.company.com\", 5432);\n    }\n}\n\n// Configuration bootstrap\npublic class ConfigurationApplication {\n    public static void main(String[] args) {\n        Warmup warmup = Warmup.runWithProfile(\n            System.getProperty(\"spring.profiles.active\", \"development\")\n        );\n        \n        DatabaseConfig dbConfig = warmup.getBean(DatabaseConfig.class);\n        System.out.println(\"Connected to: \" + dbConfig.getUrl());\n    }\n}\n```\n\n## 📊 Performance Benchmarks\n\nThe framework includes comprehensive performance benchmarks comparing against popular alternatives:\n\n| Operation | Warmup Framework | Spring | Dagger 2 | Guice |\n|-----------|------------------|--------|----------|-------|\n| Container Startup | **0.8ms** | 245ms | 12ms | 8ms |\n| Bean Resolution | **O(1)** | O(log n) | O(log n) | O(log n) |\n| Memory Usage | **~2MB** | ~45MB | ~8MB | ~6MB |\n| Reflection Overhead | **None** | High | Medium | Medium |\n\n### Running Benchmarks\n\n```bash\n# Run performance benchmarks\nmvn clean test -Pbenchmark\n\n# View detailed results\ncat warmup-benchmark/benchmark-results.json\n```\n\n## 🔧 Configuration\n\n### Container Configuration\n\n```java\n// Quick start with minimal configuration\nWarmup warmup = Warmup.quickStart();\n\n// Fluent API for advanced configuration\nWarmupContainer container = Warmup.create()\n    .scanPackages(\"com.company.application\")\n    .withProfile(\"development\")\n    .withProperty(\"db.url\", \"jdbc:h2:mem:test\")\n    .withAutoScan(true)\n    .withLazyInit(false)\n    .start();\n\n// Multiple profiles and properties\nWarmup warmup = Warmup.create()\n    .withProfiles(\"development\", \"test\")\n    .withProperties(Map.of(\n        \"db.url\", \"jdbc:h2:mem:test\",\n        \"cache.enabled\", \"true\",\n        \"log.level\", \"DEBUG\"\n    ))\n    .start();\n```\n\n### Property-Based Configuration\n\n```properties\n# application.properties\nwarmup.profile=development\nwarmup.cache.enabled=true\nwarmup.metrics.enabled=true\nwarmup.auto.scan=true\nwarmup.lazy.init=false\n```\n\n## 🧪 Testing\n\nThe framework includes comprehensive testing capabilities:\n\n```java\n// JUnit 5 Integration\n@ExtendWith(WarmupTestExtension.class)\nclass MyServiceTest {\n    @Inject\n    private MyService service;\n    \n    @Test\n    void testServiceBehavior() {\n        assertThat(service.process(\"input\")).isNotNull();\n    }\n}\n\n// Mock Framework Integration\n@Test\nvoid testWithMocks() {\n    try (MockContext context = Warmup.testMode()) {\n        MyService service = context.mock(MyService.class);\n        when(service.process(\"test\")).thenReturn(\"mocked\");\n        \n        assertThat(service.process(\"test\")).isEqualTo(\"mocked\");\n    }\n}\n```\n\n## 🔌 Integration\n\n### Spring Boot Integration\n\n```java\n@SpringBootApplication\n@EnableWarmupContainer\npublic class Application {\n    public static void main(String[] args) {\n        // Use Warmup for faster startup\n        Warmup warmup = Warmup.quickStart();\n        SpringApplication.run(Application.class, args);\n    }\n}\n```\n\n### Third-Party Framework Support\n\n- **Dagger 2**: Seamless migration and hybrid usage\n- **Google Guice**: Compatible dependency resolution\n- **Spring Framework**: Spring bean integration and compatibility\n- **Jakarta EE**: Full Jakarta EE 9+ compatibility\n\n## 📈 Monitoring \u0026 Metrics\n\nBuilt-in performance monitoring and metrics collection:\n\n```java\n@Singleton\npublic class PerformanceMonitor {\n    @Inject\n    private MetricsCollector metrics;\n    \n    @PerformanceMetrics\n    public void expensiveOperation() {\n        // Automatically monitored\n        // Metrics available via metrics collector\n    }\n}\n```\n\n### Available Metrics\n- **Bean Creation Time**: Individual bean instantiation times\n- **Dependency Resolution**: Graph resolution performance\n- **Cache Hit/Miss Rates**: Caching effectiveness\n- **Memory Usage**: Heap and non-heap memory consumption\n- **GC Impact**: Garbage collection influence\n\n## 🔒 Security Features\n\n- **ClassLoader Isolation**: Secure class loading and management\n- **Runtime Bytecode Validation**: Safe code generation and execution\n- **Access Control**: Configurable security policies\n- **Dependency Sandboxing**: Isolated dependency resolution\n\n## 📝 Logging\n\nConfigure logging for debugging and monitoring:\n\n```xml\n\u003c!-- logback.xml --\u003e\n\u003cconfiguration\u003e\n    \u003cappender name=\"WARMUP\" class=\"ch.qos.logback.core.ConsoleAppender\"\u003e\n        \u003cencoder\u003e\n            \u003cpattern\u003e%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n\u003c/pattern\u003e\n        \u003c/encoder\u003e\n    \u003c/appender\u003e\n    \n    \u003clogger name=\"io.warmup.framework\" level=\"INFO\"/\u003e\n    \u003clogger name=\"io.warmup.framework.performance\" level=\"DEBUG\"/\u003e\n    \n    \u003croot level=\"WARN\"\u003e\n        \u003cappender-ref ref=\"WARMUP\"/\u003e\n    \u003c/root\u003e\n\u003c/configuration\u003e\n```\n\n## 🤝 Contributing\n\nWe welcome contributions! Please read our contributing guidelines:\n\n1. Fork the repository\n2. Create a feature branch\n3. Add comprehensive tests\n4. Ensure all benchmarks pass\n5. Submit a pull request\n\n### Development Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/your-org/warmup-framework.git\ncd warmup-framework\n\n# Build the project\nmvn clean install\n\n# Run all tests\nmvn test\n\n# Run performance benchmarks\nmvn test -Pbenchmark\n```\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 📞 Support\n\n- **Documentation**: [Project Wiki](https://github.com/your-org/warmup-framework/wiki)\n- **Issues**: [GitHub Issues](https://github.com/your-org/warmup-framework/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/your-org/warmup-framework/discussions)\n\n## 🎯 Roadmap\n\n### Version 2.0 (Planned)\n- **Kotlin Support**: Full Kotlin DSL and extension functions\n- **Reactive Streams**: Integration with Project Reactor and RxJava\n- **Cloud Native**: Kubernetes and Cloud Foundry native support\n- **GraphQL**: Advanced GraphQL integration and optimization\n\n### Version 1.5 (Next Release)\n- **Enhanced AOP**: Advanced aspect weaving capabilities\n- **Plugin Architecture**: Extensible plugin system for custom extensions\n- **Configuration Hot-Reload**: Runtime configuration updates without restart\n- **Advanced Caching**: Multi-tier caching with TTL and invalidation strategies\n\n---\n\n## ⚡ Why Choose Warmup Framework?\n\n1. **Performance First**: Designed from the ground up for optimal performance\n2. **Modern Architecture**: Built for cloud-native and microservices environments\n3. **Developer Experience**: Clean, intuitive API with excellent documentation\n4. **Production Ready**: Comprehensive testing, monitoring, and logging\n5. **Future Proof**: Extensible architecture designed for long-term maintainability\n\n---\n\n## Quick Start Commands\n\n```bash\n# Clone and build\ngit clone https://github.com/yasmramos/warmup-framework.git\ncd warmup-framework\nmvn clean install\n\n# Run examples\ncd warmup-examples\nmvn spring-boot:run\n\n# Run benchmarks\nmvn test -Pbenchmark\n\n# Quick API test\njava -cp \"warmup-core/target/warmup-core-1.0-SNAPSHOT.jar\" \\\n  io.warmup.framework.examples.QuickStartExample\n```\n\n---\n\n**Built with ❤️ for the Java community**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyasmramos%2Fwarmup-framework","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyasmramos%2Fwarmup-framework","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyasmramos%2Fwarmup-framework/lists"}