marmelroy / objectivekit

Swift-friendly API for a set of powerful Objective C runtime functions.

ObjectiveKit

ObjectiveKit provides a Swift friendly API for a set of powerful Objective C runtime functions.

Usage

To use ObjectiveKit:

Import ObjectiveKit at the top of your Swift file:

import ObjectiveKit

The next step is to create an ObjectiveClass object typed for the class you want to modify or introspect:

let viewClass = ObjectiveClass<UIView>()

If using ObjectiveKit on a custom Swift class, make sure that it inherits at some point from NSObject and that it is exposed to the Objective C runtime using the @objc flag.

Introspection

You can learn more about classes at runtime with these handy introspection methods:

let mapViewClass = ObjectiveClass<MKMapView>()
let ivars = mapViewClass.ivars // An array of ivars.
let selectors = mapViewClass.selectors // An array of selectors.
let properties = mapViewClass.properties // An array of properties.
let protocols = mapViewClass.protocols // An array of protocols.

Modifying classes at runtime

Add a pre-existing selector from another class to your ObjectiveClass:

let viewClass = ObjectiveClass<UIView>()
viewClass.addSelector(#selector(testSelector), from: self.classForCoder)
let view = UIView()
view.perform(#selector(testSelector))

Add a custom method by providing the implementation with a closure:

let viewClass = ObjectiveClass<UIView>()
viewClass.addMethod(closureName, implementation: {
    print("hello world")
})
let view = UIView()
view.performMethod(closureName)

ObjectiveKit also supports exchanging selectors in the same class:

let viewClass = ObjectiveClass<UIView>()
viewClass.exchangeSelector(#selector(UIView.layoutSubviews), with: #selector(UIView.xxx_layoutSubviews))

Creating classes at runtime

Lastly, you can also create a custom ObjC class at runtime:

let runtimeClass = RuntimeClass(superclass: UIView.self)
runtimeClass.addIvar(ivarName, type: .Float)
let runtimeObject = runtimeClass.allocate()
runtimeObject.setValue(4.0, forKey: ivarName)

Setting up

Setting up with CocoaPods

source 'https://github.com/CocoaPods/Specs.git'
pod 'ObjectiveKit', '~> 0.2'

Setting up with Carthage

Carthage is a decentralized dependency manager that automates the process of adding frameworks to your Cocoa application.

You can install Carthage with Homebrew using the following command:

$ brew update
$ brew install carthage

To integrate ObjectiveKit into your Xcode project using Carthage, specify it in your Cartfile:

github "marmelroy/ObjectiveKit"

Inspiration

• https://github.com/mikeash/MAObjCRuntime

objectivekit's Issues

Is it within the App Store policy?

I was wondering if you would get rejected by the App Store for using this in an app.

Properties instead of methods?

I think in current trends dynamic properties are favorited over methods without parameters, e.g. you have let ivars = mapViewClass.ivars() this could be simply mapViewClass.ivars Just throwing the idea on the table

Interesting component for NSObject class :-)

Hi,
Interesting component for NSObject class 🙂
With TProperties I did something similar but for pure classes Swift 😉

README Images

More swifty naming ?

This is not an exhaustive list of course but I think this project should benefit from more concise and compact naming à la Swift 3.0.

Before	After
let ivars = mapViewClass.allIvars()	let ivars = mapViewClass.vars()
let selectors = mapViewClass.allSelectors()	let selectors = mapViewClass.selectors()
let properties = mapViewClass.allProperties()	let properties = mapViewClass.properties()
let protocols = mapViewClass.allProtocols()	let protocols = mapViewClass.protocols()
viewClass.addSelectorToClass(...)	viewClass.addSelector(...)
viewClass.addMethodToClass(...)	viewClass.addMethod(...)

I've spotted a few other places where this can be applied. What do you think ?