857 lines
14 KiB
ReStructuredText
857 lines
14 KiB
ReStructuredText
..
|
|
This file used a mixture of `plain` and `php` languages for code blocks so that `hl_lines` display correctly.
|
|
|
|
.. page:: titlePage
|
|
|
|
.. class:: centredtitle
|
|
|
|
Building a blog module
|
|
|
|
.. raw:: pdf
|
|
|
|
TextAnnotation "Shortened and simplified example."
|
|
TextAnnotation "I'd use Views for this in a real situation."
|
|
|
|
.. page:: standardPage
|
|
|
|
Acceptance criteria
|
|
===================
|
|
|
|
- As a site visitor
|
|
- I want to see a list of published articles at ``/blog``
|
|
- Ordered by post date, most recent first
|
|
|
|
Tasks
|
|
=====
|
|
|
|
- Ensure the blog page exists
|
|
- Ensure only published articles are shown
|
|
- Ensure the articles are shown in the correct order
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. Creating the test class.
|
|
|
|
.. code-block:: php
|
|
:include: code/2.txt
|
|
:linenos:
|
|
:startinline: true
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/2.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:hl_lines: 1,2,3
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/2.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:hl_lines: 5,6,7
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/2.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:hl_lines: 9,10,11
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. Adding the first test.
|
|
|
|
.. code-block:: php
|
|
:include: code/3.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:end-before: // end test
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/3.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:end-before: // end test
|
|
:hl_lines: 3,4,8
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/3.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:end-before: // end test
|
|
:hl_lines: 5
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/3.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:end-before: // end test
|
|
:hl_lines: 7
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: plain
|
|
:include: code/3.txt
|
|
:startinline: true
|
|
:start-after: // start output
|
|
:end-before: // end output
|
|
|
|
.. code-block:: php
|
|
:include: code/3.txt
|
|
:startinline: true
|
|
:start-after: // start output
|
|
:end-before: // end output
|
|
:hl_lines: 1,5
|
|
|
|
.. code-block:: php
|
|
:include: code/3.txt
|
|
:startinline: true
|
|
:start-after: // start output
|
|
:end-before: // end output
|
|
:hl_lines: 7
|
|
|
|
.. code-block:: php
|
|
:include: code/3.txt
|
|
:startinline: true
|
|
:start-after: // start output
|
|
:end-before: // end output
|
|
:hl_lines: 8,9
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: yaml
|
|
:include: code/3.txt
|
|
:linenos:
|
|
:start-after: // start routing
|
|
:end-before: // end routing
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: yaml
|
|
:include: code/3.txt
|
|
:linenos:
|
|
:start-after: // start routing
|
|
:end-before: // end routing
|
|
:hl_lines: 4,6
|
|
|
|
.. raw:: pdf
|
|
|
|
TextAnnotation "This controller doesn't exist yet, but the test will tell us that."
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/3.txt
|
|
:startinline: true
|
|
:start-after: // start output
|
|
:end-before: // end output
|
|
:hl_lines: 7,8,9
|
|
|
|
.. raw:: pdf
|
|
|
|
TextAnnotation "Same result as the module isn't enabled."
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/4.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:end-before: // output
|
|
|
|
|
|
|
|
|
.. code-block:: plain
|
|
:include: code/4.txt
|
|
:startinline: true
|
|
:start-after: // output
|
|
:end-before: // end output
|
|
|
|
.. raw:: pdf
|
|
|
|
TextAnnotation "The `access content` permission isn't available."
|
|
PageBreak
|
|
|
|
.. Enable the node module.
|
|
|
|
.. code-block:: php
|
|
:include: code/5.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:end-before: // end code
|
|
|
|
|
|
|
|
|
.. code-block:: plain
|
|
:include: code/5.txt
|
|
:start-after: // start output
|
|
:end-before: // end output
|
|
|
|
.. raw:: pdf
|
|
|
|
TextAnnotation "The error has changed. This is good."
|
|
TextAnnotation "The controller we specified doesn't exist."
|
|
PageBreak
|
|
|
|
.. Create the Controller.
|
|
|
|
.. code-block:: php
|
|
:include: code/6.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code
|
|
:end-before: // end code
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/6.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code
|
|
:end-before: // end code
|
|
:hl_lines: 1,2,3
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/6.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code
|
|
:end-before: // end code
|
|
:hl_lines: 7,13
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/6.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code
|
|
:end-before: // end code
|
|
:hl_lines: 9,10,11
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: plain
|
|
:include: code/6.txt
|
|
:start-after: // start output
|
|
:end-before: // end output
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/7.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start test
|
|
:end-before: // end test
|
|
|
|
.. raw:: pdf
|
|
|
|
TextAnnotation "Adding more assertions."
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/7.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start test
|
|
:end-before: // end test
|
|
:hl_lines: 5,6
|
|
|
|
.. raw:: pdf
|
|
|
|
TextAnnotation "Refactor the original assertion."
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/7.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start test
|
|
:end-before: // end test
|
|
:hl_lines: 8,9
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: plain
|
|
:include: code/7.txt
|
|
:start-after: // start output
|
|
:end-before: // end output
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/7.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code
|
|
:end-before: // end code
|
|
:hl_lines: 3,7
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/7.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code
|
|
:end-before: // end code
|
|
:hl_lines: 10,11,12
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: plain
|
|
:include: code/7.txt
|
|
:start-after: // start output2
|
|
:end-before: // end output2
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/8.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code
|
|
:end-before: // end code
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/8.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code
|
|
:end-before: // end code
|
|
:hl_lines: 1,2,3,4,5,6,7,15
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/8.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code
|
|
:end-before: // end code
|
|
:hl_lines: 9,10,14
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/8.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code
|
|
:end-before: // end code
|
|
:hl_lines: 11
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/8.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code
|
|
:end-before: // end code
|
|
:hl_lines: 13
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/8.txt
|
|
:start-after: // start output
|
|
:end-before: // end output
|
|
|
|
.. code-block:: php
|
|
:include: code/8.txt
|
|
:start-after: // start output
|
|
:end-before: // end output
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/9.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code
|
|
:end-before: // end code
|
|
|
|
|
|
|
|
|
.. code-block:: yaml
|
|
:include: code/9.txt
|
|
:linenos:
|
|
:start-after: // start services
|
|
:end-before: // end services
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: yaml
|
|
:include: code/9.txt
|
|
:start-after: // start output
|
|
:end-before: // end output
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/10.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code
|
|
:end-before: // end code
|
|
:hl_lines: 5,6,7
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: plain
|
|
:include: code/10.txt
|
|
:start-after: // start output
|
|
:end-before: // end output
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/11.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code 1
|
|
:end-before: // end code 1
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/11.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code 1
|
|
:end-before: // end code 1
|
|
:hl_lines: 10,11,12
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/11.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code 1
|
|
:end-before: // end code 1
|
|
:hl_lines: 8,13
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/11.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code 2
|
|
:end-before: // end code 2
|
|
:hl_lines: 1,3
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/11.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code 2
|
|
:end-before: // end code 2
|
|
:hl_lines: 2
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: yaml
|
|
:include: code/12.txt
|
|
:linenos:
|
|
:start-after: // start services1
|
|
:end-before: // end services1
|
|
|
|
|
|
|
|
|
.. code-block:: yaml
|
|
:include: code/12.txt
|
|
:linenos:
|
|
:start-after: // start services2
|
|
:end-before: // end services2
|
|
|
|
.. raw:: pdf
|
|
|
|
TextAnnotation "Declare the Repository as a service."
|
|
TextAnnotation "Autowire or declare dependencies explicitly."
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: plain
|
|
:include: code/12.txt
|
|
:start-after: // start output
|
|
:end-before: // end output
|
|
|
|
|
|
|
|
|
.. code-block:: php
|
|
:include: code/13.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start test
|
|
:end-before: // end test
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: plain
|
|
:include: code/13.txt
|
|
:start-after: // start output
|
|
:end-before: // end output
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/14.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start test
|
|
:end-before: // end test
|
|
:hl_lines: 1
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/14.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start test
|
|
:end-before: // end test
|
|
:hl_lines: 5
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: plain
|
|
:include: code/14.txt
|
|
:start-after: // start output
|
|
:end-before: // end output
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/15.txt
|
|
:linenos:
|
|
:start-after: // start test
|
|
:end-before: // end test
|
|
:startinline: true
|
|
|
|
.. raw:: pdf
|
|
|
|
TextAnnotation "We know we're getting a node, but are we getting the correct node?"
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/15.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start test
|
|
:end-before: // end test
|
|
:hl_lines: 1,2,3,4
|
|
|
|
.. raw:: pdf
|
|
|
|
TextAnnotation "Create a node with a specific title."
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/15.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:end-before: // end test
|
|
:start-after: // start test
|
|
:hl_lines: 10,11
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/15.txt
|
|
:startinline: true
|
|
:linenos:
|
|
:start-after: // start test
|
|
:end-before: // end test
|
|
:hl_lines: 13,14,15
|
|
|
|
.. raw:: pdf
|
|
|
|
TextAnnotation "Ensure the node is an article and has the correct title."
|
|
PageBreak
|
|
|
|
.. Published or unpublished nodes.
|
|
|
|
.. code-block:: php
|
|
:include: code/16.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start test
|
|
:end-before: // end test
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/16.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start test
|
|
:end-before: // end test
|
|
:hl_lines: 2,4,6
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/16.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start test
|
|
:end-before: // end test
|
|
:hl_lines: 3,5
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/16.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start test
|
|
:end-before: // end test
|
|
:hl_lines: 12
|
|
|
|
.. raw:: pdf
|
|
|
|
TextAnnotation "We should only have three published articles."
|
|
PageBreak
|
|
|
|
.. code-block:: plain
|
|
:include: code/16.txt
|
|
:start-after: // start output
|
|
:end-before: // end output
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/17.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code
|
|
:end-before: // end code
|
|
|
|
|
|
|
|
|
.. code-block:: plain
|
|
:include: code/17.txt
|
|
:start-after: // start output
|
|
:end-before: // end output
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. Ensure articles are ordered correctly.
|
|
|
|
.. code-block:: php
|
|
:include: code/18.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start test
|
|
:end-before: // end test
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/18.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start test
|
|
:end-before: // end test
|
|
:hl_lines: 3,5,7,9,11
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/18.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start test
|
|
:end-before: // end test
|
|
:hl_lines: 16
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: plain
|
|
:include: code/18.txt
|
|
:start-after: // start output
|
|
:end-before: // end output
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/19.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code
|
|
:end-before: // end code
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/19.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code
|
|
:end-before: // end code
|
|
:hl_lines: 2,3,4
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/19.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code
|
|
:end-before: // end code
|
|
:hl_lines: 6,7
|
|
|
|
.. raw:: pdf
|
|
|
|
TextAnnotation "Spaceship operator!"
|
|
PageBreak
|
|
|
|
.. code-block:: php
|
|
:include: code/19.txt
|
|
:linenos:
|
|
:startinline: true
|
|
:start-after: // start code
|
|
:end-before: // end code
|
|
:hl_lines: 9
|
|
|
|
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. code-block:: plain
|
|
:include: code/19.txt
|
|
:start-after: // start output
|
|
:end-before: // end output
|