pointfreeco/swift-dependencies
Swift Dependencies
This library provides a dependency management system for Swift applications that utilizes an environment-based approach to distribute services and utilities throughout a codebase. By leveraging a centralized container, it eliminates the need for manual data passing or global state, allowing services to be injected into the application hierarchy automatically.
The framework distinguishes itself through a type-safe mechanism that uses key paths and property wrappers to access and override services. This architecture supports the substitution of live service implementations with controlled, predictable versions, which facilitates isolated unit testing and rapid interface development during design iterations.
The system includes infrastructure for registering custom services and validating that all required dependencies are accounted for during testing. This ensures that components remain decoupled from external systems and production side effects, providing a consistent environment for both automated tests and interface previews.
Features
- Swift Implementations - Provides a type-safe, environment-based dependency injection system for Swift applications.
- Environment-Based Injections - Injects services and utilities into the environment to avoid manual data passing or global state in view hierarchies.
- Service Injection Patterns - Distributes services and utilities throughout the codebase using a centralized injection mechanism.
- Compile-Time Dependency Resolution - Verifies and resolves service dependency graphs during the compilation phase to ensure all required services are accounted for.
- Live Preview UI Development - Supports rapid interface development by using controlled mock services during design iterations.
- Clean Architecture SwiftUI Applications - Implements a centralized dependency container to distribute services and eliminate manual data passing.
- Property Wrapper Declarations - Provides a declarative syntax for consuming services using property wrappers.
- Environment Dependency Injections - Propagates dependencies through a hierarchical storage system, making them accessible to components without manual initializer injection.
- Test Service Injections - Substitutes real-world service implementations with predictable test versions to ensure isolation during automated testing.
- Key Path Convenience APIs - Uses type-safe key paths to simplify service access and overriding throughout the application hierarchy.
- Service Implementation Overriding - Replaces live service implementations with mock versions at runtime to isolate components for testing and previews.
- Service Dependency Registration - Registers custom application services to a centralized system, making them available for injection throughout the project.
- Framework Service Mocks - Replaces live services with controlled mock instances to facilitate rapid UI development and design iterations.
- Unit Testing - Enables isolated unit testing by replacing real-world service implementations with predictable mock versions.
