Docs: Update stdlib docs (u-z)

Co-Authored-By: Codex <codex@openai.com>

Author: heikkitoivonen

DOCUMENTATION_STATUS.md

@@ -5,8 +5,8 @@ This document tracks the coverage of built-in functions, types, and standard lib
 ## Overview
 
 - **Total Items**: 313 (150 builtins + 163 stdlib modules)
-- **Documented**: 386 (174 builtins + 212 stdlib)
-- **Coverage**: 123.3%
+- **Documented**: 387 (174 builtins + 213 stdlib)
+- **Coverage**: 123.6%
 
 **Note**: Coverage exceeds 100% because comprehensive documentation files (like `exceptions.md`) cover multiple individual items, and we document deprecated/removed modules for historical reference.
 
@@ -203,7 +203,7 @@ Complete coverage of all built-in functions, types, exceptions, and constants:
 
 ## Standard Library Modules
 
-**Coverage: 130.1% (212/163)**
+**Coverage: 130.7% (213/163)**
 
 All standard library modules are fully documented, including new Python 3.14 modules. Coverage exceeds 100% due to documentation of deprecated/removed modules for historical reference.
 
@@ -312,11 +312,11 @@ All file and I/O modules now documented:
 - ✅ `shutil` - High-level file operations
 - ✅ `tempfile` - Temporary files
 
-### ✅ ALL MODULES COMPLETE (212/212)
+### ✅ ALL MODULES COMPLETE (213/213)
 
 All 108 previously undocumented stdlib modules have been added:
 
-**Utilities & System (23)**
+**Utilities & System (24)**
 - ✅ `ast` - Abstract syntax trees
 - ✅ `dis` - Disassembler for bytecode
 - ✅ `doctest` - Testing via docstrings
@@ -419,6 +419,7 @@ All 108 previously undocumented stdlib modules have been added:
 - ✅ `compileall` - Batch compilation
 - ✅ `rlcompleter` - Readline completion
 - ✅ `tabnanny` - Python indentation checker
+- ✅ `unicodedata` - Unicode character database
 - ✅ `this` - Zen of Python
 - ✅ `readline` - Line-editing support
 

data/documentation_audit.json

@@ -168,8 +168,8 @@
   },
   "stdlib": {
     "total": 163,
-    "documented": 212,
-    "coverage_percent": 130.1,
+    "documented": 213,
+    "coverage_percent": 130.7,
     "missing": [
       "audit_documentation",
       "cProfile",
@@ -179,7 +179,7 @@
   },
   "summary": {
     "total_items": 313,
-    "total_documented": 386,
-    "overall_coverage_percent": 123.3
+    "total_documented": 387,
+    "overall_coverage_percent": 123.6
   }
 }

docs/stdlib/unicodedata.md

@@ -0,0 +1,72 @@
+# unicodedata Module
+
+The `unicodedata` module provides access to the Unicode Character Database (UCD),
+including character names, categories, normalization, and digit/decimal values.
+
+## Complexity Reference
+
+| Operation | Time | Space | Notes |
+|-----------|------|-------|-------|
+| `name(ch)` | O(1) | O(1) | Lookup by code point; raises ValueError if unnamed |
+| `lookup(name)` | O(1) | O(1) | Lookup by name |
+| `category(ch)` | O(1) | O(1) | General category |
+| `bidirectional(ch)` | O(1) | O(1) | Bidi class |
+| `combining(ch)` | O(1) | O(1) | Canonical combining class |
+| `decimal(ch)` / `digit(ch)` / `numeric(ch)` | O(1) | O(1) | Numeric properties |
+| `normalize(form, s)` | O(n) | O(n) | n = string length |
+| `is_normalized(form, s)` | O(n) | O(1) | Checks normalization |
+
+## Character Properties
+
+```python
+import unicodedata
+
+# Basic properties
+ch = "é"
+print(unicodedata.name(ch))       # LATIN SMALL LETTER E WITH ACUTE
+print(unicodedata.category(ch))   # Ll
+print(unicodedata.combining(ch))  # 0
+print(unicodedata.bidirectional(ch))  # L
+
+# Numeric properties
+print(unicodedata.decimal("٢"))   # 2
+print(unicodedata.digit("②"))     # 2
+print(unicodedata.numeric("Ⅷ"))   # 8.0
+```
+
+## Name Lookup
+
+```python
+import unicodedata
+
+# Lookup by name
+ch = unicodedata.lookup("GREEK SMALL LETTER MU")  # "μ"
+
+# Safe name lookup with default
+name = unicodedata.name("Ω", "UNKNOWN")  # "GREEK CAPITAL LETTER OMEGA"
+missing = unicodedata.name("😀", None)    # Name exists; returns string
+```
+
+## Normalization
+
+```python
+import unicodedata
+
+text = "cafe\u0301"  # "e" + combining acute
+
+# Normalize to NFC/NFD/NFKC/NFKD
+nfc = unicodedata.normalize("NFC", text)
+nfd = unicodedata.normalize("NFD", text)
+
+print(text == nfc)  # False
+print(text == nfd)  # True
+
+# Check normalization
+print(unicodedata.is_normalized("NFC", text))  # False
+print(unicodedata.is_normalized("NFD", text))  # True
+```
+
+## Related Documentation
+
+- [codecs Module](codecs.md)
+- [encodings Module](encodings.md)

docs/stdlib/unittest.md

@@ -17,6 +17,13 @@ The `unittest` module provides a framework for unit testing with test cases, fix
 import unittest
 
 # Define test class - O(1)
+class Calculator:
+    def add(self, a, b):
+        return a + b
+
+    def subtract(self, a, b):
+        return a - b
+
 class TestCalculator(unittest.TestCase):
 
     def setUp(self):  # O(s) - called before each test
@@ -147,12 +154,6 @@ python -m unittest discover  # O(n*t)
 python -m unittest -v  # O(n*t)
 ```
 
-## Version Notes
-
-- **Python 2.x**: unittest available (as unittest2 backport)
-- **Python 3.x**: Built-in with enhancements
-- **Python 3.4+**: Subtests added
-
 ## Best Practices
 
 ✅ **Do**:

docs/stdlib/urllib.md

@@ -10,7 +10,7 @@ The `urllib` module provides utilities for working with URLs, including fetching
 | `urllib.parse.urlencode()` | O(n*m) | O(n*m) | n = items, m = avg value length |
 | `urllib.parse.quote()` | O(n) | O(n) | n = string length |
 | `urllib.parse.unquote()` | O(n) | O(n) | n = string length |
-| `urllib.request.urlopen()` | O(response) | O(response) | Network-bound; response size dominates |
+| `urllib.request.urlopen()` | O(response) | O(1) | Network-bound; response size dominates |
 | `response.read()` | O(n) | O(n) | n = response size |
 
 ## URL Parsing
@@ -114,12 +114,11 @@ from urllib.request import urlopen
 try:
     with urlopen('https://example.com') as response:  # O(network)
         content = response.read()  # O(n) - n = response size
+        # Access response metadata - O(1)
+        status = response.status  # 200
+        headers = response.headers  # dict-like
 except Exception as e:
     print(f"Error: {e}")
-
-# Access response metadata - O(1)
-status = response.status  # 200
-headers = response.headers  # dict-like
 ```
 
 ### Reading Response Content
@@ -308,25 +307,6 @@ def fetch_with_retry(url, max_retries=3):
 content = fetch_with_retry('https://example.com')  # O(response)
 ```
 
-## Limitations and Alternatives
-
-### When to Use requests Library
-
-```python
-# urllib is built-in but basic
-# For more features, use requests library (not built-in)
-
-# urllib - basic, manual handling
-from urllib.request import urlopen
-response = urlopen('https://api.example.com/data')
-data = response.read()
-
-# requests - higher-level, more convenient
-import requests  # Must install: pip install requests
-response = requests.get('https://api.example.com/data')
-data = response.json()  # Auto JSON parsing
-```
-
 ## Performance Considerations
 
 ### Batch Fetching
@@ -378,17 +358,10 @@ content1 = fetch_cached('https://example.com')
 content2 = fetch_cached('https://example.com')
 ```
 
-## Version Notes
-
-- **Python 2.x**: `urllib` and `urllib2` separate modules
-- **Python 3.x**: `urllib.request`, `urllib.parse`, `urllib.error` (reorganized)
-- **All versions**: Basic functionality stable
-
 ## Related Modules
 
 - **[http.client](http.md)** - Lower-level HTTP client
 - **[json](json.md)** - Parse JSON responses
-- **requests** - Higher-level HTTP library (external)
 
 ## Best Practices
 

docs/stdlib/uuid.md

@@ -301,14 +301,9 @@ u = uuid4()  # O(1) - cryptographically secure, globally unique
 # Random string (worse)
 uid = ''.join(random.choices(string.ascii_letters, k=36))  # O(n) - collision possible
 
-# UUID is guaranteed unique across systems and time
+# UUIDs are designed to be globally unique, but not absolutely guaranteed
 ```
 
-## Version Notes
-
-- **Python 3.x**: Full UUID support
-- **Python 3.6+**: UUID object improvements
-
 ## Related Documentation
 
 - [Random Module](random.md) - Random number generation

docs/stdlib/weakref.md

@@ -1,4 +1,4 @@
-# Weakref Module
+# weakref Module
 
 The `weakref` module provides utilities for creating weak references to objects, allowing garbage collection when objects are no longer strongly referenced.
 
@@ -115,7 +115,11 @@ class CachedResource:
 
 # Usage
 cache = CachedResource()
-obj1 = {"data": "value"}
+class Data:
+    def __init__(self, value):
+        self.value = value
+
+obj1 = Data("value")
 cache.register("key1", obj1)
 
 retrieved = cache.get("key1")  # O(1)
@@ -235,9 +239,9 @@ class Registry:
 # Usage
 registry = Registry()
 
-obj1 = {"id": 1}
-obj2 = {"id": 2}
-obj3 = {"id": 3}
+obj1 = Data(1)
+obj2 = Data(2)
+obj3 = Data(3)
 
 registry.register(obj1)  # O(1)
 registry.register(obj2)  # O(1)
@@ -297,7 +301,7 @@ class TransientCache:
 
 # Usage
 cache = TransientCache()
-obj = {"data": "value"}
+obj = Data("value")
 cache._cache["key"] = obj  # O(1)
 
 # Query without keeping obj alive
@@ -307,13 +311,7 @@ data = cache.query("key")  # O(1)
 exists = cache.query_exists("key")  # O(1) - won't prevent GC
 ```
 
-## Version Notes
-
-- **Python 2.6+**: Basic weakref support
-- **Python 3.x**: All features available
-- **Python 3.13+**: Performance improvements
-
 ## Related Documentation
 
-- Gc Module - Garbage collection control
+- [gc Module](gc.md) - Garbage collection control
 - [Collections Module](collections.md) - OrderedDict alternatives

docs/stdlib/zipapp.md

@@ -21,7 +21,7 @@ zipapp.create_archive(
     'myapp',
     target='myapp.pyz',
     main='myapp:main',
-    compression='deflated'
+    compressed=True
 )
 
 # Run: