vipergen-afnan 0.2.7

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2b00196a7d3e615c449d19d50edee3091bd08676
+  data.tar.gz: 96b584282d700df052e0bcfe6f7312462bb1fccc
+SHA512:
+  metadata.gz: 1a058058ade86443ad259fa759427f32b4a0dde86407c164c17ff50b3aaf85ce9986bb9216239e853f2692cfab762f31bd71a731b3a8e9b0dfaab75931a7a739
+  data.tar.gz: f85670ec8d9892e71f942c203a0893499da9b794ad3c125cd760e4034790bd84c69a18e31fb6e3b487569ec2436004d40da98d9959c3fab27281a771698874d3

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Redbooth
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,157 @@
+Viper Module Generator
+======================
+[![Code Climate](https://codeclimate.com/github/teambox/viper-module-generator/badges/gpa.svg)](https://codeclimate.com/github/teambox/viper-module-generator)
+[![Build Status](https://travis-ci.org/teambox/viper-module-generator.svg?branch=master)](https://travis-ci.org/teambox/viper-module-generator)
+[![Test Coverage](https://codeclimate.com/github/teambox/viper-module-generator/badges/coverage.svg)](https://codeclimate.com/github/teambox/viper-module-generator)
+[![Dependency Status](https://gemnasium.com/teambox/viper-module-generator.svg)](https://gemnasium.com/teambox/viper-module-generator)
+
+
+![image](http://www.objc.io/images/issue-13/2014-06-07-viper-intro.jpg)
+
+Gem to generate VIPER modules to use them in your Objective-C/Swift projects
+The implementation scheme returned by this generator is hardly inspired in the example and post of Objc.io, http://www.objc.io/issue-13/viper.html .
+
+- [Features](#features)
+  - [Changelog](#changelog-0.1)
+  - [Expected in version 0.2](#expected-in-version-0.2)
+- [Viper files structure](#viper-files-structure)
+- [How to install vipergen](#how-to-install-vipergen)
+- [How to generate a VIPER module with a given name?](#how-to-generate-viper-module-with-a-given-name?)
+- [Developer tips](#developer-tips)
+  - [Update the gem](#update-the-gem)
+  - [Add a new template](#add-a-new-template)
+- [Resources](#resources)
+
+## Features
+- Generates the module in Swift and Objective-C
+- Ready to be installed as a gem https://rubygems.org/gems/VIPERGen
+
+### Changelog 0.1.6
+- Added `templates` command to know which templates are available
+- YAML file in each template with the information about the template (more scalable)
+
+### Changelog 0.1
+- Added default template
+- Fully components tested
+
+### Changelog 0.2.3
+- VIPER Example using the Twitter API 
+- Default template implemented in Swift
+- 
+
+### Expected in version 0.3
+- Integrate with XCode as a plugin (http://nshipster.com/xcode-plugins/)
+
+## Viper files structure
+```bash
+.objc
++-- DataManager
+|   +-- VIPERDataManager.h
+|   +-- VIPERDataManager.m
++-- Interactor
+|   +-- VIPERInteractor.h
+|   +-- VIPERInteractor.m
+|   +-- VIPERInteractorSpec.m
++-- Presenter
+|   +-- VIPERPresenter.h
+|   +-- VIPERPresenter.m
+|   +-- VIPERPresenterSpec.m
++-- ViewController
+|   +-- VIPERViewController.h
+|   +-- VIPERViewController.m
+|   +-- VIPERViewControllerSpec.m
++-- WireFrame
+|   +-- VIPERWireFrame.h
+|   +-- VIPERWireFrame.m
++-- Protocols
+|   +-- VIPERProtocols.h
+.swift
++-- DataManager
+|   +-- VIPERDataManager.swift
++-- Interactor
+|   +-- VIPERInteractor.swift
+|   +-- VIPERInteractorSpec.swift
++-- Presenter
+|   +-- VIPERPresenter.swift
+|   +-- VIPERPresenterSpec.swift
++-- View
+|   +-- VIPERView.swift
+|   +-- VIPERViewSpec.swift
++-- WireFrame
+|   +-- VIPERWireFrame.swift
++-- Protocols
+|   +-- VIPERProtocols.swift
+```
+## How to install vipergen ?
+You can install it easily as using the gem. With ruby installed in your OSX execute:
+```bash
+sudo gem install vipergen-roche
+```
+If everything were right, you should have now the vipergem command available in your system console
+
+## How to generate a VIPER module with a given name?
+You have just to execute the following command
+```bash
+vipergen generate MyFirstViperModule --path=~/myproject/shared
+```
+And then the files structure will be automatically created. Don't forget to add this folder to your project dragging it into the XCode/Appcode inspector
+
+## What options are available in generator?
+You have just to execute the following command
+```bash
+vipergen help generate
+```
+And then you will see all options available
+
+Sample:
+```bash
+vipergen generate <Module_Name> --path=<Path> --language=swift --author='michal' --template=testable --swift-module <MY_Project>
+```
+
+## How can I try the demo project?
+
+1. Clone the repo `git clone https://github.com/pepibumur/viper-module-generator.git`
+2. Move into the repo folder and update the git submodules `git sumodule update --init`
+3. In the folder VIPERGenDemo install the pods `pod install`
+4. Open the project from the `VIPERGenDemo.xcworkspace` file
+5. Enjoy it!
+
+
+## Developer tips
+### Update the gem 
+When the gem is updated it has to be reported to the gem repository. I followed this tutorial http://amaras-tech.co.uk/article/43/Creating_executable_gems that basically says that once you have your gem ready execute:
+```bash
+gem build vipergen.gemspec
+gem install vipergen-0.1.gem
+gem push vipergen-0.1.gem
+```
+Then you'll be asked for your credentials in order to make the update in the repo (http://guides.rubygems.org/publishing/)
+
+### Add a new template
+Are you interested in VIPER and you would like to contribute with this gem adding new templates? Feel free to do it. It's pretty easy. You've just to:
+- Create a folder inside `templates` with the name of your template
+- You'll have to create inside the templates in both languages, Swift and Objective-C (get inspired from existing templates)
+- Use the word VIPER where you want the name to be replaced in.
+- Remember to add the file viperspec.yml with the description of your template as below:
+```yaml
+author: pepi
+author_email: pepibumur@gmail.com
+template_description: Default template with the simplest structure using VIPER
+updated_at: 2014-08-24
+```
+- Report it as a PR in this repo updating the gem version in Gemspec.
+
+### Available Templates
+- default by pepimbur
+- testable by wojtysim (includes Spec file templates for Interactor, Presenter and View)
+
+## Resources
+- Redbooth presentation: https://speakerdeck.com/sergigracia/clean-architecture-viper
+- Rspec documentation: http://rubydoc.info/gems/rspec-expectations/frames
+- XCode Plugins: http://nshipster.com/xcode-plugins/
+- XCodeProj gem (to modify project groups structure): https://github.com/CocoaPods/Xcodeproj
+- Thor, powerful Ruby library for command line: http://whatisthor.com/
+- Cocoa Design Patters: https://developer.apple.com/legacy/library/documentation/Cocoa/Conceptual/CocoaFundamentals/CocoaDesignPatterns/CocoaDesignPatterns.html
+
+## Contact
+If you have any doubt about the gem or even if you want to make any suggestion you can do it directly to my email address, pedro@redbooth.com . You can use the issues Github page too

data/bin/vipergen

@@ -0,0 +1,9 @@
+#!/usr/bin/env ruby
+
+#require 'rubygems'
+require 'vipergen/viperthor'
+
+puts "------- VIPER GENERATOR---------\n"
+puts ARGV
+Vipergen::ViperThor.start(ARGV)
+puts "--------------------------------\n"

data/lib/templates/MAU/objc/Application Logic/DataManager/API/VIPERAPIDataManager.h

@@ -0,0 +1,15 @@
+//
+// VIPERAPIDataManager.h
+// PROJECT
+//
+// Created by AUTHOR on DATE.
+// Copyright © YEAR COMPANY. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "VIPERProtocols.h"
+
+
+@interface VIPERAPIDataManager : NSObject <VIPERAPIDataManagerInputProtocol>
+
+@end

data/lib/templates/MAU/objc/Application Logic/DataManager/API/VIPERAPIDataManager.m

@@ -0,0 +1,13 @@
+//
+// VIPERAPIDataManager.m
+// PROJECT
+//
+// Created by AUTHOR on DATE.
+// Copyright © YEAR COMPANY. All rights reserved.
+//
+
+#import "VIPERAPIDataManager.h"
+
+@implementation VIPERAPIDataManager
+
+@end

data/lib/templates/MAU/objc/Application Logic/DataManager/Local/VIPERLocalDataManager.h

@@ -0,0 +1,15 @@
+//
+// VIPERLocalDataManager.h
+// PROJECT
+//
+// Created by AUTHOR on DATE.
+// Copyright © YEAR COMPANY. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "VIPERProtocols.h"
+
+
+@interface VIPERLocalDataManager : NSObject <VIPERLocalDataManagerInputProtocol>
+
+@end

data/lib/templates/MAU/objc/Application Logic/DataManager/Local/VIPERLocalDataManager.m

@@ -0,0 +1,13 @@
+//
+// VIPERLocalDataManager.m
+// PROJECT
+//
+// Created by AUTHOR on DATE.
+// Copyright © YEAR COMPANY. All rights reserved.
+//
+
+#import "VIPERLocalDataManager.h"
+
+@implementation VIPERLocalDataManager
+
+@end

data/lib/templates/MAU/objc/Application Logic/Interactor/VIPERInteractor.h

@@ -0,0 +1,19 @@
+//
+// VIPERInteractor.h
+// PROJECT
+//
+// Created by AUTHOR on DATE.
+// Copyright © YEAR COMPANY. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "VIPERProtocols.h"
+
+
+@interface VIPERInteractor : NSObject <VIPERInteractorInputProtocol>
+
+@property (nonatomic, weak) id <VIPERInteractorOutputProtocol> presenter;
+@property (nonatomic, strong) id <VIPERAPIDataManagerInputProtocol> APIDataManager;
+@property (nonatomic, strong) id <VIPERLocalDataManagerInputProtocol> localDataManager;
+
+@end

data/lib/templates/MAU/objc/Application Logic/Interactor/VIPERInteractor.m

@@ -0,0 +1,14 @@
+//
+// VIPERInteractor.m
+// PROJECT
+//
+// Created by AUTHOR on DATE.
+// Copyright © YEAR COMPANY. All rights reserved.
+//
+
+
+#import "VIPERInteractor.h"
+
+@implementation VIPERInteractor
+
+@end

data/lib/templates/MAU/objc/Application Logic/Interactor/VIPERItem.h

@@ -0,0 +1,13 @@
+//
+// VIPERItem.h
+// PROJECT
+//
+// Created by AUTHOR on DATE.
+// Copyright © YEAR COMPANY. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+@interface VIPERItem : NSObject
+
+@end

data/lib/templates/MAU/objc/Application Logic/Interactor/VIPERItem.m

@@ -0,0 +1,13 @@
+//
+// VIPERItem.m
+// PROJECT
+//
+// Created by AUTHOR on DATE.
+// Copyright © YEAR COMPANY. All rights reserved.
+//
+
+#import "VIPERItem.h"
+
+@implementation VIPERItem
+
+@end

data/lib/templates/MAU/objc/Module Interface/VIPERProtocols.h

@@ -0,0 +1,83 @@
+//
+// VIPERProtocols.h
+// PROJECT
+//
+// Created by AUTHOR on DATE.
+// Copyright © YEAR COMPANY. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import <UIKit/UIKit.h>
+
+@protocol VIPERInteractorOutputProtocol;
+@protocol VIPERInteractorInputProtocol;
+@protocol VIPERViewProtocol;
+@protocol VIPERPresenterProtocol;
+@protocol VIPERLocalDataManagerInputProtocol;
+@protocol VIPERAPIDataManagerInputProtocol;
+
+
+@class VIPERWireFrame;
+
+@protocol VIPERViewProtocol
+@required
+@property (nonatomic, strong) id <VIPERPresenterProtocol> presenter;
+/**
+ * Add here your methods for communication PRESENTER -> VIEWCONTROLLER
+ */
+@end
+
+@protocol VIPERWireFrameProtocol
+@required
++ (void)presentVIPERModuleFrom:(id)fromView;
+/**
+ * Add here your methods for communication PRESENTER -> WIREFRAME
+ */
+@end
+
+@protocol VIPERPresenterProtocol
+@required
+@property (nonatomic, weak) id <VIPERViewProtocol> view;
+@property (nonatomic, strong) id <VIPERInteractorInputProtocol> interactor;
+@property (nonatomic, strong) id <VIPERWireFrameProtocol> wireFrame;
+/**
+ * Add here your methods for communication VIEWCONTROLLER -> PRESENTER
+ */
+@end
+
+@protocol VIPERInteractorOutputProtocol
+/**
+ * Add here your methods for communication INTERACTOR -> PRESENTER
+ */
+@end
+
+@protocol VIPERInteractorInputProtocol
+@required
+@property (nonatomic, weak) id <VIPERInteractorOutputProtocol> presenter;
+@property (nonatomic, strong) id <VIPERAPIDataManagerInputProtocol> APIDataManager;
+@property (nonatomic, strong) id <VIPERLocalDataManagerInputProtocol> localDataManager;
+/**
+ * Add here your methods for communication PRESENTER -> INTERACTOR
+ */
+@end
+
+
+@protocol VIPERDataManagerInputProtocol
+/**
+ * Add here your methods for communication INTERACTOR -> DATAMANAGER
+ */
+@end
+
+@protocol VIPERAPIDataManagerInputProtocol <VIPERDataManagerInputProtocol>
+/**
+ * Add here your methods for communication INTERACTOR -> APIDATAMANAGER
+ */
+@end
+
+@protocol VIPERLocalDataManagerInputProtocol <VIPERDataManagerInputProtocol>
+/**
+ * Add here your methods for communication INTERACTOR -> LOCLDATAMANAGER
+ */
+@end
+
+

data/lib/templates/MAU/objc/User Interface/Presenter/VIPERPresenter.h

@@ -0,0 +1,20 @@
+//
+// VIPERPresenter.h
+// PROJECT
+//
+// Created by AUTHOR on DATE.
+// Copyright © YEAR COMPANY. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "VIPERProtocols.h"
+
+@class VIPERWireFrame;
+
+@interface VIPERPresenter : NSObject <VIPERPresenterProtocol, VIPERInteractorOutputProtocol>
+
+@property (nonatomic, weak) id <VIPERViewProtocol> view;
+@property (nonatomic, strong) id <VIPERInteractorInputProtocol> interactor;
+@property (nonatomic, strong) id <VIPERWireFrameProtocol> wireFrame;
+
+@end

data/lib/templates/MAU/objc/User Interface/Presenter/VIPERPresenter.m

@@ -0,0 +1,14 @@
+//
+// VIPERPresenter.m
+// PROJECT
+//
+// Created by AUTHOR on DATE.
+// Copyright © YEAR COMPANY. All rights reserved.
+//
+
+#import "VIPERPresenter.h"
+#import "VIPERWireframe.h"
+
+@implementation VIPERPresenter
+
+@end