cli.py

"""
Password Generator - CLI Version
Author: RIFINOO
License: MIT License

Command-line interface for the password generator using argparse.
Provides a non-interactive way to generate passwords via command-line arguments.

Role in System:
- Entry point: Run with `python cli.py [options]`
- Uses: generator.py for core password generation
- Features: Command-line arguments, password strength analysis, clipboard integration
- Use case: Scripting, automation, quick password generation
"""

import argparse
import sys
import logging
from generator import PasswordGenerator
try:
    import pyperclip
    CLIPBOARD_AVAILABLE = True
except ImportError:
    CLIPBOARD_AVAILABLE = False
    print("Warning: pyperclip not installed. Clipboard functionality disabled.")

logger = logging.getLogger(__name__)


def main():
    """Main CLI entry point."""
    parser = argparse.ArgumentParser(
        description='Professional Password Generator - Generate secure passwords',
        formatter_class=argparse.RawDescriptionHelpFormatter,
        epilog="""
Examples:
  python cli.py --length 20
  python cli.py -l 16 --no-special
  python cli.py -l 24 --copy
  python cli.py -l 12 --check-strength
        """
    )
    
    parser.add_argument(
        '-l', '--length',
        type=int,
        default=16,
        help='Password length (default: 16, minimum: 4)'
    )
    
    parser.add_argument(
        '--no-uppercase',
        action='store_true',
        help='Exclude uppercase letters'
    )
    
    parser.add_argument(
        '--no-lowercase',
        action='store_true',
        help='Exclude lowercase letters'
    )
    
    parser.add_argument(
        '--no-numbers',
        action='store_true',
        help='Exclude numbers'
    )
    
    parser.add_argument(
        '--no-special',
        action='store_true',
        help='Exclude special characters'
    )
    
    parser.add_argument(
        '-c', '--copy',
        action='store_true',
        help='Copy password to clipboard'
    )
    
    parser.add_argument(
        '--check-strength',
        action='store_true',
        help='Display password strength analysis'
    )
    
    parser.add_argument(
        '--entropy',
        action='store_true',
        help='Display password entropy'
    )
    
    args = parser.parse_args()
    
    # Create generator instance
    generator = PasswordGenerator()
    
    # Generate password
    password = generator.generate_password(
        length=args.length,
        include_uppercase=not args.no_uppercase,
        include_lowercase=not args.no_lowercase,
        include_numbers=not args.no_numbers,
        include_special=not args.no_special
    )
    
    if not password:
        print("Error: Failed to generate password. Check your parameters.", file=sys.stderr)
        sys.exit(1)
    
    # Display password
    print(f"\n{'='*60}")
    print(f"Generated Password: {password}")
    print(f"{'='*60}\n")
    
    # Display entropy if requested
    if args.entropy or args.check_strength:
        entropy = generator.calculate_entropy(password)
        print(f"Entropy: {entropy} bits\n")
    
    # Display strength analysis if requested
    if args.check_strength:
        strength_data = generator.check_strength(password)
        print(f"Strength: {strength_data['strength']} (Score: {strength_data['score']}/6)")
        print(f"Length: {strength_data['length']} characters")
        print(f"Entropy: {strength_data['entropy']} bits")
        print("\nFeedback:")
        for item in strength_data['feedback']:
            print(f"  {item}")
        print()
    
    # Copy to clipboard if requested
    if args.copy:
        if CLIPBOARD_AVAILABLE:
            try:
                pyperclip.copy(password)
                print("✓ Password copied to clipboard!")
            except Exception as e:
                print(f"Error copying to clipboard: {e}", file=sys.stderr)
        else:
            print("Warning: Clipboard functionality not available.", file=sys.stderr)
    
    logger.info("Password generated via CLI")


if __name__ == '__main__':
    main()