Create a command line Python script to generate random numbers within a given range.…
- User
Create a command line Python script to generate random numbers within a given range. Minimum Number: 10 and Maximum Number: 25
Assistant
Problem: Create a command line Python script to generate random numbers within a given range. Minimum Number: 10 and Maximum Number: 25
Let me implement this solution.
Architectural Decisions
1. CLI Framework:
argparse- Choice: Python's built-in
argparsemodule - Reasoning: No external dependencies, provides automatic help generation, input validation, and is part of the standard library. This ensures maximum portability and zero installation requirements beyond Python itself.
2. Random Number Generation:
random.randint()- Choice: Using
random.randint()from the standard library - Reasoning: It provides inclusive bounds (both min and max are possible outputs), which is the intuitive expectation for users asking for a "range."
3. Default Values
- Choice: Hardcode defaults of min=10, max=25 as specified
- Reasoning: Provides immediate functionality without arguments while allowing full customization.
4. Additional Features
- Count option: Allow generating multiple random numbers in one execution
- Seed option: For reproducibility in testing/debugging scenarios
- Input validation: Ensure min ≤ max with clear error messages
5. Code Structure
- Modular functions with single responsibilities
- Type hints for clarity
- Proper
if __name__ == "__main__"entry point guard
Implementation
#!/usr/bin/env python3 """ Random Number Generator CLI A command-line tool to generate random integers within a specified range. Default range: 10 to 25 (inclusive) Usage: python random_generator.py # Single random number (10-25) python random_generator.py --min 5 --max 50 # Custom range python random_generator.py --count 5 # Generate 5 numbers python random_generator.py --seed 42 # Reproducible results """ import argparse import random import sys from typing import List # Default values as specified DEFAULT_MIN = 10 DEFAULT_MAX = 25 def generate_random_number(min_val: int, max_val: int) -> int: """ Generate a single random integer within the specified range (inclusive). Args: min_val: The minimum value (inclusive) max_val: The maximum value (inclusive) Returns: A random integer between min_val and max_val """ return random.randint(min_val, max_val) def generate_multiple_numbers(min_val: int, max_val: int, count: int) -> List[int]: """ Generate multiple random integers within the specified range. Args: min_val: The minimum value (inclusive) max_val: The maximum value (inclusive) count: Number of random numbers to generate Returns: A list of random integers """ return [generate_random_number(min_val, max_val) for _ in range(count)] def validate_range(min_val: int, max_val: int) -> None: """ Validate that the range is valid (min <= max). Args: min_val: The minimum value max_val: The maximum value Raises: ValueError: If min_val > max_val """ if min_val > max_val: raise ValueError( f"Invalid range: minimum ({min_val}) cannot be greater than maximum ({max_val})" ) def parse_arguments() -> argparse.Namespace: """ Parse and validate command-line arguments. Returns: Namespace object containing parsed arguments """ parser = argparse.ArgumentParser( description="Generate random numbers within a specified range.", formatter_class=argparse.RawDescriptionHelpFormatter, epilog=""" Examples: %(prog)s Generate one random number (10-25) %(prog)s --min 1 --max 100 Generate one random number (1-100) %(prog)s -c 10 Generate 10 random numbers (10-25) %(prog)s --seed 42 -c 5 Generate 5 reproducible random numbers """ ) parser.add_argument( "--min", "-m", type=int, default=DEFAULT_MIN, help=f"Minimum value (default: {DEFAULT_MIN})" ) parser.add_argument( "--max", "-M", type=int, default=DEFAULT_MAX, help=f"Maximum value (default: {DEFAULT_MAX})" ) parser.add_argument( "--count", "-c", type=int, default=1, help="Number of random numbers to generate (default: 1)" ) parser.add_argument( "--seed", "-s", type=int, default=None, help="Seed for reproducible results (default: None, uses system time)" ) parser.add_argument( "--delimiter", "-d", type=str, default="\n", help="Delimiter between multiple numbers (default: newline)" ) return parser.parse_args() def main() -> int: """ Main entry point for the random number generator. Returns: Exit code (0 for success, 1 for error) """ args = parse_arguments() # Set seed if provided (for reproducibility) if args.seed is not None: random.seed(args.seed) # Validate range try: validate_range(args.min, args.max) except ValueError as e: print(f"Error: {e}", file=sys.stderr) return 1 # Validate count if args.count < 1: print("Error: Count must be at least 1", file=sys.stderr) return 1 # Generate random numbers numbers = generate_multiple_numbers(args.min, args.max, args.count) # Output results output = args.delimiter.join(str(num) for num in numbers) print(output) return 0 if __name__ == "__main__": sys.exit(main())
Usage Examples
# Basic usage with defaults (10-25) $ python random_generator.py 17 # Custom range $ python random_generator.py --min 1 --max 100 73 # Generate multiple numbers $ python random_generator.py --count 5 12 25 10 18 22 # Custom delimiter for multiple numbers $ python random_generator.py -c 5 -d ", " 14, 22, 10, 25, 17 # Reproducible results with seed $ python random_generator.py --seed 42 -c 3 18 22 13 # Running the same seed again produces identical results $ python random_generator.py --seed 42 -c 3 18 22 13 # View help $ python random_generator.py --help
Key Features Summary
Feature Description Default Range 10-25 (as specified) Inclusive Bounds Both min and max can be generated Multiple Numbers -c/--countoptionReproducibility -s/--seedoptionCustom Delimiter -d/--delimiterfor output formattingInput Validation Clear error messages for invalid inputs Zero Dependencies Uses only Python standard library - Choice: Python's built-in