google/auto
Auto
This project is a Java annotation processing framework and source code generator designed to automate repetitive boilerplate and reduce manual coding errors. It functions as a toolkit for building custom annotation processors that produce source code, metadata, and type definitions during the compilation process.
The framework specifically automates the creation of immutable value types with built-in equality and hashing logic, as well as the generation of factory implementations for dependency injection. It also handles the automated production of service provider configuration files to enable the discovery and loading of service implementations at runtime.
Beyond these specific generators, the project provides utilities for managing the annotation processing workflow, including compilation-phase element validation and the ability to defer processing of specific elements to resolve dependencies. It includes tools for element visibility analysis and provides a simplified abstraction for the Java Compiler API to streamline the development of custom generators.
Features
- Java Annotation Processors - Provides a framework for creating Java annotation processors that generate source code during compilation.
- Code Generators - Automates the creation of repetitive source code and boilerplate using Java annotation processors.
- Source Generators - Produces immutable value types, factory implementations, and service provider configurations during the compilation process.
- Compiler API Abstractions - Provides a simplified abstraction for the Java Compiler API to streamline the development of custom generators.
- Deferred Element Processing - Implements the ability to defer processing of specific elements to resolve dependencies between generated types.
- Annotation Processor Frameworks - Streamlines the creation of custom annotation processors through utility tools that handle complex compiler plumbing.
- Source Code Generators - Enables the creation of custom source code generators using annotation processing tools to automate type definitions.
- Annotation Processing Workflows - Organizes processing actions into discrete steps and manages the deferral of invalid elements to later phases.
- Compile-Time Validators - Scans source elements during the compilation phase to ensure they are valid before triggering code generation.
- Annotation Processor Validation - Includes a system to scan source elements for validity to prevent the generation of corrupted output.
- Immutable Data Structures - Creates immutable value types with built-in equality and hashing to ensure data consistency without manual getters.
- Immutable Value Class Generators - Generates immutable value classes featuring built-in equality and hashing logic to ensure data consistency.
- Code Boilerplate Templates - Utilizes predefined structural templates to synthesize repetitive code patterns for factories and value classes.
- Boilerplate Generators - Offers utilities to scaffold repetitive code structures and members, reducing manual coding errors.
- Configuration File Generators - Produces the configuration files required for the runtime environment to discover service implementations.
- Dependency Injection Source Generators - Automates the creation of factory classes and service registration files for object instantiation.
- Dependency Injection Factory Generators - Generates factory implementations that automate dependency injection boilerplate to simplify object instantiation.
- Standard Injection Factory Generators - Produces factory classes that follow injection standards to automate object instantiation.
- Factory Generators - Generates factory implementations that handle dependency injection boilerplate to simplify object instantiation.
- Service-Loader Metadata Generation - Automatically produces service provider configuration files to enable runtime discovery and loading of implementations.
- Automatic Service Registrations - Automatically creates provider configuration files that register service implementations through the service loader mechanism.
- Service Provider Configuration Generators - Automatically produces service provider configuration files to enable the discovery and loading of implementations at runtime.
- Service Discovery - Creates configuration files that allow the system to automatically discover and load service implementations.
- Code Generation - Collection of source code generators for Java.
- Code Generation and Bytecode - Collection of source code generators for Java.
- Code Generators - Generates factory, service, and value classes.
- Metaprogramming and Compilers - Collection of source code generators for Java.
