Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/abdullahselek/viperc

Xcode template for VIPER Architecture for both Objective-C and Swift.
https://github.com/abdullahselek/viperc

ios objective-c quick swift swift-3 swift-4 viper viper-architecture xcode-templates xctest

Last synced: 3 days ago
JSON representation

Xcode template for VIPER Architecture for both Objective-C and Swift.

Awesome Lists containing this project

README

        

![License](https://img.shields.io/dub/l/vibe-d.svg)

![ViperC](https://raw.githubusercontent.com/abdullahselek/ViperC/master/images/viperc_header.png)

# ViperC
Xcode template for VIPER Architecture for both Objective-C and Swift.

- ViperC creates modules for you when you want to use VIPER architecture in your projects. You can choose your language for the VIPER modules that will be created.

## Installation

- Clone this repository
- Go to repository main folder
- ```./install.sh ViperC``` installs ViperC module for Objective-C or Swift.
- ```./install.sh ViperC-Quick``` installs ViperC unit tests module for Objective-C or Swift. It uses **Quick** and **Expecta** for Objective-C and **Quick** and **Nimble** for Swift.
- ```./install.sh ViperC-XCTest``` installs ViperC unit tests module for Objective-C or Swift. It uses default **XCTest**.

## Template Path

You can find ViperC under ```/Users/USER_NAME/Library/Developer/Xcode/Templates/File Templates/ViperC/ViperC.xctemplate```

## Usage

![ViperC Demo](https://raw.githubusercontent.com/abdullahselek/ViperC/master/images/demo.gif)

## VIPER Diagram

![VIPER](https://raw.githubusercontent.com/abdullahselek/ViperC/master/images/viper.png)

## Generated Source Code

Example for a ToDO module:

### Protocols

```
#pragma mark - WireFrameProtocol

@protocol ToDoWireframeProtocol

@end

#pragma mark - PresenterProtocol

@protocol ToDoPresenterProtocol

@end

#pragma mark - InteractorProtocol

@protocol ToDoInteractorOutputProtocol

@end

@protocol ToDoInteractorInputProtocol

- (void)setOutput:(id)output;
- (id)getOutputProtocol;

@end

#pragma mark - ViewProtocol

@protocol ToDoViewProtocol

@end
```

### Interactor

```
NS_ASSUME_NONNULL_BEGIN

@interface ToDoInteractor: NSObject

@property (nonatomic, weak, nullable) id output;

@end

NS_ASSUME_NONNULL_END
```

### Presenter

```
NS_ASSUME_NONNULL_BEGIN

@interface ToDoPresenter: NSObject

@property (nonatomic, weak, nullable) id view;
@property (nonatomic) id interactor;
@property (nonatomic, weak) id router;

- (instancetype)initWithInterface:(id)interface
interactor:(id)interactor
router:(id)router;

@end

NS_ASSUME_NONNULL_END
```

### WireFrame

```
@interface ToDoRouter: NSObject

@property (nonatomic, weak) ToDoViewController *viewController;

+ (UIViewController *)createModule;

@end
```

### View

```
NS_ASSUME_NONNULL_BEGIN

@interface ToDoViewController: UIViewController

@property (nonatomic) ToDoPresenter *presenter;

@end

NS_ASSUME_NONNULL_END
```

## License

ViperC is released under the MIT license. See LICENSE for details.