timecalc-cli 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f0a9f612e928ac76c23ed9465032704fb65e69efa20d19953809d3b5e9f88fd1
+  data.tar.gz: b421a1764b820597bf222d4cfa60842035c8eba0124c490da9e0990fa75623f9
+SHA512:
+  metadata.gz: 35800c706e05118ff7ccccf4c52e9dfa2fb1633b76441af5650d3ce8cb289acece56cf27d786fc92a6a61025f29e103d46c53c5abc377f930eeccdadc740c23d
+  data.tar.gz: b1d5eb7ee8add40bc8f6a0436f0a5e48df995e71bcc6788df4f9cb0056c11c6e75f2ff8c75c17b98f40a34f9b8ca4b31df1badef2376b9e6a6f189d35657554c

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eli
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,297 @@
+# TimeCalc
+
+TimeCalcは、複数の時間帯を入力して、合計時間を計算できるRuby製のコマンドラインツール（CLI）です。
+
+**日本語 | [English](#english)**
+
+---
+
+## 日本語
+
+### 機能
+
+- 複数の時間帯の合計時間を計算
+- `HH:MM` または `HH` 形式で時刻を指定可能
+- 各時間帯の経過時間と合計時間を表示
+- `--hm` で標準入力の時間・分データを縦に合計
+- 不正な入力は標準エラー出力に表示し、終了コード `1` で終了
+
+### インストール
+
+Rubyがインストールされている環境で、以下を実行してください。
+
+```bash
+gem install timecalc-cli
+```
+
+※ RubyGems.orgへの公開後に利用できます。
+
+### 使い方
+
+複数の時間帯をカンマ区切りで指定します。
+
+```bash
+timecalc "11:17-12, 12:30-13, 13:15-14, 15:30-18"
+```
+
+実行結果：
+
+```text
+11:17 - 12 : 0時間43分
+12:30 - 13 : 0時間30分
+13:15 - 14 : 0時間45分
+15:30 - 18 : 2時間30分
+--------------------------
+合計：4時間28分
+```
+
+分を省略した場合は、0分として扱います。
+
+```bash
+timecalc "11-12, 13-15"
+```
+
+実行結果：
+
+```text
+11 - 12 : 1時間0分
+13 - 15 : 2時間0分
+--------------------------
+合計：3時間0分
+```
+
+### 時間・分を縦に合計する（`--hm`）
+
+`--hm` を指定すると、標準入力から1行につき1件の経過時間を受け取り、EOF（Ctrl+D）で合計を表示します。
+
+```bash
+timecalc --hm
+6.15
+8.4
+7.7
+# Ctrl+D
+```
+
+```text
+合計：21時間26分
+```
+
+ファイルからの入力にも対応しています。
+
+```bash
+timecalc --hm < times.txt
+```
+
+`6.15` は6時間15分を表します。これは小数ではなく、ピリオドの前を時間、後ろを分として扱います。
+
+### 入力ルール
+
+- 時刻は2桁の `HH` または `HH:MM` 形式で指定します。
+- 時は `00`〜`23`、分は `00`〜`59` の範囲です。
+- 開始時刻は終了時刻以前にしてください。同じ時刻は0分として計算されます。
+- 日付をまたぐ時間帯には対応していません。
+- すべての時間帯を検証してから計算結果を表示します。不正な入力では結果を表示せず、標準エラー出力にエラーメッセージを表示して終了コード `1` で終了します。
+
+### `--hm` の入力ルール
+
+- 1行につき、非負の `H` または `H.MM` 形式で1件の経過時間を指定します。時間部分は24時間以上でも指定できます。
+- 分は `0`〜`59` の範囲です。`8.4`、`7.5`、`0.3`、`8.04` はそれぞれ8時間4分、7時間5分、0時間3分、8時間4分を表します。
+- 空行は無視します。負の数、文字列、不正な書式、範囲外の分はエラーになります。
+- 不正な行がある場合は、行番号を含むエラーを標準エラー出力に表示し、合計は表示しません。
+
+### オプション
+
+```bash
+timecalc --help
+timecalc --version
+timecalc --hm
+```
+
+### 開発方法
+
+リポジトリをクローンし、依存ライブラリをインストールします。
+
+```bash
+git clone https://github.com/<username>/timecalc.git
+cd timecalc
+bundle install
+```
+
+ローカルで実行します。
+
+```bash
+bundle exec ruby bin/timecalc "11-12, 13-15"
+```
+
+テストを実行します。
+
+```bash
+bundle exec rspec
+```
+
+Gemをビルドします。
+
+```bash
+gem build timecalc-cli.gemspec
+```
+
+ビルドしたGemをローカルにインストールします。
+
+```bash
+gem install ./timecalc-cli-0.1.0.gem
+```
+
+### 動作環境
+
+- Ruby 3.1以上
+
+### ライセンス
+
+MIT License
+
+---
+
+## English
+
+TimeCalc is a Ruby command-line tool (CLI) that calculates the total duration of multiple time ranges.
+
+### Features
+
+- Calculate the total duration of multiple time ranges
+- Support `HH:MM` and `HH` time formats
+- Display individual durations and the total duration
+- Sum line-oriented hours-and-minutes input from standard input with `--hm`
+- Print invalid-input errors to standard error and exit with status `1`
+
+### Installation
+
+Run the following command in an environment with Ruby installed.
+
+```bash
+gem install timecalc-cli
+```
+
+_This command will be available after the gem is published to RubyGems.org._
+
+### Usage
+
+Pass multiple time ranges separated by commas.
+
+```bash
+timecalc "11:17-12, 12:30-13, 13:15-14, 15:30-18"
+```
+
+Output:
+
+```text
+11:17 - 12 : 0時間43分
+12:30 - 13 : 0時間30分
+13:15 - 14 : 0時間45分
+15:30 - 18 : 2時間30分
+--------------------------
+合計：4時間28分
+```
+
+If minutes are omitted, they are treated as `00`.
+
+```bash
+timecalc "11-12, 13-15"
+```
+
+Output:
+
+```text
+11 - 12 : 1時間0分
+13 - 15 : 2時間0分
+--------------------------
+合計：3時間0分
+```
+
+### Sum line-oriented hours and minutes (`--hm`)
+
+With `--hm`, enter one elapsed duration per line through standard input. End input with EOF (Ctrl+D) to print the total.
+
+```bash
+timecalc --hm
+6.15
+8.4
+7.7
+# Ctrl+D
+```
+
+```text
+合計：21時間26分
+```
+
+Input redirection is also supported:
+
+```bash
+timecalc --hm < times.txt
+```
+
+`6.15` means 6 hours and 15 minutes. It is not a decimal value: the portion before the period is hours and the portion after it is minutes.
+
+### Input rules
+
+- Times must use the two-digit `HH` or `HH:MM` format.
+- Hours must be from `00` to `23`; minutes must be from `00` to `59`.
+- The start time must be no later than the end time. Equal times count as zero minutes.
+- Time ranges that cross midnight are not supported.
+- All ranges are validated before any results are printed. Invalid input prints an error to standard error and exits with status `1` without printing results.
+
+### `--hm` input rules
+
+- Enter one non-negative elapsed duration per line in `H` or `H.MM` format. The hour portion may be 24 or greater.
+- Minutes must be from `0` to `59`. `8.4`, `7.5`, `0.3`, and `8.04` mean 8 hours 4 minutes, 7 hours 5 minutes, 0 hours 3 minutes, and 8 hours 4 minutes, respectively.
+- Blank lines are ignored. Negative values, text, malformed values, and out-of-range minutes are errors.
+- If any line is invalid, an error including its line number is printed to standard error and no total is printed.
+
+### Options
+
+```bash
+timecalc --help
+timecalc --version
+timecalc --hm
+```
+
+### Development
+
+Clone the repository and install dependencies.
+
+```bash
+git clone https://github.com/<username>/timecalc.git
+cd timecalc
+bundle install
+```
+
+Run locally:
+
+```bash
+bundle exec ruby bin/timecalc "11-12, 13-15"
+```
+
+Run tests:
+
+```bash
+bundle exec rspec
+```
+
+Build the gem:
+
+```bash
+gem build timecalc-cli.gemspec
+```
+
+Install the gem locally:
+
+```bash
+gem install ./timecalc-cli-0.1.0.gem
+```
+
+### Requirements
+
+- Ruby 3.1 or later
+
+### License
+
+MIT License

data/bin/timecalc

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/timecalc_cli"
+
+exit TimecalcCLI.run(ARGV)

data/lib/timecalc/cli.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+module TimecalcCLI
+  VERSION = "0.1.0"
+  TIME_PATTERN = /\A\d{2}(?::\d{2})?\z/
+  RANGE_PATTERN = /\A(?<start>\d{2}(?::\d{2})?)-(?<finish>\d{2}(?::\d{2})?)\z/
+  HM_PATTERN = /\A(?<hours>\d+)(?:\.(?<minutes>\d{1,2}))?\z/
+  ParsedRange = Struct.new(:start_label, :end_label, :duration, keyword_init: true)
+
+  class InputError < StandardError; end
+
+  def self.run(args, input: $stdin, output: $stdout, error: $stderr)
+    case args
+    when []
+      output.puts help
+      return 0
+    when ["--help"]
+      output.puts help
+      return 0
+    when ["--version"]
+      output.puts VERSION
+      return 0
+    when ["--hm"]
+      return run_hm(input, output)
+    end
+
+    ranges = parse_ranges(args.join(" "))
+    print_result(ranges, output)
+    0
+  rescue InputError => e
+    error.puts "エラー: #{e.message}"
+    1
+  end
+
+  def self.run_hm(input, output)
+    total_minutes = parse_hm_entries(input).sum
+    output.puts "合計：#{format_duration(total_minutes)}"
+    0
+  end
+
+  def self.parse_hm_entries(input)
+    input.each_line.with_index(1).filter_map do |line, line_number|
+      value = line.strip
+      next if value.empty?
+
+      parse_hm_entry(value, line_number)
+    end
+  end
+
+  def self.parse_hm_entry(value, line_number)
+    match = HM_PATTERN.match(value)
+    unless match
+      raise InputError, "行 #{line_number}: 時間は H または H.MM 形式で指定してください: #{value.inspect}"
+    end
+
+    hours = match[:hours].to_i
+    minutes = match[:minutes]&.to_i || 0
+
+    unless minutes.between?(0, 59)
+      raise InputError, "行 #{line_number}: 分は 0〜59 の範囲で指定してください: #{value.inspect}"
+    end
+
+    (hours * 60) + minutes
+  end
+
+  def self.parse_ranges(input)
+    ranges = input.split(",", -1).map(&:strip)
+    raise InputError, "時間帯を指定してください。" if ranges.empty? || ranges.any?(&:empty?)
+
+    ranges.map { |range| parse_range(range) }
+  end
+
+  def self.parse_range(range)
+    match = RANGE_PATTERN.match(range)
+    raise InputError, "時間帯は HH-HH または HH:MM-HH:MM 形式で指定してください: #{range}" unless match
+
+    start_label = match[:start]
+    end_label = match[:finish]
+    start_minutes = to_minutes(start_label)
+    end_minutes = to_minutes(end_label)
+
+    if start_minutes > end_minutes
+      raise InputError, "開始時刻は終了時刻以前にしてください（日付をまたぐ時間帯には対応していません）: #{range}"
+    end
+
+    ParsedRange.new(
+      start_label: start_label,
+      end_label: end_label,
+      duration: end_minutes - start_minutes
+    )
+  end
+
+  def self.to_minutes(time)
+    raise InputError, "時刻は HH または HH:MM 形式で指定してください: #{time}" unless TIME_PATTERN.match?(time)
+
+    hours, minutes = time.split(":").map(&:to_i)
+    minutes ||= 0
+
+    unless hours.between?(0, 23) && minutes.between?(0, 59)
+      raise InputError, "時刻は 00:00 から 23:59 の範囲で指定してください: #{time}"
+    end
+
+    hours * 60 + minutes
+  end
+
+  def self.format_duration(total_minutes)
+    hours, minutes = total_minutes.divmod(60)
+    "#{hours}時間#{minutes}分"
+  end
+
+  def self.print_result(ranges, output)
+    total_minutes = ranges.sum(&:duration)
+
+    ranges.each do |range|
+      output.puts "#{range.start_label} - #{range.end_label} : #{format_duration(range.duration)}"
+    end
+
+    output.puts "--------------------------"
+    output.puts "合計：#{format_duration(total_minutes)}"
+  end
+
+  def self.help
+    <<~HELP.chomp
+      使い方:
+        timecalc "HH-HH, HH:MM-HH:MM"
+        timecalc --hm
+
+      複数の時間帯をカンマ区切りで指定します。
+      時刻は 00〜23 時、00〜59 分の範囲で指定してください。
+      日付をまたぐ時間帯には対応していません。
+
+      --hm は標準入力から 1 行につき H または H.MM 形式の経過時間を受け取り、EOF で合計を表示します。
+    HELP
+  end
+end

data/lib/timecalc_cli.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "timecalc/cli"

metadata

@@ -0,0 +1,43 @@
+--- !ruby/object:Gem::Specification
+name: timecalc-cli
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Eli
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: Calculate total duration from multiple time ranges.
+executables:
+- timecalc
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- bin/timecalc
+- lib/timecalc/cli.rb
+- lib/timecalc_cli.rb
+licenses:
+- MIT
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.10
+specification_version: 4
+summary: A simple CLI time calculator
+test_files: []