indexmap 0.7.1 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 64a9d1c671519fea6ba6a46b7f67daed2784ad5aaccf2594dc3aa0a374f55854
-  data.tar.gz: 50f6bc13a8097194dec9736b96c8cc6baf0f76429edf0175372aee97991c63f0
+  metadata.gz: 2f78184d7ab33df85d653a915d6b9e42f7c5409fe0e01bb81991b358616cf4f5
+  data.tar.gz: 739a22b6445ca41a090d296c7c30ea3e96fd08c120fce59dbca41ca76c5c57b5
 SHA512:
-  metadata.gz: 2ce92a1da076303265c03ff833585b069215c8417b134407850770c64ae04b3ab93fcf894484874e710e304c6b3c94f19247d70073aaa6ba5e170f70212e4992
-  data.tar.gz: 991f39cd9db707dd79e7a404e636aaea8c8a1db07ce5b59d2daf9d73c33a55d39c252d6edef2adf8fc98ea22e153f8619aee4f67f9fd11c3fccf56b473bb1ffa
+  metadata.gz: a78824d383358e1bbc36ebccc37e5cda6d2311a1d37cfd5941f09c7f3a39d30a8023b94dfffdb812b37dd95e754ef908e6a73a3368a861bb761c960b192e19ef
+  data.tar.gz: 89b5cca3351e953d92a7d0b712b56a7856c47564168e759dcd6dbb5e672e7d714ef62e864f1172bc4b4cbedb129801da9bae68fd1542d8d773f77a13314cfc63

data/CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.8.1] - 2026-07-21
+
+
+### Added
+
+- add lazy install generator ([#17](https://github.com/ethos-link/indexmap/pull/17))
+
+
+
+## [0.8.0] - 2026-07-21
+
+
+### Added
+
+- harden git commit ([#15](https://github.com/ethos-link/indexmap/pull/15))
+
+
+
+
+### Changed
+
+- lazy load search console dependencies ([#16](https://github.com/ethos-link/indexmap/pull/16))
+
+
+
 ## [0.7.1] - 2026-05-31
 
 

data/README.md

@@ -19,9 +19,13 @@ By default, `indexmap` writes a sitemap index plus one or more child sitemap fil
 Add this line to your application's Gemfile:
 
 ```ruby
-gem "indexmap"
+gem "indexmap", require: false
 ```
 
+`require: false` keeps sitemap generation and search-engine clients out of web
+process boot. Require `indexmap` at the application boundary that generates a
+sitemap, or use the task setup below.
+
 And then execute:
 
 ```bash
@@ -68,7 +72,18 @@ Indexmap::Writer.new(
 
 ## Rails Usage
 
-In an initializer:
+Run the install generator after adding the gem:
+
+```bash
+bin/rails generate indexmap:install
+```
+
+The generator creates `config/initializers/indexmap.rb` with an idempotent
+`IndexmapConfiguration.apply` loader and adds conditional `indexmap/tasks`
+loading to the application's `Rakefile`. This preserves `bin/rails --tasks` and
+the `indexmap:*` tasks without loading Indexmap during normal Rails boot.
+
+Customize the `Indexmap.configure` block inside the generated initializer:
 
 ```ruby
 Indexmap.configure do |config|
@@ -92,6 +107,17 @@ Indexmap.configure do |config|
 end
 ```
 
+Runtime callers and jobs must apply the generated configuration before using
+Indexmap:
+
+```ruby
+IndexmapConfiguration.apply
+Indexmap.create
+```
+
+Rake tasks apply it automatically because `indexmap/tasks` loads the gem before
+Rails evaluates the initializer.
+
 Then run:
 
 ```bash

data/lib/generators/indexmap/install_generator.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module Indexmap
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Create a lazy-safe Indexmap initializer and task loader"
+
+      def create_initializer
+        template "initializer.rb.tt", "config/initializers/indexmap.rb"
+      end
+
+      def configure_rakefile
+        rakefile = File.join(destination_root, "Rakefile")
+        return unless File.exist?(rakefile)
+        return if File.read(rakefile).include?('require "indexmap/tasks"')
+
+        inject_into_file "Rakefile", rakefile_setup, before: /^require_relative ["']config\/application["']/
+      end
+
+      private
+
+      def rakefile_setup
+        <<~RUBY
+          indexmap_tasks_requested = Rake.application.options.show_tasks ||
+            ARGV.any? { |argument| ["-T", "--tasks"].include?(argument) }
+          require "indexmap/tasks" if indexmap_tasks_requested ||
+            ARGV.any? { |argument| argument.start_with?("indexmap:") }
+
+        RUBY
+      end
+    end
+  end
+end

data/lib/generators/indexmap/templates/initializer.rb.tt

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module IndexmapConfiguration
+  MUTEX = Mutex.new
+
+  def self.apply
+    return if @applied
+
+    MUTEX.synchronize do
+      return if @applied
+
+      require "indexmap"
+
+      Indexmap.configure do |config|
+        config.base_url = -> { ENV.fetch("INDEXMAP_BASE_URL", "http://localhost:3000") }
+        config.storage = lambda {
+          Indexmap::Storage::Filesystem.new(
+            path: Rails.public_path,
+            public_url: config.base_url
+          )
+        }
+
+        # Configure the sitemap data owned by your application:
+        # config.sections = -> { Sitemap.sections }
+      end
+
+      @applied = true
+    end
+  end
+end
+
+IndexmapConfiguration.apply if defined?(Indexmap)

data/lib/indexmap/creator.rb

@@ -4,7 +4,7 @@ require "nokogiri"
 
 module Indexmap
   class Creator
-    ValidationConfiguration = Struct.new(:base_url, :index_filename, :storage, keyword_init: true)
+    ValidationConfiguration = Struct.new(:base_url, :index_filename, :storage)
 
     def initialize(output:)
       @output = output

data/lib/indexmap/entry.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Indexmap
-  Entry = Struct.new(:loc, :lastmod, keyword_init: true)
+  Entry = Struct.new(:loc, :lastmod)
 end

data/lib/indexmap/parser.rb

@@ -6,7 +6,7 @@ require "uri"
 
 module Indexmap
   class Parser
-    Entry = Struct.new(:loc, :lastmod, :source_sitemap, keyword_init: true)
+    Entry = Struct.new(:loc, :lastmod, :source_sitemap)
 
     def initialize(source: nil, rebase_remote_children: false, index_filename: Indexmap.configuration.index_filename, storage: Indexmap.configuration.storage)
       @source = (source || index_filename).to_s

data/lib/indexmap/railtie.rb

@@ -3,7 +3,7 @@
 module Indexmap
   class Railtie < Rails::Railtie
     rake_tasks do
-      load File.expand_path("../tasks/indexmap_tasks.rake", __dir__)
+      require "indexmap/tasks"
     end
   end
 end

data/lib/indexmap/section.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Indexmap
-  Section = Struct.new(:filename, :entries, keyword_init: true)
+  Section = Struct.new(:filename, :entries)
 end

data/lib/indexmap/storage/file.rb

@@ -2,7 +2,7 @@
 
 module Indexmap
   module Storage
-    File = Struct.new(:filename, :body, :content_type, keyword_init: true) do
+    File = Struct.new(:filename, :body, :content_type) do
       def basename
         ::File.basename(filename)
       end

data/lib/indexmap/tasks.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "indexmap"
+require "rake"
+
+unless Rake::Task.task_defined?("indexmap:sitemap:create")
+  load File.expand_path("../tasks/indexmap_tasks.rake", __dir__)
+end

data/lib/indexmap/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Indexmap
-  VERSION = "0.7.1"
+  VERSION = "0.8.1"
 end

data/lib/indexmap.rb

@@ -18,14 +18,17 @@ require_relative "indexmap/entry"
 require_relative "indexmap/output"
 require_relative "indexmap/parser"
 require_relative "indexmap/pinger/base"
-require_relative "indexmap/pinger/google"
-require_relative "indexmap/pinger/index_now"
 require_relative "indexmap/section"
 require_relative "indexmap/task_runner"
 require_relative "indexmap/validator"
 require_relative "indexmap/writer"
 
 module Indexmap
+  module Pinger
+    autoload :Google, File.expand_path("indexmap/pinger/google", __dir__)
+    autoload :IndexNow, File.expand_path("indexmap/pinger/index_now", __dir__)
+  end
+
   class Error < StandardError; end
 
   class ConfigurationError < Error; end

data/test/indexmap/install_generator_test.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require "test_helper"
+require "generators/indexmap/install_generator"
+require "open3"
+require "rbconfig"
+
+class IndexmapInstallGeneratorTest < Minitest::Test
+  def test_generates_lazy_initializer_and_task_loader
+    Dir.mktmpdir do |destination|
+      File.write(File.join(destination, "Rakefile"), <<~RUBY)
+        require_relative "config/application"
+        Rails.application.load_tasks
+      RUBY
+
+      Indexmap::Generators::InstallGenerator.start([], destination_root: destination)
+
+      initializer = File.join(destination, "config/initializers/indexmap.rb")
+      rakefile = File.read(File.join(destination, "Rakefile"))
+
+      assert File.exist?(initializer)
+      assert_includes File.read(initializer), "module IndexmapConfiguration"
+      assert_includes File.read(initializer), "IndexmapConfiguration.apply if defined?(Indexmap)"
+      assert_includes rakefile, 'require "indexmap/tasks"'
+      assert_operator rakefile.index('require "indexmap/tasks"'), :<, rakefile.index('require_relative "config/application"')
+
+      _stdout, stderr, status = Open3.capture3(RbConfig.ruby, initializer)
+      assert status.success?, stderr
+
+      script = <<~RUBY
+        require "pathname"
+
+        module Rails
+          def self.public_path
+            Pathname.new("public")
+          end
+        end
+
+        require "indexmap"
+        load ARGV.fetch(0)
+
+        configuration = Indexmap.configuration
+        IndexmapConfiguration.apply
+        abort "configuration replaced" unless Indexmap.configuration.equal?(configuration)
+        abort "base URL missing" unless configuration.base_url == "http://localhost:3000"
+      RUBY
+      _stdout, stderr, status = Open3.capture3(
+        RbConfig.ruby,
+        "-I#{File.expand_path("../../lib", __dir__)}",
+        "-e",
+        script,
+        initializer
+      )
+      assert status.success?, stderr
+    end
+  end
+end

data/test/indexmap/lazy_loading_test.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require "test_helper"
+require "open3"
+require "rbconfig"
+
+class IndexmapLazyLoadingTest < Minitest::Test
+  def test_entrypoint_does_not_load_search_console_dependencies
+    script = <<~RUBY
+      require "indexmap"
+
+      loaded = $LOADED_FEATURES.grep(%r{/(?:google/apis|googleauth)(?:/|\\.rb)})
+      abort loaded.join("\\n") unless loaded.empty?
+    RUBY
+
+    _stdout, stderr, status = Open3.capture3(
+      RbConfig.ruby,
+      "-I#{File.expand_path("../../lib", __dir__)}",
+      "-e",
+      script
+    )
+
+    assert status.success?, stderr
+  end
+
+  def test_task_entrypoint_registers_tasks
+    script = <<~RUBY
+      require "indexmap/tasks"
+
+      abort "task missing" unless Rake::Task.task_defined?("indexmap:sitemap:create")
+    RUBY
+
+    _stdout, stderr, status = Open3.capture3(
+      RbConfig.ruby,
+      "-I#{File.expand_path("../../lib", __dir__)}",
+      "-e",
+      script
+    )
+
+    assert status.success?, stderr
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: indexmap
 version: !ruby/object:Gem::Version
-  version: 0.7.1
+  version: 0.8.1
 platform: ruby
 authors:
 - Paulo Fidalgo
@@ -175,6 +175,8 @@ files:
 - CHANGELOG.md
 - LICENSE.txt
 - README.md
+- lib/generators/indexmap/install_generator.rb
+- lib/generators/indexmap/templates/initializer.rb.tt
 - lib/indexmap.rb
 - lib/indexmap/configuration.rb
 - lib/indexmap/creator.rb
@@ -193,11 +195,14 @@ files:
 - lib/indexmap/storage/filesystem.rb
 - lib/indexmap/storage/memory.rb
 - lib/indexmap/task_runner.rb
+- lib/indexmap/tasks.rb
 - lib/indexmap/validator.rb
 - lib/indexmap/version.rb
 - lib/indexmap/writer.rb
 - lib/tasks/indexmap_tasks.rake
 - test/indexmap/configuration_test.rb
+- test/indexmap/install_generator_test.rb
+- test/indexmap/lazy_loading_test.rb
 - test/indexmap/parser_test.rb
 - test/indexmap/pinger/google_test.rb
 - test/indexmap/pinger/index_now_test.rb
@@ -234,7 +239,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.10
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Generate sitemap indexes and child sitemaps with plain Ruby
 test_files: []