Download the PHP package phptaskman/core without Composer

PHP Taskman

Description

Taskman is a helper for running commands and tasks. It is shipped with a few simple default tasks.

It will help you in your every day life of setting up recurring tasks that you have to run in your projects.

Taskman is based on Robo and not tied to any framework or whatsoever.

Requirements

• PHP >= 5.6

Installation

Configuration

Taskman can be customized in different ways:

1. By setting arguments and options when running a command.
2. By providing default values in configuration files. Taskman will read the following files in the specified order. Options supplied in later files will override earlier ones:
   • The defaults provided by Taskman. This file is located inside the Taskman repository in config/default.yml.
   • taskman.yml.dist - project specific defaults. This file should be placed in the root folder of the project that depends on Taskman. Use this file to declare default options which are expected to work with your application under regular circumstances. This file should be committed in the project.
   • taskman.yml - project specific user overrides. This file is also located in the root folder of the project that depends on Taskman. This file can be used to override options with values that are specific to the user's local environment. It is considered good practice to add this file to .gitignore to prevent it from being accidentally committed in the project repository.
   • User provided global overrides stored in environment variables. These can be used to define environment specific configuration that applies to all projects that uses Taskman, such as database credentials and the Github access token. The following locations will be checked and the first one that is found will be used:
     • $PHPTASKMAN_CONFIG
     • $XDG_CONFIG_HOME/phptaskman/taskman.yml
     • $HOME/.config/phptaskman/taskman.yml

Optional packages

• phptaskman/drupal Provides commands for your Drupal environment.

• phptaskman/package Provide commands for generating packages out of your sources.

• phptaskman/travis Provide commands to execute parts of your .travis.yml file.

Usage

Then run a command:

Documentation

The documentation is not up to date, this is a never ending work in progress.

Taskman will run commands. Commands contains one or multiple tasks.

Commands or tasks can be defined using YAML or through code.

An example of custom command with some tasks in a taskman.yml.dist file:

As you can see, there are 2 custom commands that are defined: foo:foo and foo:remove.

Those commands contains tasks, 4 tasks for foo:foo and 2 tasks for foo:remove.

A task can be either a string or a well structured array.

Expose custom tasks in YAML

Let's use the same example and add a custom task in the YAML file.

There are a few tasks that are supported by default in Taskman and provided by the phptaskman/core-tasks package.

Expose custom commands in YAML

Taskman allows you to expose new commands using a YAML file (taskman.yml.dist or taskman.yml). Commands can reference each other, allowing for complex scenarios to be implemented with relative ease.

• Create a file taskman.yml or taskman.yml.dist in your project, and start adding commands:

Taskman will automatically look into your package dependencies for such files automatically.

This means that you can create custom packagist packages containing your taskman.yml file with your custom commands.

Advanced custom commands

You can define also command options along with a custom command.

Define global command options

You can define global options that can be applied to any command.

Now you can run the command and change the value of the command option dynamically:

Contributing

See Contributing.