|
1 | | -# ddev-core-dev |
| 1 | +# DDEV Drupal Core Development plugin |
2 | 2 |
|
3 | | -This is a DDEV addon for doing Drupal core development. |
| 3 | +I maintain this fork of [justafish/ddev-drupal-core-dev](https://github.com/justafish/ddev-drupal-core-dev) |
| 4 | +for my own tinkering. I have diverged parts of it from the upstream so don't use this |
| 5 | +unless someone asks you to. |
4 | 6 |
|
5 | | -We're in #ddev-for-core-dev on [Drupal Slack](https://www.drupal.org/community/contributor-guide/reference-information/talk/tools/slack) (but please try and keep work and feature requests in Issues where it's visible to all 🙏) |
| 7 | +I keep the [upstream branch](https://github.com/simesy/ddev-drupal-core-dev/tree/upstream) aligned with |
| 8 | +the upstream along with anything I'm trying to get merged upstream. |
| 9 | + |
| 10 | +Ping @sime in #ddev-for-core-dev on [Drupal Slack](https://www.drupal.org/community/contributor-guide/reference-information/talk/tools/slack). |
| 11 | + |
| 12 | +## Setting up |
6 | 13 |
|
7 | 14 | ``` |
8 | 15 | git clone https://git.drupalcode.org/project/drupal.git drupal |
9 | 16 | cd drupal |
10 | 17 | ddev config --omit-containers=db --disable-settings-management |
11 | 18 | ddev start |
12 | | -ddev get justafish/ddev-drupal-core-dev |
| 19 | +ddev get simesy/ddev-drupal-core-dev |
13 | 20 | ddev restart |
14 | 21 | ddev composer install |
| 22 | +``` |
| 23 | + |
| 24 | +## Checking the basic workflow |
15 | 25 |
|
16 | | -# See included commands |
| 26 | +``` |
17 | 27 | ddev drupal list |
18 | 28 |
|
19 | 29 | # Install drupal |
20 | | -ddev drupal install |
| 30 | +ddev drupal install minimal |
21 | 31 |
|
22 | 32 | # Run PHPUnit tests |
23 | | -ddev phpunit core/modules/sdc |
| 33 | +ddev phpunit core/modules/text/tests/src/Functional/GenericTest.php |
24 | 34 |
|
25 | 35 | # Run Nightwatch tests (currently only runs on Chrome) |
26 | 36 | ddev nightwatch --tag core |
27 | | -``` |
28 | | - |
29 | | -## Nightwatch Examples |
30 | | - |
31 | | -You can watch Nightwatch running in real time at https://drupal.ddev.site:7900 |
32 | | -for Chrome and https://drupal.ddev.site:7901 for Firefox. The password is |
33 | | -"secret". YMMV using Firefox as core tests don't currently run on it. |
34 | | - |
35 | | -Only core tests |
36 | | -``` |
37 | | -ddev nightwatch --tag core |
38 | | -``` |
39 | | - |
40 | | -Skip running core tests |
41 | | -``` |
42 | | -ddev nightwatch --skiptags core |
43 | | -``` |
44 | | - |
45 | | -Run a single test |
46 | | -``` |
47 | | -ddev nightwatch tests/Drupal/Nightwatch/Tests/exampleTest.js |
48 | | -``` |
49 | | - |
50 | | -a11y tests for both the admin and default themes |
51 | | -``` |
52 | | -ddev nightwatch --tag a11y |
53 | | -``` |
54 | | - |
55 | | -a11y tests for the admin theme only |
56 | | -``` |
57 | | -ddev nightwatch --tag a11y:admin |
58 | | -``` |
59 | | - |
60 | | -a11y tests for the default theme only |
61 | | -``` |
62 | | -ddev nightwatch --tag a11y:default |
63 | | -``` |
64 | | - |
65 | | -a11y test for a custom theme used as the default theme |
66 | | -``` |
67 | | -ddev nightwatch --tag a11y:default --defaultTheme bartik |
68 | | -``` |
69 | | - |
70 | | -a11y test for a custom admin theme |
71 | | -``` |
72 | 37 | ddev nightwatch --tag a11y:admin --adminTheme seven |
73 | 38 | ``` |
0 commit comments