gem_hadar 1.19.0 → 1.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 040403d6ff936fc93918a7b72ee41b7c06b0ffaf9b88cd5953c96458587513bc
-  data.tar.gz: ce6834549c29b47f6540e65a52b4d7967fc96ff05a2ef42b21187ea12fcf0aa2
+  metadata.gz: 410e007cfd4db6fe45a437edb7edb73c3cc501708e94fc8dfc81d950c423d011
+  data.tar.gz: c9861d9f19d895d0ded7b1d774906e0026fce892f68768ff7fa4658343212e5c
 SHA512:
-  metadata.gz: 22b85d777cdac8646cb462559ace1a6b7cb3ca0bae520f734431e3d0f8403313506ef0aa04800159f6a7692b506fba877286c52e512bced5a4b3a4a3f883c5d8
-  data.tar.gz: 91b9a1e72041b5e7231c88f09d99f197666226af7485fd8cb4c6702417c0e0896280eb5bf6c7e673efb748bc6ebacd939d8572ae55f023bd52c4a03e831e3911
+  metadata.gz: 1c187a124e2f34104d533e86f724a52d579f7b21fb2e4b5be64aa7205a3b3194b3d3aa74dde3beab66a85efc32bc617aafe911e41e8d31be456a11a15c9b4584
+  data.tar.gz: 8c9dba1c9a4778d6e76aa389fc95299bb84d7c5ca8a5b1dd932dec7ad4ef52c3bf16b52be18c1027af86ee75994efc6c743c58e7d996b0b136ad0e8e623c53dd

data/README.md

@@ -16,12 +16,33 @@ or can be installed via
 $ gem install gem_hadar
 ```
 
+## Usage
+
+Create a new directory and excecute
+
+```
+$ gem_hadar
+```
+
+Edit the created Rakefile until
+
+```
+$ rake gemspec
+```
+
+and then
+
+```
+$ rake build
+```
+
+are perfomed as desired.
+
 ## Author
 
 Florian Frank \<mailto:flori@ping.de\>
+**GemHadar** was written by [Florian Frank](mailto:flori@ping.de)
 
 ## License
 
-This software is licensed under the X11 (or MIT) license:
-http://www.xfree86.org/3.3.6/COPYRIGHT2.html#3
-
+This software is licensed under the _MIT_ license.

data/Rakefile

@@ -17,6 +17,7 @@ GemHadar do
 
   dependency  'tins',           '~> 1.0'
   dependency  'term-ansicolor', '~> 1.0'
+  dependency  'ollama-ruby',    '~> 1.0'
   dependency  'rake'
   dependency  'yard'
 

data/VERSION

@@ -1 +1 @@
-1.19.0
+1.21.0

data/gem_hadar.gemspec

@@ -1,30 +1,31 @@
 # -*- encoding: utf-8 -*-
-# stub: gem_hadar 1.19.0 ruby lib
+# stub: gem_hadar 1.21.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "gem_hadar".freeze
-  s.version = "1.19.0".freeze
+  s.version = "1.21.0".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
   s.authors = ["Florian Frank".freeze]
-  s.date = "2024-10-14"
+  s.date = "1980-01-02"
   s.description = "This library contains some useful functionality to support the development of Ruby Gems".freeze
   s.email = "flori@ping.de".freeze
   s.executables = ["gem_hadar".freeze]
-  s.extra_rdoc_files = ["README.md".freeze, "lib/gem_hadar.rb".freeze, "lib/gem_hadar/version.rb".freeze]
-  s.files = [".gitignore".freeze, "Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "Rakefile".freeze, "VERSION".freeze, "bin/gem_hadar".freeze, "gem_hadar.gemspec".freeze, "lib/gem_hadar.rb".freeze, "lib/gem_hadar/version.rb".freeze]
+  s.extra_rdoc_files = ["README.md".freeze, "lib/gem_hadar.rb".freeze, "lib/gem_hadar/github.rb".freeze, "lib/gem_hadar/setup.rb".freeze, "lib/gem_hadar/template_compiler.rb".freeze, "lib/gem_hadar/version.rb".freeze]
+  s.files = [".gitignore".freeze, "Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "Rakefile".freeze, "VERSION".freeze, "bin/gem_hadar".freeze, "gem_hadar.gemspec".freeze, "lib/gem_hadar.rb".freeze, "lib/gem_hadar/github.rb".freeze, "lib/gem_hadar/setup.rb".freeze, "lib/gem_hadar/template_compiler.rb".freeze, "lib/gem_hadar/version.rb".freeze]
   s.homepage = "https://github.com/flori/gem_hadar".freeze
   s.licenses = ["MIT".freeze]
   s.rdoc_options = ["--title".freeze, "GemHadar - Library for the development of Ruby Gems".freeze, "--main".freeze, "README.md".freeze]
-  s.rubygems_version = "3.5.18".freeze
+  s.rubygems_version = "3.6.9".freeze
   s.summary = "Library for the development of Ruby Gems".freeze
 
   s.specification_version = 4
 
-  s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 1.19".freeze])
+  s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 1.20".freeze])
   s.add_runtime_dependency(%q<tins>.freeze, ["~> 1.0".freeze])
   s.add_runtime_dependency(%q<term-ansicolor>.freeze, ["~> 1.0".freeze])
+  s.add_runtime_dependency(%q<ollama-ruby>.freeze, ["~> 1.0".freeze])
   s.add_runtime_dependency(%q<rake>.freeze, [">= 0".freeze])
   s.add_runtime_dependency(%q<yard>.freeze, [">= 0".freeze])
 end

data/lib/gem_hadar/github.rb

@@ -0,0 +1,57 @@
+require 'net/http'
+require 'json'
+
+module GemHadar::GitHub
+end
+
+class GemHadar::GitHub::ReleaseCreator
+  class << self
+    attr_accessor :github_api_url
+  end
+  self.github_api_url = 'https://api.github.com'
+
+  def initialize(owner:, repo:, token:, api_version: '2022-11-28')
+    @owner       = owner
+    @repo        = repo
+    @token       = token
+    @api_version = api_version
+  end
+
+  def perform(tag_name:, target_commitish:, body:, name: tag_name, draft: false, prerelease: false)
+    uri = URI("#{self.class.github_api_url}/repos/#{@owner}/#{@repo}/releases")
+
+    headers = {
+      "Accept" => "application/vnd.github+json",
+      "Authorization" => "Bearer #{@token}",
+      "X-GitHub-Api-Version" => @api_version
+    }
+
+    data = {
+      tag_name:,
+      target_commitish:,
+      body:,
+      name:,
+      draft:,
+      prerelease:,
+    }.compact
+
+    req = Net::HTTP::Post.new(uri.request_uri, headers)
+    req.body = JSON(data)
+
+    response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+      http.request(req)
+    end
+
+    case response
+    when Net::HTTPSuccess
+      puts "Release created successfully!"
+      response.body
+    else
+      error_msg = "Failed to create release. Status: #{response.code}"
+      raise error_msg
+    end
+  rescue => e
+    warn "Error creating release: #{e.message}"
+    nil
+  end
+end

data/lib/gem_hadar/setup.rb

@@ -0,0 +1,41 @@
+class GemHadar::Setup
+  include FileUtils
+
+  def perform
+    mkdir_p 'lib'
+    unless File.exist?('VERSION')
+      File.open('VERSION', 'w') do |output|
+        output.puts '0.0.0'
+      end
+    end
+    unless File.exist?('Rakefile')
+      File.open('Rakefile', 'w') do |output|
+        output.puts <<~EOT
+            # vim: set filetype=ruby et sw=2 ts=2:
+
+            require 'gem_hadar'
+
+            GemHadar do
+              #developing true
+              #name       'TODO'
+              module_type :class
+              #author     'TODO'
+              #email      'todo@example.com'
+              #homepage   "https://github.com/TODO/NAME"
+              #summary    'TODO'
+              description 'TODO'
+              test_dir    'spec'
+              ignore      '.*.sw[pon]', 'pkg', 'Gemfile.lock', '.AppleDouble', '.bundle', '.yardoc', 'tags'
+              readme      'README.md'
+
+              #executables << 'bin/TODO'
+
+              #dependency  'TODO', '~>1.2.3'
+
+              #licenses << 'TODO
+            end
+        EOT
+      end
+    end
+  end
+end

data/lib/gem_hadar/template_compiler.rb

@@ -0,0 +1,31 @@
+require 'erb'
+
+class GemHadar::TemplateCompiler
+  include Tins::BlockSelf
+  include Tins::MethodMissingDelegator::DelegatorModule
+
+  def initialize(&block)
+    super block_self(&block)
+    @values = {}
+    instance_eval(&block)
+  end
+
+  def compile(src, dst)
+    template = File.read(src)
+    File.open(dst, 'w') do |output|
+      erb = ERB.new(template, nil, '-')
+      erb.filename = src.to_s
+      output.write erb.result binding
+    end
+  end
+
+  def method_missing(id, *a, &b)
+    if a.empty? && id && @values.key?(id)
+      @values[id]
+    elsif a.size == 1
+      @values[id] = a.first
+    else
+      super
+    end
+  end
+end

data/lib/gem_hadar/version.rb

@@ -1,6 +1,6 @@
 class GemHadar
   # GemHadar version
-  VERSION         = '1.19.0'
+  VERSION         = '1.21.0'
   VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
   VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
   VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:

data/lib/gem_hadar.rb

@@ -15,18 +15,19 @@ require 'rake/testtask'
 require 'dslkit/polite'
 require 'set'
 require 'pathname'
-require 'erb'
-require 'gem_hadar/version'
+require 'ollama'
 require 'term/ansicolor'
 require_maybe 'yard'
 require_maybe 'simplecov'
 require_maybe 'rubygems/package_task'
 require_maybe 'rcov/rcovtask'
 require_maybe 'rspec/core/rake_task'
-
-def GemHadar(&block)
-  GemHadar.new(&block).create_all_tasks
+class GemHadar
 end
+require 'gem_hadar/version'
+require 'gem_hadar/setup'
+require 'gem_hadar/template_compiler'
+require 'gem_hadar/github'
 
 class GemHadar
   include Term::ANSIColor
@@ -50,18 +51,6 @@ class GemHadar
     fail "#{self.class}: #{name} has to be set for gem"
   end
 
-  def assert_valid_link(name, orig_url)
-    developing and return orig_url
-    url = orig_url
-    begin
-      response = Net::HTTP.get_response(URI.parse(url))
-      url = response['location']
-    end while response.is_a?(Net::HTTPRedirection)
-    response.is_a?(Net::HTTPOK) or
-      fail "#{orig_url.inspect} for #{name} has to be a valid link"
-    orig_url
-  end
-
   dsl_accessor :developing, false
 
   dsl_accessor :name do
@@ -214,7 +203,7 @@ class GemHadar
   end
 
   def install_library(&block)
-    @install_library_block = lambda do
+    @install_library_block = -> do
       desc 'Install executable/library into site_ruby directories'
       task :install => :prepare_install, &block
     end
@@ -268,72 +257,22 @@ class GemHadar
     end
   end
 
-  def gem_files
-    (files.to_a - package_ignore_files.to_a)
-  end
-
-  def gemspec
-    Gem::Specification.new do |s|
-      s.name        = name
-      s.version     = ::Gem::Version.new(version)
-      s.author      = author
-      s.email       = email
-      s.homepage    = assert_valid_link(:homepage, homepage)
-      s.summary     = summary
-      s.description = description
-
-      gem_files.full? { |f| s.files = Array(f) }
-      test_files.full? { |t| s.test_files = Array(t) }
-      extensions.full? { |e| s.extensions = Array(e) }
-      bindir.full? { |b| s.bindir = b }
-      executables.full? { |e| s.executables = Array(e) }
-      licenses.full? { |l| s.licenses = Array(licenses) }
-      post_install_message.full? { |m| s.post_install_message = m }
-
-      required_ruby_version.full? { |v| s.required_ruby_version = v }
-      s.add_development_dependency('gem_hadar', "~> #{VERSION[/\A\d+\.\d+/, 0]}")
-      for d in @development_dependencies
-        s.add_development_dependency(*d)
-      end
-      for d in @dependencies
-        if s.respond_to?(:add_runtime_dependency)
-          s.add_runtime_dependency(*d)
-        else
-          s.add_dependency(*d)
-        end
-      end
-
-      require_paths.full? { |r| s.require_paths = Array(r) }
-
-      if title
-        s.rdoc_options << '--title' << title
-      else
-        s.rdoc_options << '--title' << "#{name.camelize} - #{summary}"
-      end
-      if readme
-        s.rdoc_options << '--main' << readme
-        s.extra_rdoc_files << readme
-      end
-      doc_files.full? { |df| s.extra_rdoc_files.concat Array(df) }
-    end
-  end
-
   def version_task
     desc m = "Writing version information for #{name}-#{version}"
     task :version do
       puts m
       mkdir_p dir = File.join('lib', path_name)
       secure_write(File.join(dir, 'version.rb')) do |v|
-        v.puts <<EOT
-#{module_type} #{path_module}
-  # #{path_module} version
-  VERSION         = '#{version}'
-  VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
-  VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
-  VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:
-  VERSION_BUILD   = VERSION_ARRAY[2] # :nodoc:
-end
-EOT
+        v.puts <<~EOT
+          #{module_type} #{path_module}
+            # #{path_module} version
+            VERSION         = '#{version}'
+            VERSION_ARRAY   = VERSION.split('.').map(&:to_i) # :nodoc:
+            VERSION_MAJOR   = VERSION_ARRAY[0] # :nodoc:
+            VERSION_MINOR   = VERSION_ARRAY[1] # :nodoc:
+            VERSION_BUILD   = VERSION_ARRAY[2] # :nodoc:
+          end
+        EOT
         version_epilogue.full? { |ve| v.puts ve }
       end
     end
@@ -357,10 +296,36 @@ EOT
     end
   end
 
-  def versions
-    `git tag`.lines.grep(/^v?\d+\.\d+\.\d+$/).map(&:chomp).map {
-      _1.sub(/\Av/, '')
-    }.sort_by(&:version)
+  def version_log_diff(to_version: 'HEAD', from_version: nil)
+    if to_version == 'HEAD'
+      if from_version.blank?
+        from_version = versions.last
+      else
+        unless versions.find { |v| v == from_version }
+          fail "Could not find #{from_version.inspect}."
+        end
+      end
+      `git log -p #{version_identifier(from_version)}..HEAD`
+    else
+      unless versions.find { |v| v == to_version }
+        fail "Could not find #{to_version.inspect}."
+      end
+      if from_version.blank?
+        from_version = versions.each_cons(2).find do |previous_version, v|
+          if v == to_version
+            break previous_version
+          end
+        end
+        unless from_version
+          fail "Could not find version before #{to_version.inspect}."
+        end
+      else
+        unless versions.find { |v| v == from_version }
+          fail "Could not find #{from_version.inspect}."
+        end
+      end
+      `git log -p #{version_identifier(from_version)}..#{version_identifier(to_version)}`
+    end
   end
 
   def version_diff_task
@@ -374,8 +339,8 @@ EOT
 
       desc "Displaying the diff from env var VERSION to the next version or HEAD"
       task :diff do
-        arg_version = ENV.fetch('VERSION', version).dup.prepend(?v)
-        my_versions = versions.map { _1.prepend(?v) } + %w[ HEAD ]
+        arg_version = version_identifier(ENV.fetch('VERSION', version))
+        my_versions = versions.map { version_identifier(_1) } + %w[ HEAD ]
         start_version, end_version = my_versions[my_versions.index(arg_version), 2]
         puts color(172) {"Showing diff from version %s to %s:" % [ start_version, end_version ]}
         puts `git diff --color=always #{start_version}..#{end_version}`
@@ -489,41 +454,6 @@ EOT
     end
   end
 
-  def self.start_simplecov
-    defined? SimpleCov or return
-    filter = "#{File.basename(File.dirname(caller.first))}/"
-    SimpleCov.start do
-      add_filter filter
-    end
-  end
-
-  def write_ignore_file
-    secure_write('.gitignore') do |output|
-      output.puts(ignore.sort)
-    end
-  end
-
-  def write_gemfile
-     default_gemfile =<<EOT
-# vim: set filetype=ruby et sw=2 ts=2:
-
-source 'https://rubygems.org'
-
-gemspec
-EOT
-    current_gemfile = File.exist?('Gemfile') && File.read('Gemfile')
-    case current_gemfile
-    when false
-      secure_write('Gemfile') do |output|
-        output.write default_gemfile
-      end
-    when default_gemfile
-      ;;
-    else
-      warn "INFO: Current Gemfile differs from default Gemfile."
-    end
-  end
-
   def version_bump_task
     namespace :version do
       namespace :bump do
@@ -557,7 +487,7 @@ EOT
       task :tag do
         force = ENV['FORCE'].to_i == 1
         begin
-          sh "git tag -a -m 'Version #{version}' #{'-f' if force} v#{version}"
+          sh "git tag -a -m 'Version #{version}' #{'-f' if force} #{version_identifier(version)}"
         rescue RuntimeError
           if `git diff v#{version}..HEAD`.empty?
             puts "Version #{version} is already tagged, but it's no different"
@@ -579,12 +509,6 @@ EOT
     ENV.fetch('GIT_REMOTE', 'origin').split(/\s+/).first
   end
 
-  def git_remotes
-    remotes = ENV['GIT_REMOTE'].full?(:split, /\s+/)
-    remotes or remotes = `git remote`.lines.map(&:chomp)
-    remotes
-  end
-
   def master_prepare_task
     namespace :master do
       desc "Prepare a remote git repository for this project"
@@ -648,7 +572,7 @@ EOT
             if ask?("Do you really want to push #{path.inspect} to rubygems? "\
                 "(yes/NO) ", /\Ayes\z/i)
               then
-              key = ENV['GEM_API_KEY'].full? { |k| "--key #{k} " }
+              key = ENV['GEM_HOST_API_KEY'].full? { |k| "--key #{k} " }
               sh "gem push #{key}#{path}"
             else
               exit 1
@@ -671,12 +595,106 @@ EOT
     end
   end
 
+  def create_body
+    base_url = ENV['OLLAMA_URL']
+    if base_url.blank? && host = ENV['OLLAMA_HOST'].full?
+      base_url = 'http://%s' % host
+    end
+    base_url.present? or return
+    log_diff = version_log_diff(to_version: version)
+    model    = ENV.fetch('OLLAMA_MODEL', 'llama3.1')
+    ollama   = Ollama::Client.new(base_url:, read_timeout: 600, connect_timeout: 60)
+    system = <<~EOT
+      You are a Ruby programmer generating changelog messages in markdown
+      format for new releases, so users can see what has changed. Remember you
+      are not a chatbot of any kind.
+    EOT
+    prompt = (<<~EOT) % { name:, version:, log_diff: }
+      Output the content of a changelog for the new release of %{name} %{version}
+
+      **Strictly** follow these guidelines:
+
+        - Use bullet points in markdown format (`-`) to list significant changes.
+        - Exclude trivial updates such as:
+          * Version number increments
+          * Dependency version bumps (unless they resolve critical issues)
+          * Minor code style adjustments
+          * Internal documentation tweaks
+        - Include only verified and substantial changes that impact
+          functionality, performance, or user experience.
+        - If unsure about a change's significance, omit it from the output.
+        - Avoid adding any comments or notes; keep the output purely factual.
+
+      These are the log messages including patches for the new release:
+
+      %{log_diff}
+    EOT
+    options = ENV['OLLAMA_OPTIONS'].full? { |o| JSON.parse(o) } || {}
+    options |= { "temperature" => 0, "top_p" => 1, "min_p" => 0.1 }
+    ollama.generate(model:, system:, prompt:, options:, stream: false, think: false).response
+  end
+
+  def edit_temp_file(content)
+    editor = ENV.fetch('EDITOR', `which vi`.chomp)
+    unless File.exist?(editor)
+      warn "Can't find EDITOR. => Returning."
+      return
+    end
+    temp_file = Tempfile.new('changelog')
+    temp_file.write(content)
+    temp_file.close
+
+    unless system("#{editor} #{temp_file.path}")
+      warn "#{editor} returned #{$?.exitstatus} => Returning."
+      return
+    end
+
+    File.read(temp_file.path)
+  ensure
+    temp_file&.close&.unlink
+  end
+
+  def github_release_task
+    namespace :github do
+      unless github_api_token = ENV['GITHUB_API_TOKEN'].full?
+        warn "GITHUB_API_TOKEN not set. => Skipping github release task."
+        task :release
+        return
+      end
+      desc "Create a new GitHub release for the current version with a changelog"
+      task :release do
+        yes = ask?(
+          "Do you want to publish a release message on github? (y/n, %{default}) ",
+          /\Ay/i, default: ENV['GITHUB_RELEASE_ENABLED']
+        )
+        unless yes
+            warn "Skipping publication of a github release message."
+            next
+        end
+        if %r(\A/*(?<owner>[^/]+)/(?<repo>[^/.]+)) =~ github_remote_url&.path
+          rc = GitHub::ReleaseCreator.new(owner:, repo:, token: github_api_token)
+          tag_name         = version_identifier(version)
+          target_commitish = `git rev-parse #{tag_name.inspect}`.chomp
+          body             = edit_temp_file(create_body)
+          if body.present?
+            rc.perform(tag_name:, target_commitish:, body:)
+          else
+            warn "Skipping creation of github release message."
+          end
+        else
+          warn "Could not derive github remote url from git remotes. => Skipping github release task."
+        end
+      end
+    end
+  end
+
   def push_task
     master_prepare_task
     version_push_task
     master_push_task
     gem_push_task
     git_remotes_task
+    github_release_task
     task :modified do
       changed_files = `git status --porcelain`.gsub(/^\s*\S\s+/, '').lines
       unless changed_files.empty?
@@ -685,7 +703,7 @@ EOT
       end
     end
     desc "Push master and version #{version} all git remotes: #{git_remotes * ' '}"
-    task :push => %i[ modified build master:push version:push gem:push ]
+    task :push => %i[ modified build master:push version:push gem:push github:release ]
   end
 
   def compile_task
@@ -709,11 +727,11 @@ EOT
     desc 'Create .rvmrc file'
     task :rvm do
       secure_write('.rvmrc') do |output|
-        output.write <<EOT
-rvm use #{rvm.use}
-rvm gemset create #{rvm.gemset}
-rvm gemset use #{rvm.gemset}
-EOT
+        output.write <<~EOT
+          rvm use #{rvm.use}
+          rvm gemset create #{rvm.gemset}
+          rvm gemset use #{rvm.gemset}
+        EOT
       end
     end
   end
@@ -750,14 +768,10 @@ EOT
     task :yard => %i[ yard:private yard:view ]
   end
 
-  def ask?(prompt, pattern)
-    STDOUT.print prompt
-    answer = STDIN.gets.chomp
-    if answer =~ pattern
-      $~
-    end
-  end
-
+  # The create_all_tasks method sets up and registers all the Rake tasks for
+  # the gem project.
+  #
+  # @return [GemHadar] the instance of GemHadar
   def create_all_tasks
     default_task
     build_task
@@ -791,77 +805,242 @@ EOT
     self
   end
 
-  class TemplateCompiler
-    include Tins::BlockSelf
-    include Tins::MethodMissingDelegator::DelegatorModule
-
-    def initialize(&block)
-      super block_self(&block)
-      @values = {}
-      instance_eval(&block)
+  # The write_ignore_file method writes the current ignore_files configuration
+  # to a .gitignore file in the project root directory.
+  def write_ignore_file
+    secure_write('.gitignore') do |output|
+      output.puts(ignore.sort)
     end
+  end
 
-    def compile(src, dst)
-      template = File.read(src)
-      File.open(dst, 'w') do |output|
-        erb = ERB.new(template, nil, '-')
-        erb.filename = src.to_s
-        output.write erb.result binding
+  # The write_gemfile method creates and writes the default Gemfile content if
+  # it doesn't exist. If a custom Gemfile exists, it only displays a warning.
+  def write_gemfile
+    default_gemfile =<<~EOT
+      # vim: set filetype=ruby et sw=2 ts=2:
+
+      source 'https://rubygems.org'
+
+      gemspec
+    EOT
+    current_gemfile = File.exist?('Gemfile') && File.read('Gemfile')
+    case current_gemfile
+    when false
+      secure_write('Gemfile') do |output|
+        output.write default_gemfile
       end
+    when default_gemfile
+      ;;
+    else
+      warn "INFO: Current Gemfile differs from default Gemfile."
     end
+  end
+
+  # The assert_valid_link method verifies that the provided URL is valid by
+  # checking if it returns an HTTP OK status after following redirects, unless
+  # project is still `developing`.
+  #
+  # @param name [String] the name associated with the link being validated
+  # @param orig_url [String] the URL to validate
+  #
+  # @return [String] the original URL if validation succeeds
+  #
+  # @raise [ArgumentError] if the final response is not an HTTP OK status after
+  # following redirects
+  def assert_valid_link(name, orig_url)
+    developing and return orig_url
+    url = orig_url
+    begin
+      response = Net::HTTP.get_response(URI.parse(url))
+      url = response['location']
+    end while response.is_a?(Net::HTTPRedirection)
+    response.is_a?(Net::HTTPOK) or
+      fail "#{orig_url.inspect} for #{name} has to be a valid link"
+    orig_url
+  end
+
+  # The gemspec method creates and returns a new Gem::Specification object
+  # that defines the metadata and dependencies for the gem package.
+  #
+  # @return [Gem::Specification] a fully configured Gem specification object
+  def gemspec
+    Gem::Specification.new do |s|
+      s.name        = name
+      s.version     = ::Gem::Version.new(version)
+      s.author      = author
+      s.email       = email
+      s.homepage    = assert_valid_link(:homepage, homepage)
+      s.summary     = summary
+      s.description = description
+
+      gem_files.full? { |f| s.files = Array(f) }
+      test_files.full? { |t| s.test_files = Array(t) }
+      extensions.full? { |e| s.extensions = Array(e) }
+      bindir.full? { |b| s.bindir = b }
+      executables.full? { |e| s.executables = Array(e) }
+      licenses.full? { |l| s.licenses = Array(licenses) }
+      post_install_message.full? { |m| s.post_install_message = m }
 
-    def method_missing(id, *a, &b)
-      if a.empty? && id && @values.key?(id)
-        @values[id]
-      elsif a.size == 1
-        @values[id] = a.first
+      required_ruby_version.full? { |v| s.required_ruby_version = v }
+      s.add_development_dependency('gem_hadar', "~> #{VERSION[/\A\d+\.\d+/, 0]}")
+      for d in @development_dependencies
+        s.add_development_dependency(*d)
+      end
+      for d in @dependencies
+        if s.respond_to?(:add_runtime_dependency)
+          s.add_runtime_dependency(*d)
+        else
+          s.add_dependency(*d)
+        end
+      end
+
+      require_paths.full? { |r| s.require_paths = Array(r) }
+
+      if title
+        s.rdoc_options << '--title' << title
       else
-        super
+        s.rdoc_options << '--title' << "#{name.camelize} - #{summary}"
       end
+      if readme
+        s.rdoc_options << '--main' << readme
+        s.extra_rdoc_files << readme
+      end
+      doc_files.full? { |df| s.extra_rdoc_files.concat Array(df) }
     end
   end
 
-  class Setup
-    include FileUtils
+  # The warn method displays warning messages using orange colored output.
+  #
+  # @param msgs [Array<String>] the array of message strings to display
+  def warn(*msgs)
+    msgs.map! { |m| color(208) { m } }
+    super(*msgs, uplevel: 1)
+  end
 
-    def perform
-      mkdir_p 'lib'
-      unless File.exist?('VERSION')
-        File.open('VERSION', 'w') do |output|
-          output.puts '0.0.0'
-        end
-      end
-      unless File.exist?('Rakefile')
-        File.open('Rakefile', 'w') do |output|
-          output.puts <<~EOT
-            # vim: set filetype=ruby et sw=2 ts=2:
+  # The fail method formats and displays failure messages using red colored
+  # output.
+  #
+  # @param args [Array] the array of arguments to be formatted and passed to super
+  def fail(*args)
+    args.map! do |a|
+      a.respond_to?(:to_str) ? color(196) { a.to_str } : a
+    end
+    super(*args)
+  end
+  def fail(*args)
+    args.map! do |a|
+      a.respond_to?(:to_str) ? color(196) { a.to_str } : a
+    end
+    super(*args)
+  end
 
-            require 'gem_hadar'
+  # The git_remotes method retrieves the list of remote repositories configured
+  # for the current Git project.
+  #
+  # It first attempts to read the remotes from the ENV['GIT_REMOTE']
+  # environment variable, splitting it by whitespace. If this is not available,
+  # it falls back to querying the local Git repository using `git remote`.
+  #
+  # @return [ Array<String> ] an array of remote names
+  def git_remotes
+    remotes = ENV['GIT_REMOTE'].full?(:split, /\s+/)
+    remotes or remotes = `git remote`.lines.map(&:chomp)
+    remotes
+  end
 
-            GemHadar do
-              #developing true
-              #name       'TODO'
-              module_type :class
-              #author     'TODO'
-              #email      'todo@example.com'
-              #homepage   "https://github.com/TODO/NAME"
-              #summary    'TODO'
-              description 'TODO'
-              test_dir    'spec'
-              ignore      '.*.sw[pon]', 'pkg', 'Gemfile.lock', '.AppleDouble', '.bundle', '.yardoc', 'tags'
-              readme      'README.md'
+  # The ask? method prompts the user with a message and reads their input It
+  # returns a MatchData object if the input matches the provided pattern.
+  #
+  # @param prompt [ String ] the message to display to the user
+  # @param pattern [ Regexp ] the regular expression to match against the input
+  #
+  # @return [ MatchData, nil ] the result of the pattern match or nil if no match
+  def ask?(prompt, pattern, default: nil)
+    if prompt.include?('%{default}') && default.present?
+       prompt = prompt % { default: "default is #{default.inspect}" }
+    end
+    STDOUT.print prompt
+    answer = STDIN.gets.chomp
+    default.present? && answer.blank? and answer = default
+    if answer =~ pattern
+      $~
+    end
+  end
 
-              #executables << 'bin/TODO'
+  # The gem_files method returns an array of files that are included in the gem
+  # package.
+  #
+  # It calculates this by subtracting the files listed in package_ignore_files
+  # from the list of all files.
+  #
+  # @return [ Array<String> ] the list of files to include in the gem package
+  def gem_files
+    (files.to_a - package_ignore_files.to_a)
+  end
 
-              #dependency  'TODO', '~>1.2.3'
+  # The versions method retrieves and processes the list of git tags that match
+  # semantic versioning patterns.
+  #
+  # It executes `git tag` to get all available tags, filters them using a
+  # regular expression to identify valid version strings, removes any 'v'
+  # prefix from each version string, trims whitespace, and sorts the resulting
+  # array based on semantic versioning order.
+  #
+  # @return [ Array<String> ] an array of version strings sorted in ascending
+  # order according to semantic versioning rules.
+  def versions
+    @versions ||= `git tag`.lines.grep(/^v?\d+\.\d+\.\d+$/).map(&:chomp).map {
+      _1.sub(/\Av/, '')
+    }.sort_by(&:version)
+  end
 
-              #licenses << 'TODO
-            end
-          EOT
+  # The version_identifier method prepends a 'v' prefix to the given version
+  # string.
+  #
+  # @param version [String] the version string to modify
+  # @return [String] the modified version string with a 'v' prefix
+  def version_identifier(version)
+    version.dup.prepend ?v
+  end
+
+  # The github_remote_url method retrieves and parses the GitHub remote URL
+  # from the local Git configuration.
+  #
+  # It executes `git remote -v` to get all remote configurations, extracts the
+  # push URLs, processes them to construct valid URIs, and returns the first
+  # URI pointing to GitHub.com.
+  #
+  # @return [URI, nil] The parsed GitHub remote URI or nil if not found.
+  def github_remote_url
+    if remotes = `git remote -v`
+      remotes_urls = remotes.scan(/^(\S+)\s+(\S+)\s+\(push\)/)
+      remotes_uris = remotes_urls.map do |name, url|
+        if %r(\A(?<scheme>[^@]+)@(?<hostname>[A-Za-z0-9.]+):(?:\d*)(?<path>.*)) =~ url
+          path = ?/ + path unless path.start_with? ?/
+          url = 'ssh://%s@%s%s' % [ scheme, hostname, path ] # approximate correct URIs
         end
+        URI.parse(url)
       end
+      remotes_uris.find { |uri| uri.hostname == 'github.com' }
     end
   end
+
+  class << self
+    # The start_simplecov method initializes SimpleCov and configures it to
+    # ignore coverage data from the directory containing the caller. This can be
+    # called from a test or spec helper.
+    def start_simplecov
+      defined? SimpleCov or return
+      filter = "#{File.basename(File.dirname(caller.first))}/"
+      SimpleCov.start do
+        add_filter filter
+      end
+    end
+  end
+end
+
+def GemHadar(&block)
+  GemHadar.new(&block).create_all_tasks
 end
 
 def template(pathname, &block)

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: gem_hadar
 version: !ruby/object:Gem::Version
-  version: 1.19.0
+  version: 1.21.0
 platform: ruby
 authors:
 - Florian Frank
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-10-14 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gem_hadar
@@ -16,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.19'
+        version: '1.20'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.19'
+        version: '1.20'
 - !ruby/object:Gem::Dependency
   name: tins
   requirement: !ruby/object:Gem::Requirement
@@ -52,6 +51,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: ollama-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -89,6 +102,9 @@ extensions: []
 extra_rdoc_files:
 - README.md
 - lib/gem_hadar.rb
+- lib/gem_hadar/github.rb
+- lib/gem_hadar/setup.rb
+- lib/gem_hadar/template_compiler.rb
 - lib/gem_hadar/version.rb
 files:
 - ".gitignore"
@@ -100,12 +116,14 @@ files:
 - bin/gem_hadar
 - gem_hadar.gemspec
 - lib/gem_hadar.rb
+- lib/gem_hadar/github.rb
+- lib/gem_hadar/setup.rb
+- lib/gem_hadar/template_compiler.rb
 - lib/gem_hadar/version.rb
 homepage: https://github.com/flori/gem_hadar
 licenses:
 - MIT
 metadata: {}
-post_install_message:
 rdoc_options:
 - "--title"
 - GemHadar - Library for the development of Ruby Gems
@@ -124,8 +142,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.18
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Library for the development of Ruby Gems
 test_files: []