Skip to content

grrr-amsterdam/garp-functional

main
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

PHPUnit PHPCS PHPStan

Garp Functional

Utility library embracing functional programming paradigms.

Documentation

Developed with ❤️ by GRRR

Philosophy

Garp\Functional is a practical functional library that strives to embrace functional paradigms.

  • Functions are pure, referentially transparent, without side-effects.
  • Data immutability is favored over mutating existing properties of given parameters.
  • In general, functions are curried. Almost all of the functions in the library can be called partially applied, to a point where this makes sense.
  • Function parameters are ordered to promote currying. Data is usually the last thing to go in, making every function a fine candidate to pass to native array_map, array_filter and the like, without having to create a closure around the call.
  • Higher-order functions are provided to fill the gaps. Functions like compose, partial, partial_right or not are legos for you to use in your own implementation.
  • Nothing is type-hinted too strictly. I don't care if you pass a string or an array to prop, as long as it allows accessing members thru bracket syntax [], I'll allow it. Nothing irks me more about PHP than not being able to toss a Traversable object into the native array_map.
  • Typeclasses are added, broadening the applicability of the functions. Next to primitives, they will now work with your objects as well, so long as they implement the right interface.

Usage

Installation:

composer require grrr-amsterdam/garp-functional

That'll do, all functions are available to you.

Read the docs for a complete reference

Thanks

This library is inspired by beautiful languages like Haskell and Clojure,
as well as the awesome RamdaJS library.