Merge branch 'master' into python-pyqt-tutorial-update

KateFinegan · web-flow · commit 46e112923ac7 · 2022-08-22T11:53:53.000-06:00
diff --git a/html-css-python/README.md b/html-css-python/README.md
@@ -0,0 +1,3 @@
+# HTML and CSS for Python Developers
+
+Supplemental materials for the [tutorial on HTML and CSS for Python Developers](https://realpython.com/html-css-python/) hosted on Real Python.
diff --git a/html-css-python/html_boilerplate/index.html b/html-css-python/html_boilerplate/index.html
@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>HTML Boilerplate</title>
+    <link rel="stylesheet" href="style.css">
+</head>
+<body>
+
+    <!-- Your Content -->
+
+</body>
+</html>
diff --git a/html-css-python/html_boilerplate/style.css b/html-css-python/html_boilerplate/style.css
@@ -0,0 +1 @@
+/* Add your CSS styles in this file */
diff --git a/html-css-python/html_project/emoji.html b/html-css-python/html_project/emoji.html
@@ -0,0 +1,38 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>My favorite emoji</title>
+    <link rel="stylesheet" href="https://cdn.simplecss.org/simple.css">
+    <link rel="stylesheet" href="style.css">
+</head>
+<body>
+<nav>
+    <a href="index.html">Home</a>
+    <a href="images/gallery.html">Gallery</a>
+</nav>
+<h1>My favorite emoji</h1>
+<p>I don't just <em>like</em> emoji,<br>
+I <strong>love</strong> emoji!</p>
+<p>Here's a table of my most-used emoji:</p>
+<table>
+<thead>
+<tr><th>#</th><th>Emoji</th><th>Name</th></tr>
+</thead>
+<tbody>
+<tr><td>1.</td><td>🐞</td><td>Lady Beetle</td></tr>
+<tr><td>2.</td><td>🐍</td><td>Snake</td></tr>
+<tr><td>3.</td><td>👍</td><td>Thumbs Up Sign</td></tr>
+<tr><td>4.</td><td>🎉</td><td>Party Popper</td></tr>
+<tr><td>5.</td><td>🤩</td><td>Grinning Face With Star Eyes</td></tr>
+<tr><td>6.</td><td>😂</td><td>Face With Tears Of Joy</td></tr>
+<tr><td>7.</td><td>🐶</td><td>Dog Face</td></tr>
+<tr><td>8.</td><td>🍿</td><td>Popcorn</td></tr>
+<tr><td>9.</td><td>😎</td><td>Smiling Face With Sunglasses</td></tr>
+<tr><td>10.</td><td>✨</td><td>Sparkles</td></tr>
+<tr><td>11.</td><td>💬</td><td>Speech Balloon</td></tr>
+<tr><td>12.</td><td>😘</td><td>Face Throwing A Kiss</td></tr>
+</tbody>
+</table>
+</body>
+</html>
diff --git a/html-css-python/html_project/images/gallery.html b/html-css-python/html_project/images/gallery.html
@@ -0,0 +1,24 @@
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="utf-8">
+    <title>Image gallery</title>
+    <link rel="stylesheet" href="https://cdn.simplecss.org/simple.css">
+    <link rel="stylesheet" href="../style.css">
+</head>
+
+<body>
+    <nav>
+        <a href="../index.html">Home</a>
+        <a href="../emoji.html">Emoji</a>
+    </nav>
+    <h1>Image gallery</h1>
+    <div class="gallery rounded">
+        <img src="sky_1.png" alt="Cloudy sky."  class="rounded">
+        <img src="sky_2.png" alt="Sun shining through a cloudy sky."  class="rounded">
+        <img src="sky_3.png" alt="Sky with almost no clouds."  class="rounded">
+    </div>
+</body>
+
+</html>
diff --git a/html-css-python/html_project/images/sky_1.png b/html-css-python/html_project/images/sky_1.png
diff --git a/html-css-python/html_project/images/sky_2.png b/html-css-python/html_project/images/sky_2.png
diff --git a/html-css-python/html_project/images/sky_3.png b/html-css-python/html_project/images/sky_3.png
diff --git a/html-css-python/html_project/index.html b/html-css-python/html_project/index.html
@@ -0,0 +1,28 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>Hello, World!</title>
+    <link rel="stylesheet" href="https://cdn.simplecss.org/simple.css">
+    <link rel="stylesheet" href="style.css">
+</head>
+<body>
+    <nav>
+        <a href="emoji.html">Emoji</a>
+        <a href="images/gallery.html">Gallery</a>
+    </nav>
+    <h1>Hello, World Wide Web!</h1>
+    <p>This is my first website.</p>
+
+    <h2>About me</h2>
+    <p>I'm a Python programmer and bug collector.</p>
+
+    <h2>Links</h2>
+    <p>My favorite websites are:</p>
+    <ul>
+        <li><a href="https://www.realpython.com">realpython.com</a></li>
+        <li><a href="https://www.python.org">python.org</a></li>
+        <li><a href="https://www.pypi.org">pypi.org</a></li>
+    <ul>
+</body>
+</html>
diff --git a/html-css-python/html_project/style.css b/html-css-python/html_project/style.css
@@ -0,0 +1,37 @@
+body {
+    background-color: rgb(20, 40, 60);
+    color: rgb(240, 248, 255);
+    font-family: "Helvetica", "Arial", sans-serif;
+    font-size: 1.3em;
+}
+
+a {
+    color: rgb(255, 111, 111);
+}
+
+.gallery {
+    background: rgba(255, 255, 255, 0.2);
+    padding: 1em;
+}
+
+.rounded {
+    border-radius: 15px;
+}
+
+.gallery img {
+    margin-right: 0.2em;
+    width: 150px;
+}
+
+th,
+tr:nth-child(even) {
+    background-color: rgba(255, 255, 255, 0.2);
+}
+
+td:nth-child(1) {
+    text-align: right;
+}
+
+td:nth-child(2) {
+    text-align: center;
+}
diff --git a/html-css-python/python_scripts/emoji_table.py b/html-css-python/python_scripts/emoji_table.py
@@ -0,0 +1,16 @@
+import unicodedata
+
+all_emoji = "🐞🐍👍🎉🤩😂🐶🍿😎✨💬😘"
+columns = ["#", "Emoji", "Name"]
+
+table_head = (
+    f"<thead>\n<tr><th>{'</th><th>'.join(columns)}</th></tr>\n</thead>"
+)
+
+table_body = "\n<tbody>\n"
+for i, emoji in enumerate(all_emoji, start=1):
+    emoji_data = [f"{i}.", emoji, unicodedata.name(emoji).title()]
+    table_body += f"<tr><td>{'</td><td>'.join(emoji_data)}</td></tr>\n"
+table_body += "</tbody>\n"
+
+print(f"<table>\n{table_head}{table_body}</table>")
diff --git a/html-css-python/python_scripts/parse_image_links.py b/html-css-python/python_scripts/parse_image_links.py
@@ -0,0 +1,19 @@
+"""
+Note: Place this Python file next to gallery.html
+"""
+
+from html.parser import HTMLParser
+
+
+class ImageParser(HTMLParser):
+    def handle_starttag(self, tag, attrs):
+        for attr, val in attrs:
+            if attr == "src" and tag == "img":
+                print(f"Found Image: {val!r}")
+
+
+with open("gallery.html", mode="r", encoding="utf-8") as html_file:
+    html_content = html_file.read()
+
+parser = ImageParser()
+parser.feed(html_content)
diff --git a/python-inherit-list-userlist/README.md b/python-inherit-list-userlist/README.md
@@ -0,0 +1,4 @@
+# Custom Python Lists: Inheriting From list vs UserList
+
+This folder provides the code examples for the article [Custom Python Lists: Inheriting From list vs UserList
+](https://realpython.com/inherit-python-list/).
diff --git a/python-inherit-list-userlist/custom_list1.py b/python-inherit-list-userlist/custom_list1.py
@@ -0,0 +1,13 @@
+class CustomList(list):
+    def join(self, separator=" "):
+        return separator.join(str(item) for item in self)
+
+    def map(self, action):
+        return type(self)(action(item) for item in self)
+
+    def filter(self, predicate):
+        return type(self)(item for item in self if predicate(item))
+
+    def for_each(self, func):
+        for item in self:
+            func(item)
diff --git a/python-inherit-list-userlist/custom_list2.py b/python-inherit-list-userlist/custom_list2.py
@@ -0,0 +1,16 @@
+from collections import UserList
+
+
+class CustomList(UserList):
+    def join(self, separator=" "):
+        return separator.join(str(item) for item in self)
+
+    def map(self, action):
+        return type(self)(action(item) for item in self.data)
+
+    def filter(self, predicate):
+        return type(self)(item for item in self if predicate(item))
+
+    def for_each(self, func):
+        for item in self.data:
+            func(item)
diff --git a/python-inherit-list-userlist/number_list1.py b/python-inherit-list-userlist/number_list1.py
@@ -0,0 +1,23 @@
+class NumberList(list):
+    def __init__(self, iterable):
+        super().__init__(self._validate_number(item) for item in iterable)
+
+    def __setitem__(self, index, item):
+        super().__setitem__(index, self._validate_number(item))
+
+    def insert(self, index, item):
+        super().insert(index, self._validate_number(item))
+
+    def append(self, item):
+        super().append(self._validate_number(item))
+
+    def extend(self, other):
+        if isinstance(other, type(self)):
+            super().extend(other)
+        else:
+            super().extend(self._validate_number(item) for item in other)
+
+    def _validate_number(self, value):
+        if isinstance(value, (int, float, complex)):
+            return value
+        raise TypeError(f"numeric value expected, got {type(value).__name__}")
diff --git a/python-inherit-list-userlist/number_list2.py b/python-inherit-list-userlist/number_list2.py
@@ -0,0 +1,26 @@
+from collections import UserList
+
+
+class NumberList(UserList):
+    def __init__(self, iterable):
+        super().__init__(self._validate_number(item) for item in iterable)
+
+    def __setitem__(self, index, item):
+        self.data[index] = self._validate_number(item)
+
+    def insert(self, index, item):
+        self.data.insert(index, self._validate_number(item))
+
+    def append(self, item):
+        self.data.append(self._validate_number(item))
+
+    def extend(self, other):
+        if isinstance(other, type(self)):
+            self.data.extend(other)
+        else:
+            self.data.extend(self._validate_number(item) for item in other)
+
+    def _validate_number(self, value):
+        if isinstance(value, (int, float, complex)):
+            return value
+        raise TypeError(f"numeric value expected, got {type(value).__name__}")
diff --git a/python-inherit-list-userlist/performance.py b/python-inherit-list-userlist/performance.py
@@ -0,0 +1,74 @@
+import timeit
+from collections import UserList
+
+
+class StringList_list(list):
+    def __init__(self, iterable):
+        super().__init__(str(item) for item in iterable)
+
+    def __setitem__(self, index, item):
+        super().__setitem__(index, str(item))
+
+    def insert(self, index, item):
+        super().insert(index, str(item))
+
+    def append(self, item):
+        super().append(str(item))
+
+    def extend(self, other):
+        if isinstance(other, type(self)):
+            super().extend(other)
+        else:
+            super().extend(str(item) for item in other)
+
+
+class StringList_UserList(UserList):
+    def __init__(self, iterable):
+        super().__init__(str(item) for item in iterable)
+
+    def __setitem__(self, index, item):
+        self.data[index] = str(item)
+
+    def insert(self, index, item):
+        self.data.insert(index, str(item))
+
+    def append(self, item):
+        self.data.append(str(item))
+
+    def extend(self, other):
+        if isinstance(other, type(self)):
+            self.data.extend(other)
+        else:
+            self.data.extend(str(item) for item in other)
+
+
+init_data = range(10000)
+
+extended_list = StringList_list(init_data)
+list_extend = (
+    min(
+        timeit.repeat(
+            stmt="extended_list.extend(init_data)",
+            number=5,
+            repeat=2,
+            globals=globals(),
+        )
+    )
+    * 1e6
+)
+
+extended_user_list = StringList_UserList(init_data)
+user_list_extend = (
+    min(
+        timeit.repeat(
+            stmt="extended_user_list.extend(init_data)",
+            number=5,
+            repeat=2,
+            globals=globals(),
+        )
+    )
+    * 1e6
+)
+
+print(f"StringList_list().extend() time: {list_extend:.2f} μs")
+print(f"StringList_UserList().extend() time: {user_list_extend:.2f} μs")
diff --git a/python-inherit-list-userlist/string_list1.py b/python-inherit-list-userlist/string_list1.py
@@ -0,0 +1,18 @@
+class StringList(list):
+    def __init__(self, iterable):
+        super().__init__(str(item) for item in iterable)
+
+    def __setitem__(self, index, item):
+        super().__setitem__(index, str(item))
+
+    def insert(self, index, item):
+        super().insert(index, str(item))
+
+    def append(self, item):
+        super().append(str(item))
+
+    def extend(self, other):
+        if isinstance(other, type(self)):
+            super().extend(other)
+        else:
+            super().extend(str(item) for item in other)
diff --git a/python-inherit-list-userlist/string_list2.py b/python-inherit-list-userlist/string_list2.py
@@ -0,0 +1,21 @@
+from collections import UserList
+
+
+class StringList(UserList):
+    def __init__(self, iterable):
+        super().__init__(str(item) for item in iterable)
+
+    def __setitem__(self, index, item):
+        self.data[index] = str(item)
+
+    def insert(self, index, item):
+        self.data.insert(index, str(item))
+
+    def append(self, item):
+        self.data.append(str(item))
+
+    def extend(self, other):
+        if isinstance(other, type(self)):
+            self.data.extend(other)
+        else:
+            self.data.extend(str(item) for item in other)

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+# HTML and CSS for Python Developers`
	`2`	`+`
	`3`	`+Supplemental materials for the [tutorial on HTML and CSS for Python Developers](https://realpython.com/html-css-python/) hosted on Real Python.`