final class MkCommands extends DrushCommands (View source)

Traits

Constants

REQ

OPT

EXIT_SUCCESS

EXIT_FAILURE

EXIT_FAILURE_WITH_CLARITY

Properties

protected $uri from  ExecTrait
protected ConfigInterface $config from  ConfigAwareTrait
protected InputInterface $input from  InputAwareTrait
protected OutputInterface $output from  OutputAwareTrait
protected $io from  IO
protected $obj from  IO
protected CommandData|null $commandData from  DrushCommands

Methods

bool
startBrowser(string|null $uri = null, int $sleep = 0, int|null $port = null, string|bool $browser = false)

Starts a background browser/tab for the current site or a specified URL.

static bool
programExists($program)

No description

static string
getEditor(string|null $editor = null)

No description

$this
setConfig(ConfigInterface $config)

Set the config management object.

ConfigInterface
getConfig()

Get the config management object.

static string
configPrefix()

Any class that uses ConfigAwareTrait SHOULD override this method , and define a prefix for its configuration items. This is usually done in a base class. When used, this method should return a string that ends with a "."; see BaseTask::configPrefix().

static 
configClassIdentifier($classname)

No description

static 
configPostfix()

No description

static 
configure(string $key, mixed $value, ConfigInterface|null $config = null)

No description

mixed|null
getConfigValue(string $key, mixed|null $default = null)

No description

$this
setInput(InputInterface $input)

No description

InputInterface
input()

No description

InputInterface
getInput() deprecated

Backwards compatibility.

$this
setOutput(OutputInterface $output)

No description

OutputInterface
output()

No description

OutputInterface
stderr()

No description

OutputInterface
getOutput() deprecated

Backwards compatibility

currentState()

No description

from  IO
__construct($obj, $input, $output, $io)

No description

from  IO
restore()

No description

from  IO
void
configurePrompts(InputInterface $input)

Configure the prompt fallbacks.

mixed
promptUntilValid(Closure $prompt, bool|string $required, Closure|null $validate)

Prompt the user until the given validation callback passes.

void
restorePrompts()

Restore the prompts output.

bool
runningUnitTests()

No description

DrushStyle
io()

Override Robo's IO function with our custom style.

DrushLoggerManager|null
logger()

Returns a logger object.

void
printFile(string $file)

Print the contents of a file.

preHook(CommandData $commandData)

Persist commandData for use in primary command callback. Used by 'topic' commands.

initHook($input, AnnotationData $annotationData)

Configure Laravel prompts package.

printFileTopic(CommandData $commandData)

Print the contents of a file. The path comes from the @topic annotation.

HandlerStack
getStack()

Get a Guzzle handler stack that uses the Drush logger.

processManager()

This method overrides the trait in order to provide a more specific return type.

void
docs()

Build a Markdown document for each available Drush command/generator.

array
createAnnotatedCommands(Application $application_generate, Application $application_drush)

Convert generators into Annotated commands (for Help).

static string
appendPostAmble()

No description

static string
appendAliases($command)

No description

static string
appendTopics(AnnotatedCommand $command, string $dir_commands)

No description

static string
appendOptions($command)

No description

static string
appendOptionsGlobal($application)

No description

static string
appendArguments($command)

No description

static string
appendUsages(AnnotatedCommand $command)

No description

static string
appendPreamble($command, $root)

No description

void
writeYml(array $nav_commands, array $nav_generators, array $map_commands, array $map_generators, string $dest)

No description

void
writeAllMd(array $pages_all, string $destination_path, string $title)

No description

void
prepare($destination)

Empty target directories.

static iterable
argToArray(InputArgument $arg)

Build an array since that's what HelpCLIFormatter expects.

static iterable
optionToArray(InputOption $opt)

Build an array since that's what HelpCLIFormatter expects.

static string
cliTextToMarkdown(string $text)

Convert text like foo to foo.

array
writeContentFilesAndBuildNavAndBuildRedirectMap(array $namespaced, string $destination, string $dir_root, string $destination_path)

Write content files, add to nav, build a redirect map.

array
getRedirectMap(Command $command, string $destination)

No description

string
getFilename(string $name)

Get a filename from a command.

Details

bool startBrowser(string|null $uri = null, int $sleep = 0, int|null $port = null, string|bool $browser = false)

Starts a background browser/tab for the current site or a specified URL.

Uses a non-blocking Process call, so Drush execution will continue.

Parameters

string|null $uri

Optional URI or site path to open in browser. If omitted, or if a site path is specified, the current site home page uri will be prepended if the site's hostname resolves.

int $sleep
int|null $port
string|bool $browser

Return Value

bool

TRUE if browser was opened. FALSE if browser was disabled by the user or a default browser could not be found.

static bool programExists($program)

No description

Parameters

$program

Return Value

bool

static string getEditor(string|null $editor = null)

No description

Parameters

string|null $editor

Return Value

string

$this setConfig(ConfigInterface $config)

Set the config management object.

Parameters

ConfigInterface $config

Return Value

$this

ConfigInterface getConfig()

Get the config management object.

Return Value

ConfigInterface

static protected string configPrefix()

Any class that uses ConfigAwareTrait SHOULD override this method , and define a prefix for its configuration items. This is usually done in a base class. When used, this method should return a string that ends with a "."; see BaseTask::configPrefix().

Return Value

string

static protected configClassIdentifier($classname)

No description

Parameters

$classname

static protected configPostfix()

No description

static configure(string $key, mixed $value, ConfigInterface|null $config = null)

No description

Parameters

string $key
mixed $value
ConfigInterface|null $config

protected mixed|null getConfigValue(string $key, mixed|null $default = null)

No description

Parameters

string $key
mixed|null $default

Return Value

mixed|null

$this setInput(InputInterface $input)

No description

Parameters

InputInterface $input

Return Value

$this

See also

\Symfony\Component\Console\Input\InputAwareInterface::setInput()

protected InputInterface input()

No description

Return Value

InputInterface

protected InputInterface getInput() deprecated

deprecated

Backwards compatibility.

Return Value

InputInterface

$this setOutput(OutputInterface $output)

No description

Parameters

OutputInterface $output

Return Value

$this

See also

\Robo\Contract\OutputAwareInterface::setOutput()

protected OutputInterface output()

No description

Return Value

OutputInterface

protected OutputInterface stderr()

No description

Return Value

OutputInterface

protected OutputInterface getOutput() deprecated

deprecated

Backwards compatibility

Return Value

OutputInterface

currentState()

No description

__construct($obj, $input, $output, $io)

No description

Parameters

$obj
$input
$output
$io

restore()

No description

protected void configurePrompts(InputInterface $input)

Configure the prompt fallbacks.

Parameters

InputInterface $input

Return Value

void

protected mixed promptUntilValid(Closure $prompt, bool|string $required, Closure|null $validate)

Prompt the user until the given validation callback passes.

Parameters

Closure $prompt
bool|string $required
Closure|null $validate

Return Value

mixed

protected void restorePrompts()

Restore the prompts output.

Return Value

void

protected bool runningUnitTests()

No description

Return Value

bool

protected DrushStyle io()

Override Robo's IO function with our custom style.

Return Value

DrushStyle

DrushLoggerManager|null logger()

Returns a logger object.

Return Value

DrushLoggerManager|null

protected void printFile(string $file)

Print the contents of a file.

Parameters

string $file

Full path to a file.

Return Value

void

preHook(CommandData $commandData)

Persist commandData for use in primary command callback. Used by 'topic' commands.

Parameters

CommandData $commandData

initHook($input, AnnotationData $annotationData)

Configure Laravel prompts package.

Parameters

$input
AnnotationData $annotationData

protected printFileTopic(CommandData $commandData)

Print the contents of a file. The path comes from the @topic annotation.

Parameters

CommandData $commandData

Full path to a file.

protected HandlerStack getStack()

Get a Guzzle handler stack that uses the Drush logger.

ProcessManager processManager()

This method overrides the trait in order to provide a more specific return type.

Return Value

ProcessManager

void docs()

Build a Markdown document for each available Drush command/generator.

This command is an early step when building the www.drush.org static site. Adapt it to build a similar site listing the commands that are available on your site. Also see Drush's Github Actions workflow.

Return Value

void

array createAnnotatedCommands(Application $application_generate, Application $application_drush)

Convert generators into Annotated commands (for Help).

Parameters

Application $application_generate
Application $application_drush

Return Value

array

static protected string appendPostAmble()

No description

Return Value

string

static protected string appendAliases($command)

No description

Parameters

$command

Return Value

string

static protected string appendTopics(AnnotatedCommand $command, string $dir_commands)

No description

Parameters

AnnotatedCommand $command
string $dir_commands

Return Value

string

static protected string appendOptions($command)

No description

Parameters

$command

Return Value

string

static protected string appendOptionsGlobal($application)

No description

Parameters

$application

Return Value

string

static protected string appendArguments($command)

No description

Parameters

$command

Return Value

string

static protected string appendUsages(AnnotatedCommand $command)

No description

Parameters

AnnotatedCommand $command

Return Value

string

static protected string appendPreamble($command, $root)

No description

Parameters

$command
$root

Return Value

string

protected void writeYml(array $nav_commands, array $nav_generators, array $map_commands, array $map_generators, string $dest)

No description

Parameters

array $nav_commands
array $nav_generators
array $map_commands
array $map_generators
string $dest

Return Value

void

protected void writeAllMd(array $pages_all, string $destination_path, string $title)

No description

Parameters

array $pages_all
string $destination_path
string $title

Return Value

void

protected void prepare($destination)

Empty target directories.

Parameters

$destination

Return Value

void

static iterable argToArray(InputArgument $arg)

Build an array since that's what HelpCLIFormatter expects.

Parameters

InputArgument $arg

Return Value

iterable

static iterable optionToArray(InputOption $opt)

Build an array since that's what HelpCLIFormatter expects.

Parameters

InputOption $opt

Return Value

iterable

static string cliTextToMarkdown(string $text)

Convert text like foo to foo.

Parameters

string $text

Return Value

string

array writeContentFilesAndBuildNavAndBuildRedirectMap(array $namespaced, string $destination, string $dir_root, string $destination_path)

Write content files, add to nav, build a redirect map.

Parameters

array $namespaced
string $destination
string $dir_root
string $destination_path

Return Value

array

protected array getRedirectMap(Command $command, string $destination)

No description

Parameters

Command $command
string $destination

Return Value

array

string getFilename(string $name)

Get a filename from a command.

Parameters

string $name

Return Value

string