Only run HTTP with --serve; use --open for browser

Author: maxkapur

README.md

@@ -9,11 +9,14 @@ The script uses only the standard library and `requests`, so in most
 environments (e.g. Ubuntu) you can just run the script in your shell:
 
 ```
+# Open docs in web browser
+./fetch_python_docs.py --open
+# Start the web server but don't open anything
 ./fetch_python_docs.py --serve
+# Just downlaod/extract docs
+./fetch_python_docs.py
 ```
 
-Omit `--serve` to only download and extract.
-
 ## Why not just use `pydoc -b`?
 
 The color scheme.

fetch_python_docs.py

@@ -18,7 +18,12 @@
     parser = argparse.ArgumentParser(
         description="Idempotently download/serve Python docs from a local copy"
     )
-    parser.add_argument("--serve", action="store_true")
+    parser.add_argument(
+        "--serve", action="store_true", help="Serve docs over HTTP on port 8004"
+    )
+    parser.add_argument(
+        "--open", action="store_true", help="Serve and open the docs in the browser"
+    )
     parsed = parser.parse_args()
 
     major, minor, *_ = sys.version_info
@@ -46,14 +51,15 @@
             f.extractall(path=HERE, filter="data")  # Extracting HERE creates outdir
         assert (outdir / "index.html").is_file()
 
-    if parsed.serve:
+    if parsed.serve or parsed.open:
         # Use a different port from 8000 to avoid conflicting with other
         # instances of http.server
         server = subprocess.Popen(
             [sys.executable, "-m", "http.server", "-d", outdir.absolute(), "8004"]
         )
-        time.sleep(0.5)
-        webbrowser.open("http://localhost:8004")
+        if parsed.open:
+            time.sleep(0.5)
+            webbrowser.open("http://localhost:8004")
 
         try:
             server.wait()