Code files added

Author: Jijo

Chapter01/better_hello_tkinter.py

@@ -0,0 +1,56 @@
+"""A better Hello World for Tkinter"""
+
+import tkinter as tk
+from tkinter import ttk
+
+
+class HelloView(tk.Frame):
+    """A friendly little module"""
+
+    def __init__(self, parent, *args, **kwargs):
+        super().__init__(parent, *args, **kwargs)
+
+        self.name = tk.StringVar()
+        self.hello_string = tk.StringVar()
+        self.hello_string.set("Hello World")
+
+        name_label = ttk.Label(self, text="Name:")
+        name_entry = ttk.Entry(self, textvariable=self.name)
+        ch_button = ttk.Button(self, text="Change", command=self.on_change)
+        hello_label = ttk.Label(self, textvariable=self.hello_string,
+            font=("TkDefaultFont", 64), wraplength=600)
+
+        # Layout form
+        name_label.grid(row=0, column=0, sticky=tk.W)
+        name_entry.grid(row=0, column=1, sticky=(tk.W + tk.E))
+        ch_button.grid(row=0, column=2, sticky=tk.E)
+        hello_label.grid(row=1, column=0, columnspan=3)
+        self.columnconfigure(1, weight=1)
+
+    def on_change(self):
+        """Handle Change button clicks"""
+        if self.name.get().strip():
+            self.hello_string.set("Hello " + self.name.get())
+        else:
+            self.hello_string.set("Hello World")
+
+
+class MyApplication(tk.Tk):
+    """Hello World Main Application"""
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+
+        # set the window properties
+        self.title("Hello Tkinter")
+        self.geometry("800x600")
+        self.resizable(width=False, height=False)
+
+        # Define the UI
+        HelloView(self).grid(sticky=(tk.E + tk.W + tk.N + tk.S))
+        self.columnconfigure(0, weight=1)
+
+
+if __name__ == '__main__':
+    app = MyApplication()
+    app.mainloop()

Chapter01/hello_tkinter.py

@@ -0,0 +1,12 @@
+"""Hello World application for Tkinter"""
+
+
+from tkinter import *
+from tkinter.ttk 
+import *
+
+root = Tk()
+
+label = Label(root, text="Hello World")
+label.pack()
+root.mainloop()

Chapter02/abq_data_entry_spec.rst

@@ -0,0 +1,91 @@
+======================================
+ ABQ Data Entry Program specification
+======================================
+
+
+Description
+-----------
+The program is being created to minimize data entry errors for laboratory measurements.
+
+Functionality Required
+----------------------
+
+The program must:
+
+* allow all relevant, valid data to be entered, as per the field chart
+* append entered data to a CSV file
+  - The CSV file must have a filename of abq_data_record_CURRENTDATE.csv,
+    where CURRENTDATE is the date of the checks in ISO format (Year-month-day)
+  - The CSV file must have all the fields as per the chart
+* enforce correct datatypes per field
+
+The program should try, whenever possible, to:
+
+* enforce reasonable limits on data entered
+* Auto-fill data
+* Suggest likely correct values
+* Provide a smooth and efficient workflow
+
+Functionality Not Required
+--------------------------
+
+The program does not need to:
+
+* Allow editing of data. This can be done in LibreOffice if necessary.
+* Allow deletion of data.
+
+Limitations
+-----------
+
+The program must:
+
+* Be efficiently operable by keyboard-only users.
+* Be accessible to color blind users.
+* Run on Debian Linux.
+* Run acceptably on a low-end PC.
+
+Data Dictionary
+---------------
++------------+----------+------+------------------+--------------------------+
+|Field       | Datatype | Units| Range            |Descripton                |
++============+==========+======+==================+==========================+
+|Date        |Date      |      |                  |Date of record            |
++------------+----------+------+------------------+--------------------------+
+|Time        |Time      |      |8:00, 12:00,      |Time period               |
+|            |          |      |16:00, or 20:00   |                          |
++------------+----------+------+------------------+--------------------------+
+|Lab         |String    |      | A - E            |Lab ID                    |
++------------+----------+------+------------------+--------------------------+
+|Technician  |String    |      |                  |Technician name           |
++------------+----------+------+------------------+--------------------------+
+|Plot        |Int       |      | 1 - 20           |Plot ID                   |
++------------+----------+------+------------------+--------------------------+
+|Seed        |String    |      |                  |Seed sample ID            |
+|sample      |          |      |                  |                          |
++------------+----------+------+------------------+--------------------------+
+|Fault       |Bool      |      |                  |Fault on environmental    |
+|            |          |      |                  |sensor                    |
++------------+----------+------+------------------+--------------------------+
+|Light       |Decimal   |klx   | 0 - 100          |Light at plot             |
++------------+----------+------+------------------+--------------------------+
+|Humidity    |Decimal   |g/m³  | 0.5 - 52.0       |Abs humidity at plot      |
++------------+----------+------+------------------+--------------------------+
+|Temperature |Decimal   |°C    | 4 - 40           |Temperature at plot       |
++------------+----------+------+------------------+--------------------------+
+|Blossoms    |Int       |      | 0 - 1000         |Number of blossoms in plot|
++------------+----------+------+------------------+--------------------------+
+|Fruit       |Int       |      | 0 - 1000         |Number of fruits in plot  |
++------------+----------+------+------------------+--------------------------+
+|Plants      |Int       |      | 0 - 20           |Number of plants in plot  |
++------------+----------+------+------------------+--------------------------+
+|Max height  |Decimal   |cm    | 0 - 1000         |Height of tallest plant in|
+|            |          |      |                  |plot                      |
++------------+----------+------+------------------+--------------------------+
+|Min height  |Decimal   |cm    | 0 - 1000         |Height of shortest plant  |
+|            |          |      |                  |in plot                   |
++------------+----------+------+------------------+--------------------------+
+|Median      |Decimal   |cm    | 0 - 1000         |Median height of plants in|
+|height      |          |      |                  |plot                      |
++------------+----------+------+------------------+--------------------------+
+|Notes       |String    |      |                  |Miscellaneous notes       |
++------------+----------+------+------------------+--------------------------+

Chapter03/abq_data_entry_spec.rst

@@ -0,0 +1,91 @@
+======================================
+ ABQ Data Entry Program specification
+======================================
+
+
+Description
+-----------
+The program is being created to minimize data entry errors for laboratory measurements.
+
+Functionality Required
+----------------------
+
+The program must:
+
+* allow all relevant, valid data to be entered, as per the field chart
+* append entered data to a CSV file
+  - The CSV file must have a filename of abq_data_record_CURRENTDATE.csv,
+    where CURRENTDATE is the date of the checks in ISO format (Year-month-day)
+  - The CSV file must have all the fields as per the chart
+* enforce correct datatypes per field
+
+The program should try, whenever possible, to:
+
+* enforce reasonable limits on data entered
+* Auto-fill data
+* Suggest likely correct values
+* Provide a smooth and efficient workflow
+
+Functionality Not Required
+--------------------------
+
+The program does not need to:
+
+* Allow editing of data. This can be done in LibreOffice if necessary.
+* Allow deletion of data.
+
+Limitations
+-----------
+
+The program must:
+
+* Be efficiently operable by keyboard-only users.
+* Be accessible to color blind users.
+* Run on Debian Linux.
+* Run acceptably on a low-end PC.
+
+Data Dictionary
+---------------
++------------+----------+------+------------------+--------------------------+
+|Field       | Datatype | Units| Range            |Descripton                |
++============+==========+======+==================+==========================+
+|Date        |Date      |      |                  |Date of record            |
++------------+----------+------+------------------+--------------------------+
+|Time        |Time      |      |8:00, 12:00,      |Time period               |
+|            |          |      |16:00, or 20:00   |                          |
++------------+----------+------+------------------+--------------------------+
+|Lab         |String    |      | A - E            |Lab ID                    |
++------------+----------+------+------------------+--------------------------+
+|Technician  |String    |      |                  |Technician name           |
++------------+----------+------+------------------+--------------------------+
+|Plot        |Int       |      | 1 - 20           |Plot ID                   |
++------------+----------+------+------------------+--------------------------+
+|Seed        |String    |      |                  |Seed sample ID            |
+|sample      |          |      |                  |                          |
++------------+----------+------+------------------+--------------------------+
+|Fault       |Bool      |      |                  |Fault on environmental    |
+|            |          |      |                  |sensor                    |
++------------+----------+------+------------------+--------------------------+
+|Light       |Decimal   |klx   | 0 - 100          |Light at plot             |
++------------+----------+------+------------------+--------------------------+
+|Humidity    |Decimal   |g/m³  | 0.5 - 52.0       |Abs humidity at plot      |
++------------+----------+------+------------------+--------------------------+
+|Temperature |Decimal   |°C    | 4 - 40           |Temperature at plot       |
++------------+----------+------+------------------+--------------------------+
+|Blossoms    |Int       |      | 0 - 1000         |Number of blossoms in plot|
++------------+----------+------+------------------+--------------------------+
+|Fruit       |Int       |      | 0 - 1000         |Number of fruits in plot  |
++------------+----------+------+------------------+--------------------------+
+|Plants      |Int       |      | 0 - 20           |Number of plants in plot  |
++------------+----------+------+------------------+--------------------------+
+|Max height  |Decimal   |cm    | 0 - 1000         |Height of tallest plant in|
+|            |          |      |                  |plot                      |
++------------+----------+------+------------------+--------------------------+
+|Min height  |Decimal   |cm    | 0 - 1000         |Height of shortest plant  |
+|            |          |      |                  |in plot                   |
++------------+----------+------+------------------+--------------------------+
+|Median      |Decimal   |cm    | 0 - 1000         |Median height of plants in|
+|height      |          |      |                  |plot                      |
++------------+----------+------+------------------+--------------------------+
+|Notes       |String    |      |                  |Miscellaneous notes       |
++------------+----------+------+------------------+--------------------------+

Chapter03/boilerplate.py

@@ -0,0 +1,12 @@
+import tkinter as tk
+from tkinter import ttk
+
+# Start coding here
+
+
+class Application(tk.Tk):
+    """Application root window"""
+
+if __name__ == "__main__":
+    app = Application()
+    app.mainloop()

Chapter03/button_example.py

@@ -0,0 +1,14 @@
+import tkinter as tk
+from tkinter import ttk
+
+parent = tk.Tk()
+
+tvar = tk.StringVar()
+def swaptext():
+    tvar.set('There' if tvar.get() == 'Hi' else 'Hi')
+
+my_button = ttk.Button(parent, textvariable=tvar, command=swaptext)
+my_button.pack()
+
+
+parent.mainloop()

Chapter03/checkbutton_example.py

@@ -0,0 +1,12 @@
+import tkinter as tk
+from tkinter import ttk
+
+parent = tk.Tk()
+my_boolean_var = tk.BooleanVar()
+
+my_checkbutton = ttk.Checkbutton(
+    text="Check to make this option True",
+    variable=my_boolean_var
+)
+my_checkbutton.pack()
+parent.mainloop()

Chapter03/combobox_example.py

@@ -0,0 +1,13 @@
+import tkinter as tk
+from tkinter import ttk
+
+parent = tk.Tk()
+my_string_var = tk.StringVar()
+
+combobox = ttk.Combobox(
+    parent,
+    textvariable=my_string_var,
+    values=["Option 1", "Option 2", "Option 3"]
+)
+combobox.pack()
+parent.mainloop()