Maghic

Maghic is a Swiss army knife tool for GitHub Actions Workflow.

This project is a W.I.P. for "2021 GitHub Actions Hackathon on DEV". It is not yet completed and it is under development as side project.

It provides:

• a command line tool for managing, creating and autogenerate Yaml file Workflow for GitHub Actions;
• a set of classes and methods for managing Yaml file (specific for GitHub Actions Workflows).

This is created for the GitHub Actions Hackathon: 2021 GitHub Actions Hackathon on DEV

Auto generate workflows

If you want to create automatically a GitHub Actions workflow file you can execute "maghic yaml:guess" command. If you want to save the file, you need to use --save option. Amandatory argument is the directory of the project that needs a workflow file. If you want to enable a MySql service, you need to use --mysql option.

./maghic yaml:guess --mysql --save .

If you want to show the workflow file, you can use --show option:

./maghic yaml:guess --show .

The yaml:guess command will inspect your project detecting some characteristics to guess the workflow:

• a dependencies file like composer.json (for PHP), packages.json (for Node/JS) etc.;
• the dependencies: if there are some relevant dependencies like testing tool, static code analysis or code sniffer;
• .nvmrc to identify the right version of Node in the pipeline
• ...

References

Packages

• Laravel Zero: micro framework for console application;
• Symfony Yaml: a package for parsing Yaml structures.
• swaggest/json-schema: a package to validate the GitHub Actions workflow.

Code quality packages

• PestPHP: a testing framework for PHP;
• PHPStan: a static code analysis tool for PHP;
• PHP_CodeSniffer: detects violations of a defined set of coding standards (for example PSR2 and PSR12).