ConciseKit
A set of Objective-C additions and macros that lets you to write code more quickly.
Pull requests are welcome!
USAGE
Use CocoaPods
dependency 'ConciseKit', '~> 0.1.2'or
- Copy files under
src/to your project.
#import "ConciseKit.h"$ class
Method Swizzling
[$ swizzleMethod:@selector(foo) with:@selector(bar) in:[Foo class]]
[$ swizzleMethod:@selector(foo) in:[Foo class] with:@selector(bar) in:[Bar class]]
[$ swizzleClassMethod:@selector(foo) with:@selector(bar) in:[Foo class]]
[$ swizzleClassMethod:@selector(foo) in:[Foo class] with:@selector(bar) in:[Bar class]]
Path
[$ homePath] => path to user's home directory
[$ desktopPath] => path to user's desktop directory
[$ documentPath] => path to user's document directory
[$ appPath] => path to app directory
[$ resourcePath] => path to app's resources directory
waitUntil
Useful when writing tests for asynchronous tasks. Default timeout is 10 seconds, checking is done every 0.1 seconds.
[$ waitUntil:^{ return (BOOL)(someConditionIsMet == YES) }]
[$ waitUntil:^{ return (BOOL)(someConditionIsMet == YES) } timeOut:10.0]
[$ waitUntil:^{ return (BOOL)(someConditionIsMet == YES) } timeOut:10.0 interval:0.1]
Singleton
Creating Singletons
@interface Foo
- (id)initSingleton; // <= add these to the interface
+ (Foo *)sharedFoo; // <= where Foo is the class name
@end
@implementation Foo
$singleton(Foo); // => makes Foo a singleton class
- (id)initSingleton {
foo = 1; // do initialization in -initSingleton method
bar = 2;
return self;
}
@end
Using Singletons
$shared(Foo) // => returns the shared instance
/* or */
[Foo sharedFoo]
Macros
General shorthands
$new(Foo) => [[[Foo alloc] init] autorelease]
$eql(foo, bar) => [foo isEqual:bar]
$safe(obj) => (obj == [NSNull null] ? nil : obj)
NSArray shorthands
$arr(foo, bar) => [NSArray arrayWithObjects:foo, bar, nil]
$marr(foo, bar) => [NSMutableArray ...]
$marrnew or $marr(nil) => [NSMutableArray array]
NSSet shorthands
$set(foo, bar) => [NSSet setWithObjects:foo, bar, nil]
$mset(foo, bar) => [NSMutableSet ...]
$msetnew or $mset(nil) => [NSMutableSet set]
NSDictionary shorthands
$dict(v1, k1, v2, k2) => [NSDictionary dictionaryWithObjectsAndKeys:v1, k1, v2, k2, nil]
$mdict(v1, k1, v2, k2) => [NSMutableDictionary ...]
$mdictnew or $mdict(nil) => [NSMutableDictionary dictionary]
NSString shorthands
$str(@"foo: %@", bar) => [NSString stringWithFormat:@"foo: %@", bar]
$mstr(@"foo: %@", bar) => [NSMutableString ...]
$mstrnew or $mstr(nil) => [NSMutableString string]
NSNumber shorthands
$bool(YES) => [NSNumber numberWithBool:YES]
$int(123) => [NSNumber numberWithInt:123]
$float(123.4) => [NSNumber numberWithFloat:123.4]
$char(), $double(), $integer(), $long(), $longlong(), $short(),
$uchar(), $uint(), $uinteger(), $ulong(), $ulonglong(), $ushort()
NSValue shorthands
$nonretained(), $pointer(), $point(), $range(), $rect(), $size()
Additions
NSArray
[array $first] => [array objectAtIndex:0]
[array $last] => [array lastObject]
[array $at:1] => [array objectAtIndex:1]
[array $each:^(id obj) {
NSLog(@"%@", obj);
}]
[array $eachWithIndex:^(id obj, NSUInteger i) {
NSLog(@"%d %@", i, obj);
}]
[array $eachWithStop:^(id obj, BOOL *stop) {
NSLog(@"%@", obj);
if($eql(obj, @"foo")) {
*stop = YES;
}
}]
[array $eachWithIndexAndStop:^(id obj, NSUInteger i, BOOL *stop) {
NSLog(@"%d %@", i, obj);
if(i == 1) {
*stop = YES;
}
}]
[array $map:^(id obj) {
return $integer([obj integerValue] * 2);
}]
[array $mapWithIndex:^(id obj, NSUInteger i) {
return $integer([obj integerValue] * 2 + i);
}]
[array $reduce:^(id obj) {
return $integer([obj integerValue] * 2);
}]
[array $reduce:^(NSNumber *memo, NSNumber *obj) {
return $integer([memo integerValue] + [obj integerValue]);
}]
[array $reduceStartingAt:$integer(1) with:^(NSNumber *memo, NSNumber *obj) {
return $integer([memo integerValue] * [obj integerValue]);
}]
[array $select:^BOOL(NSNumber *obj) {
return ([obj integerValue] % 2) == 0;
}]
[array $detect:^BOOL(NSNumber *obj) {
return ([obj integerValue] % 2) == 1;
}]
[array $join] => [self componentsJoinedByString:@""]
[array $join:@","] => [self componentsJoinedByString:@","]
NSMutableArray
[array $push:foo] => [array addObject:foo] (+ returns self)
[array $pop] => [array removeLastObject] (+ returns lastObject)
[array $unshift:foo] => [array insertObject:foo atIndex:0] (+ returns self)
[array $shift] => [array removeObjectAtIndex:0] (+ returns first object)
NSDictionary
[dict $for:@"foo"] => [dict objectForKey:@"foo"]
[dict $keys] => [dict allKeys]
[dict $values] => [dict allValues]
[dict $each:^(id key, id value) {
NSLog(@"%@ => %@", key, value);
}
[dict $eachWithStop:^(id key, id value, BOOL *stop) {
NSLog(@"%@ => %@", key, value);
if($eql(key, @"foo")) {
*stop = YES;
}
}]
[dict $eachKey:^(id key) {
NSLog(@"%@", key);
}]
[dict $eachValue:^(id value) {
NSLog(@"%@", value);
}]
NSMutableDictionary
[dict $obj:@"bar" for:@"foo"] => [dict setObject:@"bar" forKey:@"foo"] (+ returns self)
NSString
[string $append:@"foo"] => [string stringByAppendString:@"foo"]
[string $prepend:@"foo"] => [NSString stringWithFormat:@"%@%@", @"foo", string]
[string $split:@","] => [string componentsSeparatedByString:@","]
[string $split] => [string componentsSeparatedByCharactersInSet:[NSCharacterSet whitespaceAndNewlineCharacterSet]]
NSMutableString
[string $append_:@"foo"] => [string appendString:@"foo"] (+ returns self)
[string $prepend_:@"foo"] => [string insertString:@"foo" atIndex:0] (+ returns self)
[string $insert:@"foo" at:1] => [string insertString:@"foo" atIndex:1] (+ returns self)
[string $set:@"foo"] => [string setString:@"foo"] (+ returns self)
Contributors
License
Copyright (c) 2010-2012 Peter Jihoon Kim and contributors. This code is licensed under the MIT License.