Skip to content

dazzle-php/promise

Repository files navigation

Dazzle Promise Implementation

Build Status Code Coverage Code Quality Latest Stable Version Latest Unstable Version License

Note: This repository is part of Dazzle Project - the next-gen library for PHP. The project's purpose is to provide PHP developers with a set of complete tools to build functional async applications. Please, make sure you read the attached README carefully and it is guaranteed you will be surprised how easy to use and powerful it is. In the meantime, you might want to check out the rest of our async libraries in Dazzle repository for the full extent of Dazzle experience.


Description

Dazzle Promise is a component that provides PHP implementation of promises specification and additional promise-related concepts such as joining, mapping, reducing and cancelling promises.

Feature Highlights

Dazzle Promise features:

  • Implementation of promises,
  • Methods to resolve, reject or cancel promises,
  • Cancellation of promises using forget semantics,
  • Methods to join, map, race, reduce and do other things with set of promises,
  • ...and more.

Provided Example(s)

Quickstart

TODO

Additional

TODO

Requirements

Dazzle Promise requires:

  • PHP-5.6 or PHP-7.0+,
  • UNIX or Windows OS.

Installation

To install this library make sure you have composer installed, then run following command:

$> composer require dazzle-php/promise

Tests

Tests can be run via:

$> vendor/bin/phpunit -d memory_limit=1024M

Versioning

Versioning of Dazzle libraries is being shared between all packages included in Dazzle Project. That means the releases are being made concurrently for all of them. On one hand this might lead to "empty" releases for some packages at times, but don't worry. In the end it is far much easier for contributors to maintain and -- what's the most important -- much more straight-forward for users to understand the compatibility and inter-operability of the packages.

Contributing

Thank you for considering contributing to this repository!

License

Dazzle Framework is open-sourced software licensed under the MIT license.


"Everything is possible. The impossible just takes longer." ― Dan Brown