# 🎯 Simple Module Demo

# This demonstrates what would be in a file called "calculator.py"
def add(a, b):
    """Add two numbers together"""
    return a + b

def subtract(a, b):
    """Subtract second number from first"""
    return a - b

def multiply(a, b):
    """Multiply two numbers"""
    return a * b

def divide(a, b):
    """Divide first number by second"""
    if b == 0:
        return "Error: Cannot divide by zero"
    return a / b

# Constants that users might need
PI = 3.14159
VERSION = "1.0"

# Demo of using our calculator functions
print("🧮 Calculator Module Demo:")
print(f"5 + 3 = {add(5, 3)}")
print(f"10 - 4 = {subtract(10, 4)}")
print(f"6 × 7 = {multiply(6, 7)}")
print(f"15 ÷ 3 = {divide(15, 3)}")
print(f"Pi constant: {PI}")
print(f"Module version: {VERSION}")

# 📝 Text Helper Module Example
# This would be saved as "text_helpers.py"

def clean_text(text):
    """Remove extra spaces and clean up text"""
    return " ".join(text.split())

def count_words(text):
    """Count the number of words in text"""
    return len(text.split())

def make_title(text):
    """Convert text to title case"""
    return text.title()

def make_slug(text):
    """Convert text to URL-friendly format"""
    # Replace spaces and special characters with hyphens
    slug = text.lower()
    slug = slug.replace(" ", "-")
    slug = slug.replace("_", "-")
    # Remove extra hyphens
    while "--" in slug:
        slug = slug.replace("--", "-")
    return slug.strip("-")

def reverse_words(text):
    """Reverse the order of words in text"""
    words = text.split()
    return " ".join(reversed(words))

# Demo of our text helper functions
print("📝 Text Helper Module Demo:")
sample_text = "  hello   world  python   programming  "

print(f"Original: '{sample_text}'")
print(f"Cleaned: '{clean_text(sample_text)}'")
print(f"Word count: {count_words(sample_text)}")
print(f"Title case: '{make_title(sample_text)}'")
print(f"URL slug: '{make_slug(sample_text)}'")
print(f"Reversed: '{reverse_words(sample_text)}'")

# 🏗️ Simple User Module Example
# This would be saved as "user_tools.py"

class User:
    """Represents a user in our system"""
    
    def __init__(self, name, email):
        self.name = name
        self.email = email
        self.login_count = 0
        self.active = True
    
    def login(self):
        """Record that user logged in"""
        if self.active:
            self.login_count += 1
            return f"{self.name} logged in successfully"
        else:
            return f"{self.name} account is not active"
    
    def deactivate(self):
        """Deactivate user account"""
        self.active = False
        return f"{self.name}'s account has been deactivated"
    
    def update_email(self, new_email):
        """Change user's email address"""
        old_email = self.email
        self.email = new_email
        return f"Email updated from {old_email} to {new_email}"
    
    def get_info(self):
        """Get user information"""
        status = "Active" if self.active else "Inactive"
        return f"{self.name} ({self.email}) - {status} - {self.login_count} logins"

def create_user(name, email):
    """Helper function to create a new user"""
    return User(name, email)

# Demo of our User module
print("👤 User Module Demo:")
user1 = create_user("Alice", "alice@example.com")
user2 = create_user("Bob", "bob@example.com")

print(user1.login())
print(user1.update_email("alice.smith@example.com"))
print(user2.login())
print(user2.deactivate())

print("\nUser Information:")
print(user1.get_info())
print(user2.get_info())

# 📊 Math Helper Module Example
# This would be saved as "math_helpers.py"

def calculate_average(numbers):
    """Calculate the average of a list of numbers"""
    if not numbers:
        return 0
    return sum(numbers) / len(numbers)

def find_largest(numbers):
    """Find the largest number in a list"""
    if not numbers:
        return None
    return max(numbers)

def find_smallest(numbers):
    """Find the smallest number in a list"""
    if not numbers:
        return None
    return min(numbers)

def calculate_percentage(part, whole):
    """Calculate what percentage part is of whole"""
    if whole == 0:
        return 0
    return (part / whole) * 100

def round_to_places(number, places=2):
    """Round number to specified decimal places"""
    return round(number, places)

def is_even(number):
    """Check if a number is even"""
    return number % 2 == 0

def is_odd(number):
    """Check if a number is odd"""
    return number % 2 == 1

# Demo of our math helper functions
print("🔢 Math Helper Module Demo:")
test_numbers = [10, 25, 30, 45, 50, 15, 35]

print(f"Numbers: {test_numbers}")
print(f"Average: {calculate_average(test_numbers)}")
print(f"Largest: {find_largest(test_numbers)}")
print(f"Smallest: {find_smallest(test_numbers)}")
print(f"50 is {calculate_percentage(50, 200):.1f}% of 200")
print(f"Pi rounded: {round_to_places(3.14159, 3)}")
print(f"Is 42 even? {is_even(42)}")
print(f"Is 42 odd? {is_odd(42)}")