Sample code for: Python sleep(): How to Add Time Delays to Your Code (#769)

* Sample code for: Python sleep(): How to Add Time Delays to Your Code

* Final QA

---------

Co-authored-by: Bartosz Zaczyński <bartosz.zaczynski@gmail.com>

Author: lpozo

python-sleep/README.md

@@ -0,0 +1,3 @@
+# Python sleep(): How to Add Time Delays to Your Code
+
+This folder provides the code examples for the Real Python tutorial [Python sleep(): How to Add Time Delays to Your Code](https://realpython.com/python-sleep/)

python-sleep/coffee.py

@@ -0,0 +1,6 @@
+import time
+
+print("Brewing coffee...")
+print("This would take like 3 secs...")
+time.sleep(3)
+print("Done! Your coffee is ready!")

python-sleep/download.py

@@ -0,0 +1,18 @@
+import urllib.error
+import urllib.request
+
+from utils import retry
+
+
+@retry(delay=3)
+def download_file(url):
+    try:
+        response = urllib.request.urlopen(url)
+        print(f"Downloaded {url} ({response.length} bytes)")
+    except urllib.error.URLError as e:
+        print(f"Download failed: {e.reason}")
+        raise
+
+
+if __name__ == "__main__":
+    download_file("http://www.example.com/data.csv")

python-sleep/frozen_app.py

@@ -0,0 +1,17 @@
+import time
+import tkinter
+
+DELAY = 3  # Sleep for 3 seconds
+
+
+def on_click():
+    time.sleep(DELAY)
+    print("Done!")
+
+
+root = tkinter.Tk()
+root.geometry("400x400")
+button = tkinter.Button(text="Click me!", command=on_click)
+button.pack()
+
+root.mainloop()

python-sleep/hello_async.py

@@ -0,0 +1,11 @@
+import asyncio
+
+
+async def main():
+    print("Hello ...")
+    await asyncio.sleep(1)
+    print("... World!")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

python-sleep/rate_limited.py

@@ -0,0 +1,26 @@
+import asyncio
+
+import aiohttp
+
+RATE_LIMIT_DELAY = 1  # Seconds between API requests
+
+
+async def fetch_page(session, url):
+    async with session.get(url) as response:
+        print(f"{url} ({response.status})")
+    await asyncio.sleep(RATE_LIMIT_DELAY)
+
+
+async def main():
+    urls = [
+        "https://httpbin.org/get",
+        "https://httpbin.org/ip",
+        "https://httpbin.org/headers",
+    ]
+    async with aiohttp.ClientSession() as session:
+        for url in urls:
+            await fetch_page(session, url)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

python-sleep/requirements.txt

@@ -0,0 +1,9 @@
+aiohappyeyeballs==2.6.2
+aiohttp==3.13.5
+aiosignal==1.4.0
+attrs==26.1.0
+frozenlist==1.8.0
+idna==3.15
+multidict==6.7.1
+propcache==0.5.2
+yarl==1.24.2

python-sleep/responsive_app.py

@@ -0,0 +1,15 @@
+import tkinter
+
+DELAY = 3000  # The after() method takes milliseconds (3000 ms = 3 seconds)
+
+
+def on_click():
+    root.after(DELAY, lambda: print("Done!"))
+
+
+root = tkinter.Tk()
+root.geometry("400x400")
+button = tkinter.Button(text="Click me!", command=on_click)
+button.pack()
+
+root.mainloop()

python-sleep/sleep_use.py

@@ -0,0 +1,10 @@
+import time
+
+# Sleep for 3 seconds
+time.sleep(3)
+
+# Pass fractional seconds for shorter delays
+time.sleep(0.5)  # Wait 500 milliseconds
+time.sleep(0.001)  # Wait 1 millisecond
+time.sleep(1.5)  # Wait 1.5 seconds
+time.sleep(60)  # Wait 1 minute

python-sleep/thread_monitor.py

@@ -0,0 +1,37 @@
+import logging
+import threading
+
+WORKER_INTERVAL = 1  # Seconds between worker check-ins
+MAIN_INTERVAL = 0.75  # Seconds between main thread check-ins
+
+
+def worker(event):
+    while not event.is_set():
+        logging.debug("Worker thread checking in")
+        event.wait(WORKER_INTERVAL)
+
+
+def main():
+    logging.basicConfig(
+        level=logging.DEBUG,
+        format="{relativeCreated:>6,.0f} ms | {threadName:<18} | {message}",
+        style="{",
+    )
+    event = threading.Event()
+
+    thread_one = threading.Thread(target=worker, args=(event,))
+    thread_two = threading.Thread(target=worker, args=(event,))
+    thread_one.start()
+    thread_two.start()
+
+    while not event.is_set():
+        try:
+            logging.debug("Main thread checking in")
+            event.wait(MAIN_INTERVAL)
+        except KeyboardInterrupt:
+            event.set()
+            break
+
+
+if __name__ == "__main__":
+    main()