PHPackages                             recipe-runner/recipe-runner - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Parsing &amp; Serialization](/categories/parsing)
4. /
5. recipe-runner/recipe-runner

ActiveLibrary[Parsing &amp; Serialization](/categories/parsing)

recipe-runner/recipe-runner
===========================

1.0.0-alpha1(6y ago)1148[1 issues](https://github.com/recipe-runner/recipe-runner/issues)1MITPHPPHP ^7.2CI failing

Since Sep 17Pushed 6y ago1 watchersCompare

[ Source](https://github.com/recipe-runner/recipe-runner)[ Packagist](https://packagist.org/packages/recipe-runner/recipe-runner)[ Docs](https://github.com/recipe-runner/recipe-runner)[ RSS](/packages/recipe-runner-recipe-runner/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (1)Dependencies (5)Versions (2)Used By (1)

Recipe Runner
=============

[](#recipe-runner)

[![Build Status](https://camo.githubusercontent.com/1b8a3650f57ba29277d2d63269721f0362b8a36a90447a8976222ae181cc7276/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f7265636970652d72756e6e65722f7265636970652d72756e6e65722f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/recipe-runner/recipe-runner)[![Build status](https://camo.githubusercontent.com/57961e6a2c519d5d6b48785b13b35c027f3ce13e7ca41091cb4c3101c82ef284/68747470733a2f2f63692e6170707665796f722e636f6d2f6170692f70726f6a656374732f7374617475732f6a7237316e77716e71613570316764343f7376673d74727565)](https://ci.appveyor.com/project/yosymfony/recipe-runner)

Recipe Runner is a new way to automate tasks and extend your applications.

Requires
--------

[](#requires)

- PHP +7.3

Installation
------------

[](#installation)

The preferred installation method is [composer](https://getcomposer.org):

```
composer require recipe-runner/recipe-runner
```

Usage
-----

[](#usage)

```
use RecipeRunner\Definition\RecipeMaker;
use RecipeRunner\RecipeRunner\Recipe\StandardRecipeVariables;
use RecipeRunner\RecipeRunner\Setup\QuickStart;

$recipeVariables = StandardRecipeVariables::getCollectionOfVariables();

$recipeMaker = new YamlRecipeMaker();
$recipe = $recipeMaker->makeRecipeFromFile('/path-to-a-recipe.yml');

$recipeParser = QuickStart::Create();
$recipeParser->parse($recipe, $recipeVariables);
```

Recipe example
--------------

[](#recipe-example)

Recipes are written in YAML:

```
name: "Very simple example that creates variables"

steps:
  - actions:
    - register_variables:
        user: "victor"
        register: my_variables
```

Unit tests
----------

[](#unit-tests)

You can run the unit tests with the following command:

```
$ cd recipe-runner
$ composer test
```

License
-------

[](#license)

This library is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT).

###  Health Score

16

—

LowBetter than 5% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

2426d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/cac3ac1311a4a66c37c1c6cb3301e6a02e5f4f8b742dfb95d1ce6805e8d8fe94?d=identicon)[yosymfony](/maintainers/yosymfony)

---

Top Contributors

[![yosymfony](https://avatars.githubusercontent.com/u/3321099?v=4)](https://github.com/yosymfony "yosymfony (50 commits)")

---

Tags

automationphprecipe-runnerymlyaml

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/recipe-runner-recipe-runner/health.svg)

```
[![Health](https://phpackages.com/badges/recipe-runner-recipe-runner/health.svg)](https://phpackages.com/packages/recipe-runner-recipe-runner)
```

###  Alternatives

[spatie/yaml-front-matter

A to the point yaml front matter parser

3411.8M67](/packages/spatie-yaml-front-matter)[pragmarx/yaml

Load your Laravel config files using yaml

1152.8M29](/packages/pragmarx-yaml)[sspooky13/yaml-standards

Standards for yaml files

11518.3k3](/packages/sspooky13-yaml-standards)[thunderer/serializard

Flexible serializer

2767.3k1](/packages/thunderer-serializard)[mhujer/yaml-sort-checker

YAML sort checker checks if your YML files are properly sorted to prevent merge conflicts

2361.6k](/packages/mhujer-yaml-sort-checker)[pagerange/metaparsedown

Adds ability to have meta data in markdown files parsed by eursev/parsedown or eruseve/parsedown-extra

2637.2k2](/packages/pagerange-metaparsedown)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
