GitXplorerGitXplorer
t

Funky

public
42 stars
2 forks
5 issues

Commits

List of commits on branch master.
Verified
0bd22c7ae443a56a9c0fba8114342c30421c24fa

Merge pull request #2 from tevelee/dependabot/bundler/redcarpet-3.5.1

ttevelee committed 4 years ago
Verified
484cda4554e159688a9fe5a2d36030f221488509

Bump redcarpet from 3.4.0 to 3.5.1

ddependabot[bot] committed 4 years ago
Verified
0211321247254b518f054749d9db4c17b8c56956

CI update

ttevelee committed 7 years ago
Unverified
f47dcb15a5da411f13aeb6922c625d8371c1e8eb

Documentation update

ttevelee committed 7 years ago
Unverified
a337d7ee48d61a9ce66de9a8982bc9cead7f9880

Improving test coverage

ttevelee committed 7 years ago
Unverified
2325cf8d4b43d200654abb520bfab59b14118d1e

Minor fix in documentation

ttevelee committed 7 years ago

README

The README file for this repository.

Funky

CI Status Code coverage Documentation Version License Platform Language

Funky is a functional utility library written in Objective-C.

It provides a set of extension methods on NSArray, NSDictionary and NSSet for you to help dealing with common operations (usually in a functional way).

Documentation

Full documentation is available at tevelee.github.io/Funky

Installation with CocoaPods

CocoaPods is a dependency manager for Swift and Objective-C Cocoa projects. You can install it with the following command:

$ sudo gem install cocoapods

To install Funky, simply add the following line to your Podfile:

pod "FunkyObjC"

then import using any of these

#import <Funky/NSArray+FunkyUtilities.h>
#import <Funky/NSDictionary+FunkyUtilities.h>
#import <Funky/NSSet+FunkyUtilities.h>

Usage

The framework contains a set of extension methods on NSArray, NSSet and NSDictionary.

Using them is as simle as

NSArray<NSNumber*>* numbers = @[@1, @2, @3];
NSArray<NSString*>* strings = [numbers map:^id(NSNumber* item) {
    return item.stringValue;
}];

or

bigNumbers = [numbers filter:^BOOL(NSNumber* item) {
    return item.intValue > 1000;
}];

Click here for the full list of utils, or visit tevelee.github.io/Funky for a detailed documentation

The framework includes some cool nil-tolerant collection behaviours as well:

NSArray* array = @[@0, @1, @2].nilTolerant;
NSLog(@"Items: %@", [array arrayByAddingObject:nil]);

Again, see the docs for more details

Help & Bug Reporting

In case you need help or want to report a bug - please file an issue. Make sure to provide as much information as you can, sample code also makes it a lot easier for me to help you.

Contribution

Anyone is more than welcome to contribute to Funky! It even can be an addition to the docs or to the code directly, by raising an issue or in form of a pull request. Both are equally valuable to me!

Future plans

Roadmap

  • Figuring out ways for lazy collections, so the order of map/filter/take won't matter and always compute only the most necessary computations. So if you operate a map function on a huge array, but at the end you filter only for a few, the mapping should only take effect on the very few you needed.

General guidelines

  • Active maintenance
  • Keep the >95% test and documentation coverage
  • Accepting suggestions and pull requests from the community

Author

I am Laszlo Teveli, software engineer, iOS evangelist.

Feel free to reach out to me anytime via tevelee [at] gmail [dot] com.

License

Funky is available under the MIT license. See the LICENSE file for more information.