thunder / testsite_builder
Provides Drupal console command to create site configuration and content based on Sampler module report
Installs: 13 046
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 3
Forks: 0
Open Issues: 5
Type:drupal-module
Requires
- php: >=7.0.0
- ext-json: *
- ext-pcntl: *
- drupal/config_update: ^1.6
- drupal/update_helper: ^2.0||^3.0.2
Requires (Dev)
- drush/drush: ~10.2
This package is auto-updated.
Last update: 2024-10-09 17:20:56 UTC
README
The Testsite Builder provides Drush commands for the creation of test sites based on the report generated by Sampler module.
Prerequisites
Your project should be set up to use composer for installing the required modules. Projects that have a different setup are not supported.
This module provides Drush commands only. If you do not already use Drush, install it before continuing.
Installation
In your project-root do:
composer require thunder/testsite_builder
Then enable the testsite_builder module, either with command line or in the admin UI.
drush en testsite_builder
Flush the caches, and you are ready to go.
Adjust database
To use the content-create functionality of the testsite_builder, adjust the MySQL database settings.
Grant files
Login as root and execute
GRANT FILE on *.* to 'drupaluser'@'localhost'
GRANT SUPER on *.* to 'drupaluser'@'localhost'
Adjust config
Open your my.cnf and add
[mysqld]
secure-file-priv=""
Restart the MySQL Server.
Usage
Create configuration
To create site configuration from Sampler report, you can execute the following command:
drupal testsite-builder:create-config <sampler report JSON file>
That command removes all existing content and configuration for the site and generates a new configuration from the provided Sampler report file.
Create configuration and content
To create site configuration from Sampler report and content for it, you can execute the following command:
drupal testsite-builder:create-config <sampler report JSON file> --create-content
That command removes all existing content and configuration for the site, generate new configuration and content from the provided Sampler report file.
The Testsite Builder executes the content creation task in the following steps:
- it creates content and stores them in temporal CSV files ready for database import
- it imports created CSV files into database
- it deletes temporal CSV files after database import
If you want to investigate CSV files and intermediary configuration used for content creation, you can add an option to the previous command to keep created files. Like this:
drupal testsite-builder:create-config <sampler report JSON file> --create-content --keep-content-files
In this case, the Testsite Builder skips step 3, and the command outputs the path to temp directory with generated CSV files.