Командні рядки в Ruby CLI

Ruby - це потужна мова програмування, яка дозволяє створювати різноманітні програми, включаючи командні рядки (CLI). Використання командних рядків у Ruby може значно спростити взаємодію з вашими програмами, дозволяючи користувачам передавати параметри та налаштування безпосередньо через термінал. У цій статті ми розглянемо, як працюють командні рядки в Ruby, які бібліотеки можна використовувати для їх обробки, а також надамо кілька прикладів.

Що таке командні рядки?

Командні рядки - це текстові команди, які вводяться в терміналі або командному рядку операційної системи. Вони дозволяють користувачам взаємодіяти з програмами, передаючи їм параметри, які можуть змінювати поведінку програми. Наприклад, ви можете запустити програму з певними параметрами, які вказують, які дані обробляти або які дії виконувати.

Основи обробки командних рядків у Ruby

У Ruby є кілька способів обробки командних рядків. Найпростішим способом є використання масиву ARGV, який містить всі аргументи, передані вашій програмі через командний рядок. Давайте розглянемо приклад:

puts "Вітаю, #{ARGV[0]}!" if ARGV.length > 0

У цьому прикладі програма виведе привітання з ім'ям, яке передано як перший аргумент командного рядка. Якщо ви запустите програму з командою:

ruby my_program.rb Олександр

Вона виведе:

Вітаю, Олександр!

Обробка параметрів командного рядка

Хоча використання ARGV є простим способом обробки аргументів, для більш складних сценаріїв рекомендується використовувати бібліотеки, які спрощують цю задачу. Однією з найпопулярніших бібліотек для обробки командних рядків у Ruby є OptionParser.

Використання OptionParser

Бібліотека OptionParser дозволяє вам визначати параметри командного рядка, які ваша програма може приймати, а також автоматично генерувати допомогу для користувачів. Ось приклад використання OptionParser:

require 'optparse'

options = {}
OptionParser.new do |opts|
  opts.banner = "Використання: my_program.rb [опції]"

  opts.on("-nNAME", "--name NAME", "Ваше ім'я") do |name|
    options[:name] = name
  end

  opts.on("-h", "--help", "Показати цю допомогу") do
    puts opts
    exit
  end
end.parse!

puts "Вітаю, #{options[:name]}!" if options[:name]

У цьому прикладі ми визначили два параметри: -n або --name для імені та -h або --help для відображення допомоги. Коли ви запустите програму з параметром -n, вона виведе привітання з вашим ім'ям:

ruby my_program.rb -n Олександр

Виведе:

Вітаю, Олександр!

Додаткові можливості OptionParser

Бібліотека OptionParser має багато інших можливостей, які можуть бути корисними для вашої програми. Ось кілька з них:

Визначення обов'язкових параметрів: Ви можете зробити параметри обов'язковими, перевіряючи їх наявність після парсингу.
Визначення значень за замовчуванням: Ви можете задати значення за замовчуванням для параметрів, якщо вони не були передані.
Валідація параметрів: Ви можете додати логіку для перевірки правильності значень параметрів.

Приклад програми з OptionParser

Давайте розглянемо більш складний приклад програми, яка використовує OptionParser для обробки кількох параметрів:

require 'optparse'

options = {
  name: 'Гість',
  age: nil,
  verbose: false
}

OptionParser.new do |opts|
  opts.banner = "Використання: my_program.rb [опції]"

  opts.on("-nNAME", "--name NAME", "Ваше ім'я") do |name|
    options[:name] = name
  end

  opts.on("-aAGE", "--age AGE", "Ваш вік") do |age|
    options[:age] = age.to_i
  end

  opts.on("-v", "--verbose", "Виводити детальну інформацію") do
    options[:verbose] = true
  end

  opts.on("-h", "--help", "Показати цю допомогу") do
    puts opts
    exit
  end
end.parse!

if options[:verbose]
  puts "Запущено з параметрами: #{options.inspect}"
end

puts "Вітаю, #{options[:name]}!"
puts "Ваш вік: #{options[:age]}" if options[:age]

Ця програма приймає три параметри: ім'я, вік і параметр для детального виводу. Якщо ви запустите програму з параметрами:

ruby my_program.rb -n Олександр -a 30 -v

Вона виведе:

Запущено з параметрами: {:name=>"Олександр", :age=>30, :verbose=>true}
Вітаю, Олександр!
Ваш вік: 30

Висновок

Обробка командних рядків у Ruby є важливою частиною створення зручних для користувача програм. Використовуючи бібліотеку OptionParser, ви можете легко визначати параметри, які ваша програма може приймати, а також надавати користувачам зрозумілу допомогу. Сподіваємося, що ця стаття допомогла вам зрозуміти основи роботи з командними рядками в Ruby. Тепер ви готові створювати свої власні CLI-програми!