Skip to content

DDEV integration for developing Drupal contrib projects

License

Notifications You must be signed in to change notification settings

tyler36/ddev-drupal-contrib

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

44 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DDEV integration for developing Drupal contrib projects. As a general philosophy, your contributed module is the center of the universe. The codebase layout (see image below) and commands in this project match the Gitlab CI approach from the Drupal Association.

Install

  1. git clone your contrib module
  2. Add DDEV to your contrib project if not already added.
  3. Run ddev get ddev/ddev-drupal-contrib.

Commands

This project provides the following DDEV container commands.

  • ddev poser.
    • Edits composer.json so that drupal/core-recommended becomes a dev dependency.
    • Runs composer install AND yarn install so that dependencies are available.
    • Note: it is perfectly acceptable to skip this command and edit the require-dev of composer.json by hand.
  • ddev symlink-project. This symlinks the top level files of your project into web/modules/custom so that Drupal finds your module. This command runs automatically on every ddev start. See codebase image below.
  • ddev phpunit. Run phpunit tests on the web/modules/custom directory.
  • ddev nightwatch. Run nightwatch tests on the web/modules/custom directory.
  • ddev phpcs. Run phpcs on the web/modules/custom directory.
  • ddev eslint. Run eslint on the js files in the web/modules/custom directory.
  • ddev stylelint. Run stylelint on the css files in the web/modules/custom directory.

Codebase layout

Folder tree

Misc

  • Optional: Install Chrome service for FunctionalJavascript and Nightwatch tests.
  • Optional. Commit the changes .ddev after this plugin installs. This saves other users from having to install this integration. Rerun the ddev get in order to update the commands from this project.
  • This project reads your project_type from DDEV and fetches adds the corresponding version of drupal/core-recommended to composer.json. if you are doing something non-standard with project_type, don't use ddev poser command.
  • This project should work for any contrib project, including those that haven't opted into Gitlab CI. One advantage of that is that failures in CI are more likely to be reproducible locally when using this integration.
  • If you add/remove a root file or directory, re-symlink root files via EITHER of these methods
    • ddev restart
    • ddev symlink-project

Contributed and maintained by @weitzman

About

DDEV integration for developing Drupal contrib projects

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Shell 100.0%