No description, website, or topics provided.
JavaScript Objective-C Ruby
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

#Value Add Key Path

Value Add Key Path is a key path grammar taken to it's Cocoa Extreme. It allows creation of keypaths with custom collection operations and collection filtering with NSPredicate. It is a goal to allow the lookup of any object in your application with a single string.

Using this in Application code is probably a bad idea. Using this in Test Code, is very nice.

This was written to give Frank users a Cocoa option for looking up objects using frank. It allows the tester to work with non-UIView objects as well as use a grammar Cocoa developers are used to. It is very wordy, but clear and easily extensible. Think of it as an alternative to UISpec rather than an advanced keypath.

In addition to custom Key Paths, there is also a category to simplify object lookup and a SelectorEngine for use inside Frank.


  • Objects can be filtered by adding a NSPredicate defined by a '[[.*]]' block
  • Only NSArray and NSSet object supported by default
  • Any object can add filtering support by implementing filteredValueAddUsingPredicate:
  • Execute a method on an object by preceding the key path with a @
  • Arguments are not currently supported. Grammar suggestions are desired!
  • Regular key path collection operations may not be supported without additional categories


Assume the following wrapper for the examples below.

[[UIApplication sharedApplication] valueAddKeyPath:$EXAMPLE]

To obtain a list of all subviews:


To obtain a specific type of view:


To obtain the view's grand parent:


To Ensure that the specified view is not moving

windows.@flattenBy.subviews[[class.description='UILabel' AND tag=1000 AND isHidden=NO AND isOnScreen=YES]].@flattenBy.superview[[isAnimating = 0]]

Yes, it's a bit excessive, but it makes easy to bridge into scripting languages.