Merge branch 'main' into review-docker

Author: hjwp

.git-blame-ignore-revs

@@ -46,15 +46,13 @@ book.html: $(SOURCES)
 build: $(HTML_PAGES) $(TMPDIR)
 
 
-MKVENV := $(shell which uv && "uv venv" || "python3 -m venv")
-MKVENV := $(shell which uv && "uv venv" || "python3 -m venv")
-
 .venv/bin:
 	which uv && uv venv .venv || python -m venv .venv
 	which uv && uv pip install -e . || .venv/bin/pip install -e .
 
 .PHONY: install
 install: .venv/bin
+	which brew && brew install asciidoctor || apt install -y asciidoctor
 
 .PHONY: update-submodules
 update-submodules:

Makefile

@@ -99,7 +99,7 @@ gonulate, Margie Roswell, Ben Elliott, Ramsay Mayka, peterj, 1hx, Wi, Duncan
 Betts, Matthew Senko, Neric "Kasu" Kaz, Dominic Scotto, Andrey Makarov,
 and many, many more.
 
-=== Additional Thanks for the Thid Edition
+=== Additional Thanks for the Third Edition
 
 Thanks to my editor Rita Fernando,
 thanks to my tech reviewers Csanad, David, Sebastian and Jan,

acknowledgments.asciidoc

@@ -58,15 +58,15 @@
     "pdf": {
       "version": "web",
       "toc": true,
-      "index": true,
+      "index": false,
       "antennahouse_version": "AHFormatterV62_64-MR4",
       "syntaxhighlighting": true,
       "show_comments": false,
       "color_count": "1",
       "trim_size": "7inx9.1875in"
     },
     "epub": {
-      "index": true,
+      "index": false,
       "toc": true,
       "epubcheck": true,
       "syntaxhighlighting": true,

atlas.json

@@ -1,6 +1,15 @@
 [[chapter_01]]
 == Getting Django Set Up Using a [keep-together]#Functional Test#
 
+.A Note for Early Release Readers
+****
+With Early Release ebooks, you get books in their earliest form—the author's raw and unedited content as they write—so you can take advantage of these technologies long before the official release of these titles.
+
+This will be the 1st chapter of the final book. The GitHub repo is available at https://github.com/hjwp/book-example.
+
+If you have comments about how we might improve the content and/or examples in this book, or if you notice missing material within this chapter, please reach out to the author at [email protected].
+****
+
 TDD isn't something that comes naturally.
 It's a discipline, like a martial art, and just like in a Kung Fu movie,
 you need a bad-tempered and unreasonable master to force you to learn the discipline.

chapter_01.asciidoc

@@ -1,6 +1,14 @@
 [[chapter_02_unittest]]
 == Extending Our Functional Test Using [keep-together]#the unittest Module#
 
+.A Note for Early Release Readers
+****
+With Early Release ebooks, you get books in their earliest form—the author's raw and unedited content as they write—so you can take advantage of these technologies long before the official release of these titles.
+
+This will be the 2nd chapter of the final book. The GitHub repo is available at https://github.com/hjwp/book-example.
+
+If you have comments about how we might improve the content and/or examples in this book, or if you notice missing material within this chapter, please reach out to the author at [email protected].
+****
 
 ((("functional tests (FTs)", "using unittest module", id="FTunittest02")))
 ((("unittest module", "basic functional test creation", id="UTMbasic02")))

chapter_02_unittest.asciidoc

@@ -1,6 +1,14 @@
 [[chapter_03_unit_test_first_view]]
 == Testing a Simple Home Page with [keep-together]#Unit Tests#
 
+.A Note for Early Release Readers
+****
+With Early Release ebooks, you get books in their earliest form—the author's raw and unedited content as they write—so you can take advantage of these technologies long before the official release of these titles.
+
+This will be the 3rd chapter of the final book. The GitHub repo is available at https://github.com/hjwp/book-example.
+
+If you have comments about how we might improve the content and/or examples in this book, or if you notice missing material within this chapter, please reach out to the author at [email protected].
+****
 
 We finished the last chapter with a functional test failing,
 telling us that it wanted the home page for our site to have ``To-Do'' in its title.

chapter_03_unit_test_first_view.asciidoc

@@ -1,6 +1,15 @@
 [[chapter_04_philosophy_and_refactoring]]
 == What Are We Doing with All These Tests? (And, Refactoring)
 
+.A Note for Early Release Readers
+****
+With Early Release ebooks, you get books in their earliest form—the author's raw and unedited content as they write—so you can take advantage of these technologies long before the official release of these titles.
+
+This will be the 4th chapter of the final book. The GitHub repo is available at https://github.com/hjwp/book-example.
+
+If you have comments about how we might improve the content and/or examples in this book, or if you notice missing material within this chapter, please reach out to the author at [email protected].
+****
+
 ((("Test-Driven Development (TDD)", "need for", id="TDDneed04")))
 Now that we've seen the basics of TDD in action,
 it's time to pause and talk about why we're doing it.

chapter_04_philosophy_and_refactoring.asciidoc

@@ -1,6 +1,15 @@
 [[chapter_05_post_and_database]]
 == Saving User Input: Testing the Database
 
+.A Note for Early Release Readers
+****
+With Early Release ebooks, you get books in their earliest form—the author's raw and unedited content as they write—so you can take advantage of these technologies long before the official release of these titles.
+
+This will be the 5th chapter of the final book. The GitHub repo is available at https://github.com/hjwp/book-example.
+
+If you have comments about how we might improve the content and/or examples in this book, or if you notice missing material within this chapter, please reach out to the author at [email protected].
+****
+
 // ((("user interactions", "testing database input", id="UIdatabase05")))
 // disabled due to pdf rendering issue
 So far we've managed to return a static HTML page with an input box in it.

chapter_05_post_and_database.asciidoc

@@ -1,6 +1,15 @@
 [[chapter_06_explicit_waits_1]]
 == Improving Functional Tests: Ensuring Isolation and Removing Voodoo Sleeps
 
+.A Note for Early Release Readers
+****
+With Early Release ebooks, you get books in their earliest form—the author's raw and unedited content as they write—so you can take advantage of these technologies long before the official release of these titles.
+
+This will be the 6th chapter of the final book. The GitHub repo is available at https://github.com/hjwp/book-example.
+
+If you have comments about how we might improve the content and/or examples in this book, or if you notice missing material within this chapter, please reach out to the author at [email protected].
+****
+
 Before we dive in and fix our single-global-list problem,
 let's take care of a couple of housekeeping items.
 At the end of the last chapter, we made a note