localgovdrupal / localgov_microsites_project
Project template for the LocalGov Drupal Microsites distribution.
Installs: 3 563
Dependents: 0
Suggesters: 0
Security: 0
Stars: 6
Watchers: 6
Forks: 4
Open Issues: 8
Type:project
Requires
- composer/installers: ^1.12
- cweagans/composer-patches: ^1.7
- drupal/core-composer-scaffold: ^10.0@stable
- drupal/core-recommended: ^10.0@stable
- drush/drush: ^12.0
- localgovdrupal/localgov_microsites: ^4.0@beta
Requires (Dev)
- brianium/paratest: ^6.3
- drupal/core-dev: ^10.0
Conflicts
- 4.x-dev
- 4.0.0
- 4.0.0-beta5
- 4.0.0-beta4
- 4.0.0-beta3
- 4.0.0-beta2
- 4.0.0-beta1
- 4.0.0-alpha1
- 3.x-dev
- 3.0.0-alpha1
- 2.x-dev
- 2.0.x-dev
- 2.0.0-beta7
- 2.0.0-beta6
- 2.0.0-beta5
- 2.0.0-beta4
- 2.0.0-beta3
- 2.0.0-beta2
- 2.0.0-beta1
- 1.x-dev
- 1.0.0-alpha1
- dev-feature/fail-workflow-on-failed-composer-patch
- dev-feature/483-update-dependencies
- dev-feature/4.x/add-phpstan-updates
- dev-release-4.x
- dev-fix/4.3/66-remove-dev-dependencies
- dev-feature/4.x/update-workflow-file
- dev-fix/4.x/61-github-testing
- dev-feature/4.x-drupal-10.3
- dev-feature/52-ddev-fqdns
- dev-feature/add-workflow-dispatch
- dev-feature/3.x/fix-phpstan-checks
- dev-feature/47-webform-libraries
- dev-feature/ddev-default-to-php82
- dev-feature/4.x/44-suppress-deprecation-notices-from-phpunit
- dev-feature/opd-add-nix-flake
- dev-fix/update-github-workflow-for-4-branch
- dev-feature/40-lando-config
- dev-fix/4.x/441-add-media-via-paragraphs
- dev-feature/group_sites
- dev-release-3.x
- dev-feature/3.x/add-php-8-2-to-workflow
- dev-feature/3.x/32-ddev
- dev-release-2.x
- dev-feature/2.x/domain_group-repo-switch
- dev-feature/2.x/drush-upgrade
- dev-feature/2.x/php-8.0
- dev-fix/2.x/24-enable-php-http-discovery-plugin
- dev-feature/22-lando-node-remove
- dev-feature/19-maintainers
- dev-feature/group-content-menu-repo-switch
- dev-fix/htaccess
- dev-fix/group-term-released
- dev-fix/dont-overwrite-robots-htaccss
- dev-feature/group-3.x
- dev-release-1.x
- dev-bump-profile-alpha
- dev-fix/github-workflow-update-2022-06-22
- dev-fix/8-failing-tests
- dev-feature/5-add-environment-variables-for-phpunit
- dev-feature/5-better-defaults-phpunit
- dev-feature/57-directories
- dev-feature/84-layout-paragraphs-2
- dev-feature/microsites-domains
This package is auto-updated.
Last update: 2024-11-20 16:12:18 UTC
README
This project template provides a starter kit for managing your LocalGov Drupal Microsites dependencies with Composer.
Usage
First you need to install Composer.
After that you can create the project:
composer create-project --stability stable localgovdrupal/localgov_microsites_project:^4.0 MY_PROJECT --no-install
Using Lando
If using Lando, you can then boot up Lando and run the site install
cd MY_PROJECT
lando start
lando composer install
lando drush si localgov_microsites -y
Using DDEV
If using ddev, you can then boot up ddev and run the site install
cd MY_PROJECT
ddev start
ddev composer install
ddev drush si localgov_microsites -y
Using host machine
If you're working directly on your host machine, you'll still need to run the composer install.
cd MY_PROJECT
composer install
drush si localgov_microsites -y
Running PHPUnit tests in Lando
The included phpunit.xml.dist file contains configuration for automatically running the LocalGov Drupal test suite.
The default .lando.dist.xml includes environment variables for:
BROWSERTEST_OUTPUT_DIRECTORY: '/app/web/sites/simpletest/browser_output' BROWSERTEST_OUTPUT_BASE_URL: 'https://localgov-micro.lndo.site'
To allow html output, manually create a directory for browser output.
mkdir web/sites/simpletest/browser_output
To run all LocalGov Drupal tests from Lando:
lando ssh phpunit
To run all the tests for a specific module:
lando ssh phpunit web/modules/contrib/localgov_my_module
Tests can be filtered using the --filter
option. To only run a specific test:
lando ssh phpunit --filter=myTestName
Running PHPUnit tests in DDEV
The included phpunit.xml.dist file contains configuration for automatically running the LocalGov Drupal test suite.
The default .ddev/config.yml includes configuration for some extra domains that ddev and phpunit will need to resolve different microsite domains.
When ddev starts, it will attempt to write these to /etc/hosts
If DDEV cannot write to /etc/hosts, you may need to add these manually.
If you are having problems runnign phpunit tests in DDEV, try adding the
following to /etc/hosts
127.0.0.1 group-1.web group-2.web group-3.web group-4.web group-5.web
To allow html output, manually create a directory for browser output.
mkdir web/sites/simpletest/browser_output
To run all LocalGov Drupal tests from inside DDEV:
ddev ssh phpunit
To run all the tests for a specific module:
ddev ssh phpunit web/modules/contrib/localgov_my_module
Tests can be filtered using the --filter
option. To only run a specific test:
ddev ssh phpunit --filter=myTestName
Maintainers
This project is currently maintained by:
- Ekes: https://www.drupal.org/u/ekes
- Finn Lewis: https://www.drupal.org/u/finn-lewis
- Stephen Cox: https://www.drupal.org/u/stephen-cox