Add custom commands

Author: odeialba

README.md

@@ -190,6 +190,76 @@ bin/moodle-docker-compose stop
 bin/moodle-docker-compose start
 ```
 
+## Custom commands
+
+### moodle-docker-bash
+This script was created to easily run any command inside any container. First parameter will be the container name and second one will be the command. Example:
+```bash
+~$ bin/moodle-docker-bash webserver php -v
+PHP 7.4.23 (cli) (built: Sep  3 2021 18:14:02) ( NTS )
+```
+```bash
+~$ bin/moodle-docker-bash db psql --version
+psql (PostgreSQL) 11.13 (Debian 11.13-1.pgdg90+1)
+```
+
+### mbash
+As most of the commands using the `moodle-docker-bash` script will be run on the `webserver` container, this is a shortcut of that script that runs the commands only in the `webserver` container. Example:
+```bash
+~$ bin/mbash php -v
+PHP 7.4.23 (cli) (built: Sep  3 2021 18:14:02) ( NTS )
+```
+
+### minstall
+This script was created to be automatically installed in the webserver container and to easily run any install command. First parameter will be the database to install (moodle, phpunit or behat) and the rest will be all the parameters that want to be used to override the default one. Note that this script needs to be run either withing the container shell or using `moodle-docker-bash`. Examples:
+```bash
+~$ bin/mbash minstall moodle --fullname="Moodle first instance" --adminpass="admin"
+-------------------------------------------------------------------------------
+== Setting up database ==
+-->System
+```
+```bash
+~$ bin/mbash minstall phpunit
+Initialising Moodle PHPUnit test environment...
+```
+```bash
+~$ bin/mbash minstall behat
+You are already using the latest available Composer version 2.1.8 (stable channel).
+Installing dependencies from lock file (including require-dev)
+```
+
+### mtest
+This script was created to be automatically installed in the webserver container and to easily run any test command. First parameter will be the tests to be run (phpunit or behat) and the rest will be all the parameters that want to be used to override the default ones. Note that this script needs to be run either withing the container shell or using `moodle-docker-bash`. Examples:
+```bash
+~$ bin/mbash mtest phpunit --filter auth_manual_testcase
+Moodle 3.11.3 (Build: 20210913), 8c02bd32af238dfc83727fb4260b9caf1b622fdb
+Php: 7.4.23, pgsql: 11.13 (Debian 11.13-1.pgdg90+1), OS: Linux 5.10.47-linuxkit x86_64
+```
+```bash
+~$ bin/mbash mtest behat --tags=@auth_manual
+Running single behat site:
+```
+
+### mutil
+This script was created to be automatically installed in the webserver container and to easily access the `util.php` files of phpunit and behat. First parameter will be the test environment (phpunit or behat) and the rest will be all the parameters that want to be used to override the default ones. Note that this script needs to be run either withing the container shell or using `moodle-docker-bash`. Examples:
+```bash
+~$ bin/mbash mutil phpunit --drop
+Purging dataroot:
+Dropping tables:
+```
+```bash
+~$ bin/mbash mutil behat --drop
+Dropping tables:
+```
+
+### mfixversion
+After increasing the version number in a branch, going back to the master branch might cause version problems. This script was created to easily solve that issue. Note that this script needs to be run either withing the container shell or using `moodle-docker-bash`. Example:
+```bash
+~$ bin/mbash mfixversion
+-------------------------------------------------------------------------------
+== Resetting all version numbers ==
+```
+
 ## Environment variables
 
 You can change the configuration of the docker images by setting various environment variables **before** calling `bin/moodle-docker-compose up`.

assets/web/commands/mcommon

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+command=''
+quoteopen='no'
+for (( i=2; i<=$#; i++)); do
+  part=${!i}
+  if [[ "$quoteopen" == 'yes' && "$part" == "-"* ]]; then
+    command="$command\""
+    quoteopen='no'
+  fi
+  eqsign="${part//[^=]}"
+  if [ ${#eqsign} -eq 1 ]; then
+    part="${part//=/=\"}"
+    quoteopen='yes'
+  fi
+  command="$command $part"
+done
+
+if [ "$quoteopen" == 'yes' ]; then
+  command="$command\""
+  quoteopen='no'
+fi

assets/web/commands/mfixversion

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+eval "cp ../scripts/fixversions.php fixversions.php"
+eval "php fixversions.php"
+eval "rm fixversions.php"

assets/web/commands/minstall

@@ -0,0 +1,20 @@
+#!/usr/bin/env bash
+DIR="${BASH_SOURCE%/*}"
+if [[ ! -d "$DIR" ]]; then DIR="$PWD"; fi
+. "$DIR/mcommon"
+
+case "$1" in
+  moodle)
+    eval "php admin/cli/install_database.php --agree-license --fullname=\"Moodle\" --shortname=\"moodle\" --summary=\"Moodle site\" --adminpass=\"admin\" --adminemail=\"[email protected]\" ${command}"
+    ;;
+  phpunit)
+    eval "php admin/tool/phpunit/cli/init.php ${command}"
+    ;;
+  behat)
+    eval "php admin/tool/behat/cli/init.php -a -o ${command}"
+    ;;
+  *)
+    SCRIPT_NAME=`basename "$0"`
+    echo "Usage: $SCRIPT_NAME {moodle|phpunit|behat} [arguments]"
+    exit 1
+esac

assets/web/commands/mtest

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+DIR="${BASH_SOURCE%/*}"
+if [[ ! -d "$DIR" ]]; then DIR="$PWD"; fi
+. "$DIR/mcommon"
+
+case "$1" in
+  phpunit)
+    eval "vendor/bin/phpunit ${command}"
+    ;;
+  behat)
+    eval "php admin/tool/behat/cli/run.php ${command}"
+    ;;
+  *)
+    SCRIPT_NAME=`basename "$0"`
+    echo "Usage: $SCRIPT_NAME {phpunit|behat} [arguments]"
+    exit 1
+esac

assets/web/commands/mutil

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+DIR="${BASH_SOURCE%/*}"
+if [[ ! -d "$DIR" ]]; then DIR="$PWD"; fi
+. "$DIR/mcommon"
+
+case "$1" in
+  phpunit)
+    eval "php admin/tool/phpunit/cli/util.php ${command}"
+    ;;
+  behat)
+    eval "php admin/tool/behat/cli/util.php ${command}"
+    ;;
+  *)
+    SCRIPT_NAME=`basename "$0"`
+    echo "Usage: $SCRIPT_NAME {phpunit|behat} [arguments]"
+    exit 1
+esac

assets/web/scripts/fixversions.php

@@ -0,0 +1,40 @@
+<?php
+
+define('CLI_SCRIPT', true);
+require(getcwd().'/config.php');
+require_once($CFG->libdir.'/clilib.php');
+require("$CFG->dirroot/version.php");
+
+cli_separator();
+cli_heading('Resetting all version numbers');
+
+$manager = core_plugin_manager::instance();
+
+// Purge caches to make sure we have the fresh information about versions.
+$manager::reset_caches();
+$configcache = cache::make('core', 'config');
+$configcache->purge();
+
+$plugininfo = $manager->get_plugins();
+foreach ($plugininfo as $type => $plugins) {
+    foreach ($plugins as $name => $plugin) {
+        if ($plugin->get_status() !== core_plugin_manager::PLUGIN_STATUS_DOWNGRADE) {
+            continue;
+        }
+
+        $frankenstyle = sprintf("%s_%s", $type, $name);
+
+        mtrace("Updating {$frankenstyle} from {$plugin->versiondb} to {$plugin->versiondisk}");
+        $DB->set_field('config_plugins', 'value', $plugin->versiondisk, array('name' => 'version', 'plugin' => $frankenstyle));
+    }
+}
+
+// Check that the main version hasn't changed.
+if ((float) $CFG->version !== $version) {
+    set_config('version', $version);
+    mtrace("Updated main version from {$CFG->version} to {$version}");
+}
+
+// Purge relevant caches again.
+$manager::reset_caches();
+$configcache->purge();

base.yml

@@ -2,6 +2,11 @@ version: "2"
 services:
   webserver:
     image: "moodlehq/moodle-php-apache:${MOODLE_DOCKER_PHP_VERSION}"
+    build:
+      context: "."
+      dockerfile: "./dockerfiles/Dockerfilewebserver"
+      args:
+        MOODLE_DOCKER_PHP_VERSION: "${MOODLE_DOCKER_PHP_VERSION}"
     depends_on:
       - db
     volumes:

bin/mbash

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+DIR="${BASH_SOURCE%/*}"
+if [[ ! -d "$DIR" ]]; then DIR="$PWD"; fi
+eval "$DIR/moodle-docker-compose exec webserver bash -c '${@}'"

bin/moodle-docker-bash

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+DIR="${BASH_SOURCE%/*}"
+if [[ ! -d "$DIR" ]]; then DIR="$PWD"; fi
+eval "$DIR/moodle-docker-compose exec $1 bash -c '${@:2}'"