Manual review of builtin functions: next-locals

Author: heikkitoivonen

docs/builtins/input.md

@@ -96,192 +96,6 @@ while True:
 # Total: O(n*k) where n = number of lines
 ```
 
-## Common Patterns
-
-### Menu Selection
-
-```python
-# Simple menu - O(k)
-def show_menu():
-    print("1. Option A")
-    print("2. Option B")
-    print("3. Exit")
-    choice = input("Choose: ")  # O(k)
-    return choice
-
-# Usage
-choice = show_menu()  # O(k)
-if choice == "1":
-    do_a()
-elif choice == "2":
-    do_b()
-```
-
-### Validation Loop
-
-```python
-# Repeat until valid input - O(n*k)
-def get_positive_number():
-    while True:
-        try:
-            num_str = input("Enter positive number: ")  # O(k)
-            num = int(num_str)  # O(k)
-            if num > 0:
-                return num
-            print("Must be positive")
-        except ValueError:
-            print("Invalid number")
-
-# Usage - might need multiple attempts
-value = get_positive_number()  # O(k) per attempt
-```
-
-### Yes/No Question
-
-```python
-# Simple yes/no - O(k)
-def confirm(message):
-    while True:
-        response = input(f"{message} (yes/no): ").lower()  # O(k)
-        if response in ['yes', 'y']:
-            return True
-        elif response in ['no', 'n']:
-            return False
-        print("Please answer yes or no")
-
-# Usage
-if confirm("Delete file?"):  # O(k)
-    delete_file()
-```
-
-## Error Handling
-
-### Handling Input Errors
-
-```python
-# Catch conversion errors - O(k)
-try:
-    age = int(input("Age: "))  # O(k)
-except ValueError:
-    print("Invalid age")
-    age = 0
-
-# Catch EOF (Ctrl+D on Unix, Ctrl+Z on Windows)
-try:
-    name = input("Name: ")  # O(k)
-except EOFError:
-    print("Input cancelled")
-    name = ""
-
-# Catch keyboard interrupt (Ctrl+C)
-try:
-    data = input("Data: ")  # O(k)
-except KeyboardInterrupt:
-    print("\nCancelled")
-    data = ""
-```
-
-## Advanced Patterns
-
-### Interactive Session
-
-```python
-# Multi-step input session - O(n*k)
-def interactive_form():
-    print("Fill in the form:")
-    
-    data = {}
-    fields = ['name', 'email', 'phone']
-    
-    for field in fields:  # O(n) iterations
-        value = input(f"Enter {field}: ")  # O(k) per field
-        data[field] = value
-    
-    return data
-
-# Usage - O(n*k)
-user_data = interactive_form()
-```
-
-### Parsing Structured Input
-
-```python
-# Parse CSV-like input - O(n*m)
-print("Enter records (name,age,city):")
-records = []
-
-while True:
-    line = input("Record (empty to stop): ")  # O(k)
-    if not line:
-        break
-    
-    # Parse - O(k)
-    fields = line.split(',')  # O(k)
-    record = {
-        'name': fields[0].strip(),  # O(k)
-        'age': fields[1].strip(),
-        'city': fields[2].strip()
-    }
-    records.append(record)  # O(1)
-
-# Total: O(n*m) where n = records, m = avg fields
-```
-
-## Input from Files (Not input())
-
-```python
-# input() reads from keyboard only
-# For file input, use open()
-
-# Read from file - O(k) per line
-with open('data.txt', 'r') as f:
-    for line in f:  # O(1) each iteration
-        # line includes newline, unlike input()
-        line = line.strip()  # O(k) to remove it
-        process(line)
-
-# Read all at once - O(n)
-with open('data.txt', 'r') as f:
-    all_lines = f.readlines()  # O(n)
-```
-
-## Input in Scripts vs Interactive
-
-### Interactive Mode
-
-```python
-# Works in interactive Python
-name = input("Name: ")  # O(k) - waits for user
-print(f"Hello, {name}")
-```
-
-### Script Mode
-
-```python
-# Script with input() - O(k)
-#!/usr/bin/env python3
-
-name = input("What is your name? ")  # O(k)
-age = int(input("What is your age? "))  # O(k)
-print(f"Hello {name}, you are {age} years old")
-```
-
-### Testing Scripts with input()
-
-```python
-# For testing, redirect stdin or mock input()
-import sys
-from io import StringIO
-
-# Simulate user input
-sys.stdin = StringIO("Alice\n30\n")
-
-name = input()  # O(k) - reads "Alice"
-age = int(input())  # O(k) - reads "30"
-
-print(f"{name} is {age}")
-```
-
 ## Performance Considerations
 
 ### Input Speed
@@ -335,15 +149,8 @@ values = input("Enter all values: ").split()  # O(k)
 ✅ **Do**:
 
 - Use `input()` for interactive programs
-- Validate and convert input with error handling
-- Use `strip()` to remove whitespace
-- Provide clear prompts
 - Use file input for large data sets
 
 ❌ **Avoid**:
 
-- Using `input()` in production servers (won't work)
-- Forgetting input returns a string (requires conversion)
-- Assuming input is safe (validate it!)
 - Using `input()` for performance-critical code
-- Trusting user input without validation

docs/builtins/next.md

@@ -101,155 +101,6 @@ except StopIteration:
     print("Done")
 ```
 
-## Common Patterns
-
-### Pairwise Iteration
-
-```python
-# Iterate elements in pairs
-def pairwise(iterable):
-    """Yield consecutive pairs"""
-    it = iter(iterable)
-    a = next(it, None)  # O(1)
-    
-    for b in it:  # O(1) each
-        yield (a, b)
-        a = b
-
-# Usage
-items = [1, 2, 3, 4, 5]
-for pair in pairwise(items):  # O(n) total
-    print(pair)
-# Output: (1,2), (2,3), (3,4), (4,5)
-```
-
-### Skip Items
-
-```python
-# Skip first n items
-def skip_n(iterable, n):
-    it = iter(iterable)
-    
-    # Skip n items - O(n)
-    for _ in range(n):
-        next(it, None)  # O(1) each
-    
-    # Return rest
-    return it
-
-# Usage
-it = skip_n(range(10), 3)
-for item in it:  # O(1) each
-    print(item)  # 3, 4, 5, ..., 9
-```
-
-### Take First N
-
-```python
-# Take first n items - O(n)
-def take(iterable, n):
-    it = iter(iterable)
-    for _ in range(n):
-        yield next(it)  # O(1) each
-
-# Usage
-items = range(100)
-first_five = take(items, 5)  # O(5)
-```
-
-## Error Handling
-
-### Safe next() with Default
-
-```python
-# Avoid exceptions with default - O(1)
-it = iter([1, 2, 3])
-
-while True:
-    value = next(it, None)  # O(1)
-    if value is None:
-        break
-    print(value)
-```
-
-### Checking for Exhaustion
-
-```python
-# Sentinel pattern
-it = iter([1, 2, 3])
-sentinel = object()  # Unique marker
-
-while True:
-    value = next(it, sentinel)  # O(1)
-    if value is sentinel:
-        break
-    process(value)
-```
-
-## Advanced Iterator Patterns
-
-### Iterator with State
-
-```python
-# Iterator that maintains state
-class CountUp:
-    def __init__(self, max):
-        self.max = max
-        self.current = 0
-    
-    def __iter__(self):
-        return self
-    
-    def __next__(self):
-        if self.current < self.max:
-            val = self.current
-            self.current += 1
-            return val  # O(1)
-        raise StopIteration
-
-# Usage
-counter = CountUp(3)
-val1 = next(counter)  # 0 - O(1)
-val2 = next(counter)  # 1 - O(1)
-```
-
-### Chained Iterators
-
-```python
-# Chain multiple iterators - O(1) per next()
-from itertools import chain
-
-it1 = iter([1, 2, 3])
-it2 = iter([4, 5, 6])
-combined = chain(it1, it2)  # O(1) to create
-
-# Iterate through both - O(1) each
-for item in combined:  # O(6) total
-    print(item)
-```
-
-## Comparison with For Loop
-
-```python
-# For loop uses next() internally
-items = [1, 2, 3]
-
-# Manual with next() - O(n)
-it = iter(items)
-while True:
-    try:
-        item = next(it)  # O(1)
-        print(item)
-    except StopIteration:
-        break
-
-# For loop (equivalent) - O(n)
-for item in items:  # O(1) each
-    print(item)
-
-# For loop is cleaner; use next() for special cases
-```
-
 ## Performance Considerations
 
 ### next() vs Indexing