Welcome to the SwiftMVVMDemo repository! This sample app is designed to showcase various programming concepts, including SOLID principles, MVVM architecture, design patterns like singleton, and observer, and the integration of modern Swift features.
The primary goal of this repository is to provide a comprehensive understanding of essential programming principles and demonstrate their implementation within a Swift project. Through this demo, you'll explore:
- MVVM Architecture: Understand the Model-View-ViewModel architecture and its implementation in Swift.
- SOLID Principles: Learn about writing maintainable and scalable code by applying SOLID principles.
- Design Patterns: Explore various design patterns and their utilization in the context of this project.
- Swift Package: Understand how you can create SwiftPackage and use it in your project.
- UIKit and SwiftUI: See how a single ViewModel can be utilized in both UIKit and SwiftUI frameworks.
- Swift Concurrency: Examples showcasing async-await usage for concurrency.
- Combine Framework: Understanding and using the Combine framework for reactive programming.
- Unit Tests: Learn about writing unit tests to ensure code quality and reliability.
| MVVM | Coordinator |
|---|---|
 |
 |
| Component | Class | Unit Test |
|---|---|---|
| Model | Post | - |
| View | PostListViewController (UIKit) PostListView (SwiftUI) |
PostListViewControllerTests PostListViewTests |
ViewModel Business logic |
PostListViewModel | PostListViewModelTests |
Service Get data from DB or Network |
PostService | PostServiceTests |
Coordinator Routing |
PostCoordinator | - |
| Principle | Meaning |  Example |
|---|---|---|
| S - Single Responsibility | A class should have a single responsibility only. | APIRequestHandler class only handling network requests. APIResponseHandler class only for parsing network response. |
| O - Open/Closed | The classes and functions should be open for extension and closed for internal modification. | Leveraging generics within the NetworkHandler fetch functionality empowers us to execute a wide range of requests, not limited to posts alone. |
| L - Liskov Substitution | The code should be maintainable and reusable; objects should be replaced with instances of their subclasses without altering the behavior. LSP is closely related to Polymorphism |
Typecasting of PostCoordinator to Coordinator protocol or calling method of viewDidLoad on UINavigationController will call UIViewController.viewDidLoad |
| I - Interface Segregation | A class should not be forced to implement interfaces that they do not use. | Breaking interfaces into smaller and more specific ones. |
| D - Dependency Inversion | High-level modules should not depend on low-level modules; rather, both should depend on abstractions. | Using protocols in NetworkManager and PostService allow us to remove direct dependencies and improve testability and mocking of individual components. |
| Pattern | Meaning | Example |
Tests |
|---|---|---|---|
| Singleton | The singleton pattern guarantees that only one instance of a class is instantiated. | CacheManager | CacheManagerTests |
| Observer | The Observer pattern involves a subject maintaining a list of observers and automatically notifying them of any state changes, commonly used for implementing publish/subscribe systems. | PhotoRowViewModel uses Combine |
PhotoRowViewModelTests |
| Feature | Description | Example |
|---|---|---|
| UIKit + SwiftUI | Provides examples showcasing the use of a single ViewModel in both UIKit and SwiftUI. | PhotosViewModel PhotosViewController PhotosCustomAsyncImageView |
| Swift Package | Create and distribute your own Swift Package and use it in your project. | NetworkKit |
| Async-Await Usage | Shows how to use async-await for asynchronous operations. | APIRequestHandler PostListViewModel |
| Combine Framework | Examples of using Combine for reactive programming. | AsyncImageLoader PhotoRowViewModel |
| Unit Tests | Comprehensive unit tests ensure code reliability and functionality. | PostListViewControllerTests APIRequestHandlerTests PostServiceTests |
To get started with this demo project, follow these steps:
- Clone the Repository: Clone this repository to your local machine using
git clone https://github.com/rushisangani/SwiftMVVMDemo.git. - Explore the Code: Dive into the codebase to explore the various concepts implemented.
- Run the Project: Run the project in Xcode to see the sample app in action.
- Check Unit Tests: Review the unit tests to understand how different functionalities are tested.
Contributions to enhance or expand this project are welcome! Feel free to submit issues, propose enhancements, or create pull requests to collaborate on improving this sample app further.