https://github.com/grrr-amsterdam/garp-functional

PHP utility library embracing functional programming paradigms.
https://github.com/grrr-amsterdam/garp-functional

currying data-last functional-programming hacktoberfest php

Last synced: about 2 months ago
JSON representation

PHP utility library embracing functional programming paradigms.

• Host: GitHub
• URL: https://github.com/grrr-amsterdam/garp-functional
• Owner: grrr-amsterdam
• License: bsd-3-clause
• Created: 2017-01-12T07:14:34.000Z (almost 8 years ago)
• Default Branch: main
• Last Pushed: 2023-10-16T15:36:37.000Z (about 1 year ago)
• Last Synced: 2024-04-14T12:48:15.588Z (9 months ago)
• Topics: currying, data-last, functional-programming, hacktoberfest, php
• Language: PHP
• Homepage:
• Size: 508 KB
• Stars: 31
• Watchers: 4
• Forks: 4
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
[![PHPUnit](https://github.com/grrr-amsterdam/garp-functional/actions/workflows/phpunit.yml/badge.svg)](https://github.com/grrr-amsterdam/garp-functional/actions/workflows/phpunit.yml) [![PHPCS](https://github.com/grrr-amsterdam/garp-functional/actions/workflows/phpcs.yml/badge.svg)](https://github.com/grrr-amsterdam/garp-functional/actions/workflows/phpcs.yml) [![PHPStan](https://github.com/grrr-amsterdam/garp-functional/actions/workflows/phpstan.yml/badge.svg)](https://github.com/grrr-amsterdam/garp-functional/actions/workflows/phpstan.yml)

# Garp Functional

Utility library embracing functional programming paradigms.

[Documentation](https://grrr-amsterdam.github.io/garp-functional/)

## Developed with ❤️ by [GRRR](https://grrr.nl)

- GRRR is a [B Corp](https://grrr.nl/en/b-corp/)

- GRRR has a [tech blog](https://grrr.tech/)

- GRRR is [hiring](https://grrr.nl/en/jobs/)

- [@GRRRTech](https://twitter.com/grrrtech) tweets

## 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](https://grrr-amsterdam.github.io/garp-functional/)

## Thanks

This library is inspired by beautiful languages like [Haskell](https://www.haskell.org/) and [Clojure](https://clojure.org/),  

as well as the awesome [RamdaJS](https://ramdajs.com/) library.