ruby_llm_community 0.0.6 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d3fa93c4ea3fddd52d6cf639bb620c99d10a0fdc01082ecab1c1e9ddb022763d
-  data.tar.gz: 4be92604b71b94c096162a25165178344f56e22ea332815f542a87af095350f5
+  metadata.gz: 0d28b384f53784c1954147d9f217caff1325893f1853e6be63c60158d9c37b79
+  data.tar.gz: 3c6e66e260c1300b3b20ae730ec3755fcca19be8afc8dee754e26cc82cbee7f4
 SHA512:
-  metadata.gz: 376559dd9e4c9ab5dbcb4c0e4c556d548c13fdebedaecef9edaebffb608f1af5380213bd388562d48866375b4bb63729c877b1548bfab17d07e2d3a9c550d67e
-  data.tar.gz: c2f8a24697f9abb88509bdf9b793020360bff7175544bd62b31fb3644f276fc103ae5809dc8a8dd8098962f2f59b1decc0baa1f08482d82bb4ab40e29578c705
+  metadata.gz: 568f6c9a3facf5e5f721ec6e3d44862eb0988529cf72625a88220fe80f00ba89f5602f0a178d0ead3cfc3c4accca3a4b56321a3a24f84883df16bd1c72432458
+  data.tar.gz: e6336936468acfc005284a1e6f7cbffe58e55e85c760082af71569d9555371ed124b26fe0cc70d274124f4b80530881c012d10079145f0c90383f2d6e2c51ff7

data/README.md

@@ -9,10 +9,10 @@
 
 Battle tested at [<picture><source media="(prefers-color-scheme: dark)" srcset="https://chatwithwork.com/logotype-dark.svg"><img src="https://chatwithwork.com/logotype.svg" alt="Chat with Work" height="30" align="absmiddle"></picture>](https://chatwithwork.com) — *Claude Code for your documents*
 
-[![Gem Version](https://badge.fury.io/rb/ruby_llm.svg?a=5)](https://badge.fury.io/rb/ruby_llm)
+[![Gem Version](https://badge.fury.io/rb/ruby_llm.svg?a=7)](https://badge.fury.io/rb/ruby_llm)
 [![Ruby Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://github.com/testdouble/standard)
 [![Gem Downloads](https://img.shields.io/gem/dt/ruby_llm)](https://rubygems.org/gems/ruby_llm)
-[![codecov](https://codecov.io/gh/crmne/ruby_llm/branch/main/graph/badge.svg)](https://codecov.io/gh/crmne/ruby_llm)
+[![codecov](https://codecov.io/gh/crmne/ruby_llm/branch/main/graph/badge.svg?a=2)](https://codecov.io/gh/crmne/ruby_llm)
 
 <a href="https://trendshift.io/repositories/13640" target="_blank"><img src="https://trendshift.io/api/badge/repositories/13640" alt="crmne%2Fruby_llm | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
 </div>
@@ -108,7 +108,7 @@ response = chat.with_schema(ProductSchema).ask "Analyze this product", with: "pr
 * **Rails:** ActiveRecord integration with `acts_as_chat`
 * **Async:** Fiber-based concurrency
 * **Model registry:** 500+ models with capability detection and pricing
-* **Providers:** OpenAI, Anthropic, Gemini, Bedrock, DeepSeek, Mistral, Ollama, OpenRouter, Perplexity, GPUStack, and any OpenAI-compatible API
+* **Providers:** OpenAI, Anthropic, Gemini, VertexAI, Bedrock, DeepSeek, Mistral, Ollama, OpenRouter, Perplexity, GPUStack, and any OpenAI-compatible API
 
 ## Installation
 

data/lib/generators/ruby_llm/install/templates/create_models_migration.rb.tt

@@ -0,0 +1,34 @@
+class Create<%= options[:model_model_name].pluralize %> < ActiveRecord::Migration<%= migration_version %>
+  def change
+    create_table :<%= options[:model_model_name].tableize %> do |t|
+      t.string :model_id, null: false
+      t.string :name, null: false
+      t.string :provider, null: false
+      t.string :family
+      t.datetime :model_created_at
+      t.integer :context_window
+      t.integer :max_output_tokens
+      t.date :knowledge_cutoff
+<% if postgresql? %>
+      t.jsonb :modalities, default: {}
+      t.jsonb :capabilities, default: []
+      t.jsonb :pricing, default: {}
+      t.jsonb :metadata, default: {}
+<% else %>
+      t.json :modalities, default: {}
+      t.json :capabilities, default: []
+      t.json :pricing, default: {}
+      t.json :metadata, default: {}
+<% end %>
+      t.timestamps
+
+      t.index [:provider, :model_id], unique: true
+      t.index :provider
+      t.index :family
+<% if postgresql? %>
+      t.index :capabilities, using: :gin
+      t.index :modalities, using: :gin
+<% end %>
+    end
+  end
+end

data/lib/generators/ruby_llm/install/templates/initializer.rb.tt

@@ -3,4 +3,9 @@ RubyLLM.configure do |config|
   config.anthropic_api_key = ENV["ANTHROPIC_API_KEY"]
 
   # config.default_model = "gpt-4.1-nano"
+<% unless options[:skip_model] %>
+
+  # Model registry persistence
+  config.model_registry_class = "<%= options[:model_model_name] %>"
+<% end %>
 end

data/lib/generators/ruby_llm/install/templates/model_model.rb.tt

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+# Model registry persistence
+class <%= options[:model_model_name] %> < ApplicationRecord
+  <%= acts_as_model_declaration %>
+end

data/lib/generators/ruby_llm/install_generator.rb

@@ -18,8 +18,12 @@ module RubyLLM
                                       desc: 'Name of the Message model class'
     class_option :tool_call_model_name, type: :string, default: 'ToolCall',
                                         desc: 'Name of the ToolCall model class'
+    class_option :model_model_name, type: :string, default: 'Model',
+                                    desc: 'Name of the Model model class (for model registry)'
+    class_option :skip_model, type: :boolean, default: false,
+                              desc: 'Skip creating Model model for model registry persistence'
 
-    desc 'Creates model files for Chat, Message, and ToolCall, and creates migrations for RubyLLM Rails integration'
+    desc 'Creates models and migrations for RubyLLM Rails integration'
 
     def self.next_migration_number(dirname)
       ::ActiveRecord::Generators::Base.next_migration_number(dirname)
@@ -75,6 +79,10 @@ module RubyLLM
       end
     end
 
+    def acts_as_model_declaration
+      'acts_as_model'
+    end
+
     def create_migration_files
       # Create migrations with timestamps to ensure proper order
       # First create chats table
@@ -86,16 +94,27 @@ module RubyLLM
       migration_template 'create_messages_migration.rb.tt',
                          "db/migrate/create_#{options[:message_model_name].tableize}.rb"
 
-      # Finally create tool_calls table (references messages)
+      # Then create tool_calls table (references messages)
       sleep 1 # Ensure different timestamp
       migration_template 'create_tool_calls_migration.rb.tt',
                          "db/migrate/create_#{options[:tool_call_model_name].tableize}.rb"
+
+      # Finally create models table (for model registry)
+      return if options[:skip_model]
+
+      sleep 1 # Ensure different timestamp
+      migration_template 'create_models_migration.rb.tt',
+                         "db/migrate/create_#{options[:model_model_name].tableize}.rb"
     end
 
     def create_model_files
       template 'chat_model.rb.tt', "app/models/#{options[:chat_model_name].underscore}.rb"
       template 'message_model.rb.tt', "app/models/#{options[:message_model_name].underscore}.rb"
       template 'tool_call_model.rb.tt', "app/models/#{options[:tool_call_model_name].underscore}.rb"
+
+      return if options[:skip_model]
+
+      template 'model_model.rb.tt', "app/models/#{options[:model_model_name].underscore}.rb"
     end
 
     def create_initializer
@@ -110,6 +129,12 @@ module RubyLLM
       say '     2. Set your API keys in config/initializers/ruby_llm.rb'
       say "     3. Start chatting: #{options[:chat_model_name]}.create!(model_id: 'gpt-4.1-nano').ask('Hello!')"
 
+      unless options[:skip_model]
+        say "     4. Sync models: #{options[:model_model_name]}.sync!"
+        say "\n  🚀 Model registry is database-backed!", :cyan
+        say '     Models will automatically load from the database'
+      end
+
       say "\n  📚 Full docs: https://rubyllm.com", :cyan
 
       say "\n  ❤️  Love RubyLLM?", :magenta

data/lib/ruby_llm/active_record/acts_as.rb

@@ -3,17 +3,19 @@
 module RubyLLM
   module ActiveRecord
     # Adds chat and message persistence capabilities to ActiveRecord models.
-    # Provides a clean interface for storing chat history, message metadata,
-    # and attachments in your database.
     module ActsAs
       extend ActiveSupport::Concern
 
       class_methods do # rubocop:disable Metrics/BlockLength
-        def acts_as_chat(message_class: 'Message', tool_call_class: 'ToolCall')
+        def acts_as_chat(message_class: 'Message', tool_call_class: 'ToolCall',
+                         model_class: 'Model', model_foreign_key: nil, model_primary_key: nil)
           include ChatMethods
 
           @message_class = message_class.to_s
           @tool_call_class = tool_call_class.to_s
+          @model_class = model_class.to_s
+          @model_foreign_key = model_foreign_key || ActiveSupport::Inflector.foreign_key(@model_class)
+          @model_primary_key = model_primary_key || 'model_id'
 
           has_many :messages,
                    -> { order(created_at: :asc) },
@@ -21,13 +23,43 @@ module RubyLLM
                    inverse_of: :chat,
                    dependent: :destroy
 
+          # Set up model association if model registry is configured
+          if RubyLLM.config.model_registry_class
+            belongs_to :model,
+                       class_name: @model_class,
+                       foreign_key: @model_foreign_key,
+                       primary_key: @model_primary_key,
+                       optional: true
+          end
+
           delegate :add_message, to: :to_llm
         end
 
-        def acts_as_message(chat_class: 'Chat',
+        def acts_as_model(chat_class: 'Chat')
+          include ModelMethods
+
+          @chat_class = chat_class.to_s
+
+          validates :model_id, presence: true, uniqueness: { scope: :provider }
+          validates :name, presence: true
+          validates :provider, presence: true
+
+          # Set up chat association if configured
+          return unless RubyLLM.config.model_registry_class
+
+          has_many :chats,
+                   class_name: @chat_class,
+                   foreign_key: 'model_id',
+                   primary_key: 'model_id'
+        end
+
+        def acts_as_message(chat_class: 'Chat', # rubocop:disable Metrics/ParameterLists
                             chat_foreign_key: nil,
                             tool_call_class: 'ToolCall',
                             tool_call_foreign_key: nil,
+                            model_class: 'Model',
+                            model_foreign_key: nil,
+                            model_primary_key: nil,
                             touch_chat: false)
           include MessageMethods
 
@@ -37,6 +69,10 @@ module RubyLLM
           @tool_call_class = tool_call_class.to_s
           @tool_call_foreign_key = tool_call_foreign_key || ActiveSupport::Inflector.foreign_key(@tool_call_class)
 
+          @model_class = model_class.to_s
+          @model_foreign_key = model_foreign_key || ActiveSupport::Inflector.foreign_key(@model_class)
+          @model_primary_key = model_primary_key || 'model_id'
+
           belongs_to :chat,
                      class_name: @chat_class,
                      foreign_key: @chat_foreign_key,
@@ -53,7 +89,21 @@ module RubyLLM
                      optional: true,
                      inverse_of: :result
 
-          delegate :tool_call?, :tool_result?, :tool_results, to: :to_llm
+          has_many :tool_results,
+                   through: :tool_calls,
+                   source: :result,
+                   class_name: @message_class
+
+          # Set up model association if model registry is configured
+          if RubyLLM.config.model_registry_class
+            belongs_to :model,
+                       class_name: @model_class,
+                       foreign_key: @model_foreign_key,
+                       primary_key: @model_primary_key,
+                       optional: true
+          end
+
+          delegate :tool_call?, :tool_result?, to: :to_llm
         end
 
         def acts_as_tool_call(message_class: 'Message', message_foreign_key: nil, result_foreign_key: nil)
@@ -75,8 +125,7 @@ module RubyLLM
       end
     end
 
-    # Methods mixed into chat models to handle message persistence and
-    # provide a conversation interface.
+    # Methods mixed into chat models.
     module ChatMethods
       extend ActiveSupport::Concern
 
@@ -85,10 +134,20 @@ module RubyLLM
       end
 
       def to_llm(context: nil)
+        # If we have a model association, use both model_id and provider
+        # Otherwise, model_id is a string that RubyLLM can resolve
+        if respond_to?(:model) && model
+          model_to_use = model.model_id
+          provider_to_use = model.provider.to_sym
+        else
+          model_to_use = model_id
+          provider_to_use = nil
+        end
+
         @chat ||= if context
-                    context.chat(model: model_id)
+                    context.chat(model: model_to_use, provider: provider_to_use)
                   else
-                    RubyLLM.chat(model: model_id)
+                    RubyLLM.chat(model: model_to_use, provider: provider_to_use)
                   end
         @chat.reset_messages!
 
@@ -211,26 +270,33 @@ module RubyLLM
       private
 
       def cleanup_failed_messages
-        RubyLLM.logger.debug "RubyLLM: API call failed, destroying message: #{@message.id}"
+        RubyLLM.logger.warn "RubyLLM: API call failed, destroying message: #{@message.id}"
         @message.destroy
       end
 
-      def cleanup_orphaned_tool_results
-        loop do
-          messages.reload
-          last = messages.order(:id).last
+      def cleanup_orphaned_tool_results # rubocop:disable Metrics/PerceivedComplexity
+        messages.reload
+        last = messages.order(:id).last
 
-          break unless last&.tool_call? || last&.tool_result?
+        return unless last&.tool_call? || last&.tool_result?
 
+        if last.tool_call?
           last.destroy
+        elsif last.tool_result?
+          tool_call_message = last.parent_tool_call.message
+          expected_results = tool_call_message.tool_calls.pluck(:id)
+          actual_results = tool_call_message.tool_results.pluck(:tool_call_id)
+
+          if expected_results.sort != actual_results.sort
+            tool_call_message.tool_results.each(&:destroy)
+            tool_call_message.destroy
+          end
         end
       end
 
       def setup_persistence_callbacks
-        # Only set up once per chat instance
         return @chat if @chat.instance_variable_get(:@_persistence_callbacks_setup)
 
-        # Set up persistence callbacks (user callbacks will be chained via on_new_message/on_end_message methods)
         @chat.on_new_message { persist_new_message }
         @chat.on_end_message { |msg| persist_message_completion(msg) }
 
@@ -242,15 +308,21 @@ module RubyLLM
         @message = messages.create!(role: :assistant, content: '')
       end
 
-      def persist_message_completion(message)
+      def persist_message_completion(message) # rubocop:disable Metrics/PerceivedComplexity
         return unless message
 
         tool_call_id = find_tool_call_id(message.tool_call_id) if message.tool_call_id
 
         transaction do
-          # Convert parsed JSON back to JSON string for storage
           content = message.content
-          content = content.to_json if content.is_a?(Hash) || content.is_a?(Array)
+          attachments_to_persist = nil
+
+          if content.is_a?(RubyLLM::Content)
+            attachments_to_persist = content.attachments if content.attachments.any?
+            content = content.text
+          elsif content.is_a?(Hash) || content.is_a?(Array)
+            content = content.to_json
+          end
 
           @message.update!(
             role: message.role,
@@ -261,6 +333,8 @@ module RubyLLM
           )
           @message.write_attribute(@message.class.tool_call_foreign_key, tool_call_id) if tool_call_id
           @message.save!
+
+          persist_content(@message, attachments_to_persist) if attachments_to_persist
           persist_tool_calls(message.tool_calls) if message.tool_calls.present?
         end
       end
@@ -302,8 +376,7 @@ module RubyLLM
       def convert_to_active_storage_format(source)
         return if source.blank?
 
-        # Let RubyLLM::Attachment handle the heavy lifting
-        attachment = RubyLLM::Attachment.new(source)
+        attachment = source.is_a?(RubyLLM::Attachment) ? source : RubyLLM::Attachment.new(source)
 
         {
           io: StringIO.new(attachment.content),
@@ -316,8 +389,7 @@ module RubyLLM
       end
     end
 
-    # Methods mixed into message models to handle serialization and
-    # provide a clean interface to the underlying message data.
+    # Methods mixed into message models.
     module MessageMethods
       extend ActiveSupport::Concern
 
@@ -383,5 +455,72 @@ module RubyLLM
         tempfile
       end
     end
+
+    # Methods mixed into model registry models.
+    module ModelMethods
+      extend ActiveSupport::Concern
+
+      class_methods do # rubocop:disable Metrics/BlockLength
+        def refresh!
+          RubyLLM.models.refresh!
+
+          transaction do
+            RubyLLM.models.all.each do |model_info|
+              model = find_or_initialize_by(
+                model_id: model_info.id,
+                provider: model_info.provider
+              )
+              model.update!(from_llm_attributes(model_info))
+            end
+          end
+        end
+
+        def from_llm(model_info)
+          new(from_llm_attributes(model_info))
+        end
+
+        private
+
+        def from_llm_attributes(model_info)
+          {
+            model_id: model_info.id,
+            name: model_info.name,
+            provider: model_info.provider,
+            family: model_info.family,
+            model_created_at: model_info.created_at,
+            context_window: model_info.context_window,
+            max_output_tokens: model_info.max_output_tokens,
+            knowledge_cutoff: model_info.knowledge_cutoff,
+            modalities: model_info.modalities.to_h,
+            capabilities: model_info.capabilities,
+            pricing: model_info.pricing.to_h,
+            metadata: model_info.metadata
+          }
+        end
+      end
+
+      def to_llm
+        RubyLLM::Model::Info.new(
+          id: model_id,
+          name: name,
+          provider: provider,
+          family: family,
+          created_at: model_created_at,
+          context_window: context_window,
+          max_output_tokens: max_output_tokens,
+          knowledge_cutoff: knowledge_cutoff,
+          modalities: modalities&.deep_symbolize_keys || {},
+          capabilities: capabilities,
+          pricing: pricing&.deep_symbolize_keys || {},
+          metadata: metadata&.deep_symbolize_keys || {}
+        )
+      end
+
+      delegate :supports?, :supports_vision?, :supports_functions?, :type,
+               :input_price_per_million, :output_price_per_million,
+               :function_calling?, :structured_output?, :batch?,
+               :reasoning?, :citations?, :streaming?,
+               to: :to_llm
+    end
   end
 end

data/lib/ruby_llm/aliases.json

@@ -50,21 +50,57 @@
     "deepseek": "deepseek-chat",
     "openrouter": "deepseek/deepseek-chat"
   },
+  "gemini-1.5-flash": {
+    "gemini": "gemini-1.5-flash",
+    "vertexai": "gemini-1.5-flash"
+  },
+  "gemini-1.5-flash-002": {
+    "gemini": "gemini-1.5-flash-002",
+    "vertexai": "gemini-1.5-flash-002"
+  },
+  "gemini-1.5-flash-8b": {
+    "gemini": "gemini-1.5-flash-8b",
+    "vertexai": "gemini-1.5-flash-8b"
+  },
+  "gemini-1.5-pro": {
+    "gemini": "gemini-1.5-pro",
+    "vertexai": "gemini-1.5-pro"
+  },
+  "gemini-1.5-pro-002": {
+    "gemini": "gemini-1.5-pro-002",
+    "vertexai": "gemini-1.5-pro-002"
+  },
+  "gemini-2.0-flash": {
+    "gemini": "gemini-2.0-flash",
+    "vertexai": "gemini-2.0-flash"
+  },
   "gemini-2.0-flash-001": {
     "gemini": "gemini-2.0-flash-001",
-    "openrouter": "google/gemini-2.0-flash-001"
+    "openrouter": "google/gemini-2.0-flash-001",
+    "vertexai": "gemini-2.0-flash-001"
+  },
+  "gemini-2.0-flash-exp": {
+    "gemini": "gemini-2.0-flash-exp",
+    "vertexai": "gemini-2.0-flash-exp"
   },
   "gemini-2.0-flash-lite-001": {
     "gemini": "gemini-2.0-flash-lite-001",
-    "openrouter": "google/gemini-2.0-flash-lite-001"
+    "openrouter": "google/gemini-2.0-flash-lite-001",
+    "vertexai": "gemini-2.0-flash-lite-001"
   },
   "gemini-2.5-flash": {
     "gemini": "gemini-2.5-flash",
-    "openrouter": "google/gemini-2.5-flash"
+    "openrouter": "google/gemini-2.5-flash",
+    "vertexai": "gemini-2.5-flash"
+  },
+  "gemini-2.5-flash-image-preview": {
+    "gemini": "gemini-2.5-flash-image-preview",
+    "openrouter": "google/gemini-2.5-flash-image-preview"
   },
   "gemini-2.5-flash-lite": {
     "gemini": "gemini-2.5-flash-lite",
-    "openrouter": "google/gemini-2.5-flash-lite"
+    "openrouter": "google/gemini-2.5-flash-lite",
+    "vertexai": "gemini-2.5-flash-lite"
   },
   "gemini-2.5-flash-lite-preview-06-17": {
     "gemini": "gemini-2.5-flash-lite-preview-06-17",
@@ -72,12 +108,21 @@
   },
   "gemini-2.5-pro": {
     "gemini": "gemini-2.5-pro",
-    "openrouter": "google/gemini-2.5-pro"
+    "openrouter": "google/gemini-2.5-pro",
+    "vertexai": "gemini-2.5-pro"
   },
   "gemini-2.5-pro-preview-05-06": {
     "gemini": "gemini-2.5-pro-preview-05-06",
     "openrouter": "google/gemini-2.5-pro-preview-05-06"
   },
+  "gemini-embedding-001": {
+    "gemini": "gemini-embedding-001",
+    "vertexai": "gemini-embedding-001"
+  },
+  "gemini-exp-1206": {
+    "gemini": "gemini-exp-1206",
+    "vertexai": "gemini-exp-1206"
+  },
   "gemma-3-12b-it": {
     "gemini": "gemma-3-12b-it",
     "openrouter": "google/gemma-3-12b-it"
@@ -150,6 +195,10 @@
     "openai": "gpt-4o-2024-11-20",
     "openrouter": "openai/gpt-4o-2024-11-20"
   },
+  "gpt-4o-audio-preview": {
+    "openai": "gpt-4o-audio-preview",
+    "openrouter": "openai/gpt-4o-audio-preview"
+  },
   "gpt-4o-mini": {
     "openai": "gpt-4o-mini",
     "openrouter": "openai/gpt-4o-mini"
@@ -217,5 +266,9 @@
   "o4-mini": {
     "openai": "o4-mini",
     "openrouter": "openai/o4-mini"
+  },
+  "text-embedding-004": {
+    "gemini": "text-embedding-004",
+    "vertexai": "text-embedding-004"
   }
 }

data/lib/ruby_llm/aliases.rb

@@ -1,53 +1,35 @@
 # frozen_string_literal: true
 
 module RubyLLM
-  # Manages model aliases, allowing users to reference models by simpler names
-  # that map to specific model versions across different providers.
-  #
-  # Aliases are defined in aliases.json and follow the format:
-  #   {
-  #     "simple-name": {
-  #       "provider1": "specific-version-for-provider1",
-  #       "provider2": "specific-version-for-provider2"
-  #     }
-  #   }
+  # Manages model aliases for provider-specific versions
   class Aliases
     class << self
-      # Resolves a model ID to its provider-specific version
-      #
-      # @param model_id [String] the model identifier or alias
-      # @param provider_slug [String, Symbol, nil] optional provider to resolve for
-      # @return [String] the resolved model ID or the original if no alias exists
       def resolve(model_id, provider = nil)
         return model_id unless aliases[model_id]
 
         if provider
           aliases[model_id][provider.to_s] || model_id
         else
-          # Get native provider's version
           aliases[model_id].values.first || model_id
         end
       end
 
-      # Returns the loaded aliases mapping
-      # @return [Hash] the aliases mapping
       def aliases
         @aliases ||= load_aliases
       end
 
-      # Loads aliases from the JSON file
-      # @return [Hash] the loaded aliases
+      def aliases_file
+        File.expand_path('aliases.json', __dir__)
+      end
+
       def load_aliases
-        file_path = File.expand_path('aliases.json', __dir__)
-        if File.exist?(file_path)
-          JSON.parse(File.read(file_path))
+        if File.exist?(aliases_file)
+          JSON.parse(File.read(aliases_file))
         else
           {}
         end
       end
 
-      # Reloads aliases from disk
-      # @return [Hash] the reloaded aliases
       def reload!
         @aliases = load_aliases
       end