読み込み中...

【Ruby】コマンドライン引数活用の12ステップ

Rubyのコマンドライン引数を使ったプログラミングのイメージ画像 Ruby
2023.12.23
この記事は約9分で読めます。

【サイト内のコードはご自由に個人利用・商用利用いただけます】

この記事では、プログラムの基礎知識を前提に話を進めています。

説明のためのコードや、サンプルコードもありますので、もちろん初心者でも理解できるように表現してあります。

本記事のサンプルコードを活用して機能追加、目的を達成できるように作ってありますので、是非ご活用ください。

※この記事は、一般的にプロフェッショナルの指標とされる『実務経験10,000時間以上』を満たす現役のプログラマチームによって監修されています。

※Japanシーモアは、常に解説内容のわかりやすさや記事の品質に注力しております。不具合、分かりにくい説明や不適切な表現、動かないコードなど気になることがございましたら、記事の品質向上の為にお問い合わせフォームにてご共有いただけますと幸いです。
(送信された情報は、プライバシーポリシーのもと、厳正に取扱い、処分させていただきます。)

はじめに

Rubyのコマンドライン引数は、シェルスクリプトやバッチファイルからプログラムを実行する際に特に役立つツールです。

この記事を読むことで、Rubyでコマンドライン引数を使うための基本的な知識と使い方、そしてそれを活用するための具体的な例を学ぶことができます。

あなたが初めてコマンドライン引数を使用する場合でも、この記事はあなたがそれを理解し、自分のプロジェクトで利用するための第一歩となるでしょう。

●コマンドライン引数とは

コマンドライン引数とは、プログラムをコマンドライン（ターミナルやシェル）から実行するときに、プログラムに追加情報を渡すために使用されるパラメータのことを指します。

これらの引数は、プログラムの実行時に操作するデータや、プログラムの動作を制御するためのフラグなど、さまざまな目的で使用することができます。

●Rubyでのコマンドライン引数の基本

Rubyでは、コマンドライン引数はARGVという特別な配列を通じてアクセスすることができます。

このARGV配列には、コマンドラインから与えられた引数が順番に格納されます。

つまり、最初の引数はARGV[0]、次の引数はARGV[1]となります。

○サンプルコード1：基本的なコマンドライン引数の取得

# コマンドライン引数を取得する基本的なコード
# 引数はARGV配列を通じてアクセスできます
puts ARGV[0]

このコードでは、ARGV配列を使って最初のコマンドライン引数を取得し、それを表示しています。

この例では、”ruby sample.rb Hello”と実行すると”Hello”が表示されます。

●コマンドライン引数の応用

Rubyのコマンドライン引数は、基本的な使用法だけでなく、さまざまな応用的な使い方も可能です。

複数の引数の取得や、引数の有無で処理を変えるなどの動的な振る舞いをプログラムに組み込むこともできます。

○サンプルコード2：複数の引数を取得する

Rubyでは、コマンドライン引数はすべてARGV配列に格納されます。

これにより、複数の引数を簡単に取得することができます。

# 全てのコマンドライン引数を取得し、一つずつ表示するコード
ARGV.each do |arg|
  puts arg
end

このコードでは、eachメソッドを使ってARGV配列のすべての要素を順番に取り出し、それぞれを表示しています。

この例では、”ruby sample.rb Hello World”と実行すると、一行目に”Hello”、二行目に”World”が表示されます。

○サンプルコード3：引数の有無で処理を変える

引数の有無で処理を変更するというのは、コマンドライン引数を活用する一般的なシナリオの一つです。

下記のコードは、引数が与えられたかどうかを判断し、それに応じて処理を分岐する例です。

# 引数がある場合とない場合で処理を変えるコード
if ARGV.length > 0
  puts "Hello, #{ARGV[0]}!"
else
  puts "Hello, World!"
end

このコードでは、引数が与えられている場合はその引数を使って挨拶し、引数がない場合は”Hello, World!”と表示します。

この例では、”ruby sample.rb Alice”と実行すると”Hello, Alice!”と表示され、引数がない場合は”Hello, World!”と表示されます。

○サンプルコード4：引数をオプションとして使う

引数は単なるデータだけでなく、プログラムの振る舞いを制御する「オプション」としても使うことができます。

下記のコードは、特定のオプションが指定されているかどうかを判断する例です。

# オプションを認識し、それに応じて処理を変えるコード
if ARGV.include?("--help")
  puts "This is a help message."
else
  puts "Running the program..."
end

このコードでは、”–help”というオプションが引数に含まれているかどうかを判断し、含まれている場合はヘルプメッセージを表示し、含まれていない場合は通常の処理（ここでは”Running the program…”と表示する）を行います。

この例では、”ruby sample.rb –help”と実行すると”This is a help message.”と表示されます。

●エラーハンドリングと注意点

Rubyでコマンドライン引数を扱う際には、エラーハンドリングといくつかの注意点を理解しておくことが重要です。

まず、ARGV配列に何も入っていない場合に、インデックスで引数を取り出そうとすると、nilが返されます。

しかし、nilに対して何らかの操作を試みるとエラーが発生します。

また、引数が必要なコマンドを引数なしで実行した場合、期待しない結果を引き起こすことがあります。

これらの事態を避けるためには、適切なエラーハンドリングと引数のバリデーションが必要です。

○サンプルコード5：エラーハンドリングの例

下記のコードは、引数の数を確認し、必要な数が揃っていない場合にエラーメッセージを表示する例です。

# 引数の数を確認し、足りない場合はエラーメッセージを表示する
if ARGV.length < 2
  puts "Error: Please provide two arguments."
  exit
end

puts "The first argument is #{ARGV[0]}"
puts "The second argument is #{ARGV[1]}"

このコードでは、引数が2つ未満の場合にエラーメッセージを表示し、プログラムを終了します。

そのため、”ruby sample.rb Alice”のように1つの引数しか提供されていない場合、”Error: Please provide two arguments.”と表示され、プログラムは終了します。

一方、”ruby sample.rb Alice Bob”と2つの引数を提供すれば、各引数が表示されます。

●Rubyのコマンドライン引数を使ったプロジェクト例

Rubyでコマンドライン引数を使う具体的なプロジェクト例として、コマンドラインツールの作成とファイル操作スクリプトの作成を紹介します。

これらの例を通じて、Rubyのコマンドライン引数が実際の開発にどのように活用できるかを理解していきましょう。

○サンプルコード6：コマンドラインツールの作成例

Rubyはスクリプト言語として強力で、コマンドラインツールの作成に適しています。

下記のコードは、引数を使って名前を受け取り、挨拶する簡単なコマンドラインツールを作成する例です。

# 名前を引数に取り、挨拶するコマンドラインツール
if ARGV.length != 1


  puts "Error: Please provide one argument."
  exit
end

puts "Hello, #{ARGV[0]}!"

このコードでは、名前を1つの引数として受け取り、その名前を使って挨拶します。

引数が1つでない場合はエラーメッセージを表示し、プログラムを終了します。

したがって、”ruby sample.rb Alice”と実行すると、”Hello, Alice!”と表示されます。

しかし、引数が提供されていない場合や2つ以上の場合にはエラーメッセージが表示されます。

○サンプルコード7：ファイル操作スクリプトの作成例

また、Rubyを使ってコマンドライン引数を受け取り、その引数に基づいてファイル操作を行うスクリプトも作成できます。

下記のコードは、引数として受け取ったファイル名のファイルを開き、その内容を表示する例です。

# ファイル名を引数に取り、その内容を表示するスクリプト
if ARGV.length != 1
  puts "Error: Please provide one argument."
  exit
end

filename = ARGV[0]

begin
  file_content = File.read(filename)
  puts file_content
rescue Errno::ENOENT
  puts "Error: The file '#{filename}' does not exist."
end

このコードでは、まず引数を1つだけ受け取ることを確認し、その引数をファイル名として使用します。

次に、begin-rescue文を使ってエラーハンドリングを行います。

ここで、File.readメソッドがエラーErrno::ENOENT（ファイルが存在しない）を引き起こす可能性があるためです。

ファイルが存在する場合はその内容が表示され、存在しない場合はエラーメッセージが表示されます。

●コマンドライン引数のテスト方法

コマンドライン引数を使用するプログラムをテストする際には、それらの引数を模擬することが必要です。

これは、テスト中にプログラムに引数を手動で提供することは不可能だからです。

Rubyでは、ARGV配列を直接操作することでこれを実現できます。

○サンプルコード8：テストコードの書き方

下記のコードは、minitestフレームワークを使って、コマンドライン引数をテストする例を表しています。

# コマンドライン引数をテストする
require 'minitest/autorun'

class TestSample < Minitest::Test
  def test_argument
    ARGV.clear
    ARGV << "Alice"
    output = `ruby sample.rb`
    assert_equal "Hello, Alice!\n", output
  end
end

このコードでは、まずARGV配列をクリアし、次に必要な引数を追加しています。

その後、バッククォートを使ってコマンドラインからRubyスクリプトを実行し、その出力を取得します。

最後に、期待した出力と実際の出力が一致するかを確認します。

まとめ

Rubyのコマンドライン引数を理解し、適切に使用することで、より強力で効率的なコマンドラインツールやスクリプトを作成することが可能になります。

この記事では、その基本的な使い方からエラーハンドリング、さらにはテスト方法まで、コマンドライン引数を完全にマスターするためのステップを解説しました。

あなたもこれらの知識を利用して、Rubyプログラミングのスキルを一段と上げてみませんか。