SDC Types Rework (#686)

Updates for CodeYourFuture/curriculum#2018

Adds the latest prep tasks as individual files for submission

Adds a new stretch task to replace the old laptop allocation one

---------

Co-authored-by: l <l>

Author: LonMcGregor

types-stretch/README.md

@@ -0,0 +1,15 @@
+# Sprint 5 Stretch - Radio Control App
+
+This is part of an app that can be used to control an online radio station
+
+Your task is to:
+1. Add type annotations where appropriate.
+1. Upgrade everything use dataclasses. Use `frozen` where appropriate.
+1. Observe how the given `__str__` method works, and add one to the other classes
+1. When the `__str__` method is called, have it print the duration in formatted mm:ss rather than just seconds
+1. Add a new class of `Person` - you can use your imagination what this includes, but it should have at least a string name
+1. Turn the fields for _artists_, _host_, and _guest_ into `Person` classes
+1. Make a new class `Podcast` that _extends_ the `TalkShow` class, with an extra string field for _sponsor_
+1. Finish implementing the class `Playlist`, and set it to takes a generic, e.g. either `Song` or `TalkShow` or `Podcast`
+
+As you implement, make sure to keep checking with mypy and add your own code at the end to test it works correctly

types-stretch/requirements.txt

@@ -0,0 +1 @@
+mypy

types-stretch/stretch-radio.py

@@ -0,0 +1,43 @@
+class Song:
+	def __init__(self, artist, duration, title):
+		self.artist = artist # should be a string
+		self.duration = duration # should be an integer in seconds
+		self.title = title # should be a string
+
+	def __str__(self):
+		return f"{self.artist} - {self.title} ({self.duration})"
+
+class TalkShow:
+	def __init__(self, host, guests, duration, title):
+		self.host = host # should be a string
+		self.guests = guests # should be a list of strings
+		self.duration = duration # should be an integer in seconds
+		self.title = title # should be a string
+
+class Playlist:
+	def __init__(self, items):
+		self.items = items # A list of Song or TalkShow
+		self.currently_playing_index = 0
+
+	def play_next(self):
+		pass
+		# TODO: increment the currently_playing_index, when you get to the end loop back to 0
+
+	def get_currently_playing(self):
+		return "todo"
+		# TODO: return a string representation of whatever is playing at the current index
+		# See the __str__ method in Song for an example of how to make a string representation of a class
+
+	def get_total_duration(self):
+		return 0
+		# TODO: return
+
+song_a = Song("Rick Astley", 210, "Never Gonna Give You Up")
+print(song_a)
+
+song_b = Song("Psy", 219, "Gangnam Style")
+funny_songs = Playlist([song_a, song_b])
+print(funny_songs.get_currently_playing())
+
+show_a = TalkShow("Melvyn Bragg", ["Jim Al-Khalili", "Sheila Rowan", "Carolin Crawford"], 2700, "Gravitational Waves")
+

types/01-predict.py

@@ -0,0 +1,41 @@
+def half(value):
+    return value / 2
+
+def double(value):
+    return value * 2
+
+def second(value):
+    return value[1]
+
+# TASK 1:
+# 1. Predict what you think will happen with each of the following functions
+# 2. Then, test it, and explain in your own words what is actually happening and why
+# (feel free to comment out lines if you think they cause errors or crashes while testing)
+
+print(half(22))
+# Prediction:
+# What actually happens and why:
+
+print(half("22"))
+# Prediction:
+# What actually happens and why:
+
+print(double(22))
+# Prediction:
+# What actually happens and why:
+
+print(double("22"))
+# Prediction:
+# What actually happens and why:
+
+print(second(22))
+# Prediction:
+# What actually happens and why:
+
+print(second(0x16))
+# Prediction:
+# What actually happens and why:
+
+print(second("22"))
+# Prediction:
+# What actually happens and why:

types/02-playcomputer.js

@@ -0,0 +1,29 @@
+import process from "node:process";
+import readline from "node:readline";
+
+const rl = readline.createInterface({
+	input: process.stdin,
+	output: process.stdout,
+});
+
+rl.question("What URL should we fetch?\n> ", async (url) => {
+	const response = await fetch(url);
+	if (!response.ok) {
+		if (response.body.toLowerCase().includes("permission")) {
+			console.error("You didn't have permission to get that URL");
+		} else {
+			console.error(`The request failed - body: ${response.body}`);
+		}
+		process.exit(1);
+	}
+
+	const contents = await response.json();
+
+	console.log(contents);
+
+	rl.close();
+});
+
+// TASK 2
+// Read through this file and predict what it does.
+// Leave a comment on any lines if you spot any errors, offering an explanation of the problem.

types/03-fix.py

@@ -0,0 +1,9 @@
+def double(number):
+    return number * 3
+
+print(double(10))
+
+# TASK 3:
+# Read the code and see if you can find any bugs.
+# Write down what the bug is, and how would you fix it?
+# Are there multiple ways you could fix it?

types/04-addmypy.py

@@ -0,0 +1,37 @@
+def open_account(balances, name, amount):
+    balances[name] = amount
+
+def sum_balances(accounts):
+    total = 0
+    for name, pence in accounts.items():
+        print(f"{name} had balance {pence}")
+        total += pence
+    return total
+
+def format_pence_as_string(total_pence):
+    if total_pence < 100:
+        return f"{total_pence}p"
+    pounds = int(total_pence / 100)
+    pence = total_pence % 100
+    return f"£{pounds}.{pence:02d}"
+
+balances = {
+    "Sima": 700,
+    "Linn": 545,
+    "Georg": 831,
+}
+
+open_account("Tobi", 9.13)
+open_account("Olya", "£7.13")
+
+total_pence = sum_balances(balances)
+total_string = format_pence_as_str(total_pence)
+
+print(f"The bank accounts total {total_string}")
+
+# TASK 4
+# This code contains bugs related to types. They are bugs mypy can catch.
+# Read this code to understand what it's trying to do.
+# Add type annotations to the method parameters and return types of this code.
+# Run the code through mypy, and fix all of the bugs that show up.
+# When you're confident all of the type annotations are correct, and the bugs are fixed, run the code and check it works.

types/05-predict.py

@@ -0,0 +1,24 @@
+imran = {
+  "name": "Imran",
+  "age": 22,
+  "preferred_operating_system": "Ubuntu",
+}
+
+eliza = {
+  "name": "Eliza",
+  "age": 34,
+  "preferred_operating_system": "Arch Linux",
+}
+
+
+print(imran["name"])
+print(imran["address"])
+
+# TASK 5:
+# This code contains some untyped objects.
+# Try checking it with mypy before running the code and predict what you think will happen when you run the code.
+#
+# Prediction:
+#
+# Can you explain what actualy happens?
+#

types/06-classes.py

@@ -0,0 +1,27 @@
+class Person:
+    def __init__(self, name: str, age: int, preferred_operating_system: str):
+        self.name = name
+        self.age = age
+        self.preferred_operating_system = preferred_operating_system
+
+imran = Person("Imran", 22, "Ubuntu")
+print(imran.name)
+print(imran.address)
+
+eliza = Person("Eliza", 34, "Arch Linux")
+print(eliza.name)
+print(eliza.address)
+
+# TASK 6.1:
+# Run mypy and fix any errors.
+
+# TASK 6.2:
+# Create a new function in this file called likes_apple
+# It should take a person as parameter
+# It returns true if the preferred operating system is "macOS" or "iOS"
+# It should return false for any other preferred os
+# Add all the appropriate type annotations and test it has no errors in mypy
+
+# TASK 6.3:
+# Compare objects and classes
+# What are some advantages and disadvantages of each?

types/07-methods.txt

@@ -0,0 +1,5 @@
+TASK 7:
+Answer the following questions:
+What is the difference between a method and a function?
+Can you give some advantages of methods over functions?
+