Refactor error handling and improve logging (#13000)

* Refactor error handling and improve logging

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

* httpx --> httpx2

* updating DIRECTORY.md

* Replace httpx with httpx2 for HTTP requests

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Christian Clauss <cclauss@me.com>
Co-authored-by: cclauss <cclauss@users.noreply.github.com>

Author: 3 people

DIRECTORY.md

@@ -481,6 +481,7 @@
   * [Longest Increasing Subsequence Iterative](dynamic_programming/longest_increasing_subsequence_iterative.py)
   * [Longest Increasing Subsequence O Nlogn](dynamic_programming/longest_increasing_subsequence_o_nlogn.py)
   * [Longest Palindromic Subsequence](dynamic_programming/longest_palindromic_subsequence.py)
+  * [Longest Repeating Subsequence](dynamic_programming/longest_repeating_subsequence.py)
   * [Matrix Chain Multiplication](dynamic_programming/matrix_chain_multiplication.py)
   * [Matrix Chain Order](dynamic_programming/matrix_chain_order.py)
   * [Max Non Adjacent Sum](dynamic_programming/max_non_adjacent_sum.py)

web_programming/covid_stats_via_xpath.py

@@ -3,6 +3,8 @@
 Worldometers archive site using lxml. lxml is chosen over BeautifulSoup
 for its speed and convenience in Python web projects (such as Django or
 Flask).
+
+uv run --script web_programming/covid_stats_via_xpath.py
 """
 
 # /// script
@@ -12,7 +14,10 @@
 #     "lxml",
 # ]
 # ///
+from __future__ import annotations
 
+import argparse
+import logging
 from typing import NamedTuple
 
 import httpx2
@@ -35,25 +40,47 @@ def covid_stats(
     try:
         response = httpx2.get(url, timeout=10).raise_for_status()
     except httpx2.TimeoutException:
-        print(
+        logging.error(
             "Request timed out. Please check your network connection "
             "or try again later."
         )
         return CovidData("N/A", "N/A", "N/A")
     except httpx2.HTTPStatusError as e:
-        print(f"HTTP error occurred: {e}")
+        logging.error(f"HTTP error occurred: {e}")
         return CovidData("N/A", "N/A", "N/A")
-    data = html.fromstring(response.content).xpath(xpath_str)
+    data: list[str] = html.fromstring(response.content).xpath(xpath_str)
     if len(data) != 3:
-        print("Unexpected data format. The page structure may have changed.")
-        data = "N/A", "N/A", "N/A"
+        logging.warning("Unexpected data format. The page structure may have changed.")
+        return CovidData("N/A", "N/A", "N/A")
+
     return CovidData(*data)
 
 
-if __name__ == "__main__":
+def main() -> None:
+    """CLI entry point."""
+    parser = argparse.ArgumentParser(
+        description="Fetch COVID-19 statistics from Worldometers (archived)."
+    )
+    parser.add_argument(
+        "--url",
+        type=str,
+        default=(
+            "https://web.archive.org/web/20250825095350/"
+            "https://www.worldometers.info/coronavirus/"
+        ),
+        help="Custom archive URL (default: latest snapshot).",
+    )
+    # args = parser.parse_args()
+    args, _ = parser.parse_known_args()
+
+    stats = covid_stats(args.url)
     fmt = (
         "Total COVID-19 cases in the world: {}\n"
         "Total deaths due to COVID-19 in the world: {}\n"
         "Total COVID-19 patients recovered in the world: {}"
     )
-    print(fmt.format(*covid_stats()))
+    print(fmt.format(*stats))
+
+
+if __name__ == "__main__":
+    main()