rakesh-mohanta / underscore-1

Functional programming library for PHP

Underscore

Functional programming library for PHP

Code example

Library aims to be as easy to use as possible. Here is example of doing some not-so-meaningful operations to show off:

    Underscore::from([1,2,3,4,5])
            // convert array format
        ->map(function($num) { return ['number' => $num];})
            // filter out odd elements
        ->filter(function($item) { return ($item['number'] % 2) == 0;})
            // vardump elements
        ->invoke(function($item) { var_dump($item);})
            // changed my mind, I only want numbers
        ->pick('number')
            // add numbers to 1000
        ->reduce(function($sum, $num) { $sum += $num; return $sum; }, 1000)
            // take result
        ->value();
            // 1006

Motivation

Originaly I needed functional programming magic for other project, so had to pick one lib or write my own.

There is several PHP ports of UnderscoreJS, however none of those fit my requirements (nice code, easy to write, standardized):

• brianhaveri/Underscore.php - not maintained, messy code
• Anahkiasen/underscore-php - Laravel4 package => incompatible with PSR-2

Installation

Via composer:

$ composer require Im0rtality/Underscore:dev-master

Composer docs recommend to use specific version. You can look them up in Releases.

Documentation

Will be added later

TODO

Check open issues

Tests

Each commit is tested on TRAVIS using multiple PHP versions (5.3, 5.4, 5.5; plus 5.6, hhvm which are being run but not checked for failures) to ensure compatibility.

Tests generate coverage reports in clover.xml format

$ phpunit

License

MIT License: You can do whatever you want as long as you include the original copyright.