massive refactoring to allow more flexible addition and exchange of chapters in the future

Author: thomasWeise

notation/terms.sty

@@ -186,7 +186,7 @@ text={\softwareStyle{Java}},%
 name={Java},%
 sort={Java},%
 description={%
-is another very success programming language, with roots in the \pgls{C}~family of languages~\cite{LNL2020LJ,B2008EJ}.%
+is another very successful programming language, with roots in the \pgls{C}~family of languages~\cite{LNL2020LJ,B2008EJ}.%
 }%
 }%
 %

styles/listing.sty

@@ -327,7 +327,7 @@ $\downarrow$~~\expandafter\bashil{bash #3}~~$\downarrow$%
 \gitLoad{#1}{#2/#3}{python3 -m latexgit.formatters.python #4}%
 \expandafter\expandafter\expandafter\edef\expandafter\csname @pwp@gitUrl:lst:#5\endcsname{\gitUrl}%
 \expandafter\expandafter\expandafter\edef\expandafter\csname @pwp@gitFile:lst:#5\endcsname{\gitFile}%
-\gitExec{#1}{.}{./scripts/pythonIgnoreErrors.sh #2 #3}%
+\gitExec{#1}{.}{./_scripts_/pythonIgnoreErrors.sh #2 #3}%
 \expandafter\expandafter\expandafter\edef\expandafter\csname @pwp@gitFile:exec:#5\endcsname{\gitFile}%
 %
 \begin{figure}[tb]%

text/back/scripts.tex

@@ -1,18 +1,18 @@
 \hsection{Scripts}%
 %
-\gitBash{\programmingWithPythonCodeRepo}{scripts/mypy.sh}{bash:mypy}{%
+\gitBash{\programmingWithPythonCodeRepo}{_scripts_/mypy.sh}{bash:mypy}{%
 A \bash\ script for executing \mypy, which prints the command line and the exit code; see \cref{ut:mypy}.}%
 %
-\gitBash{\programmingWithPythonCodeRepo}{scripts/ruff.sh}{bash:ruff}{%
+\gitBash{\programmingWithPythonCodeRepo}{_scripts_/ruff.sh}{bash:ruff}{%
 A \bash\ script for executing \ruff, which prints the command line and the exit code; see \cref{ut:ruff}.}%
 %
-\gitBash{\programmingWithPythonCodeRepo}{scripts/pylint.sh}{bash:pylint}{%
+\gitBash{\programmingWithPythonCodeRepo}{_scripts_/pylint.sh}{bash:pylint}{%
 A \bash\ script for executing \pylint, which prints the command line and the exit code; see \cref{ut:pylint}.}%
 %
-\gitBash{\programmingWithPythonCodeRepo}{scripts/pytest.sh}{bash:pytest}{%
+\gitBash{\programmingWithPythonCodeRepo}{_scripts_/pytest.sh}{bash:pytest}{%
 A \bash\ script for executing test cases with \pytest, which prints the command line and the exit code; see \cref{ut:pytest}.}%
 %
-\gitBash{\programmingWithPythonCodeRepo}{scripts/pytest_doctest.sh}{bash:pytest_doctest}{%
+\gitBash{\programmingWithPythonCodeRepo}{_scripts_/pytest_doctest.sh}{bash:pytest_doctest}{%
 A \bash\ script for executing \pglspl{doctest} with \pytest, which prints the command line and the exit code; see \cref{ut:doctest}.}%
 %
 Here we provide some scripts that are used within this book.

text/main/basics/collections/dictionaries/dictionaries.tex

@@ -1,7 +1,7 @@
 \hsection{Dictionaries}%
 \label{sec:dictionaries}%
 %
-\gitPythonAndOutput{\programmingWithPythonCodeRepo}{02_collections}{dicts_1.py}{--args format}{dicts:dicts_1}{%
+\gitPythonAndOutput{\programmingWithPythonCodeRepo}{collections}{dicts_1.py}{--args format}{dicts:dicts_1}{%
 An example of using dictionaries in \python.}%
 %
 Dictionaries in \python\ are containers that store key-value pairs.

text/main/basics/collections/lists/lists.tex

@@ -7,13 +7,13 @@
 \hsection{Basic Functionality and Examples}%
 \label{sec:lists:basicFunctions}%
 %
-\gitPythonAndOutput{\programmingWithPythonCodeRepo}{02_collections}{lists_1.py}{--args format}{lists:lists_1}{%
+\gitPythonAndOutput{\programmingWithPythonCodeRepo}{collections}{lists_1.py}{--args format}{lists:lists_1}{%
 A first example for using lists in \python: creating, indexing, printing of and appending elements and other lists to lists.}%
 %
-\gitPythonAndOutput{\programmingWithPythonCodeRepo}{02_collections}{lists_2.py}{--args format}{lists:lists_2}{%
+\gitPythonAndOutput{\programmingWithPythonCodeRepo}{collections}{lists_2.py}{--args format}{lists:lists_2}{%
 A second example of using lists in \python: inserting and deleting elements, sorting and reversing lists.}%
 %
-\gitPythonAndOutput{\programmingWithPythonCodeRepo}{02_collections}{lists_3.py}{--args format}{lists:lists_3}{%
+\gitPythonAndOutput{\programmingWithPythonCodeRepo}{collections}{lists_3.py}{--args format}{lists:lists_3}{%
 A third example of using lists in \python: slicing, adding, and multiplying lists.}%
 %
 In \cref{lst:lists:lists_1}, we provide some first examples for using lists.
@@ -143,7 +143,7 @@
 \hsection{An Example of Errors and a new Tool}%
 \label{sec:listExampleForErrorsAndRuff}%
 %
-\gitPythonAndOutput{\programmingWithPythonCodeRepo}{02_collections}{lists_error.py}{--args format}{lists:lists_error}{%
+\gitPythonAndOutput{\programmingWithPythonCodeRepo}{collections}{lists_error.py}{--args format}{lists:lists_error}{%
 A program processing lists which exhibits some subtle errors and inefficiencies.}
 
 Now, in the previous chapter, we learned that static code analysis tools can help us to discover subtle problems in our programs.
@@ -153,7 +153,7 @@
 It does not have any \emph{error} in the strict sense.
 We can execute it just fine and it will produce the output \textil{[1, 2, 3]} as shown in \cref{exec:lists:lists_error}.
 
-\gitOutputTool{\programmingWithPythonCodeRepo}{.}{scripts/mypy.sh 02_collections lists_error.py}{lists:lists_error:mypy}{%
+\gitOutputTool{\programmingWithPythonCodeRepo}{.}{_scripts_/mypy.sh collections lists_error.py}{lists:lists_error:mypy}{%
 The results of static type checking with \mypy\ of the program given in \cref{lst:lists:lists_error}.}
 
 However, upon closer inspection, we discover some issues.
@@ -179,7 +179,7 @@
 We provide a script for using \ruff\ with a reasonable default configuration in \cref{lst:bash:ruff} on \cpageref{lst:bash:ruff}.%
 }%
 %
-\gitOutputTool{\programmingWithPythonCodeRepo}{.}{scripts/ruff.sh 02_collections lists_error.py}{lists:lists_error:ruff}{%
+\gitOutputTool{\programmingWithPythonCodeRepo}{.}{_scripts_/ruff.sh collections lists_error.py}{lists:lists_error:ruff}{%
 The results of linting with \ruff\ of the program given in \cref{lst:lists:lists_error}. (We used the script given in \cref{lst:bash:ruff} on \cpageref{lst:bash:ruff} to apply \ruff.)}%
 %
 Let us apply \ruff\ to the program \textil{lists_error.py} given in \cref{lst:lists:lists_error}, which produces the output \cref{exec:lists:lists_error:ruff}.
@@ -199,7 +199,7 @@
 It basically creates a list via \pythonil{[1, 2, 3]} and then immediately makes a copy of it via the \pythonilIdx{list} function wrapped around the list specification.
 We can leave this outer call to \pythonil{list} away.
 
-\gitPythonAndOutput{\programmingWithPythonCodeRepo}{02_collections}{lists_fixed.py}{--args format}{lists:lists_fixed}{%
+\gitPythonAndOutput{\programmingWithPythonCodeRepo}{collections}{lists_fixed.py}{--args format}{lists:lists_fixed}{%
 The corrected version of~\cref{lst:lists:lists_error}, taking into account the information given by \mypy\ in \cref{exec:lists:lists_error:mypy} and \ruff\ in \cref{exec:lists:lists_error:ruff}.}%
 %
 %
@@ -220,10 +220,10 @@
 %
 \FloatBarrier%
 %
-\gitOutputTool{\programmingWithPythonCodeRepo}{.}{scripts/mypy.sh 02_collections lists_fixed.py}{lists:lists_fixed:mypy}{%
+\gitOutputTool{\programmingWithPythonCodeRepo}{.}{_scripts_/mypy.sh collections lists_fixed.py}{lists:lists_fixed:mypy}{%
 The results of static type checking with \mypy\ of the program given in \cref{lst:lists:lists_fixed}.}%
 %
-\gitOutputTool{\programmingWithPythonCodeRepo}{.}{scripts/ruff.sh 02_collections lists_fixed.py}{lists:lists_fixed:ruff}{%
+\gitOutputTool{\programmingWithPythonCodeRepo}{.}{_scripts_/ruff.sh collections lists_fixed.py}{lists:lists_fixed:ruff}{%
 The results of static type checking with \ruff\ of the program given in \cref{lst:lists:lists_fixed}.}
 
 Well, this was only a two-line program.

text/main/basics/collections/sets/sets.tex

@@ -1,11 +1,11 @@
 \hsection{Sets}%
 \label{sec:sets}%
 %
-\gitPythonAndOutput{\programmingWithPythonCodeRepo}{02_collections}{sets_1.py}{--args format}{sets:sets_1}{%
+\gitPythonAndOutput{\programmingWithPythonCodeRepo}{collections}{sets_1.py}{--args format}{sets:sets_1}{%
 A first example of using sets in \python: creating, modifying, and converting sets. %
 Since sets are unordered, printing them can yield a different result each time a program is executed (see \cref{bp:setsUnordered}).}%
 %
-\gitPythonAndOutput{\programmingWithPythonCodeRepo}{02_collections}{sets_2.py}{--args format}{sets:sets_2}{%
+\gitPythonAndOutput{\programmingWithPythonCodeRepo}{collections}{sets_2.py}{--args format}{sets:sets_2}{%
 A second example of using sets in \python: creating sets and set operations (as illustrated in \cref{fig:setOperations}). %
 Since sets are unordered, printing them can yield a different result each time a program is executed (see \cref{bp:setsUnordered}).}%
 %

text/main/basics/collections/tuples/tuples.tex

@@ -1,16 +1,16 @@
 \hsection{Tuples}%
 \label{sec:tuples}%
 %
-\gitPythonAndOutput{\programmingWithPythonCodeRepo}{02_collections}{tuples_1.py}{--args format}{tuples:tuples_1}{%
+\gitPythonAndOutput{\programmingWithPythonCodeRepo}{collections}{tuples_1.py}{--args format}{tuples:tuples_1}{%
 A first example of using tuples in \python: creating, indexing, and printing of tuples.}%
 %
-\gitPythonAndOutput{\programmingWithPythonCodeRepo}{02_collections}{tuples_2.py}{--args format}{tuples:tuples_2}{%
+\gitPythonAndOutput{\programmingWithPythonCodeRepo}{collections}{tuples_2.py}{--args format}{tuples:tuples_2}{%
 A second example of using tuples in \python: tuples with elements of different types and tuple unpacking.}%
 %
-\gitPythonAndErrorOutput{\programmingWithPythonCodeRepo}{02_collections}{tuples_3.py}{--args format}{tuples:tuples_3}{%
+\gitPythonAndErrorOutput{\programmingWithPythonCodeRepo}{collections}{tuples_3.py}{--args format}{tuples:tuples_3}{%
 A third example of using tuples in \python: testing the immutability property.}%
 %
-\gitOutputTool{\programmingWithPythonCodeRepo}{.}{scripts/mypy.sh 02_collections tuples_3.py}{tuples:tuples_3:mypy}{%
+\gitOutputTool{\programmingWithPythonCodeRepo}{.}{_scripts_/mypy.sh collections tuples_3.py}{tuples:tuples_3:mypy}{%
 The results of static type checking with \mypy\ of the program given in \cref{lst:tuples:tuples_3}.}%
 %
 \pythonIdx{tuple}%

text/main/basics/gettingStarted/firstProgram/firstProgram.tex

@@ -6,7 +6,7 @@
 This program should just print \inQuotes{Hello World!} to the text output and then exit.
 It therefore will consist of the single statement \pythonil{print("Hello World!")}, as illustrated in \cref{lst:very_first_program}.
 
-\gitPythonAndOutput{\programmingWithPythonCodeRepo}{00_veryFirstProject}{very_first_program.py}{--args format}{very_first_program}{%
+\gitPythonAndOutput{\programmingWithPythonCodeRepo}{veryFirstProject}{very_first_program.py}{--args format}{very_first_program}{%
 Our very first \python\ program, which just prints \inQuotes{Hello World!}}%
 %
 \begin{figure}%

text/main/basics/variables/assignment/assignment.tex

@@ -6,7 +6,7 @@
 Here, \pythonil{name} is the name of the variable and \pythonil{value} be the value that we want to assign to that name.%
 %
 \hsection{A Simple Example of Variable Assignment and Comments in the Code}%
-\gitPythonAndOutput{\programmingWithPythonCodeRepo}{01_variables}{assignment.py}{--args format}{variables:assignment}{%
+\gitPythonAndOutput{\programmingWithPythonCodeRepo}{variables}{assignment.py}{--args format}{variables:assignment}{%
 A \python\ program showing some examples for variable assignments.}%
 %
 \begin{figure}[tb]%
@@ -232,7 +232,7 @@
 \pi_{2e} &= \frac{e}{2} s_{2e}\label{eq:liuhui:approx}%
 \end{align}%
 %
-\gitPythonAndOutput{\programmingWithPythonCodeRepo}{01_variables}{pi_liu_hui.py}{--args format}{variables:pi_liu_hui}{%
+\gitPythonAndOutput{\programmingWithPythonCodeRepo}{variables}{pi_liu_hui.py}{--args format}{variables:pi_liu_hui}{%
 A \python\ program showing several steps of the approximation of~\numberPi\ using the method of LIU Hui.}%
 %
 \begin{figure}[tb]%

text/main/basics/variables/identity/identity.tex

@@ -21,10 +21,10 @@
 \label{fig:variables:equalityAndIdentity}%
 \end{figure}%
 %
-\gitPythonAndOutput{\programmingWithPythonCodeRepo}{01_variables}{identity_1.py}{--args format}{variables:identity_1}{%
+\gitPythonAndOutput{\programmingWithPythonCodeRepo}{variables}{identity_1.py}{--args format}{variables:identity_1}{%
 An example of the difference between equality and identity\pythonIdx{sqrt}.}%
 %
-\gitPythonAndOutput{\programmingWithPythonCodeRepo}{01_variables}{identity_2.py}{--args format}{variables:identity_2}{%
+\gitPythonAndOutput{\programmingWithPythonCodeRepo}{variables}{identity_2.py}{--args format}{variables:identity_2}{%
 An second example of the difference between equality and identity.}%
 %
 We use variables to references objects in memory.