Ruby入門:テキストを整形する小さな道具を作る手順

Ruby入門:テキストを整形する小さな道具を作る手順 Ruby

こんにちは!ともです。メモや原稿のテキストファイルを渡されたとき、行の頭や末尾に余分な空白が混ざっていて、そのままでは使いにくい、という場面があります。1つずつ手で直すのは件数が多いほど大変です。

この記事では、フレームワークを使わない「素のRuby」で、テキストファイルを読み込んで行頭・行末の空白を整え、行番号を付けて別ファイルへ書き出す小さな道具を作ります。Rubyという言語そのものの書き味に触れる入門作例です。

【この記事で分かること】

この記事で分かること
この記事で分かること
  • Rubyで作るテキスト整形ツールの完成形
  • 必要なものとコスト
  • rbenvでRubyをインストールする手順
  • ファイルを読み込んで、行ごとに空白を整える書き方
  • 行番号を付けて、別ファイルへ書き出す書き方
  • 実行コマンドと、結果の確認の仕方

【完成品のイメージ:ぐちゃっとした行が、番号付きできれいにそろう】

完成品のイメージ:ぐちゃっとした行が、番号付きできれいにそろう
完成品のイメージ:ぐちゃっとした行が、番号付きできれいにそろう

完成すると、コマンド1つでテキストファイルを整形できる道具が手に入ります。たとえば、次のような入力ファイルを用意します。

# 変換前の例(input.txt)
  会議のメモです
次回の予定は来週
    資料は事前に共有する

行頭の空白は行ごとにばらばらで、行末にも余分な空白が混ざっています。この道具に通すと、空白がそろい、行番号が付いた形で別ファイルに書き出されます。

# 変換後の例(output.txt)
1: 会議のメモです
2: 次回の予定は来週
3: 資料は事前に共有する

元のファイルは書き換えず、整形した結果を別のファイルに残す形にします。「読み込む→整える→書き出す」という、ファイル処理の基本の流れがそのまま題材です。似た題材をPythonで扱った作例もあるので、言語ごとの書き味の違いを比べてみたい場合はそちらもどうぞ。

フォルダ内のファイルを名前のルールで自動整理する小さな道具

【必要なものとコスト】

必要なものとコスト
必要なものとコスト

Rubyは無料で公開されているオープンソースです。自分のパソコンの中で動かす範囲では、料金はかかりません。

項目内容
使うツールRuby/rbenv(Rubyのバージョン管理ツール)/VS Codeなどのエディタ
料金の目安無料(約0円)
前提Mac、またはWSL2を用意したWindows/ターミナルの基本操作

バージョンの目安として、2026年11月時点でRubyの現行系列は3.4系です。この記事では、長く使える3.4系を用意します。細かなバージョンの対応は変わりやすいため、導入時に公式サイトで最新を確認してください。

【難易度と進め方の目安】

難易度と進め方の目安
難易度と進め方の目安

難易度は低めです。作る道具は1ファイルの短いプログラムで、フレームワークの知識は要りません。目安の所要時間は、Rubyのインストール込みで1時間前後です。

進め方は「Rubyの導入→プログラムを書く→小さなサンプルで実行→結果を確認する」の順番です。エディタはVS Codeがあると、プログラムの作成と修正がしやすくなります。

VS Codeのインストールと初期設定

【インストール・初期設定】

インストール・初期設定
インストール・初期設定

Rubyの導入には、バージョン管理の道具「rbenv」経由で入れる方法を使います。パソコンに最初から入っているRubyとは別に、自分で選んだバージョンを用意できるため、あとからバージョンを切り替えるときにも困りません。Macの場合はHomebrewなどからrbenvを先に入れ、Windowsの場合はWSL2(Windowsの中でLinuxを動かす仕組み)の中で用意するのが基本です。rbenv自体の入れ方は環境で異なるため、公式の案内に沿って進めてください。

rbenvが使えるようになったら、Ruby 3.4系を入れます。バージョンは、パッチ版まで含めた完全な番号で指定するのがポイントです。

# バージョン管理の道具 rbenv で、Ruby 3.4系をインストールする(少し時間がかかる)
# バージョンは、パッチ版まで含めた完全な番号で指定する(数字は一例)
rbenv install 3.4.8

# このパソコン全体で使うRubyとして、入れたバージョンを指定する
rbenv global 3.4.8

# Rubyのバージョンを表示して確認する(3.4.8 と表示されれば用意ができている)
ruby -v

ruby -v で入れたバージョンが表示されれば、土台は動いています。違う数字が表示される場合は、rbenv global の指定を忘れていないかを確認してください。

【作り方の骨格1:ファイルを読み込んで、行ごとに空白を整える】

作り方の骨格1:ファイルを読み込んで、行ごとに空白を整える
作り方の骨格1:ファイルを読み込んで、行ごとに空白を整える

プログラムは text_cleaner.rb という名前のファイルに書きます。まず前半として、ファイルを読み込み、行頭と行末の空白を取り除くところまでを作ります。

# テキストファイルを読み、行頭・行末の空白を整えて、行番号を付けて別ファイルへ書き出す道具
# 使い方: ruby text_cleaner.rb input.txt output.txt

# コマンドライン引数から、入力ファイルと出力ファイルの名前を受け取る
input_file = ARGV[0]
output_file = ARGV[1]

# 入力ファイルを1行ずつ読み込む(chomp: true で、行末の改行を取り除いておく)
lines = File.readlines(input_file, chomp: true)

# 各行の行頭と行末の空白を取り除く
# 半角スペースとタブに加えて、全角スペースも対象にしている
cleaned = lines.map do |line|
  line.gsub(/\A[ \t ]+|[ \t ]+\z/, '')
end

ポイントは2つです。1つ目は、入力と出力のファイル名をプログラムの中に直接書かず、コマンドライン引数(ARGV)で受け取る形にしていることです。ファイル名を外から渡せるようにしておくと、別のテキストでも同じ道具を使い回せます。

2つ目は、空白の取り除き方です。Rubyには行頭・行末の空白を取る strip という部品もありますが、これは半角の空白が中心で、全角スペースは対象になりません。日本語のテキストでは全角スペースが混ざることが多いため、ここでは gsub(置き換えの部品)で対象を明示しています。空行はそのまま空行として残ります。

【作り方の骨格2:行番号を付けて、別ファイルへ書き出す】

作り方の骨格2:行番号を付けて、別ファイルへ書き出す
作り方の骨格2:行番号を付けて、別ファイルへ書き出す

後半では、整えた各行に行番号を付けて、出力ファイルへ書き出します。前半の続きとして、同じファイルに書き足してください。

# 整えた行に、先頭から順番に番号を付けて、1つの文字列に組み立てる
numbered = cleaned.each_with_index.map do |line, index|
  "#{index + 1}: #{line}"
end

# 組み立てた文字列を、出力ファイルへ書き出す(末尾に改行を付ける)
File.write(output_file, numbered.join("\n") + "\n")

# 完了したことを画面に表示する(書き出した行数もあわせて出す)
puts "#{output_file} に #{numbered.size} 行を書き出しました"

each_with_index は「要素と、その順番(0から始まる番号)」をセットで取り出す部品です。表示する行番号は1から始めたいので、index + 1 としています。実行はターミナルから行います。

# 道具を実行する(入力ファイル input.txt を整形して、output.txt へ書き出す)
ruby text_cleaner.rb input.txt output.txt

# 書き出された結果の中身を表示して確認する
cat output.txt

完了のメッセージが表示され、output.txt の中身が想定どおりに整っていれば完成です。元の input.txt は書き換えていないので、失敗してもやり直せます。

【つまずきやすい点】

つまずきやすい点
つまずきやすい点

よくあるつまずきは5つです。1つ目は、rbenv install のバージョン指定です。「3.4」のような短い指定では対象が定まらず、エラーになります。パッチ版まで含めた完全な番号(例:3.4.8)で指定してください。指定できる番号の一覧は rbenv install -l で確認できます。

2つ目は、rbenv global の指定忘れです。インストールしただけでは使うバージョンが切り替わらず、古いRubyで実行されてしまいます。ruby -v で数字を確認し、違う場合はglobalの指定と、ターミナルの開き直しを試してください。

3つ目は、ファイルが見つからないエラー(Errno::ENOENT)です。入力ファイルの名前や、コマンドを実行している場所(カレントディレクトリ)がずれていないかを確認します。道具と入力ファイルは、同じフォルダに置くのが分かりやすい形です。

4つ目は、日本語の文字化けや文字コードのエラーです。入力ファイルの保存形式がUTF-8でないと、読み込みの段階でエラーになることがあります。エディタでファイルを開き、UTF-8で保存し直してから実行してください。

5つ目は、全角スペースが取れていないケースです。前述のとおり strip だけでは全角スペースは対象外です。この記事のコードでは gsub で対象に含めていますが、書き換えた場合は対象の文字が漏れていないか確認してください。

【まとめ】

まとめ
まとめ

素のRubyの入門は、「rbenvでRubyを用意する→ファイルを読み込む→行ごとに整える→行番号を付けて書き出す」という流れで進みます。1ファイルの小さな道具でも、「読み込む→加工する→書き出す」というファイル処理の型は、大きな道具でも変わりません。

この先、「データをためて、画面で操作できるWebアプリ」を作りたくなったら、Rubyのフレームワークの作例が次の段階です。

Ruby on Rails入門:CRUDアプリの骨格を作る手順

なお、「自分で作るのではなく、業務の自動化そのものを相談したい」という場合は、作ってもらう選択肢もあります。

\ 業務の自動化やAI活用を、代わりに作ってほしい方はこちら /

コメント

タイトルとURLをコピーしました