final class MkCommands extends DrushCommands implements SiteAliasManagerAwareInterface (View source)

Traits

SiteAliasManagerAwareTrait
ProcessManagerAwareTrait
LoggerAwareTrait
IO
ConfigAwareTrait

Constants

REQ

OPT

EXIT_SUCCESS

EXIT_FAILURE

EXIT_FAILURE_WITH_CLARITY

Properties

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

getConfig()

Replaces same method in ConfigAwareTrait in order to provide a DrushConfig as return type. Helps with IDE completion.

__construct(ContainerInterface $container, ContainerInterface $drush_container)

No description

SymfonyStyle
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.

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.

static MkCommands
create(ContainerInterface $container, ContainerInterface $drush_container)

No description

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

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

DrushConfig getConfig()

Replaces same method in ConfigAwareTrait in order to provide a DrushConfig as return type. Helps with IDE completion.

protected __construct(ContainerInterface $container, ContainerInterface $drush_container)

No description

Parameters

ContainerInterface $container
ContainerInterface $drush_container

protected SymfonyStyle io()

Override Robo's IO function with our custom style.

Return Value

SymfonyStyle

protected 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

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.

static MkCommands create(ContainerInterface $container, ContainerInterface $drush_container)

No description

Parameters

ContainerInterface $container
ContainerInterface $drush_container

Return Value

MkCommands

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