# File: hello_debugger.rb
# This simple script demonstrates where to place breakpoints for IRB and Pry.

require 'pry' # Required only if using the Pry gem

def greet(name)
  message = "Hello, #{name}!"
  
  # Breakpoint for IRB: Program will pause here, control transfers to IRB console.
  # Type 'message' to inspect its value, 'name' to inspect current name.
  # Type 'continue' or 'exit' to proceed.
  binding.irb
  
  puts message
  
  # Breakpoint for Pry: Program will pause here, control transfers to Pry console.
  # Type 'message' to inspect, 'ls' for local variables and methods.
  # Type 'continue' or 'exit' to proceed.
  binding.pry # Requires 'pry' gem to be installed (gem install pry) and required
  
  return message
end

puts "Starting program..."
greet("World")
puts "Program finished."

# To run this script:
# 1. Ensure you have the 'pry' gem installed: gem install pry
# 2. Execute from your terminal: ruby hello_debugger.rb
# 3. Interact with IRB and Pry when the breakpoints are hit.

# File: irb_explorer.rb
# This script demonstrates basic real-time inspection using IRB.

def calculate_discount(price, discount_percentage)
  puts "Calculating discount for price: #{price}, percentage: #{discount_percentage}"
  
  # Ensure discount_percentage is treated as a float for accurate calculation
  discount_amount = price * (discount_percentage / 100.0)
  final_price = price - discount_amount

  # Pause execution here to inspect variables and potentially modify state.
  binding.irb

  puts "Discount amount: #{discount_amount}"
  puts "Final price: #{final_price}"
  final_price
end

item_price = 150
discount = 10

# Call the method with initial values
puts "\n--- First Calculation (150, 10%) ---"
calculate_discount(item_price, discount)

puts "\n--- Second Calculation (200, 25%) ---"
calculate_discount(200, 25)

puts "\nProgram finished."

# Instructions for interacting with IRB:
# 1. Run the script: ruby irb_explorer.rb
# 2. When execution pauses at `binding.irb` for the first calculation:
#    - Type 'price' (and Enter) to see its current value (150).
#    - Type 'discount_percentage' to see its value (10).
#    - Type 'discount_amount = 50' to manually change the discount amount.
#    - Type 'final_price = price - discount_amount' to recalculate based on the new 'discount_amount'.
#    - Type 'whereami' to see the current location in code.
#    - Type 'ls' to list local variables and methods.
#    - Type 'continue' to resume execution of the script.
#    - Type 'exit' to quit IRB and terminate the program.
# 3. Repeat for the second calculation.

# File: pry_powerhouse.rb
# This script showcases advanced interactive debugging features of Pry.

require 'pry'

class User
  attr_accessor :name, :email
  attr_reader :registered_at

  def initialize(name, email)
    @name = name
    @email = email
    @registered_at = Time.now
  end

  def full_info
    "Name: #{name}, Email: #{email}, Registered: #{@registered_at.strftime('%Y-%m-%d %H:%M:%S')}"
  end

  def update_email(new_email)
    # Simulating a validation check
    if new_email.include?('@')
      self.email = new_email
      puts "Email updated to: #{self.email}"
    else
      puts "Invalid email format for: #{new_email}"
    end
  end
end

def process_user_data(user_object)
  puts "Processing user: #{user_object.name}"
  
  # Introduce a breakpoint for Pry. Program will pause here.
  binding.pry

  puts "User processed successfully. Final info: #{user_object.full_info}"
  user_object.full_info
end

my_user = User.new("Alice", "alice@example.com")
puts "Initial User Info: #{my_user.full_info}"
process_user_data(my_user)

puts "\nProgram finished."

# Instructions for interacting with Pry:
# 1. Ensure you have the 'pry' gem installed: gem install pry
# 2. Run the script: ruby pry_powerhouse.rb
# 3. When execution pauses at `binding.pry`:
#    - Type 'ls' to see local variables (my_user) and methods in the current scope.
#    - Type 'ls -M User' to see all methods defined on the User class.
#    - Type 'ls -i my_user' to see instance variables of the 'my_user' object.
#    - Type 'cd my_user' to change the current console scope to the 'my_user' object.
#      - Inside 'my_user' scope: Type 'ls' again to see its methods/variables.
#      - Type 'name' or 'email' to inspect them.
#      - Type 'name = "Alicia"' to change the name.
#      - Type 'update_email("alicia.smith@example.com")' to call a method on the object.
#      - Type 'exit' to return to the previous scope (the 'process_user_data' method scope).
#    - Type 'show-source User#full_info' to display the source code of the 'full_info' method.
#    - Type 'edit User#full_info' to open 'full_info' in your default editor (e.g., VS Code).
#      - Make a change (e.g., add more details), save the file, and close the editor.
#      - Pry will reload the changes instantly into the running application.
#    - Type 'full_info' to see the effect of your changes immediately.
#    - Type 'continue' to resume execution of the script.
#    - Type 'exit' to quit Pry and terminate the program.

# File: optimized_debugging.rb
# This script demonstrates advanced debugging techniques and best practices with Pry.

require 'pry'

class ReportGenerator
  def initialize(data)
    @data = data
  end

  def generate_summary(threshold)
    puts "Generating summary for data with threshold: #{threshold}"
    summary = []
    @data.each_with_index do |value, index|
      # Conditional breakpoint: Program will pause only if value exceeds threshold AND is at a specific index.
      # This is achieved by wrapping `binding.pry` in an 'if' statement.
      if value > threshold && index == 2
        puts "--> Debugging: Conditional breakpoint triggered for value=#{value} at index=#{index}"
        binding.pry # Program will pause here conditionally
      end

      # Simulating some data processing
      if value > threshold
        summary << "High: #{value}"
      else
        summary << "Low: #{value}"
      end
    end
    summary.join(", ")
  end
end

data_points = [10, 25, 60, 15, 80] # Note: 60 is at index 2
generator = ReportGenerator.new(data_points)

puts "Starting report generation...\n"

# Example 1: Triggering the conditional breakpoint
puts "Report 1 (Threshold 50): #{generator.generate_summary(50)}" # This should pause when value is 60 (index 2)

puts "\n--- Next Report (should NOT trigger breakpoint) ---"
# Example 2: Not triggering the conditional breakpoint
puts "Report 2 (Threshold 100): #{generator.generate_summary(100)}" # No value > 100, so no pause.

puts "\nProgram finished."

# Instructions for interaction and advanced commands within Pry:
# 1. Run the script: ruby optimized_debugging.rb
# 2. When inside Pry (triggered by the conditional binding.pry):
#    - Type 'value' to see its current value (e.g., 60).
#    - Type 'index' to see its current index (e.g., 2).
#    - Type 'next' to step over the current line of code (execute it and move to the next).
#    - Type 'step' to step into any method call on the current line (e.g., if there was a helper method call).
#    - Type 'continue' to resume normal execution until the next breakpoint or the end of the program.
#    - Type 'finish' to execute until the end of the current method (`generate_summary`) and then pause again.
#    - Type 'whereami' to show the current context and surrounding code.
#    - Type 'edit' or 'edit generate_summary' to open the code in your editor for live modification.
#    - Type 'help' to see a list of all available Pry commands and their descriptions.
#    - Type 'exit' to quit Pry and terminate the program.