Enforce sorted README example inventory

Co-authored-by: Shri Sukhani <shrisukhani@users.noreply.github.com>

Author: cursoragent

README.md

@@ -257,18 +257,18 @@ Contributor workflow details are available in [CONTRIBUTING.md](CONTRIBUTING.md)
 
 Ready-to-run examples are available in `examples/`:
 
-- `examples/sync_scrape.py`
-- `examples/async_scrape.py`
-- `examples/async_extract.py`
-- `examples/sync_extract.py`
-- `examples/sync_crawl.py`
 - `examples/async_crawl.py`
-- `examples/sync_web_fetch.py`
+- `examples/async_extract.py`
+- `examples/async_scrape.py`
+- `examples/async_session_list.py`
 - `examples/async_web_fetch.py`
-- `examples/sync_web_search.py`
 - `examples/async_web_search.py`
+- `examples/sync_crawl.py`
+- `examples/sync_extract.py`
+- `examples/sync_scrape.py`
 - `examples/sync_session_list.py`
-- `examples/async_session_list.py`
+- `examples/sync_web_fetch.py`
+- `examples/sync_web_search.py`
 
 ## License
 

tests/test_readme_examples_listing.py

@@ -23,3 +23,10 @@ def test_readme_example_list_covers_all_python_example_scripts():
     }
 
     assert example_files == listed_examples
+
+
+def test_readme_example_list_is_sorted():
+    readme_text = Path("README.md").read_text(encoding="utf-8")
+    listed_examples = re.findall(r"- `([^`]*examples/[^`]*)`", readme_text)
+
+    assert listed_examples == sorted(listed_examples)