Как написать простой CLI инструмент на Ruby

Ruby — это мощный и гибкий язык программирования, который идеально подходит для создания различных приложений, включая инструменты командной строки (CLI). В этом руководстве мы рассмотрим, как создать простой CLI инструмент на Ruby, который будет полезен и интересен. Мы пройдем через все этапы, от установки необходимых инструментов до написания и тестирования нашего приложения.

Что такое CLI инструмент?

CLI (Command Line Interface) инструмент — это программа, которая взаимодействует с пользователем через текстовый интерфейс. Пользователи вводят команды в терминале, а программа обрабатывает их и выводит результаты. CLI инструменты часто используются для автоматизации задач, управления системами и выполнения различных операций без необходимости графического интерфейса.

Установка Ruby

Перед тем как начать, убедитесь, что у вас установлен Ruby. Вы можете проверить это, выполнив следующую команду в терминале:

ruby -v

Если Ruby не установлен, вы можете установить его с помощью менеджера версий, такого как rbenv или RVM, или скачать с официального сайта Ruby.

Создание нового проекта

Создадим новую директорию для нашего проекта и перейдем в нее:

mkdir my_cli_tool
cd my_cli_tool

Теперь создадим файл с именем cli_tool.rb, в котором будет находиться наш код:

touch cli_tool.rb

Структура CLI инструмента

Простой CLI инструмент может принимать аргументы командной строки и выполнять определенные действия в зависимости от этих аргументов. Давайте создадим инструмент, который будет выполнять простые математические операции: сложение, вычитание, умножение и деление.

Обработка аргументов командной строки

Для начала нам нужно обработать аргументы, которые пользователь передает в командной строке. Ruby предоставляет встроенный массив ARGV, который содержит все аргументы, переданные программе. Давайте добавим код для обработки этих аргументов:

# cli_tool.rb

def print_usage
  puts "Использование: ruby cli_tool.rb [операция] [число1] [число2]"
  puts "Операции: add, subtract, multiply, divide"
end

if ARGV.length != 3
  print_usage
  exit
end

operation = ARGV[0]
num1 = ARGV[1].to_f
num2 = ARGV[2].to_f

Реализация математических операций

Теперь давайте реализуем функции для каждой из операций. Мы создадим методы для сложения, вычитания, умножения и деления:

def add(a, b)
  a + b
end

def subtract(a, b)
  a - b
end

def multiply(a, b)
  a * b
end

def divide(a, b)
  return "Ошибка: деление на ноль" if b.zero?
  a / b
end

Теперь мы можем использовать эти методы в зависимости от выбранной операции:

case operation
when "add"
  result = add(num1, num2)
when "subtract"
  result = subtract(num1, num2)
when "multiply"
  result = multiply(num1, num2)
when "divide"
  result = divide(num1, num2)
else
  print_usage
  exit
end

puts "Результат: #{result}"

Полный код CLI инструмента

Теперь, когда мы реализовали все необходимые функции, давайте соберем весь код вместе:

# cli_tool.rb

def print_usage
  puts "Использование: ruby cli_tool.rb [операция] [число1] [число2]"
  puts "Операции: add, subtract, multiply, divide"
end

if ARGV.length != 3
  print_usage
  exit
end

operation = ARGV[0]
num1 = ARGV[1].to_f
num2 = ARGV[2].to_f

def add(a, b)
  a + b
end

def subtract(a, b)
  a - b
end

def multiply(a, b)
  a * b
end

def divide(a, b)
  return "Ошибка: деление на ноль" if b.zero?
  a / b
end

case operation
when "add"
  result = add(num1, num2)
when "subtract"
  result = subtract(num1, num2)
when "multiply"
  result = multiply(num1, num2)
when "divide"
  result = divide(num1, num2)
else
  print_usage
  exit
end

puts "Результат: #{result}"

Тестирование нашего CLI инструмента

Теперь, когда наш инструмент готов, давайте протестируем его. Откройте терминал и выполните следующие команды:

ruby cli_tool.rb add 5 3
ruby cli_tool.rb subtract 10 4
ruby cli_tool.rb multiply 6 7
ruby cli_tool.rb divide 8 2
ruby cli_tool.rb divide 8 0

Вы должны увидеть следующие результаты:

Результат: 8.0
Результат: 6.0
Результат: 42.0
Результат: 4.0
Ошибка: деление на ноль

Заключение

Поздравляем! Вы только что создали свой собственный простой CLI инструмент на Ruby. Мы рассмотрели, как обрабатывать аргументы командной строки, реализовывать функции для выполнения математических операций и тестировать наш инструмент. Теперь вы можете расширить его функциональность, добавив больше операций или улучшив обработку ошибок.

Ruby — это отличный язык для создания CLI инструментов, и с его помощью вы можете автоматизировать множество задач. Надеемся, что это руководство было полезным и вдохновило вас на создание собственных проектов!