gem_override_marker 0.1.0

data/lib/gem_override_marker/diff_generator.rb

@@ -0,0 +1,40 @@
+require "diff/lcs"
+require "diff/lcs/hunk"
+
+module GemOverrideMarker
+  # 本家ソースと override の unified diff を生成する。
+  class DiffGenerator
+    # 前後に表示するコンテキスト行数。
+    CONTEXT_LINES = 3
+
+    # 2つのソース文字列の unified diff を返す。差分が無ければ空文字。
+    def self.unified(old_source, new_source, old_label:, new_label:)
+      old_lines = old_source.lines.map(&:chomp)
+      new_lines = new_source.lines.map(&:chomp)
+
+      changes = Diff::LCS.diff(old_lines, new_lines)
+      return "" if changes.empty?
+
+      output = +"--- #{old_label}\n+++ #{new_label}\n"
+      # diff-lcs の Hunk はコンテキスト行ぶんのオフセットを file_length_difference として
+      # hunk 間で累積する必要がある。これを引き継がず 0 固定にすると、離れた hunk 同士で
+      # 内部オフセットが破綻して @data_old[lo..hi] が範囲外 (nil) になりクラッシュする。
+      # コンテキストが重なる hunk は直前の hunk に merge し、重ならなければ flush して出力する。
+      file_length_difference = 0
+      last_hunk = nil
+      changes.each do |hunk_changes|
+        hunk = Diff::LCS::Hunk.new(old_lines, new_lines, hunk_changes, CONTEXT_LINES, file_length_difference)
+        file_length_difference = hunk.file_length_difference
+
+        if last_hunk && hunk.merge(last_hunk)
+          # merge 済み (overlaps した) ので last_hunk は出力せず hunk に取り込まれている
+        elsif last_hunk
+          output << last_hunk.diff(:unified) << "\n"
+        end
+        last_hunk = hunk
+      end
+      output << last_hunk.diff(:unified, true) << "\n" if last_hunk
+      output
+    end
+  end
+end

data/lib/gem_override_marker/gem_source.rb

@@ -0,0 +1,75 @@
+module GemOverrideMarker
+  # gem のインストールパス解決と、Gemfile.lock 上の実バージョン取得を担う。
+  #
+  # diff の比較対象となる本家ソースは、`{gem名}-{バージョン}/{gem内パス}` を
+  # 実環境の gem インストールパス (Gem.path 配下の gems/) から解決する。
+  # マーカーに書かれたバージョンを正とするが、アップグレード検討時などは
+  # 明示的に別バージョンを指定できる。
+  class GemSource
+    class SourceNotFoundError < StandardError; end
+
+    # マーカー対象ファイル (本家ソース) の絶対パスを返す。
+    # 比較対象の版はマーカーに書かれた版を使う。
+    def self.resolve_file(marker)
+      resolve_path(marker.gem_name, marker.version, marker.path)
+    end
+
+    # gem名・版・gem内パスから本家ソースの絶対パスを返す。
+    # マーカーに縛られず任意の版を解決できるため、本家2版間の diff
+    # (upstream_diff) で from / to 双方の本家ソースを得るのに使う。
+    def self.resolve_path(gem_name, version, path)
+      dir = gem_dir(gem_name, version)
+      unless dir
+        raise SourceNotFoundError,
+          "#{gem_name}-#{version} not found in gem install paths"
+      end
+
+      file = File.join(dir, path)
+      unless File.exist?(file)
+        raise SourceNotFoundError, "gem source not found: #{file}"
+      end
+
+      file
+    end
+
+    # {gem名}-{バージョン} の gem ディレクトリを Gem.path 配下から探す。
+    # 見つからなければ nil。
+    def self.gem_dir(gem_name, version)
+      gem_paths.each do |base|
+        candidate = File.join(base, "gems", "#{gem_name}-#{version}")
+        return candidate if Dir.exist?(candidate)
+      end
+      nil
+    end
+
+    # Gemfile.lock 上で実際に解決されている gem のバージョンを返す。
+    # マーカーの版とこの版がズレていれば追従漏れの可能性がある (check で使う)。
+    #
+    # lockfile_path を省略すると Bundler が解決したプロジェクトの Gemfile.lock を
+    # 使う。Bundler は BUNDLE_GEMFILE やカレントからの探索で Gemfile の場所を
+    # 自動解決するため、利用側はパスを意識しなくてよい。
+    def self.locked_version(gem_name, lockfile_path = nil)
+      path = lockfile_path || default_lockfile_path
+      return nil if path.nil? || !File.exist?(path)
+
+      require "bundler"
+      parser = Bundler::LockfileParser.new(File.read(path))
+      spec = parser.specs.find { |s| s.name == gem_name }
+      spec&.version&.to_s
+    end
+
+    # Bundler が解決したプロジェクトの Gemfile.lock の絶対パス。
+    # Bundler が使えない (非 Bundler 環境) 場合はカレントの Gemfile.lock を試す。
+    def self.default_lockfile_path
+      require "bundler"
+      Bundler.default_lockfile.to_s
+    rescue StandardError
+      File.expand_path("Gemfile.lock")
+    end
+
+    # Gem.path を基本とし、現在ロード中の Gem.dir も補う。
+    def self.gem_paths
+      ([ Gem.dir ] + Gem.path).uniq
+    end
+  end
+end

data/lib/gem_override_marker/marker.rb

@@ -0,0 +1,88 @@
+module GemOverrideMarker
+  # `@gem-override` マーカー1行を解析した結果を表す値オブジェクト。
+  #
+  # gem のメソッドを prepend で丸ごと再実装したり、gem の view / partial を
+  # コピーして丸ごと上書きしている箇所に、本家のどこを基準にしているかを
+  # 宣言するためのマーカー。decorator メソッドの直前 / 上書きファイルの冒頭に置く。
+  #
+  #   @gem-override {gem名}-{バージョン}/{gem内パス}#{メソッド名}
+  #
+  # 例:
+  #   @gem-override spree_core-5.1.6/app/models/spree/stock/packer.rb#default_package
+  #   @gem-override spree_storefront-5.1.6/app/views/spree/products/_cart_form.html.erb
+  #   @gem-override devise-4.9.4/app/controllers/devise/sessions_controller.rb#create
+  #
+  # メソッド名 (`#method`) は省略可能で、省略時は対象ファイル全体を比較する
+  # (view / partial の丸ごと上書きを想定)。
+  class Marker
+    # マーカーは「コメント記号 + 半角スペース1個ちょうど + @gem-override」で始まる
+    # 行だけを有効とする。これにより、ドキュメント中で字下げして例示したもの
+    # (`#   @gem-override ...` のようにスペースが2個以上) や、文中にバッククォート等で
+    # 引用したものを本物のマーカーと誤検出しない。
+    #
+    # 対応するコメント記号: Ruby (#) / ERB (<%#) / Slim・Haml (/)。
+    #
+    # gem 名はバージョンの直前のハイフンで区切る。gem 名側にハイフンや数字が
+    # 含まれていてもバージョン部分を正しく切り出せるよう、gem 名は最短一致とし
+    # 「数字始まりのトークン」をバージョンの開始位置とみなす。
+    # 各部の意味 (上から順に):
+    #   \A[ \t]*      行頭の字下げ。メソッドの階層に応じた任意のインデント
+    #   (?:\#|<%\#|\/) コメント記号。Ruby / ERB / Slim・Haml
+    #   [ ]           半角スペース1個ちょうど。これで字下げ例を弾く
+    #   @gem-override[ ] マーカー本体と区切りスペース1個
+    #   gem           gem 名。最短一致でバージョン直前まで
+    #   version       バージョン。数字始まり
+    #   path          gem 内の相対パス
+    #   method        メソッド名。省略可
+    PATTERN = /
+      \A[ \t]*
+      (?:\#|<%\#|\/)
+      [ ]
+      @gem-override[ ]
+      (?<gem>[a-z0-9_]+?)-
+      (?<version>\d[\w.\-]*)
+      \/
+      (?<path>[^\s\#]+)
+      (?:\#(?<method>\w+[!?=]?))?
+      (?:[ ]|%>|$)
+    /x
+
+    attr_reader :gem_name, :version, :path, :method_name, :file_path, :line_number
+
+    # マーカーを含む1行を解析する。マーカーでなければ nil を返す。
+    # file_path / line_number はマーカーが書かれた場所 (リポジトリ側) を記録する。
+    def self.parse(line, file_path: nil, line_number: nil)
+      match = PATTERN.match(line)
+      return nil unless match
+
+      new(
+        gem_name: match[:gem],
+        version: match[:version],
+        path: match[:path],
+        method_name: match[:method],
+        file_path: file_path,
+        line_number: line_number
+      )
+    end
+
+    def initialize(gem_name:, version:, path:, method_name: nil, file_path: nil, line_number: nil)
+      @gem_name = gem_name
+      @version = version
+      @path = path
+      @method_name = method_name
+      @file_path = file_path
+      @line_number = line_number
+    end
+
+    # メソッド名を含まない = ファイル全体を対象とするマーカーか。
+    def whole_file?
+      method_name.nil?
+    end
+
+    # マーカーが指す本家論理名 (狙い撃ち指定にそのまま使える1行表現)。
+    def logical_name
+      base = "#{gem_name}-#{version}/#{path}"
+      whole_file? ? base : "#{base}##{method_name}"
+    end
+  end
+end

data/lib/gem_override_marker/railtie.rb

@@ -0,0 +1,11 @@
+require "rails/railtie"
+
+module GemOverrideMarker
+  # Rails アプリに組み込まれたとき、rake task を自動でロードする。
+  # gem 本体は Rails 非依存だが、利用側が Rails の場合の利便性のために用意する。
+  class Railtie < Rails::Railtie
+    rake_tasks do
+      load File.expand_path("../tasks/gem_override_marker.rake", __dir__)
+    end
+  end
+end

data/lib/gem_override_marker/registry.rb

@@ -0,0 +1,76 @@
+module GemOverrideMarker
+  # リポジトリ内に埋め込まれた `@gem-override` マーカーを収集し、
+  # 狙い撃ち指定 (ファイル / ファイル+メソッド / 本家論理名) で絞り込む。
+  class Registry
+    # マーカーを探索する対象ファイルの拡張子。Ruby と各種テンプレート。
+    SCANNABLE_EXTENSIONS = %w[.rb .erb .slim .haml].freeze
+
+    # 探索から除外するパス片 (相対パスの任意位置に含まれていれば除外)。
+    # tmp や依存ライブラリのほか、テスト用のダミーマーカーを誤検出しないよう
+    # spec/fixtures も除外する。
+    EXCLUDED_PATH_SEGMENTS = %w[
+      tmp/
+      node_modules/
+      vendor/bundle/
+      .git/
+      spec/fixtures/
+      test/fixtures/
+    ].freeze
+
+    attr_reader :root
+
+    def initialize(root: ".")
+      @root = root
+    end
+
+    # リポジトリ全体を走査して全マーカーを返す。
+    def all_markers
+      target_files.flat_map { |file| markers_in_file(file) }
+    end
+
+    # 1ファイル内の全マーカーを返す。
+    def markers_in_file(file)
+      File.foreach(file).with_index(1).filter_map do |line, lineno|
+        Marker.parse(line, file_path: file, line_number: lineno)
+      end
+    rescue ArgumentError
+      # バイナリ等で読み取れない行があるファイルはスキップする。
+      []
+    end
+
+    # 狙い撃ち指定文字列からマーカー群を解決する。
+    # selector の解釈:
+    #   - 既存ファイルパス             → ファイル内の全マーカー
+    #   - "ファイルパス,メソッド名"    → そのメソッドのマーカーのみ
+    #   - 本家論理名 (gem-版/パス#method) → 全マーカーから論理名一致を抽出
+    #   - nil / 空                     → リポジトリ全体の全マーカー
+    def resolve(selector)
+      return all_markers if selector.nil? || selector.strip.empty?
+
+      file_part, method_part = selector.split(",", 2).map { |s| s&.strip }
+
+      if File.file?(file_part)
+        markers = markers_in_file(file_part)
+        markers = markers.select { |m| m.method_name == method_part } if method_part
+        return markers
+      end
+
+      # ファイルとして存在しなければ本家論理名指定とみなす。
+      all_markers.select { |m| m.logical_name == selector.strip }
+    end
+
+    private
+
+    # 走査対象のファイル一覧 (除外パスと対象外拡張子を除く)。
+    def target_files
+      pattern = File.join(root, "**", "*")
+      Dir.glob(pattern, File::FNM_DOTMATCH).select do |path|
+        next false unless File.file?(path)
+        next false unless SCANNABLE_EXTENSIONS.include?(File.extname(path))
+
+        relative = path.delete_prefix("#{root}/")
+        EXCLUDED_PATH_SEGMENTS.none? { |segment| relative.include?(segment) }
+      end
+    end
+  end
+end

data/lib/gem_override_marker/source_extractor.rb

@@ -0,0 +1,69 @@
+require "prism"
+
+module GemOverrideMarker
+  # Ruby ソースから対象メソッドの実装を抽出し、インデントを正規化する。
+  #
+  # `def` から `end` までを正規表現で切り出すことはネストした `end` の判別が
+  # できず不可能なため、Ruby 3.3 標準の prism で AST 解析してメソッド単位で
+  # slice する。本家ソース・override の双方を同じ方式で抽出することで、
+  # クラス直下 (本家) と module 多階層 (decorator) のネスト差を吸収できる。
+  class SourceExtractor
+    class MethodNotFoundError < StandardError; end
+
+    # 指定ファイルから対象メソッドの実装を抽出して dedent する。
+    # method_name が nil の場合はファイル全体を返す (view / partial 等)。
+    def self.extract(file_path, method_name)
+      source = File.read(file_path)
+      return dedent(source) if method_name.nil?
+
+      sliced = slice_method(source, method_name.to_sym)
+      raise MethodNotFoundError, "method #{method_name} not found in #{file_path}" if sliced.nil?
+
+      dedent(sliced)
+    end
+
+    # AST を走査して対象メソッドの DefNode を探し、その範囲を slice する。
+    # 最初に見つかった定義を返す。見つからなければ nil。
+    def self.slice_method(source, method_name)
+      result = Prism.parse(source)
+      found = nil
+
+      visit = lambda do |node|
+        return if node.nil? || found
+
+        if node.is_a?(Prism::DefNode) && node.name == method_name
+          found = node.location.slice
+          return
+        end
+
+        node.compact_child_nodes.each { |child| visit.call(child) }
+      end
+
+      visit.call(result.value)
+      found
+    end
+
+    # prism の slice は 1行目 (def) が左寄せ・body 行が元のインデントのまま
+    # 返るため、body の最小インデントを def の位置まで詰めてネスト差を吸収する。
+    def self.dedent(code)
+      lines = code.lines
+      return code if lines.empty?
+
+      base_indent = indent_width(lines.first)
+      body = lines[1..] || []
+      body_indents = body.reject { |line| line.strip.empty? }.map { |line| indent_width(line) }
+      min_body_indent = body_indents.min || base_indent
+
+      remove = [ min_body_indent - base_indent, 0 ].max
+
+      result = [ lines.first ]
+      result += body.map { |line| line.strip.empty? ? line : line[remove..] }
+      result.join
+    end
+
+    # 行頭の半角スペース数を返す。
+    def self.indent_width(line)
+      line[/\A */].size
+    end
+  end
+end

data/lib/gem_override_marker/version.rb

@@ -0,0 +1,3 @@
+module GemOverrideMarker
+  VERSION = "0.1.0".freeze
+end

data/lib/gem_override_marker.rb

@@ -0,0 +1,79 @@
+require "gem_override_marker/version"
+require "gem_override_marker/marker"
+require "gem_override_marker/source_extractor"
+require "gem_override_marker/gem_source"
+require "gem_override_marker/diff_generator"
+require "gem_override_marker/registry"
+
+# Rails 上で使われる場合のみ rake task を自動ロードする (gem 本体は Rails 非依存)。
+require "gem_override_marker/railtie" if defined?(Rails::Railtie)
+
+# gem のメソッド prepend 再実装 / view 丸ごと上書きが、本家のどの版の何を
+# 基準にしているかを `@gem-override` マーカーで管理し、本家との diff を
+# 必要なときに生成する。gem アップグレード時の上書きの追随を支援するツール。
+module GemOverrideMarker
+  # check の結果1件。マーカーの版と Gemfile.lock の版のズレを表す。
+  Mismatch = Struct.new(:marker, :locked_version, keyword_init: true)
+
+  module_function
+
+  # 狙い撃ち指定にマッチするマーカー一覧を返す (list 用)。
+  def list(selector: nil, root: ".")
+    Registry.new(root: root).resolve(selector)
+  end
+
+  # 1マーカーについて本家ソース vs override の unified diff を生成する。
+  # 比較対象の本家はマーカーに書かれた版を使う。
+  def diff_for(marker)
+    source_file = GemSource.resolve_file(marker)
+    source_code = SourceExtractor.extract(source_file, marker.method_name)
+    override_code = SourceExtractor.extract(marker.file_path, marker.method_name)
+
+    method_suffix = marker.method_name ? "##{marker.method_name}" : ""
+    DiffGenerator.unified(
+      source_code, override_code,
+      old_label: "source #{marker.gem_name}-#{marker.version}/#{marker.path}#{method_suffix}",
+      new_label: "override #{marker.file_path}#{method_suffix}"
+    )
+  end
+
+  # 同一マーカー対象 (gem 内の同じパス・同じメソッド) について、本家の
+  # 2版間 (from_version → to_version) の unified diff を生成する。
+  #
+  # gem アップグレード時に「その上書き箇所が本家側で変わったか」を選別する
+  # ための道具。差分が空 = 本家に変更なし → 上書きコードは触らず版表記だけ
+  # 更新すればよい。差分あり = 本家が変わった → 自分の diff を新本家に貼り直す。
+  #
+  # to_version を省略すると Gemfile.lock 上の実バージョン (アップグレード後の版)
+  # を使う。本家同士の差分マージはしない設計思想に沿い、あくまで選別用途。
+  def upstream_diff(marker, from_version: nil, to_version: nil)
+    from = from_version || marker.version
+    to = to_version || GemSource.locked_version(marker.gem_name)
+    raise GemSource::SourceNotFoundError, "could not resolve to_version for #{marker.gem_name}" if to.nil?
+
+    from_file = GemSource.resolve_path(marker.gem_name, from, marker.path)
+    to_file = GemSource.resolve_path(marker.gem_name, to, marker.path)
+
+    from_code = SourceExtractor.extract(from_file, marker.method_name)
+    to_code = SourceExtractor.extract(to_file, marker.method_name)
+
+    method_suffix = marker.method_name ? "##{marker.method_name}" : ""
+    DiffGenerator.unified(
+      from_code, to_code,
+      old_label: "upstream #{marker.gem_name}-#{from}/#{marker.path}#{method_suffix}",
+      new_label: "upstream #{marker.gem_name}-#{to}/#{marker.path}#{method_suffix}"
+    )
+  end
+
+  # マーカーの版と Gemfile.lock の版がズレているものを抽出する (check 用)。
+  # ズレが無ければ空配列。lockfile_path を省略すると Bundler が解決した
+  # プロジェクトの Gemfile.lock を使う。
+  def check(selector: nil, root: ".", lockfile_path: nil)
+    list(selector: selector, root: root).filter_map do |marker|
+      locked = GemSource.locked_version(marker.gem_name, lockfile_path)
+      next if locked.nil? || locked == marker.version
+
+      Mismatch.new(marker: marker, locked_version: locked)
+    end
+  end
+end

data/lib/tasks/gem_override_marker.rake

@@ -0,0 +1,89 @@
+require "gem_override_marker"
+
+# gem の override マーカーを管理する rake task 群。
+#
+# 本家ソースをテキストとして解析するだけなので `:environment` には依存しない。
+# DB 接続やアプリ初期化を起動せずに動く。
+namespace :gem_override_marker do
+  desc "List all @gem-override markers (optionally narrowed by selector)"
+  task :list, [ :selector ] do |_task, args|
+    markers = GemOverrideMarker.list(selector: args[:selector])
+
+    if markers.empty?
+      puts "No markers found."
+      next
+    end
+
+    markers.each do |marker|
+      puts "#{marker.file_path}:#{marker.line_number}\t#{marker.logical_name}"
+    end
+    puts "\n#{markers.size} marker(s)"
+  end
+
+  desc "Generate diff between gem source and override (arg: selector)"
+  task :diff, [ :selector ] do |_task, args|
+    markers = GemOverrideMarker.list(selector: args[:selector])
+
+    if markers.empty?
+      puts "No matching markers found: #{args[:selector]}"
+      next
+    end
+
+    markers.each do |marker|
+      puts "=" * 72
+      puts "#{marker.file_path}:#{marker.line_number}  #{marker.logical_name}"
+      puts "=" * 72
+
+      begin
+        diff = GemOverrideMarker.diff_for(marker)
+        puts diff.empty? ? "(no difference)" : diff
+      rescue GemOverrideMarker::GemSource::SourceNotFoundError,
+             GemOverrideMarker::SourceExtractor::MethodNotFoundError => e
+        warn "⚠️  #{e.message}"
+      end
+    end
+  end
+
+  desc "Diff upstream between two versions for each marker (args: selector, to_version)"
+  task :upstream_diff, [ :selector, :to_version ] do |_task, args|
+    markers = GemOverrideMarker.list(selector: args[:selector])
+
+    if markers.empty?
+      puts "No matching markers found: #{args[:selector]}"
+      next
+    end
+
+    markers.each do |marker|
+      puts "=" * 72
+      puts "#{marker.file_path}:#{marker.line_number}  #{marker.logical_name}"
+      puts "=" * 72
+
+      begin
+        diff = GemOverrideMarker.upstream_diff(marker, to_version: args[:to_version])
+        puts diff.empty? ? "(no upstream change)" : diff
+      rescue GemOverrideMarker::GemSource::SourceNotFoundError,
+             GemOverrideMarker::SourceExtractor::MethodNotFoundError => e
+        warn "⚠️  #{e.message}"
+      end
+    end
+  end
+
+  desc "Detect markers whose version differs from Gemfile.lock (exits 1 on mismatch)"
+  task :check, [ :selector ] do |_task, args|
+    mismatches = GemOverrideMarker.check(selector: args[:selector])
+
+    if mismatches.empty?
+      puts "✅ All marker versions match Gemfile.lock."
+      next
+    end
+
+    warn "❌ Marker versions differ from Gemfile.lock (possible outdated overrides):"
+    mismatches.each do |mismatch|
+      marker = mismatch.marker
+      warn "  #{marker.file_path}:#{marker.line_number}"
+      warn "    marker version: #{marker.gem_name}-#{marker.version}"
+      warn "    locked version: #{marker.gem_name}-#{mismatch.locked_version}"
+    end
+    exit 1
+  end
+end

data/spec/fixtures/Gemfile.lock

@@ -0,0 +1,14 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    diff-lcs (1.6.2)
+    spree_core (5.1.6)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  spree_core (= 5.1.6)
+
+BUNDLED WITH
+   2.5.6

data/spec/fixtures/Gemfile.lock.mismatch

@@ -0,0 +1,14 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    spree_core (9.9.9)
+    spree_storefront (9.9.9)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  spree_core (= 9.9.9)
+
+BUNDLED WITH
+   2.5.6

data/spec/fixtures/override_module.rb

@@ -0,0 +1,12 @@
+# override 相当のソース (module 多階層でネストが深い状態) を模した fixture。
+module App
+  module Decorators
+    module GreeterDecorator
+      def greet(name)
+        return super if name.nil?
+
+        "hi, #{name}!"
+      end
+    end
+  end
+end

data/spec/fixtures/repo/no_marker.rb

@@ -0,0 +1,8 @@
+module Sample
+  # これは説明用の例:
+  #   @gem-override spree_core-5.1.6/app/foo.rb#bar
+  # のように字下げした行はマーカーとして拾わない。
+  def plain
+    :noop
+  end
+end

data/spec/fixtures/repo/sub/another.erb

@@ -0,0 +1,3 @@
+<%# @gem-override spree_storefront-5.1.6/app/views/spree/products/_cart_form.html.erb %>
+<%# reason: registry fixture (whole file) %>
+<div>cart form</div>

data/spec/fixtures/repo/with_marker.rb

@@ -0,0 +1,7 @@
+module Sample
+  # @gem-override spree_core-5.1.6/app/models/spree/stock/packer.rb#default_package
+  # reason: registry fixture
+  def default_package
+    :overridden
+  end
+end

data/spec/fixtures/source_class.rb

@@ -0,0 +1,14 @@
+# 本家相当のソース (class 直下にメソッドがある状態) を模した fixture。
+class SourceClass
+  def greet(name)
+    if name.nil?
+      "hello"
+    else
+      "hello, #{name}"
+    end
+  end
+
+  def untouched
+    :keep
+  end
+end