boedah/robo-drush

Drush CommandStack for Robo Task Runner

Robo Drush Extension

Extension to execute Drush commands in Robo., _(*1)

, _(*2)

Runs Drush commands in stack. You can define global options for all commands (like Drupal root and uri)., _(*3)

The option -y assumed by default but can be overridden on calls to exec() by passing false as the second parameter., _(*4)

Table of contents

• Versions
• Installation
• Testing
• Usage
• Examples

Installation

For new projects (and Robo >= 1.0.0-RC1), just do:, _(*5)

composer require --dev boedah/robo-drush

For older versions of Robo, use:, _(*6)

• ~1.0: Robo <= 0.4.5
• ~2.1: Robo >= 0.5.2

Testing

composer test, _(*7)

Usage

Use the trait (according to your used version) in your RoboFile:, _(*8)

class RoboFile extends \Robo\Tasks
{
    // if you use robo-drush ~2.1 for Robo >=0.5.2, or robo-drush >3 for Robo >=1.0.0-RC1
    use \Boedah\Robo\Task\Drush\loadTasks;

    // if you use ~1.0 for Robo ~0.4
    use \Boedah\Robo\Task\Drush;

    //...
}

Examples

Site update

This executes pending database updates and reverts all features (from code to database):, _(*9)

$this->taskDrushStack()
    ->drupalRootDirectory('/var/www/html/some-site')
    ->uri('sub.example.com')
    ->maintenanceOn()
    ->updateDb()
    ->revertAllFeatures()
    ->maintenanceOff()
    ->run();

Site install

$this->taskDrushStack()
  ->siteName('Site Name')
  ->siteMail('site-mail@example.com')
  ->locale('de')
  ->accountMail('mail@example.com')
  ->accountName('admin')
  ->accountPass('pw')
  ->dbPrefix('drupal_')
  ->sqliteDbUrl('sites/default/.ht.sqlite')
  ->disableUpdateStatusModule()
  ->siteInstall('minimal')
  ->run();