chatbot.py

"""
Project 1: Rule-Based AI Chatbot
DecodeLabs Industrial Training Program – Batch 2026

Author: Syed Faran Ali

Description:
A rule-based chatbot that demonstrates fundamental Artificial
Intelligence concepts using predefined rules, decision-making
logic, and continuous user interaction.

Concepts Covered:
- Rule-Based AI
- Control Flow (if-elif-else)
- Functions
- Dictionaries
- Loops
- Input Validation
- String Manipulation
- Modular Programming
"""

from datetime import datetime

# ==========================================================
# Configuration
# ==========================================================

BOT_NAME = "RuleBot"

EXIT_COMMANDS = {"exit", "quit", "bye"}

RESPONSES = {
    "hello": "Hello! How can I assist you today?",
    "hi": "Hi! Nice to meet you.",
    "hey": "Hey! How can I help you?",
    "good morning": "Good morning! Have a productive day.",
    "good afternoon": "Good afternoon!",
    "good evening": "Good evening!",
    "how are you": "I'm doing great. Thanks for asking!",
    "what is your name": (
        f"I'm {BOT_NAME}, a Rule-Based AI Chatbot."
    ),
    "who are you": (
        f"I'm {BOT_NAME}, a Rule-Based AI Chatbot."
    ),
    "who created you": (
        "I was developed by Syed Faran Ali "
        "during the DecodeLabs AI Internship."
    ),
    "thanks": "You're welcome! Happy to help.",
    "thank you": "You're welcome! Happy to help.",
    "joke": (
        "Why do programmers prefer Python? "
        "Because it makes coding simple and enjoyable!"
    ),
}

HELP_MESSAGE = """
Available Commands
------------------
Greetings:
  hello
  hi
  hey
  good morning
  good afternoon
  good evening

General:
  how are you
  what is your name
  who are you
  who created you
  joke
  date
  time

Utility:
  help
  exit
  quit
  bye
"""


# ==========================================================
# Helper Functions
# ==========================================================

def display_banner() -> None:
    """Display the chatbot welcome banner."""

    print("=" * 60)
    print("         DecodeLabs AI Internship")
    print("        Project 1 - Rule-Based AI Chatbot")
    print("=" * 60)
    print(f"Welcome! I'm {BOT_NAME}.")
    print("Type 'help' to view available commands.")
    print("Type 'exit' to end the conversation.")
    print("=" * 60)


def sanitize_input(user_input: str) -> str:
    """
    Normalize user input.

    Parameters:
        user_input (str): Raw user input.

    Returns:
        str: Cleaned input.
    """
    return user_input.strip().lower()


def get_date() -> str:
    """Return current date."""
    return datetime.now().strftime("%d %B %Y")


def get_time() -> str:
    """Return current time."""
    return datetime.now().strftime("%I:%M %p")


def generate_response(user_input: str) -> tuple[str, bool]:
    """
    Process user input and return chatbot response.

    Returns:
        tuple:
            response (str)
            exit_chat (bool)
    """

    command = sanitize_input(user_input)

    # Exit Commands
    if command in EXIT_COMMANDS:
        return (
            "Goodbye! Thank you for chatting with me. Have a wonderful day!",
            True,
        )

    # Help
    if command == "help":
        return HELP_MESSAGE, False

    # Date
    if command == "date":
        return f"Today's date is {get_date()}.", False

    # Time
    if command == "time":
        return f"The current time is {get_time()}.", False

    # Dictionary Lookup
    if command in RESPONSES:
        return RESPONSES[command], False

    # Unknown Command
    return (
        "Sorry, I couldn't understand your request.\n"
        "Type 'help' to see the list of available commands.",
        False,
    )


def chatbot() -> None:
    """Main chatbot conversation loop."""

    display_banner()

    while True:
        user_input = input("\nYou: ")

        response, exit_chat = generate_response(user_input)

        print(f"{BOT_NAME}: {response}")

        if exit_chat:
            break


# ==========================================================
# Entry Point
# ==========================================================

if __name__ == "__main__":
    chatbot()