Merge branch 'main' into review-chapter-10

Author: hjwp

.git-blame-ignore-revs

@@ -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

chapter_06_explicit_waits_1.asciidoc

@@ -1,6 +1,15 @@
 [[chapter_07_working_incrementally]]
 == Working Incrementally
 
+.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 7th 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)", "adapting existing code incrementally", id="TDDadapt07")))
 ((("Testing Goat", "working state to working state")))
 Now let's address our real problem,
@@ -133,7 +142,7 @@ To create a brand new list, we'll have a special URL that accepts POST requests:
 
 // DAVID: for consistency, personally I would add trailing slashes to all the URLs.
 // SEBASTIAN: Why not just POST /lists/ ?
-//      Unless it's a URL for a view with a form 😅
+//      Unless it's a URL for a view with a form!
 
 To add a new item to an existing list,
 we'll have a separate URL, to which we can send POST requests:
@@ -145,7 +154,7 @@ we'll have a separate URL, to which we can send POST requests:
 
 // DAVID: I would use kebab case for URLs -> /add-item/
 // SEBASTIAN: Why not just POST /lists/<list identifier>/item ?
-//      Unless it's a URL for a view with a form 😅
+//      Unless it's a URL for a view with a form!
 
 (Again, we're not trying to perfectly follow the rules of REST, which would use a PUT request
 here--we're just using REST for inspiration.