gem_hadar 2.10.0 → 2.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 70b8ebbb150e7e3bacd44771cb896583ce69a0eee13bd5561994d2d7f23648be
-  data.tar.gz: 9b02f037c8f2f87447bbd573caa9bad4f7dda07d0fdf1b7591b0cd25663fc480
+  metadata.gz: d873e582074092072360c3800181732ab53d2e27a5e7663262c36b60bd3f96a6
+  data.tar.gz: 6074b1585ff125a9ee21f18e0231ea34840a24ec1246cfce41ff1ca58ad60603
 SHA512:
-  metadata.gz: d93c77e6365f62946bbefe9b31cb9e3e08b1499980107b0b574033e63388f6b30c318fa0427e5ee2b997606c3281dba052f062ba1f7412473d99b5506b8657f0
-  data.tar.gz: c97c5812c7d9da0ccb0c089ad8fb7d9f0fe29ab4f4b67ebfa3d097817ebae970b52a27913ec6f465242a6c6988ed24611fe8c34b93e881311fe19e8424f62af7
+  metadata.gz: 57c0aeac59a2447bfd6073cbf4ea7f4411e3930249e863d0f6a9dffa171933a40d94646e1eb4a5a03dc5fd1519178bb613fa0a1c9b02b684e918af36e42fc0d7
+  data.tar.gz: 648d51b596c0f5b50a58d4c0e9189775356ad7de3657fe959bfe31af67b17f9634c4d89c2ee2672f2d4dc92e4f7d4be5297cec607cbb51ce22af73280d15d898

data/.all_images.yml

@@ -14,7 +14,7 @@ script: &script |-
 fail_fast: true
 
 images:
-  #ruby:4.0-rc-alpine: *script
+  ruby:4.0-rc-alpine: *script
   ruby:3.4-alpine: *script
   ruby:3.3-alpine: *script
   ruby:3.2-alpine: *script

data/Rakefile

@@ -12,7 +12,7 @@ GemHadar do
   description    'This library contains some useful functionality to support the development of Ruby Gems'
   test_dir       'spec'
   ignore         '.*.sw[pon]', 'pkg', 'Gemfile.lock', '.AppleDouble',
-                 '.bundle', '.yardoc', 'doc', 'tags'
+    '.bundle', '.yardoc', 'doc', 'tags', 'cscope.out'
   package_ignore '.gitignore', 'VERSION'
   readme         'README.md'
 
@@ -25,6 +25,7 @@ GemHadar do
   dependency 'tins',           '~> 1.0'
   dependency 'term-ansicolor', '~> 1.0'
   dependency 'ollama-ruby',    '~> 1.17'
+  dependency 'infobar',        '~> 0.11'
   dependency 'mize'
   dependency 'rake'
   dependency 'yard'

data/gem_hadar.gemspec

@@ -1,9 +1,9 @@
 # -*- encoding: utf-8 -*-
-# stub: gem_hadar 2.10.0 ruby lib
+# stub: gem_hadar 2.11.0 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "gem_hadar".freeze
-  s.version = "2.10.0".freeze
+  s.version = "2.11.0".freeze
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]
@@ -12,8 +12,8 @@ Gem::Specification.new do |s|
   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/github.rb".freeze, "lib/gem_hadar/prompt_template.rb".freeze, "lib/gem_hadar/rvm_config.rb".freeze, "lib/gem_hadar/setup.rb".freeze, "lib/gem_hadar/simplecov.rb".freeze, "lib/gem_hadar/template_compiler.rb".freeze, "lib/gem_hadar/utils.rb".freeze, "lib/gem_hadar/version.rb".freeze, "lib/gem_hadar/warn.rb".freeze]
-  s.files = [".all_images.yml".freeze, ".github/workflows/static.yml".freeze, "Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "Rakefile".freeze, "bin/gem_hadar".freeze, "gem_hadar.gemspec".freeze, "lib/gem_hadar.rb".freeze, "lib/gem_hadar/github.rb".freeze, "lib/gem_hadar/github_workflows/static.yml.erb".freeze, "lib/gem_hadar/prompt_template.rb".freeze, "lib/gem_hadar/rvm_config.rb".freeze, "lib/gem_hadar/setup.rb".freeze, "lib/gem_hadar/simplecov.rb".freeze, "lib/gem_hadar/template_compiler.rb".freeze, "lib/gem_hadar/utils.rb".freeze, "lib/gem_hadar/version.rb".freeze, "lib/gem_hadar/warn.rb".freeze, "spec/gem_hadar_spec.rb".freeze, "spec/spec_helper.rb".freeze]
+  s.extra_rdoc_files = ["README.md".freeze, "lib/gem_hadar.rb".freeze, "lib/gem_hadar/changelog_generator.rb".freeze, "lib/gem_hadar/github.rb".freeze, "lib/gem_hadar/ollama_support.rb".freeze, "lib/gem_hadar/prompt_template.rb".freeze, "lib/gem_hadar/rvm_config.rb".freeze, "lib/gem_hadar/setup.rb".freeze, "lib/gem_hadar/simplecov.rb".freeze, "lib/gem_hadar/template_compiler.rb".freeze, "lib/gem_hadar/utils.rb".freeze, "lib/gem_hadar/version.rb".freeze, "lib/gem_hadar/version_spec.rb".freeze, "lib/gem_hadar/warn.rb".freeze]
+  s.files = [".all_images.yml".freeze, ".github/workflows/static.yml".freeze, "Gemfile".freeze, "LICENSE".freeze, "README.md".freeze, "Rakefile".freeze, "bin/gem_hadar".freeze, "gem_hadar.gemspec".freeze, "lib/gem_hadar.rb".freeze, "lib/gem_hadar/changelog_generator.rb".freeze, "lib/gem_hadar/github.rb".freeze, "lib/gem_hadar/github_workflows/static.yml.erb".freeze, "lib/gem_hadar/ollama_support.rb".freeze, "lib/gem_hadar/prompt_template.rb".freeze, "lib/gem_hadar/rvm_config.rb".freeze, "lib/gem_hadar/setup.rb".freeze, "lib/gem_hadar/simplecov.rb".freeze, "lib/gem_hadar/template_compiler.rb".freeze, "lib/gem_hadar/utils.rb".freeze, "lib/gem_hadar/version.rb".freeze, "lib/gem_hadar/version_spec.rb".freeze, "lib/gem_hadar/warn.rb".freeze, "spec/gem_hadar_spec.rb".freeze, "spec/spec_helper.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]
@@ -23,13 +23,14 @@ Gem::Specification.new do |s|
 
   s.specification_version = 4
 
-  s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 2.9".freeze])
+  s.add_development_dependency(%q<gem_hadar>.freeze, ["~> 2.10".freeze])
   s.add_development_dependency(%q<all_images>.freeze, [">= 0".freeze])
   s.add_development_dependency(%q<rspec>.freeze, ["~> 3.13".freeze])
   s.add_development_dependency(%q<simplecov>.freeze, [">= 0".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.17".freeze])
+  s.add_runtime_dependency(%q<infobar>.freeze, ["~> 0.11".freeze])
   s.add_runtime_dependency(%q<mize>.freeze, [">= 0".freeze])
   s.add_runtime_dependency(%q<rake>.freeze, [">= 0".freeze])
   s.add_runtime_dependency(%q<yard>.freeze, [">= 0".freeze])

data/lib/gem_hadar/changelog_generator.rb

@@ -0,0 +1,292 @@
+require 'json'
+require 'tempfile'
+
+class GemHadar
+  # A class that generates changelog entries by analyzing Git history and AI
+  # processing
+  #
+  # The ChangelogGenerator class provides functionality to create structured
+  # changelog entries based on Git commit history. It can generate individual
+  # changelog entries for specific version ranges or create complete changelogs
+  # including all version entries. The class integrates with AI models to
+  # produce human-readable changelog content by processing Git logs through
+  # configured prompts and models.
+  #
+  # @example Generating a changelog entry for a version range
+  #   generator = GemHadar::ChangelogGenerator.new
+  #   entry = generator.generate('v1.0.0', 'v1.2.0')
+  #
+  # @example Generating a complete changelog
+  #   generator = GemHadar::ChangelogGenerator.new
+  #   generator.generate_full(STDOUT)
+  #
+  # @example Adding changelog entries to an existing file
+  #   GemHadar::ChangelogGenerator.add_to_file('CHANGELOG.md')
+  class ChangelogGenerator
+    include GemHadar::Utils
+    include GemHadar::PromptTemplate
+
+    def initialize(gem_hadar)
+      @gem_hadar = gem_hadar
+    end
+
+    # The generate method creates a changelog entry by analyzing Git history
+    # and AI processing.
+    #
+    # This method retrieves the Git log for a specified range of commits,
+    # processes the log through an AI model using configured prompts, and
+    # formats the result into a markdown changelog entry with a date header.
+    #
+    # @param from [ String ] the starting version or commit reference for the
+    #   Git log range
+    # @param to [ String ] the ending version or commit reference for the Git
+    #   log range, defaults to 'HEAD'
+    #
+    # @return [ String ] a formatted markdown changelog entry including date
+    #   and AI-generated content
+    # @return [ String ] a minimal changelog entry with just date and version
+    #   when no changes are found
+    def generate(from, to = 'HEAD')
+      from_spec = GemHadar::VersionSpec[from]
+      to_spec   = GemHadar::VersionSpec[to]
+
+      range = "#{from_spec.tag}..#{to_spec.tag}"
+
+      log = `git log #{range}`
+      $?.success? or raise "Failed to get git log for range #{range}"
+
+      date = `git log -n1 --pretty='format:%cd' --date=short #{to_spec.tag.inspect}`.chomp
+
+      if log.strip.empty?
+        return "\n## #{date} #{to_spec.without_prefix.to_s}\n"
+      end
+
+      system          = xdg_config('gem_hadar', 'changelog_system_prompt.txt', default_changelog_system_prompt)
+      prompt_template = xdg_config('gem_hadar', 'changelog_prompt.txt', default_changelog_prompt)
+      prompt = prompt_template % { log_diff: log }
+
+      response = ollama_generate(system:, prompt:)
+
+      changes = response.gsub(/\t/, '  ')
+
+      return "\n## #{date} #{to_spec.tag}\n\n#{changes}\n"
+    end
+
+    # The generate_range method creates a changelog for a specific version
+    # range by processing Git log differences and AI-generated content
+    #
+    # This method retrieves version tags within a specified range, filters them
+    # based on the provided version boundaries, generates changelog entries
+    # for each version in the range, and writes the complete changelog to the
+    # provided output stream
+    #
+    # @param output [ IO ] the output stream to which the changelog will be
+    #   written
+    # @param from [ String ] the starting version or commit reference for the
+    #   range
+    # @param to [ String ] the ending version or commit reference for the
+    #   range, defaults to 'HEAD'
+    def generate_range(output, from, to)
+      from_spec = GemHadar::VersionSpec[from]
+      to_spec   = GemHadar::VersionSpec[to]
+
+      versions = read_versions
+
+      unless versions.any?
+        raise "No version tags found in repository"
+      end
+
+      versions = versions.select do |v|
+        v.version >= from_spec.version && v.version <= to_spec.version
+      end
+
+      changelog = generate_changelog(versions)
+
+      output << changelog.join("")
+    end
+
+    # The generate_full method creates a complete changelog by processing all
+    # version tags in the repository and generating entries for each
+    # consecutive pair of versions
+    #
+    # This method retrieves all semantic version tags from the Git repository,
+    # sorts them, and generates changelog entries for each pair of consecutive
+    # versions. It also adds an initial entry for the first version with a
+    # "Start" marker
+    #
+    # @param output [ IO ] the output stream to which the complete changelog
+    #   will be written
+    #
+    # @return [ String ] a complete changelog including all version entries and
+    #   a header
+    #
+    # @raise [ RuntimeError ] if no version tags are found in the repository
+    def generate_full(output)
+      versions = read_versions
+
+      unless versions.any?
+        raise "No version tags found in repository"
+      end
+
+      first_version = versions.first
+      date          = `git log -n1 --pretty='format:%cd' --date=short #{first_version.tag.to_s}`.chomp
+      changelog     = ["\n## #{date} #{first_version.tag.to_s}\n\n* Start\n"]
+
+      changelog = generate_changelog(versions, changelog:)
+
+      changelog << "# Changes\n"
+
+      output << changelog.join("")
+    end
+
+    # The add_to_file method appends new changelog entries to an existing
+    # changelog file
+    #
+    # This method identifies the highest version already present in the
+    # changelog file, retrieves all subsequent version tags from the Git
+    # repository, and generates changelog entries for each consecutive pair of
+    # versions. It then inserts these entries into the file after the existing
+    # content, maintaining the chronological order of changes.
+    #
+    # @param filename [ String ] the path to the changelog file to which
+    #   entries will be added
+    def add_to_file(filename)
+      highest_version = find_highest_version_spec(filename)
+
+      if highest_version
+        versions = read_versions
+        versions = versions.drop_while { |t| t.version < highest_version.version }
+      else
+        raise ArgumentError, "Could not find highest version in #{filename.inspect}"
+      end
+
+      return if versions.size < 2
+
+      changelog = generate_changelog(versions)
+      return if changelog.empty?
+      inject_into_filename(filename, changelog)
+    end
+
+    private
+
+    # The ollama_generate method delegates AI generation requests to the
+    # associated GemHadar instance.
+    #
+    # This method acts as a proxy that forwards the provided options to the
+    # ollama_generate method of the parent GemHadar object, enabling AI-powered
+    # text generation using configured Ollama models.
+    #
+    # @param opts [ Hash ] the options to pass to the AI generation method
+    #
+    # @return [ String, nil ] the generated response from the AI model or nil
+    #   if generation fails
+    def ollama_generate(**opts)
+      @gem_hadar.ollama_generate(**opts)
+    end
+
+    # The read_versions method retrieves and processes semantic version tags
+    # from the Git repository.
+    #
+    # This method fetches all Git tags from the repository, filters them to
+    # include only those that match semantic versioning patterns (containing
+    # three numeric components separated by dots), removes any 'v' prefix from
+    # the tags, and sorts the resulting version specifications
+    # in ascending order according to semantic versioning rules.
+    #
+    # @return [ Array<GemHadar::VersionSpec> ] an array of VersionSpec objects
+    #   representing the semantic versions found in the repository, sorted in
+    #   ascending order
+    def read_versions
+      tags = `git tag`.lines.grep(/^v?\d+\.\d+\.\d+$/).map(&:chomp)
+
+      versions = tags.map { |tag| GemHadar::VersionSpec[tag] }
+      versions = versions.sort_by(&:version)
+    end
+
+    # The generate_changelog method creates a series of changelog entries by
+    # processing consecutive version pairs.
+    #
+    # This method takes an array of version specifications, iterates through
+    # them in pairs, and generates AI-powered changelog entries for each range.
+    # It uses the ollama_generate method to produce content for each version
+    # interval and collects the results in reverse order.
+    #
+    # @param versions [ Array<GemHadar::VersionSpec> ] an array of version
+    #   specifications to process
+    #
+    # @return [ Array<String> ] an array of changelog entry strings in reverse
+    #   chronological order
+    def generate_changelog(versions, changelog: [])
+      versions = versions.each_cons(2).
+        with_infobar(total: versions.size - 1, label: 'Change')
+      versions.each do |range_from, range_to|
+        changelog << generate(range_from, range_to)
+        +infobar
+      end
+      changelog.reverse
+    end
+
+    # The inject_into_filename method inserts changelog entries into a
+    # specified file.
+    #
+    # This method reads an existing file line by line and identifies the
+    # location of a "# Changes" header. When this header is found, it inserts
+    # the provided changelog entries immediately after the header
+    # and before the next empty line.
+    #
+    # @param filename [ String ] the path to the file into which changelog
+    #   entries will be injected
+    # @param changelog [ Array<String> ] an array of changelog entry strings to
+    #   be inserted into the file
+    #
+    # @see GemHadar::ChangelogGenerator#add_to_file
+    def inject_into_filename(filename, changelog)
+      File.open(filename) do |input|
+        File.secure_write(filename) do |output|
+          start_add = nil
+          input.each do |line|
+            if start_add.nil? && line =~ /^# Changes$/
+              start_add = true
+              output.puts line
+              next
+            end
+            if start_add && line =~ /^$/
+              changelog.each do |entry|
+                output.puts entry
+              end
+              output.puts line
+              start_add = false
+              next
+            end
+            output.puts line
+          end
+        end
+      end
+    end
+
+    # The find_highest_version_spec method extracts version specifications from
+    # a changelog file and returns the highest version found
+    #
+    # This method reads through the specified file line by line, scanning for
+    # lines that match the pattern of a changelog entry header with a version
+    # number, and collects all found version specifications. It then determines
+    # and returns the version specification with
+    # the highest version number
+    #
+    # @param filename [ String ] the path to the changelog file to process
+    #
+    # @return [ GemHadar::VersionSpec, nil ] the highest version specification
+    #   found in the file, or nil if no versions are found
+    def find_highest_version_spec(filename)
+      File.open(filename, ?r) do |input|
+        specs = []
+        input.each do |line|
+          line.scan(/^## \d{4}-\d{2}-\d{2} v(\d+\.\d+\.\d+)$/) do
+            specs << GemHadar::VersionSpec[$1]
+          end
+        end
+        specs.max_by(&:version)
+      end
+    end
+  end
+end

data/lib/gem_hadar/github.rb

@@ -6,8 +6,6 @@ require 'json'
 # This module contains the ReleaseCreator class which handles the creation of
 # GitHub releases through the GitHub Releases API. It manages authentication,
 # request construction, and response processing for release operations.
-#
-# @see GemHadar::GitHub::ReleaseCreator
 module GemHadar::GitHub
 end
 
@@ -74,6 +72,7 @@ class GemHadar::GitHub::ReleaseCreator
   #   details about the created release
   #
   # @raise [ RuntimeError ] if the GitHub API request fails with a non-success status code
+  # @raise [ JSON::ParserError ] if the API response cannot be parsed as JSON
   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")
 

data/lib/gem_hadar/ollama_support.rb

@@ -0,0 +1,72 @@
+require 'ollama'
+
+# A module that provides Ollama AI integration support for GemHadar.
+#
+# This module includes methods for initializing an Ollama client, retrieving
+# the configured AI model name, and fetching model options for AI generation.
+# It also provides a method to generate responses
+# from Ollama AI models using the configured settings.
+module GemHadar::OllamaSupport
+  # The ollama method initializes and returns an Ollama client instance.
+  #
+  # This method constructs an Ollama client by first determining the base URL
+  # from the OLLAMA_URL environment variable, falling back to the OLLAMA_HOST
+  # environment variable with a default value of 'localhost:11434'. It then
+  # creates a client configuration hash including read and connect timeouts
+  # before instantiating and returning a new Ollama::Client object.
+  #
+  # @return [ Ollama::Client ] a configured Ollama client instance ready for use
+  def ollama
+    base_url      = ENV['OLLAMA_URL'] || "http://%s" % ENV.fetch('OLLAMA_HOST', 'localhost:11434')
+    client_config = {
+      base_url:        base_url,
+      read_timeout:    600,
+      connect_timeout: 60
+    }
+    Ollama::Client.new(**client_config)
+  end
+  memoize method: :ollama
+
+  # The ollama_model method retrieves the name of the Ollama AI model to be
+  # used for generating responses.
+  #
+  # It first checks the OLLAMA_MODEL environment variable for a custom model
+  # specification. If the environment variable is not set, it falls back to
+  # using the default model name, which is determined by the
+  # ollama_model_default dsl method.
+  #
+  # @return [ String ] the name of the Ollama AI model to be used
+  def ollama_model
+    ENV.fetch('OLLAMA_MODEL', ollama_model_default)
+  end
+
+  alias model ollama_model
+
+  # The options method retrieves and configures the Ollama model options for AI
+  # generation.
+  #
+  # This method fetches the JSON configuration for the Ollama model from the
+  # OLLAMA_MODEL_OPTIONS environment variable, or uses an empty JSON object if
+  # the variable is not set. It then merges default values for temperature,
+  # top_p, and min_p parameters to ensure consistent AI response
+  # characteristics.
+  #
+  # @return [ Hash ] a hash containing the merged Ollama model options
+  #   including default values for temperature, top_p, and min_p
+  def options
+    options = JSON(ENV.fetch('OLLAMA_MODEL_OPTIONS', '{}'))
+    options.merge!("temperature" => 0, "top_p" => 1, "min_p" => 0.1)
+  end
+  memoize method: :options
+
+  # Generates a response from an AI model using the Ollama::Client.
+  #
+  # @param [String] system The system prompt for the AI model.
+  # @param [String] prompt The user prompt to generate a response to.
+  # @return [String, nil] The generated response or nil if generation fails.
+  def ollama_generate(system:, prompt:)
+    ollama.generate(
+      model:, system:, prompt:, options:, stream: false, think: false
+    ).response
+  end
+end

data/lib/gem_hadar/prompt_template.rb

@@ -96,4 +96,50 @@ module GemHadar::PromptTemplate
       'build'.
     EOT
   end
+
+  # The default_changelog_system_prompt method returns the system prompt used
+  # for generating changelog entries.
+  #
+  # This prompt instructs the AI model to act as a Ruby programmer who creates
+  # markdown-formatted changelog entries for new releases. The generated
+  # content helps users understand what has changed in the software while
+  # maintaining a professional tone and format.
+  #
+  # @return [ String ] the system prompt for changelog generation
+  def default_changelog_system_prompt
+    <<~EOT
+      You are a Ruby programmer generating a change log entry in markdown syntax,
+      summarizing the code changes for a new version in a professional way.
+    EOT
+  end
+
+  # The default_changelog_prompt method returns the prompt template used for
+  # generating changelog entries.
+  #
+  # This prompt instructs the AI model to create a structured changelog entry
+  # based on Git commit history. It provides detailed guidelines for formatting
+  # the output, including how to summarize changes, mark code elements with
+  # appropriate markdown syntax, and exclude trivial updates like version bumps
+  # while focusing on significant functional changes.
+  def default_changelog_prompt
+    <<~EOT
+      Generate a changelog entry for the following Git commit history:
+
+      %{log_diff}
+
+    - Summarize the changes in the following git log messages as bullet points.
+    - Don't mention the version of the change set
+    - Skip bullet points about version bumps.
+    - List significant changes as bullet points using markdown when applicable.
+    - Mark all names and values for variables, methods, functions, and
+      constants, you see in the messages  as markdown code surrounded by
+      backtick characters.
+    - Mark all version numbers you see in the messages as markdown bold
+     surrounded by two asterisk characters.
+    - Don't refer to single commits by sha1 hash.
+    - Don't add information about changes you are not sure about.
+    - Don't output any additional chatty remarks, notes, introductions,
+      communications, etc.
+    EOT
+  end
 end

data/lib/gem_hadar/rvm_config.rb

@@ -37,7 +37,6 @@ class GemHadar
     # an argument, it sets the Ruby version to be used.
     #
     # @return [ String ] the Ruby version string configured for RVM use
-    # @see GemHadar::RvmConfig
     dsl_accessor :use do `rvm tools strings`.split(/\n/).full?(:last) || 'ruby' end
 
     # The gemset method retrieves or sets the RVM gemset name for the project.
@@ -49,8 +48,6 @@ class GemHadar
     # When called with an argument, it sets the gemset name to be used with RVM.
     #
     # @return [ String ] the RVM gemset name configured for the project
-    # @see GemHadar::RvmConfig#use
-    # @see GemHadar::RvmConfig
     dsl_accessor :gemset do @outer_scope.name end
   end
 end