Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/appsquickly/Typhoon

Powerful dependency injection for Objective-C ✨✨ (https://PILGRIM.PH is the pure Swift successor to Typhoon!!)✨✨
https://github.com/appsquickly/Typhoon

dependency-injection di inversion-of-control ioc ioc-container typhoon

Last synced: 3 months ago
JSON representation

Powerful dependency injection for Objective-C ✨✨ (https://PILGRIM.PH is the pure Swift successor to Typhoon!!)✨✨

Awesome Lists containing this project

README 

        
# Typhoon



Powerful dependency injection for Cocoa and CocoaTouch. Lightweight, yet full-featured and super-easy to use. 



---------------------------------------



# [Pilgrim](https://pilgrim.ph) is a pure Swift successor to Typhoon!!



Typhoon uses the Objective-C runtime to collect metadata and instantiate objects. It powers thousands of Objective-C applications but it is not all that great for modern Swift. 



**Pilgrim (https://github.com/appsquickly/pilgrim) is a pure Swift successor to Typhoon. It is easy to migrate your Typhoon apps to [Pilgrim](https://pilgrim.ph).** 



---------------------------------------



## Not familiar with Dependency Injection? 



Visit the Typhoon website for an introduction. There's also a nice intro over at Big Nerd Ranch, or here's an article, by John Reid. Quite a few books have been written on the topic, though we're not familiar with one that focuses specifically on Objective-C, Swift or Cocoa yet. 



## Is Typhoon the right DI framework for you? 



Check out the feature list. 



---------------------------------------



# Usage



* Read the ***Quick Start*** for Objective-C or Swift. 

* Here's the User Guide.

* 日本のドキュメンテーション



```swift

let assembly = MyAssembly().activated()

let viewController = assembly.recommendationController() as! RecommendationController

```



# Open Source Sample Applications



* Try the official Swift Sample Application or Objective-C Sample Application. 

* This sample shows how to set up Typhoon with Storyboards, Core Data and Reactive Cocoa. 



*Have a Typhoon example app that you'd like to share? Great! Get in touch with us :)*



# Installing 

[![Build Status](https://travis-ci.org/appsquickly/typhoon.svg?branch=master)](https://travis-ci.org/appsquickly/typhoon)

[![codecov](https://codecov.io/gh/appsquickly/Typhoon/branch/master/graph/badge.svg)](https://codecov.io/gh/appsquickly/Typhoon)

![CocoaPods Version](https://cocoapod-badges.herokuapp.com/v/Typhoon/badge.png) [![Pod Platform](https://img.shields.io/cocoapods/p/Typhoon.svg?style=flat)](http://appsquickly.github.io/Typhoon/docs/latest/api/modules.html) [![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage) [![Dependency Status](https://www.versioneye.com/objective-c/typhoon/1.1.1/badge.svg?style=flat)](https://www.versioneye.com/objective-c/typhoon) [![Pod License](https://img.shields.io/cocoapods/l/Typhoon.svg?style=flat)](https://github.com/appsquickly/typhoon/blob/master/LICENSE)



Typhoon is available through CocoaPods or Carthage, and also builds easily from source.



## With CocoaPods . . . 



### Static Library



```ruby



# platform *must* be at least 5.0

platform :ios, '5.0'



target :MyAppTarget, :exclusive => true do



pod 'Typhoon'



end

```



### Dynamic Framework



If you're using Swift, you may wish to install dynamic frameworks, which can be done with the Podfile shown below: 



```ruby

# platform *must* be at least 8.0

platform :ios, '8.0'



# flag makes all dependencies build as frameworks

use_frameworks!



# framework dependencies

pod 'Typhoon'

```



Simply import the Typhoon module in any Swift file that uses the framework:



```Swift

import Typhoon

```



## With Carthage



```

github "appsquickly/Typhoon"

```



## From Source



Alternatively, add the source files to your project's target or set up an Xcode workspace. 



**NB:** *All versions of Typhoon work with iOS5 and up (and OSX 10.7 and up), iOS8 is only required if you wish to use dynamic frameworks.* 



---------------------------------------



# Feedback



### I'm not sure how to do [xyz]



If you can't find what you need in the Quick Start or User Guides above, then Typhoon users and contributors monitor the Typhoon tag on Stack Overflow. Chances are your question can be answered there. 



### I've found a bug, or have a feature request



Please raise a GitHub issue.



### Interested in contributing?



 Great! Here's the contribution guide.



### I'm blown away!



Typhoon is a non-profit, community driven project. We only ask that if you've found it useful to star us on Github or send a tweet mentioning us (@appsquickly). If you've written a Typhoon related blog or tutorial, or published a new Typhoon powered app, we'd certainly be happy to hear about that too. 



Typhoon is sponsored and led by AppsQuick.ly with contributions from around the world. 

 

---------------------------------------

© 2012 - 2015 Jasper Blues, Aleksey Garbarev and contributors.