specbee/robo-tooling

Robo commands for use to setup, build, test and deploy Drupal projects.

3.0.3 2023-09-20 12:52 UTC

Requires

• consolidation/robo: ^4.0
• drush-ops/behat-drush-endpoint: ^9.4
• drush/drush: ^11
• grasmash/yaml-cli: ^3.0
• webflo/drupal-finder: ^1.2

Requires (Dev)

• ergebnis/composer-normalize: ^2.13

MIT

• Malabya

README

The composer package intends to provide an automation layer using Robo commands to setup, build, test & deploy Drupal applications.

Installation requisites

• Lando
• Docker
• PHP >= 7.4
• Composer v2

Creating a new project

The package comes pre-installed with Specbee's Drupal starterkit https://github.com/SpecbeeLabs/drupal-starterkit

composer create-project specbee/drupal-starterkit:9.x-dev projname --no-interaction

Adding to existing project

To add the package to an existing project

composer require specbee/robo-tooling:1.x-dev

Configuration

• Copy the example.robo.yml and rename it robo.yml to the root directory if not added already
• Update the robo.yml to change the configurations based on your requirements.

Once, done run vendor/bin/robo init-repo which will:

• Setup Drush aliases
• Configure the Landofile
• Configure Grumphp for checking commits

Usage

Run lando start to spin up the containers used to run the application.

Once the lando containers are running, run the lando command

lando robo setup -n

This will install a fresh Drupal site using the installation profile drupal.profile mentioned in the robo.yml. After which if existing configurations are present those will be imported and theme will be build if present.

Tooling

The package provides the following tooling commands to automate development tasks.

All the commands can be accessed under lando namespace. lando robo <command>

Task	Command
Setup the site from scratch	setup
Running database updates and importing configurations	drupal:update
Sync database and files from remote environment defines under remote in robo.yml	sync:all
Sync database from remote environment defines under remote in robo.yml	sync:db
Sync files from remote environment defines under remote in robo.yml	sync:files
Validate files - Check composer validation, run PHPCS against modules and themes code path set in robo.yml under phpcs.code_paths and run SASS Lint in the theme	validate
Validate files - Check composer validation	validate:composer
Validate files - Run PHPCS against modules and themes code path set in robo.yml under phpcs.code_paths	validate:phpcs
Validate files - Run SASS Lint in the theme	validate:theme
Initialize and setup Redis caching	init:service:cache
Running all tests	test
Running Behat test	test:behat
Running PHPUnit test	test:phpunit
Run remote deployment procedures	test:deploy