implement '@when' docblock tag

Works on both commands and subcommands.

move setting $_SERVER['DOCUMENT_ROOT'] to set_wp_root() method

It was first defined in 390e7dbbabee7398527c3a1552e849f5c87053aa and
then sort of drifted away from where paths are handled.

move command instance creation to a separate class

Keep the disabled_commands logic inside the WP_CLI class; show an
explicit error, instead of pretending the command doesn't exist.

Merge pull request #471 from wp-cli/psr-3

Switch from WP_CLI::line() to WP_CLI::log() where appropriate

remove redundant arg check in Theme_Command::parse_name()

it's already handled by the synopsis parser

convert from WP_CLI::line() to WP_CLI::log() where appropriate

introduce WP_CLI::log()

WP_CLI::line() is for spitting something to STDOUT.

WP_CLI::log() is for sending a message to the logger, which could do
various things with it.

closes #465

help: move duplicated function_exists() check to __invoke()

rename _hook() to _action()

behat: try running the install-network command again

A basic test for converting an install to multisite.

Merge pull request #523 from wp-cli/blog-site-network

Rename `blog` to `site` and `site-meta` to `network`

site create: alias --site_id= to --network_id=

site create: rename --site_id= to --network_id=

behat: fix help --gen test

alias `wp blog` to `wp site`

rename `wp blog` to `wp site`

rename `wp site-meta` to `wp network-meta`

Merge pull request #507 from wp-cli/hooks

Implement a hook system and implement site-meta command.

closes #498

add man page for site-meta

[ci skip]

introduce 'before_invoke:{cmd}' hook and use it for site-meta command

add site meta commands

Merge changes from 0.10.1 into master

set version to 0.10.1

add URL redirect warning (for 0.10.1 branch)

see #521

Merge pull request #521 from wp-cli/redirect-warning

Add warning when a URL redirection is attempted

add URL redirect warning

Merge pull request #517 from wp-cli/colorization

Keep color handling out of WP_CLI::line()

behat: partially delete quiet run test

output from WP_CLI::line() is no longer suppressed, since we can't be
sure it's not the essential output (think `wp core version`)

move line() method from loggers back to the WP_CLI class

use WP_CLI::colorize() in CommandWithUpgrade

refresh `core version` output

* remove manifest version (absent from recent WP releases)
* remove redundant stability label for core versions
* use Mustache template and replace tabs with spaces

use Mustache templates to display plugin/theme details

introduce WP_CLI::colorize() utility

update Composer dependencies

make version requirements less strict

Merge pull request #468 from wp-cli/eager-require

load path from --require before WP is loaded

behat: test that --require works without a WP install

attempt to load built-in command early

load path from --require before WP is loaded

Merge pull request #514 from wp-cli/multiple-require

Allow passing --require multiple times

mention that --require can be used more than once

fix boolean flag handling

support passing --require multiple times

behat: add -run- to temporary directory names

this makes it easy to delete them, without deleting
wp-cli-test-download-cache

merge split_special() into parse_args()

this gives us two clear variables to work with: $runtime_config and $local_config

move parse_args() to Configurator and set WP path only if it's not explicitly set

rename is_absolute_path() to is_path_absolute()

it emphasises the assumption that the parameter is a path and not some
random string

move all config logic to a new class

Merge pull request #513 from wp-cli/travis-template

scaffold plugin-tests: create install-wp-tests.sh script

scaffold plugin-tests: create install-wp-tests.sh script

This makes it easier to run unit tests locally.

remove executable bit from mustache templates

bump version to 0.10.1-alpha

don't alter API response if the returned version happens to be the one we want

see #511

mention `wp --info` in README

post get: update man page

fixes #509

pass docparser directly to CompositeCommand constructor

make the Subcommand constructor accept a callback

the idea is to have fewer parameters, with a clearer purpose

extract create_subcommand() method

Merge pull request #508 from wp-cli/dispatcher-refactor

Refactor dispather classes

move find_command() utility to Help_Command class

it's not used anywhere else, nor should it be

get rid of pre_invoke() method

make Subcommand inherit from CompositeCommand

Simplify dispatch class hierarchy:

* merge AbstractCommandContainer into CompositeCommand
* make RootCommand inherit from CompositeCommand
* get rid of redundant Command and CommandContainer interfaces

convert get_full_synopsis() method to a standalone function

everything is documentable, so get rid of the Documentable interface

get rid of AtomicCommand interface

branding: the project name is 'WP-CLI', not 'wp-cli'

It's an abbreviation for 'WordPress Command-Line Interface'

move 'sql' aliasing to Runner

blog: don't hide multisite-only subcommands; just throw an error

This is good for `wp help --gen`, which doesn't have a WP install.

It's also good for users, since they have a clear indication of why the
subcommand doesn't work.

contributing: remove confusing ./utils/dev-build step

Merge branch 'dev'

bump version to 0.11.0-alpha

link to contributor guide from readme

Merge branch 'master' into dev

search-replace: rename --multisite flag to --network

it's more consistent with other commands

fixes #504; see #501

mailmap: add new contributors from 0.10 release

contrib-list: validate github URLs

bump version to 0.10.0

Merge pull request #501 from wp-cli/multisite-search-replace

Land `wp search-replace --multisite`

search-replace: update man page

search-replace: move primary key check

Merge branch 'master' into dev

search-replace: use a single SHOW TABLES query to get list of multisite tables

Besides simplicity, it avoids warnings for non-existant tables.

For example, the Posts 2 Posts plugin creates 2 custom, per-blog tables.
But it might not be activated on all blogs.

search-replace: fix warning from using wpdb->prepare() with only 1 parameter

search-replace: extract get_table_list() method

search-replace: blacklist user_pass column later

search-replace: whitespace fixes

search-replace function modified to perform a search and replace through multisite specific tables

bump version to 0.10.0-RC

Merge pull request #496 from wp-cli/no-home

Remove `wp home` command

remove `wp home` command

Merge pull request #494 from Future500/master

Allow capital letters in <value> tokens in @synopsis

Allow capital letters in <value> tokens in @synopsis

Values in @synopsis tags are not matched if they contain capital letters.
This allows for capital letters i.e. --name=<myPropertyValue>
fixes #493

Merge pull request #492 from om4james/updateall

Only use maintenance mode if a plugin or theme needs updating

Use empty() check instead of count()

Requested in https://github.com/wp-cli/wp-cli/pull/492#discussion_r4545088.

Change ternary operator to simple if statement

Only use maintenance mode if a plugin or theme needs updating

When updating plugins (wp plugin update-all) or themes (wp theme update-all) on a WordPress multisite installation, maintenance activated and deactivated even if there are no updates to install.

The Plugin_Upgrader::bulk_upgrade() and Theme_Upgrader::bulk_upgrade() WordPress functions currently don't check that the array passed to it isn't empty, causing maintenance mode to be enabled even if no updates are required.

This bug doesn't affect non multisite installs, because for non multisite installs the code in Plugin_Upgrader::bulk_upgrade() and Theme_Upgrader::bulk_upgrade() only uses maintenance mode if the plugin/theme being updated is activated.

Fixes #491

bump version to 0.10.0-beta2

[ci skip]

composer: update mustache to 2.3.x; update composer.lock

Merge branch 'master' into dev