Add sample code for Nuitka standalone executable tutorial

nuitka/README.md

@@ -0,0 +1,29 @@
+# Nuitka: Compile Python Into a Standalone Executable
+
+Sample code for the Real Python tutorial on [compiling Python applications with Nuitka](https://realpython.com/nuitka/).
+
+## Files
+
+- `wordcount.py`: A small command-line tool that counts the most common words in a text file
+- `sample.txt`: Sample text used to test `wordcount.py`
+- `cpu_benchmark.py`: A CPU-bound benchmark script used to compare runtime performance across regular Python, `--mode=standalone`, and `--mode=onefile` builds
+
+## Usage
+
+Install Nuitka:
+
+```console
+$ python -m pip install nuitka==4.2.1
+```
+
+Compile `wordcount.py`:
+
+```console
+$ python -m nuitka --mode=standalone wordcount.py
+```
+
+Run the compiled executable against `sample.txt`:
+
+```console
+$ ./wordcount.dist/wordcount.bin sample.txt -n 5
+```

nuitka/cpu_benchmark.py

@@ -0,0 +1,30 @@
+import time
+
+
+def is_prime(number):
+    if number < 2:
+        return False
+
+    for divisor in range(2, number):
+        if number % divisor == 0:
+            return False
+
+    return True
+
+
+def main():
+    start = time.perf_counter()
+
+    count = 0
+    for number in range(2, 100_000):
+        if is_prime(number):
+            count += 1
+
+    elapsed = time.perf_counter() - start
+
+    print(f"Primes found: {count}")
+    print(f"Time: {elapsed:.3f}s")
+
+
+if __name__ == "__main__":
+    main()

nuitka/sample.txt

@@ -0,0 +1,2 @@
+Python is popular because Python is easy to learn and easy to use.
+Python is also popular for data science and automation.

nuitka/wordcount.py

@@ -0,0 +1,21 @@
+from argparse import ArgumentParser
+from collections import Counter
+from pathlib import Path
+
+
+def main():
+    parser = ArgumentParser(
+        description="Show the most common words in a text file."
+    )
+    parser.add_argument("file", type=Path)
+    parser.add_argument("-n", "--top", type=int, default=5)
+    args = parser.parse_args()
+
+    words = args.file.read_text(encoding="utf-8").lower().split()
+
+    for word, count in Counter(words).most_common(args.top):
+        print(f"{word}: {count}")
+
+
+if __name__ == "__main__":
+    main()