Skip to content

Latest commit

 

History

History
132 lines (86 loc) · 4.12 KB

CONTRIBUTING.md

File metadata and controls

132 lines (86 loc) · 4.12 KB
Raw

Developing on Factory Lollipop

📦 Repositories

Drupal repo

git remote add drupal \
[email protected]:project/factory_lollipop.git

Github repo

git remote add github \
[email protected]:antistatique/drupal-factory-lollipop.git

🔧 Prerequisites

First of all, you need to have the following tools installed globally on your environment:

  • drush
  • The latest dev release of Factory Lollipop
  • docker
  • docker compose

Project bootstrap

Once run, you will be able to access to your fresh installed Drupal on localhost::8888.

docker-compose build --pull --build-arg BASE_IMAGE_TAG=10.2 drupal
# (get a coffee, this will take some time...)
docker compose up -d drupal
docker compose exec -u www-data drupal drush site-install standard --db-url="mysql://drupal:drupal@db/drupal" -y

# You may be interested in resetting the admin password of your Docker.
docker compose exec drupal drush user:password admin admin

# Enable the module to use it.
docker compose exec drupal drush en factory_lollipop

🏆 Tests

We use the Docker for Drupal Contrib images to run testing on our project.

Run testing by stopping at first failure using the following command:

docker compose exec -u www-data drupal phpunit --group=factory_lollipop --no-coverage --stop-on-failure --configuration=/var/www/html/phpunit.xml

🚔 Check Drupal coding standards & Drupal best practices

During Docker build, the following Static Analyzers will be installed on the Docker drupal via Composer:

  • drupal/coder^8.3.1 (including squizlabs/php_codesniffer & phpstan/phpstan),

The following Analyzer will be downloaded & installed as PHAR:

  • phpmd/phpmd
  • sebastian/phpcpd
  • wapmorgan/PhpDeprecationDetector

Command Line Usage

./scripts/hooks/post-commit
# or run command on the container itself
docker compose exec drupal bash

Running Code Sniffer Drupal & DrupalPractice

https://github.com/squizlabs/PHP_CodeSniffer

PHP_CodeSniffer is a set of two PHP scripts; the main phpcs script that tokenizes PHP, JavaScript and CSS files to detect violations of a defined coding standard, and a second phpcbf script to automatically correct coding standard violations. PHP_CodeSniffer is an essential development tool that ensures your code remains clean and consistent.

$ docker compose exec drupal ./vendor/bin/phpcs ./web/modules/contrib/factory_lollipop/

Automatically fix coding standards

$ docker compose exec drupal ./vendor/bin/phpcbf ./web/modules/contrib/factory_lollipop/

Running PHP Mess Detector

https://github.com/phpmd/phpmd

Detect overcomplicated expressions & Unused parameters, methods, properties.

$ docker compose exec drupal phpmd ./web/modules/contrib/factory_lollipop/ text ./phpmd.xml \
--suffixes php,module,inc,install,test,profile,theme,css,info,txt --exclude *Test.php,*vendor/*

Running PHP Copy/Paste Detector

https://github.com/sebastianbergmann/phpcpd

phpcpd is a Copy/Paste Detector (CPD) for PHP code.

$ docker compose exec drupal phpcpd ./web/modules/contrib/factory_lollipop/src --suffix .php --suffix .module --suffix .inc --suffix .install --suffix .test --suffix .profile --suffix .theme --suffix .css --suffix .info --suffix .txt --exclude *.md --exclude *.info.yml --exclude tests --exclude vendor/

Running PhpDeprecationDetector

https://github.com/wapmorgan/PhpDeprecationDetector

A scanner that checks compatibility of your code with PHP interpreter versions.

$ docker compose exec drupal phpdd ./web/modules/contrib/factory_lollipop/ \
  --file-extensions php,module,inc,install,test,profile,theme,info --exclude vendor

Enforce code standards with git hooks

Maintaining code quality by adding the custom post-commit hook to yours.

cat ./scripts/hooks/post-commit >> ./.git/hooks/post-commit