CONTRIBUTING.md

Developing on Entity to Text

• Pull requests can be made against https://github.com/antistatique/drupal-entity-to-text/pulls

Repositories

Github repo

$ git remote add github git@github.com:antistatique/drupal-entity-to-text.git

Prerequisites

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

• drush
• Latest dev release of Drupal 9.x/10.x/11.x.
• 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.4 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" --site-name=Example -y

# You may be interesed by reseting the admin passowrd of your Docker and install the module using those cmd.
docker compose exec drupal drush user:password admin admin
docker compose exec drupal drush en entity_to_text
# docker compose exec drupal drush en entity_to_text_tika
# docker compose exec drupal drush en entity_to_text_paragraphs

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=entity_to_text --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
• vimeo/psalm

Command Line Usage

./scripts/hooks/post-commit
# or run command on the container itself
docker compose exec dev 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/entity_to_text

Automatically fix coding standards

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

Running PHP Mess Detector

https://github.com/phpmd/phpmd

Detect overcomplicated expressions & Unused parameters, methods, properties.

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

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

$ docker compose exec dev phpmd ./behat text ./phpmd.xml -suffixes php

Running PHP Copy/Paste Detector

https://github.com/sebastianbergmann/phpcpd

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

$ docker compose exec dev phpcpd ./web/modules/custom ./behat \
--names=*.php,*.module,*.inc,*.install,*.test,*.profile,*.theme,*.css,*.info,*.txt --names-exclude=*.md,*.info.yml \
--exclude tests --exclude vendor/ --ansi

Running PhpDeprecationDetector

https://github.com/wapmorgan/PhpDeprecationDetector

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

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