Overline 0.2.0

Objective-C utilities and shorthands.

Overline is not clone of other language features. Simple and clean Objective-C.

Usage

setup with cocoapods.

pod 'Overline'

import Overline.h

#import "Overline.h"

with BlocksKit

pod 'BlocksKit'
pod 'Overline-BlocksKit'

Ignored duplicate methods: each map reduce filter reject

Features

NSArray

NSArray+Initialize

NSArray *array = [NSArray arrayWithRangeFrom:0 to:10];
// @[@0, @1, @2, @3, @4, @5, @6, @7, @8, @9]

NSArray *array2 = [NSArray arrayWithRangeFrom:0 to:-10 step:2];
// @[@0, @-2, @-4, @-6, @-8]

arrayWithRangeFrom:to:
arrayWithRangeFrom:to:step:

NSArray+Enumeration

NSArray *mapped = [@[@1,@2,@3,@4,@5,@6] mappedArrayUsingBlock:^id(id obj, NSUInteger idx) {
    if ([obj integerValue] % 2 == 0) {
        return obj;
    }
    return nil;
}];
// @[@2,@4,@6]

each
map mappedArrayUsingBlock
reduce reducedObjectByBlock
find objectUsingBlock
filter filteredArrayUsingBlock
reject rejectedArrayUsingBlock

NSArray+Random

NSArray *shuffled = [@[@1,@2,@3,@4,@5,@6] shuffledArray];

shuffle shuffledArray
anyObject

NSArray+Reverse

NSArray *reversed = [@[@1,@2,@3,@4,@5,@6] reversedArray]; 
// @[@6,@5,@4,@3,@2,@1]

reverse reversedArray
objectAtReversedIndex

NSArray+Selector

firstObject

NSArray+SubArray

subarrayFromIndex:
subarrayFromIndex:length:
subarrayToIndex:
uniqueObjects
uniqueObjectsUsingEqualsBlock

NSArray+Difference

difference arrayDifferenceWithArray
unionise arrayByUnionisingArray

NSArray+Shorthand

isEmpty

NSArray+Sorting

arraySortedDescending:
arraySortedAsc
arraySortedDesc

NSMutableArray

NSMutableArray+Shorthands

NSMutableArray *marray = [NSMutableArray arrayWithArray:@[@1,@2,@3]];
[marray insertObjects:@[@4,@5,@6] atIndex:1];

insertObjects:atIndex:

NSMutableArray+Sorting

sortDescending:
sortAsc
sortDesc

NSDate

NSDate+Components

Class Methods

currentWeekday
currentHour
currentMinute
currentSecond
currentDay
currentMonth
currentYear
commonDateComponentsForNow
timeComponentsForNow

Instance Methods

weekday
hour
minute
second
day
month
year
commonDateComponents
timeComponents

NSDictionary

NSDictionary+Selector

NSDate *date = [JSON objectForKey:@"date8601" transformBlock:^id(id obj) {
    NSDateFormatter *formatter = [[NSDateFormatter alloc] init];
    [formatter setDateFormat:@"yyyy/MM/dd HH:mm:ss Z"];
    return [formatter dateFromString:obj];
}];

objectForKey:transformBlock:
numberForKey:
stringForKey:
arrayForKey:
dictionaryForKey:
dateForKey:
dateForKey:usingFormat:
since1970DateForKey:
timestampForKey:
boolObjectForKey:withTrueValue:
boolForKey:withTureValue:
boolForKey:
intForKey:
integerForKey:
unsignedIntForKey:
unsignedIntegerForKey:
longForKey:
unsignedLongForKey:
longLongForKey:
unsignedLongLongForKey:
doubleForKey:
floatForKey:

NSDictionary+Enumeration

NSDictionary *dic = @{
        @"a" : @1,
        @"b" : @2,
        @"c" : @3,
        @"d" : @4
};

NSDictionary *filtered = [dic dictionaryFilteredByKeyUsingBlock:^BOOL(NSString *key) {
    return [key isEqualToString:@"a"];
}]; // @{@"a":@1}

each:
map mappedDictionaryUsingBlock
arrayMap mappedArrayUsingBlock
filterKey dictionaryFilteredByKeyUsingBlock
rejectKey dictionaryRejectedByKeyUsingBlock
filterObject dictionaryFilteredByObjectUsingBlock
rejectObject dictionaryRejectedByObjectUsingBlock
merge dictionaryByMergingDictionary
reduce: reducedObjectUsingBlock:memo:
queryString stringByFormattingQuery

NSDictionary+Path

/*
@{
    @"error" : @{
        @"message" : @"msg"
    }
}
*/
NSString *s = [dic objectForPath:@"error.message"];

objectForPath:

NSSet

NSSet+Enumeration

NSSet *set = [NSSet setWithArray:@[@1,@2,@3,@4,@5,@6]];
NSSet *mapped = [set mappedSetUsingBlock:^id(id obj, NSUInteger idx) {
    if ([obj integerValue] % 2 == 0) {
        return obj;
    }
    return nil;
}];

each
map mappedSetUsingBlock
reduce reducedObjectByBlock
filter filteredSetUsingBlock
reject rejectedSetUsingBlock

NSString

NSString+Components

[@"hoge=fuga&piyo=foo" componentsSeparatedByInnerString:@"=" andOuterString:@"&"];
/* 
@{
    @"hoge" : @"fuga",
    @"piyo" : @"foo"
};
*/

componentsSeparatedByInnerString:andOuterString:

NSString+RegularExpression

[@"https?" testInString:urlString];

rangeOfFirstMatchInString:
rangeOfFirstMatchInString:options:
matchesInString:
matchesInString:options:
testInString:
testInString:options:
replace:newString: stringByReplacingOccurrencesOfRegExpPattern:withString
replace:newString:options: stringByReplacingOccurrencesOfRegExpPattern:withString:options:
replace:template: stringByReplacingOccurrencesOfRegExpPattern:withTemplate:
replace:template:options: stringByReplacingOccurrencesOfRegExpPattern:withTemplate:options:

NSString+Hash

[@"hoge" md5]; // @"ea703e7aa1efda0064eaa507d9e8ab7e"

sha256
stringByHashingSha256
md5
stringByHashingMD5

NSString+URLEncode

URLEncode
stringByEncodingURL
URLDecode
stringByDecodingURL

NSString+Shorthand

trim
trim: - Trim character set in a given string

NSString+JSON

NSString *JSONString = @"{\"hoge\" : \"fuga\" }";
id json = [JSONString jsonObject];

JSON jsonObject

NSString+Base64Encode

[@"a" stringByEncodingBase64]; // @"YQ=="
[@"YQ==" stringByDecodingBase64]; // @"a"

encodeBase64 stringByEncodingBase64
decodeBase64 stringByDecodingBase64
dataUsingDecodingBase64

NSData

NSData+Base64Encode

base64Encode stringUsingEncodingBase64

NSURL

NSURL+Components

queryComponents

NSURL+Directories

NSURL *pdfURL = [NSURL URLForUserDirectoryWithAppendedPath:@"myDoc.pdf"];
NSURL *userImageFolderURL = [NSURL URLForUserDirectoryWithAppendedPath:@"images"];

URLForDirectory:domainMask:
URLForApplicationSupportDataDirectory
URLForApplicationSupportWithAppendedPath:
URLForUserDirectory
URLForUserDirectoryWithAppendedPath:
URLForDocumentDirectory;
URLForDocumentDirectoryWithAppendedPath:;

NSBundle

NSBundle+Shorthand

JSONForResourceName

NSNumber

NSNumber+Equals

[@1 isEqualToInteger:1];

isEqualToInt:
isEqualToInteger:
isEqualToUnsignedInt:
isEqualToUnsignedInteger:
isEqualToLong:
isEqualToLongLong:
isEqualToUnsignedLong:
isEqualToUnsignedLongLong:
isEqualToDouble:
isEqualToFloat:

NSDateFormatter

NSDateFormatter+Shothand

userDefaultFormatter
dateFormatterWithCalendarIndetifiter:localeIdentifiter:timeZoneAbbreviation:

NSObject

NSObject+Equals

[[NSNull null] isNullObject]; // YES
[[NSArray array] isNullObject]; // NO

isNullObject
isArray
isDictionary
isSet
isString
isNumber

NSNull

NSNull+Natural

Provide NSNull like nil

NSDictionary *dic = @{
        @"null-key" : [NSNull null]
};
[[dic objectForKey:@"null-key"] objectForKey:@"empty"]; // nil

※ This feature disable on default. Define OV_USE_NATURAL_NULL, if use this feature.

#define OV_USE_NATURAL_NULL
#import "Overline.h"

Credits

Be sure to thank these contributors:

Kazuma Ukyo (Creator, http://yaakaito.org)
Hari Karam Singh (Contributor, http://soundwandapp.com)

Coding rules

Write tests.
Objective-C style naming.
- and shorthands.

yaakaito / overline Goto Github PK

overline's Introduction