workout_menu 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: affc512b58e73f670c740957dfa8def3cc53e6e462ec7aa8a32fec11c782130f
+  data.tar.gz: 4772495becc710e6ca3508bbfa670f2631cf592f4b17d5468bd97aa1885801f2
+SHA512:
+  metadata.gz: 2f8b3c18ec96356a132d73736eb50c193ed78678867f541698ed8ec74532089db352e53c65543e564a04adba5b7285653c7630e42d67fa6bf5d1f1563fc9a02e
+  data.tar.gz: 4ac9922e776437792a48d72ced012eb10380db1b8387c232d74f1d8650bc69d7f4911f55d59e67abe54a5f6a49ba3fd67a9546ae1c22da349d44335520ddd255

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+## [Unreleased]
+
+## [0.1.0] - 2026-11-03
+
+- Initial release
+- `workout_menu` コマンドを追加。部位 (`--part`) と場所 (`--place`) を指定して、トレーニングメニューを提案する
+- 胸、背中、脚、肩、腕、腹筋の6部位、自宅とジムの2か所に対応

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 T-REX1970
+
+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,135 @@
+# WorkoutMenu
+
+「今日、何を鍛えよう?」と迷う時間をなくす、筋トレメニュー提案コマンドです。
+鍛えたい部位と場所を指定すると、ランダムに種目を選んで、セット数と回数つきで表示します。
+
+```console
+$ workout_menu --part chest --place home
+今日のメニュー: 胸 / 自宅
+1. ワイドプッシュアップ  3セット × 12回
+2. 腕立て伏せ  3セット × 15回
+3. デクラインプッシュアップ  3セット × 12回
+4. インクラインプッシュアップ  3セット × 15回
+```
+
+## Installation
+
+```bash
+gem install workout_menu
+```
+
+Bundler を使う場合は、Gemfile に次の行を追加します。
+
+```ruby
+gem "workout_menu"
+```
+
+Ruby 3.2 以上が必要です。
+
+## Usage
+
+```console
+$ workout_menu --part PART [options]
+```
+
+| オプション | 説明 | 既定値 |
+|---|---|---|
+| `-p`, `--part PART` | 鍛える部位(**必須**) | - |
+| `-l`, `--place PLACE` | 場所 | `home` |
+| `-n`, `--count N` | 種目数 | `4` |
+| `-s`, `--seed N` | 乱数のシード。同じ値なら同じメニューになる | ランダム |
+| `-v`, `--version` | バージョンを表示 | - |
+| `-h`, `--help` | ヘルプを表示 | - |
+
+### 部位 (`--part`)
+
+| 値 | 部位 |
+|---|---|
+| `chest` | 胸 |
+| `back` | 背中 |
+| `legs` | 脚 |
+| `shoulders` | 肩 |
+| `arms` | 腕 |
+| `abs` | 腹筋 |
+
+### 場所 (`--place`)
+
+| 値 | 内容 |
+|---|---|
+| `home` | 自宅。器具を使わない種目だけを提案する |
+| `gym` | ジム。マシンやバーベルを使う種目も提案する |
+
+### 例
+
+```console
+# ジムで脚を鍛える(種目数は 5)
+$ workout_menu -p legs -l gym -n 5
+
+# 同じシードなら、いつも同じメニューになる
+$ workout_menu -p back -s 42
+```
+
+時間で行う種目(プランクなど)は、回数ではなく秒数で表示されます。
+
+```console
+$ workout_menu -p abs -l gym -n 3 -s 2
+今日のメニュー: 腹筋 / ジム
+1. ケーブルクランチ  3セット × 15回
+2. ハンギングレッグレイズ  3セット × 10回
+3. マウンテンクライマー  3セット × 30秒
+```
+
+### エラー
+
+指定が正しくないときは、メッセージを標準エラー出力に出して、終了ステータス 1 で終了します。
+
+```console
+$ workout_menu
+workout_menu: --part is required (chest, back, legs, shoulders, arms, abs)
+Try 'workout_menu --help' for usage.
+```
+
+### Ruby から使う
+
+```ruby
+require "workout_menu"
+
+menu = WorkoutMenu::Menu.new
+menu.suggest(part: :chest, place: :home, count: 3).each do |exercise|
+  puts "#{exercise.name} #{exercise.volume}"
+end
+```
+
+## 種目を追加・変更するには
+
+種目は [`lib/workout_menu/exercises.yml`](lib/workout_menu/exercises.yml) に定義されています。
+次の形式で追記すると、提案の対象になります。
+
+```yaml
+- { name: 腕立て伏せ, part: chest, places: [home, gym], sets: 3, reps: 15 }
+```
+
+時間で行う種目は、`unit: 秒` を加えます。
+
+## Development
+
+リポジトリを clone したあと、`bin/setup` で依存をインストールします。
+`bundle exec rake` で、テストと RuboCop を実行します。`bin/console` で、対話的に試せます。
+
+```bash
+bin/setup
+bundle exec rake
+bundle exec exe/workout_menu --part chest
+```
+
+このgemをローカルにインストールするには `bundle exec rake install` を実行します。
+新しいバージョンをリリースするには、`lib/workout_menu/version.rb` のバージョンを更新して、`bundle exec rake release` を実行します。
+gitタグの作成、コミットとタグの push、`.gem` ファイルの [rubygems.org](https://rubygems.org) への公開が行われます。
+
+## Contributing
+
+バグ報告やプルリクエストは、GitHub の https://github.com/T-REX1996/workout_menu で歓迎します。
+
+## License
+
+このgemは、[MIT License](https://opensource.org/licenses/MIT) の条件のもとでオープンソースとして公開されています。

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+require "rubocop/rake_task"
+
+RuboCop::RakeTask.new
+
+task default: %i[test rubocop]

data/exe/workout_menu

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "workout_menu"
+
+exit WorkoutMenu::CLI.run(ARGV)

data/lib/workout_menu/catalog.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require "yaml"
+
+module WorkoutMenu
+  # 種目データの読み込みと絞り込みを担当する。
+  class Catalog
+    PARTS = {
+      chest: "胸",
+      back: "背中",
+      legs: "脚",
+      shoulders: "肩",
+      arms: "腕",
+      abs: "腹筋"
+    }.freeze
+
+    PLACES = {
+      home: "自宅",
+      gym: "ジム"
+    }.freeze
+
+    DEFAULT_PATH = File.expand_path("exercises.yml", __dir__)
+    DEFAULT_UNIT = "回"
+
+    def self.load(path = DEFAULT_PATH)
+      data = YAML.safe_load_file(path, symbolize_names: true)
+      new(data.fetch(:exercises).map { |attrs| build_exercise(attrs) })
+    end
+
+    def self.build_exercise(attrs)
+      Exercise.new(unit: DEFAULT_UNIT, **attrs, part: attrs[:part].to_sym, places: attrs[:places].map(&:to_sym))
+    end
+    private_class_method :build_exercise
+
+    def initialize(exercises)
+      @exercises = exercises.freeze
+    end
+
+    attr_reader :exercises
+
+    def select(part:, place:)
+      exercises.select { |e| e.part == part && e.places.include?(place) }
+    end
+  end
+end

data/lib/workout_menu/cli.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+require "optparse"
+
+module WorkoutMenu
+  # コマンドライン入力を解釈して、メニューを出力する。
+  class CLI
+    DEFAULT_PLACE = "home"
+    DEFAULT_COUNT = 4
+
+    def self.run(argv, out: $stdout, err: $stderr)
+      new(out: out, err: err).run(argv)
+    end
+
+    def initialize(out:, err:)
+      @out = out
+      @err = err
+    end
+
+    # 終了ステータスを返す(成功: 0、失敗: 1)。
+    def run(argv)
+      options = { place: DEFAULT_PLACE, count: DEFAULT_COUNT }
+      parser = build_parser(options)
+      parser.parse(argv)
+      dispatch(options, parser)
+      0
+    rescue OptionParser::ParseError, Error => e
+      @err.puts "workout_menu: #{e.message}"
+      @err.puts "Try 'workout_menu --help' for usage."
+      1
+    end
+
+    private
+
+    def dispatch(options, parser)
+      if options[:help]
+        @out.puts parser.help
+      elsif options[:version]
+        @out.puts VERSION
+      else
+        print_menu(options)
+      end
+    end
+
+    def build_parser(options)
+      OptionParser.new do |parser|
+        parser.banner = "Usage: workout_menu --part PART [options]"
+        define_target_options(parser, options)
+        define_amount_options(parser, options)
+        define_info_options(parser, options)
+      end
+    end
+
+    def define_target_options(parser, options)
+      parts = Catalog::PARTS.keys
+      places = Catalog::PLACES.keys
+      parser.on("-p", "--part PART", parts.map(&:to_s), "鍛える部位 (#{parts.join(", ")})") { |v| options[:part] = v }
+      parser.on("-l", "--place PLACE", places.map(&:to_s), "場所 (#{places.join(", ")}) 既定: #{DEFAULT_PLACE}") do |v|
+        options[:place] = v
+      end
+    end
+
+    def define_amount_options(parser, options)
+      parser.on("-n", "--count N", Integer, "種目数 既定: #{DEFAULT_COUNT}") { |v| options[:count] = v }
+      parser.on("-s", "--seed N", Integer, "乱数のシード(同じ値なら同じメニュー)") { |v| options[:seed] = v }
+    end
+
+    def define_info_options(parser, options)
+      parser.on("-v", "--version", "バージョンを表示") { options[:version] = true }
+      parser.on("-h", "--help", "ヘルプを表示") { options[:help] = true }
+    end
+
+    def print_menu(options)
+      raise Error, "--part is required (#{Catalog::PARTS.keys.join(", ")})" unless options[:part]
+
+      part = options[:part].to_sym
+      place = options[:place].to_sym
+      menu = Menu.new(random: random_for(options[:seed]))
+      print_exercises(part, place, menu.suggest(part: part, place: place, count: options[:count]))
+    end
+
+    def random_for(seed)
+      seed ? Random.new(seed) : Random.new
+    end
+
+    def print_exercises(part, place, exercises)
+      @out.puts "今日のメニュー: #{Catalog::PARTS[part]} / #{Catalog::PLACES[place]}"
+      exercises.each.with_index(1) { |e, i| @out.puts "#{i}. #{e.name}  #{e.volume}" }
+    end
+  end
+end

data/lib/workout_menu/exercise.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module WorkoutMenu
+  # 1つのトレーニング種目。
+  Exercise = Data.define(:name, :part, :places, :sets, :reps, :unit) do
+    # 例: "3セット × 15回"
+    def volume
+      "#{sets}セット × #{reps}#{unit}"
+    end
+  end
+end

data/lib/workout_menu/exercises.yml

@@ -0,0 +1,65 @@
+# 種目データ
+#   part:   chest / back / legs / shoulders / arms / abs
+#   places: home(自宅・器具なし) / gym(ジム)
+#   unit:   省略すると「回」。時間で行う種目は「秒」を指定する
+exercises:
+  # --- 胸 ---
+  - { name: 腕立て伏せ, part: chest, places: [home, gym], sets: 3, reps: 15 }
+  - { name: ワイドプッシュアップ, part: chest, places: [home, gym], sets: 3, reps: 12 }
+  - { name: デクラインプッシュアップ, part: chest, places: [home], sets: 3, reps: 12 }
+  - { name: インクラインプッシュアップ, part: chest, places: [home], sets: 3, reps: 15 }
+  - { name: ベンチプレス, part: chest, places: [gym], sets: 3, reps: 8 }
+  - { name: インクラインダンベルプレス, part: chest, places: [gym], sets: 3, reps: 10 }
+  - { name: ダンベルフライ, part: chest, places: [gym], sets: 3, reps: 12 }
+  - { name: チェストプレス, part: chest, places: [gym], sets: 3, reps: 10 }
+
+  # --- 背中 ---
+  - { name: バックエクステンション, part: back, places: [home, gym], sets: 3, reps: 15 }
+  - { name: スーパーマン, part: back, places: [home], sets: 3, reps: 15 }
+  - { name: リバーススノーエンジェル, part: back, places: [home], sets: 3, reps: 12 }
+  - { name: 懸垂, part: back, places: [gym], sets: 3, reps: 8 }
+  - { name: ラットプルダウン, part: back, places: [gym], sets: 3, reps: 10 }
+  - { name: ベントオーバーロウ, part: back, places: [gym], sets: 3, reps: 10 }
+  - { name: シーテッドロウ, part: back, places: [gym], sets: 3, reps: 10 }
+  - { name: デッドリフト, part: back, places: [gym], sets: 3, reps: 5 }
+
+  # --- 脚 ---
+  - { name: スクワット, part: legs, places: [home, gym], sets: 3, reps: 15 }
+  - { name: ブルガリアンスクワット, part: legs, places: [home, gym], sets: 3, reps: 10 }
+  - { name: ランジ, part: legs, places: [home, gym], sets: 3, reps: 12 }
+  - { name: カーフレイズ, part: legs, places: [home, gym], sets: 3, reps: 20 }
+  - { name: ヒップリフト, part: legs, places: [home, gym], sets: 3, reps: 15 }
+  - { name: ワイドスクワット, part: legs, places: [home], sets: 3, reps: 15 }
+  - { name: バーベルスクワット, part: legs, places: [gym], sets: 3, reps: 8 }
+  - { name: レッグプレス, part: legs, places: [gym], sets: 3, reps: 12 }
+  - { name: レッグカール, part: legs, places: [gym], sets: 3, reps: 12 }
+
+  # --- 肩 ---
+  - { name: パイクプッシュアップ, part: shoulders, places: [home], sets: 3, reps: 10 }
+  - { name: ショルダータップ, part: shoulders, places: [home], sets: 3, reps: 20 }
+  - { name: プランクアップダウン, part: shoulders, places: [home, gym], sets: 3, reps: 12 }
+  - { name: アームサークル, part: shoulders, places: [home], sets: 3, reps: 20 }
+  - { name: ショルダープレス, part: shoulders, places: [gym], sets: 3, reps: 10 }
+  - { name: サイドレイズ, part: shoulders, places: [gym], sets: 3, reps: 12 }
+  - { name: フロントレイズ, part: shoulders, places: [gym], sets: 3, reps: 12 }
+  - { name: リアレイズ, part: shoulders, places: [gym], sets: 3, reps: 12 }
+
+  # --- 腕 ---
+  - { name: ナロープッシュアップ, part: arms, places: [home, gym], sets: 3, reps: 12 }
+  - { name: ダイヤモンドプッシュアップ, part: arms, places: [home, gym], sets: 3, reps: 10 }
+  - { name: ベンチディップス, part: arms, places: [home, gym], sets: 3, reps: 12 }
+  - { name: アームカール, part: arms, places: [gym], sets: 3, reps: 12 }
+  - { name: ハンマーカール, part: arms, places: [gym], sets: 3, reps: 12 }
+  - { name: トライセプスエクステンション, part: arms, places: [gym], sets: 3, reps: 12 }
+  - { name: ケーブルプレスダウン, part: arms, places: [gym], sets: 3, reps: 12 }
+
+  # --- 腹筋 ---
+  - { name: クランチ, part: abs, places: [home, gym], sets: 3, reps: 20 }
+  - { name: レッグレイズ, part: abs, places: [home, gym], sets: 3, reps: 15 }
+  - { name: バイシクルクランチ, part: abs, places: [home, gym], sets: 3, reps: 20 }
+  - { name: プランク, part: abs, places: [home, gym], sets: 3, reps: 45, unit: 秒 }
+  - { name: サイドプランク, part: abs, places: [home, gym], sets: 3, reps: 30, unit: 秒 }
+  - { name: マウンテンクライマー, part: abs, places: [home, gym], sets: 3, reps: 30, unit: 秒 }
+  - { name: アブローラー, part: abs, places: [gym], sets: 3, reps: 10 }
+  - { name: ハンギングレッグレイズ, part: abs, places: [gym], sets: 3, reps: 10 }
+  - { name: ケーブルクランチ, part: abs, places: [gym], sets: 3, reps: 15 }

data/lib/workout_menu/menu.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module WorkoutMenu
+  # 部位と場所からトレーニングメニューを提案する。
+  class Menu
+    def initialize(catalog: Catalog.load, random: Random.new)
+      @catalog = catalog
+      @random = random
+    end
+
+    # 条件に合う種目を、重複なしでランダムに count 個まで選ぶ。
+    def suggest(part:, place:, count: 4)
+      validate!(part, place, count)
+      @catalog.select(part: part, place: place).sample(count, random: @random)
+    end
+
+    private
+
+    def validate!(part, place, count)
+      raise Error, "unknown part: #{part}" unless Catalog::PARTS.key?(part)
+      raise Error, "unknown place: #{place}" unless Catalog::PLACES.key?(place)
+      raise Error, "count must be positive: #{count}" unless count.positive?
+    end
+  end
+end

data/lib/workout_menu/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module WorkoutMenu
+  VERSION = "0.1.0"
+end

data/lib/workout_menu.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require_relative "workout_menu/version"
+
+module WorkoutMenu
+  class Error < StandardError; end
+end
+
+require_relative "workout_menu/exercise"
+require_relative "workout_menu/catalog"
+require_relative "workout_menu/menu"
+require_relative "workout_menu/cli"

data/sig/workout_menu.rbs

@@ -0,0 +1,4 @@
+module WorkoutMenu
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,58 @@
+--- !ruby/object:Gem::Specification
+name: workout_menu
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- T-REX1996
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: workout_menu suggests a workout menu by body part and place, so you can
+  decide what to train without thinking.
+email:
+- bump12@icloud.com
+executables:
+- workout_menu
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- exe/workout_menu
+- lib/workout_menu.rb
+- lib/workout_menu/catalog.rb
+- lib/workout_menu/cli.rb
+- lib/workout_menu/exercise.rb
+- lib/workout_menu/exercises.yml
+- lib/workout_menu/menu.rb
+- lib/workout_menu/version.rb
+- sig/workout_menu.rbs
+homepage: https://github.com/T-REX1996/workout_menu
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/T-REX1996/workout_menu
+  changelog_uri: https://github.com/T-REX1996/workout_menu/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.16
+specification_version: 4
+summary: A command-line tool that suggests a workout menu for your training day.
+test_files: []