iOS_Bootstrap for Swift

Overview

Networking, tableview, user defaults, data parsing, etc..., are the most common things among many more which we use in almost every project, so why do we repeat the same work again and again if there is something that do that work for us like a boss !! 😎😎.

Index

• Features
• Upcoming features
• Requirements
• Installation
• Quick start
• How to use
• FAQs
• Credits
• Help me improve the documentation
• Author
• Contributers
• Contact US
• License

Features

1. Only import boot strap.
2. Abstract network layer (Unified error + unified result closure).
3. Generic error manager.
4. Unified parser.
5. Tableview adapter with empty data set handler.
6. Reusable table view adapter.
7. Toast messages component ( Like the one in Android 😉 ).
8. Simplified syntax ( Dequeue cell, go to Viewcontroller programatically ).
9. Custom pickers ( List, date, time, date & time, multi lists ).
10. Customizable progress dialog.
11. Unified base model for objects parsing (Serialize & deserialize).
12. Unified base push notification model for push notification payload parsing.
13. User defaults manager.
14. Base collection and table view cells.
15. Only one delegate for collection view & one for table view ( Including empty data set ).
16. Singleton logger class ( Like the one in Android 😉 ).
17. Useful extensions (String to dictionary, remove duplicates from array, hex to UI color, UIlabel partial text formatting, UIimage + GIF)
18. Customizable UIview.
19. Customizable Cardview.
20. Customizable UIbutton.
21. Customizable toggle button ( Check box + radio button ).
22. Keyboard handler
23. Collection view adapter.
24. Reusable collection view adapter.
25. Table and collection views pagination handler.
26. Image loading ad caching from network out of the box.
27. Coordinator design pattern + viewcontrollers naviagator base class + examples
28. Simple depenfancy injection implementation.
29. Refresh token RX Swift plugin.
30. Real time listeners for token update/expire event ( Work with point 29 or 30 but not alone ).
31. Out of the box app build variants/schemes ( Debug - Staging - Release ) handler.
32. Read/Write Files/Folder managers.
33. In app localization manager ( No need tor restart your app 😉 ).
34. Cleaner localization syntax.
35. UI button show/hide loading extension.
36. Show/hide loading in any vew controller
37. BaseTableAdapterController, BaseTableAdapterPresenter, BaseCollectionAdapterController, BaseCollectionAdapterPresenter to save you somtime and code when you implement table or collection view.
38. You can call getUserDefaults from BaseController and BasePresenter by default.
39. Phone number validator string extension.
40. ViewPager (AKA : Segmented controller) as the one in Android 😁.
41. Automated Contexts injection.
42. Added UITabBar controller MVP base class.
43. Default app delegate configurations using friendly builder pattern methods.
44. Cancel any newtowrk request out of the box.
45. Base side menu controller + Base tabbar controller + base table and collection view controller, all with MVP out of the box.
46. You can hide the notch for iPhone X series 😁.
47. Side menu out of the box.
48. Event bus helper class.
49. Added Skeleton helper class to add shimmering effect to UIViews, table and collection views.
50. Added dropdown banner component.
51. Includes RXvalidation.
52. Out of the box table and collection view live data.
53. How to use + examples + documentation + references.

Upcoming features

1. More extensions! Please if there is an extension you are constantly using, send a PR now.

Requirements

• iOS 9.1+
• Xcode 9.2+
• Swift 4.1 +

Installation

You can integrate iOS_Bootstrap into your project using CocoaPods.

CocoaPods is a dependency manager for iOS Cocoa projects, You can install it with the following command:

$ gem install cocoapods

CocoaPods 1.1+ is required to build iOS_Bootstrap.

To integrate iOS_Bootstrap into your Xcode project using CocoaPods, specify it in your Podfile:

pod 'iOS_Bootstrap'

Then run the following command:

$ pod install

Once your project is integrated with the iOS_Bootstrap , you can pull updates using the following command:

$ pod update

Note

There is a project generator to help you build things faster at thils Link, Enjoy 😎.

Quick start

Just import iOS_Bootstrap and your are ready to go.

• For almost every feature available in this Pod their is an example or how to use file or a link to an example or explanation.
• For any thing not clear or for help, please contact me or open a bug and i will assist you as soon as i can.

How to use (Highlights)

Dequeuing cell simplified syntax :

Ues this

let cell : TableViewCell = tableview.dequeueReusableCell(forIndexPath: indexPath)

Instead of this

let cell = tableView.dequeueReusableCell(withIdentifier: "cell", for: indexPath) as? TableViewCell

Empty data set delegates :

Deal with tableview in case the data source is empty or nil.

Storyboard and Viewcontroller navigation simplified syntax ;and less typo errors :

Use this

let storyboard = UIStoryboard.getStoryboardWithName(Storyboard.home.rawValue)
let homeVC : HomeVC = storyboard.instantiateInitialViewController()
present(homeVC, animated: true, completion: nil)

Instead of this

let storyboard : UIStoryboard = UIStoryboard(name: "Home", bundle:nil)
let homeVC = storyboard.instantiateViewControllerWithIdentifier("nextView") as! HomeVC
self.presentViewController(homeVC, animated:true, completion:nil)

Erros in one place + Human readable errors :

When you use Alamofire, you get success and fail result and the failure closure will be called only if there is a network failure but if there is a server failure like forexample 404, 500, etc.., they all come in the success closure and you have to handle this by yourself, i found this wierd so if you used the GenericErrorHandler along with the network abstract layer, you can do filter the result of the result closure using the following operators .filterSuccessfulStatusCodes() & processErrors(), you can even localise the server messages in case your app. were in different languages.

#### Unified result closure :
A close that returns a result of any type and an error string.

#### Loggers :

Instead of filling your code with statemetns which is not good plus it will affetct your code when your release it to production, you can use `Log` class which is pretty readable in the console plus it works only in the debug mode and you can debug with error, info., warning, server and more.

`Log.error("There is an error ")`


>Many many more ( About 56 features ), you can find more details in the examples associated with the pod and if anything is not clear just contact me.



### Note :

>Due to a bug in Cocoapods, so the Storyboard sometimes many fail to render if you added a custom `@IBDesignable` view to a component in storyboard and this custom `@IBDesignable` view was in the pod files path (Any pod not just my pod) and not your project files path, so to solve this problem please add the following code to the end of your pod file.


>
```ruby
# Workaround for Cocoapods issue #7606
post_install do |installer|
    installer.pods_project.build_configurations.each do |config|
        config.build_settings.delete('CODE_SIGNING_ALLOWED')
        config.build_settings.delete('CODE_SIGNING_REQUIRED')
    end
end

For more details, please see this link

FAQs

1. Do i need to add Alamofire pod to my project ?
   No, you do not need to do so since Alamofire will be installed once you add the iOS_Bootstrap to your project.

2. Waht if i need to use Alamofire or anyother dependacy from the iOS_Bootstrap, What i have to do ?
   All you have to do is to import the library instead of importing iOS_Bootstrap.

Credits

The following awesome libraries are used as dependancies in my pod :

1. Alamofire.
2. IQKeyboardManager.
3. Nuke
4. SCLAlertView.

In addition, the following Repos helped me alot either by including their codes directly into my pod or using some portion of their codes to improve my library or to learn something new so thank you for sharing your awesome codes for free to the community.

1. EZLoadingActivity.
2. Lucid.
3. ActionSheetPicker-3.0.
4. ADTPagerController.
5. Bartinter.
6. SlideMenuControllerSwift.
7. HairPowder.
8. SwiftEventBus.
9. BRYXBanner
10. RxValidator

Help me improve the documentation

As a developer trying this pod out for the first time, you can make a valuable contribution by improving the documentation.

• Send a feedback about something you thought was confusing or simply missing.
• Suggesting better wording or ways of explaining certain topics.
• A pull request via GitHub.
• Bug reports, feature requests, patches, well-wishes, and rap demo tapes are always welcome.

Author

Ahmad Mahmoud Saleh

Contributers

Contact US

• Mail
• Github

License

iOS_Bootstrap is released under the MIT license. See License for details.

---