2017 © Pedro Peláez
 

composer-plugin dev

Development and debugging tools for Recoil applications.

image

recoil/dev

Development and debugging tools for Recoil applications.

  • Sunday, July 1, 2018
  • by jmalloc
  • Repository
  • 1 Watchers
  • 2 Stars
  • 1,976 Installations
  • PHP
  • 4 Dependents
  • 0 Suggesters
  • 0 Forks
  • 2 Open issues
  • 14 Versions
  • 8 % Grown

The README.md

Recoil Development Tools

Build Status Code Coverage Code Quality Latest Version, (*1)

Development and debugging tools for Recoil applications., (*2)

composer require --dev recoil/dev

Usage

Primarily, recoil/dev is a Composer plugin that automatically instruments coroutine functions to provide meaningful stack traces in the event of an exception. Without recoil/dev, stack traces tend to show details about the internals of the Recoil kernel, rather than the coroutines it is executing., (*3)

Instrumentation is performed automatically, by plugging in to the autoload pipeline. For most use cases no change is required in your code (other than the note below), and you should immediately see more usable stack traces., (*4)

The instrumentor identifies functions as coroutines if they have a return type hint of Coroutine, where Coroutine is an alias for Generator, for example:, (*5)

// Alias Generator as Coroutine.
use Generator as Coroutine;

function doNothing(int $value): Coroutine // Mark function as a coroutine.
{
    yield;
}

The instrumentor will not instrument functions that use a return type hint of Generator, as without the alias it has no way to distinguish between an actual coroutine and a regular generator function., (*6)

Troubleshooting

Check the following: 1. Ensure that assertions are enabled on your development environment. 2. Ensure that your coroutines are explicitly identified using : Coroutine type hint, as described above. 3. Syntax errors in your source files may break the PHP parsing used to generate instrumentation, leaving those files uninstrumented -- check your syntax! 4. For further issues with autoload, or to disable instrumentation, see these further notes., (*7)

Building and testing

Please see CONTRIBUTING.md for information about running the tests and submitting changes., (*8)

The Versions

01/07 2018

dev-master

9999999-dev https://github.com/recoilphp/dev

Development and debugging tools for Recoil applications.

  Sources   Download

MIT

The Requires

 

The Development Requires

debug stack exception asynchronous async trace recoil instrumentation

11/02 2018

dev-15-php-cs-fixer-2

dev-15-php-cs-fixer-2 https://github.com/recoilphp/dev

Development and debugging tools for Recoil applications.

  Sources   Download

MIT

The Requires

 

The Development Requires

debug stack exception asynchronous async trace recoil instrumentation

13/12 2017
18/10 2017
24/04 2017

dev-12-phpparser3

dev-12-phpparser3 https://github.com/recoilphp/dev

Development and debugging tools for Recoil applications.

  Sources   Download

MIT

The Requires

 

The Development Requires

debug stack exception asynchronous async trace recoil instrumentation

13/01 2017

dev-10-non-generator-annotated-as-coroutine

dev-10-non-generator-annotated-as-coroutine https://github.com/recoilphp/dev

Development and debugging tools for Recoil applications.

  Sources   Download

MIT

The Requires

 

The Development Requires

debug stack exception asynchronous async trace recoil instrumentation

11/01 2017
10/01 2017
14/12 2016
13/12 2016
12/12 2016
07/12 2016