Coverage improvements and CI fixes

Author: SamuelMarks

run_manual_test.py

@@ -1,3 +1,5 @@
+"""Manual test script for AST test extraction."""
+
 import libcst as cst
 from openapi_client.tests.parse import ASTTestExtractor
 from openapi_client.models import OpenAPI

scripts/__init__.py

@@ -0,0 +1 @@
+"""Scripts package."""

scripts/build_wasm.py

@@ -1,8 +1,11 @@
+"""Build script for WebAssembly bundle."""
+
 import os
 import subprocess
 
 
 def main():
+    """Build WASI output or fallback to zip bundle."""
     os.makedirs("bin", exist_ok=True)
     wasm_out = os.path.join("bin", "cdd-python-all.wasm")
 

scripts/doc_coverage.py

@@ -1,8 +1,11 @@
+"""Module for calculating docstring coverage."""
+
 import ast
 import os
 
 
 def calculate_doc_coverage(directory):
+    """Calculate the percentage of functions, classes, and modules with docstrings."""
     total = 0
     with_docs = 0
 

scripts/run_generated_server_test.py

@@ -1,3 +1,5 @@
+"""Run generated server tests."""
+
 import os
 import sys
 import shutil
@@ -8,13 +10,15 @@
 
 
 def find_free_port():
+    """Find a free port on localhost."""
     with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
         s.bind(("", 0))
         s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
         return s.getsockname()[1]
 
 
 def main():
+    """Main execution of the server test."""
     test_harness_dir = os.environ.get(
         "TEST_HARNESS_DIR", os.path.expanduser("~/repos/cdd-openapi-test-harness")
     )

scripts/run_petstore_test.py

@@ -1,3 +1,5 @@
+"""Run tests against the Petstore server."""
+
 import os
 import sys
 import shutil
@@ -7,13 +9,15 @@
 
 
 def find_free_port():
+    """Find a free port on localhost."""
     with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
         s.bind(("", 0))
         s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
         return s.getsockname()[1]
 
 
 def main():
+    """Main execution of the petstore test."""
     test_harness_dir = os.environ.get(
         "TEST_HARNESS_DIR", os.path.expanduser("~/repos/cdd-openapi-test-harness")
     )

scripts/update_badges.py

@@ -1,3 +1,5 @@
+"""Update test and doc coverage badges in README.md."""
+
 #!/usr/bin/env python3
 import os
 import re
@@ -6,6 +8,7 @@
 
 
 def get_color(pct):
+    """Return a color for a given coverage percentage."""
     if pct >= 90:
         return "brightgreen"
     if pct >= 80:
@@ -20,6 +23,7 @@ def get_color(pct):
 
 
 def main():
+    """Run tests, calculate coverage, and update badges in README.md."""
     readme_path = os.path.join(os.path.dirname(__file__), "..", "README.md")
     if not os.path.exists(readme_path):
         return