yard-sketchup 1.1.4 → 1.1.5

data/lib/yard-sketchup/templates/default/layout/html/setup.rb

@@ -1,19 +1,19 @@
-# Consider if this should simply replace the Classes list.
-
-=begin
-TODO(thomthom): Temporarily disabled until we have time to fully implement this.
-def menu_lists
-  # Load the existing menus
-  super + [ { :type => 'object_types', :title => 'Object Reference', :search_title => 'Object Reference List' } ]
-end
-=end
-
-def javascripts
-  # Using the latest 1.x jQuery from CDN broke the YARD js. For now we must
-  # continue to use the version shipping with the YARD template we use as base.
-  %w(js/jquery.js js/app.js)
-end
-
-def stylesheets
-  %w(css/style.css css/sketchup.css css/rubyapi.css)
-end
+# Consider if this should simply replace the Classes list.
+
+=begin
+TODO(thomthom): Temporarily disabled until we have time to fully implement this.
+def menu_lists
+  # Load the existing menus
+  super + [ { :type => 'object_types', :title => 'Object Reference', :search_title => 'Object Reference List' } ]
+end
+=end
+
+def javascripts
+  # Using the latest 1.x jQuery from CDN broke the YARD js. For now we must
+  # continue to use the version shipping with the YARD template we use as base.
+  %w(js/jquery.js js/app.js)
+end
+
+def stylesheets
+  %w(css/style.css css/sketchup.css css/rubyapi.css)
+end

data/lib/yard-sketchup/templates/default/method_details/html/method_signature.erb

@@ -1,26 +1,26 @@
-<h3 class="signature <%= 'first' if @index == 0 %>" id="<%= anchor_for(object) %>">
-  <a style="float: right;" href="#header" title="Return to Top">&uarr;</a>
-  <% if object.tags(:overload).size == 1 %>
-    <%= signature(object.tag(:overload), false) %>
-  <% elsif object.tags(:overload).size > 1 %>
-    <% object.tags(:overload).each do |overload| %>
-      <span class="overload"><%= signature(overload, false) %></span>
-    <% end %>
-  <% else %>
-    <%= signature(object, false) %>
-  <% end %>
-
-  <% if object.aliases.size > 0 %>
-    <span class="aliases">Also known as:
-    <span class="names"><%= object.aliases.map {|o|
-      "<span id='#{anchor_for(o)}'>" + h(o.name.to_s) + "</span>" }.join(", ") %></span>
-    </span>
-  <% end %>
-
-  <% if owner != object.namespace %>
-    <span class="not_defined_here">
-      Originally defined in <%= object.namespace.type %>
-        <%= linkify object, owner.relative_path(object.namespace) %>
-    </span>
-  <% end %>
+<h3 class="signature <%= 'first' if @index == 0 %>" id="<%= anchor_for(object) %>">
+  <a style="float: right;" href="#header" title="Return to Top">&uarr;</a>
+  <% if object.tags(:overload).size == 1 %>
+    <%= signature(object.tag(:overload), false) %>
+  <% elsif object.tags(:overload).size > 1 %>
+    <% object.tags(:overload).each do |overload| %>
+      <span class="overload"><%= signature(overload, false) %></span>
+    <% end %>
+  <% else %>
+    <%= signature(object, false) %>
+  <% end %>
+
+  <% if object.aliases.size > 0 %>
+    <span class="aliases">Also known as:
+    <span class="names"><%= object.aliases.map {|o|
+      "<span id='#{anchor_for(o)}'>" + h(o.name.to_s) + "</span>" }.join(", ") %></span>
+    </span>
+  <% end %>
+
+  <% if owner != object.namespace %>
+    <span class="not_defined_here">
+      Originally defined in <%= object.namespace.type %>
+        <%= linkify object, owner.relative_path(object.namespace) %>
+    </span>
+  <% end %>
 </h3>

data/lib/yard-sketchup/templates/default/method_details/setup.rb

@@ -1,12 +1,12 @@
-# We don't want to expose our source code in the API docs.
-
-# https://groups.google.com/forum/#!topic/yardoc/-HH48h-aifs
-def source 
-  return 
-end
-
-# http://stackoverflow.com/a/10345917/486990
-#def init
-#  super
-#  sections.first.delete(:source)
+# We don't want to expose our source code in the API docs.
+
+# https://groups.google.com/forum/#!topic/yardoc/-HH48h-aifs
+def source 
+  return 
+end
+
+# http://stackoverflow.com/a/10345917/486990
+#def init
+#  super
+#  sections.first.delete(:source)
 #end

data/lib/yard-sketchup/templates/default/module/html/box_info.erb

@@ -1,37 +1,37 @@
-<div class="box_info">
-  <% if CodeObjects::ClassObject === object && object.superclass %>
-  <dl>
-    <dt>Inherits:</dt>
-    <dd>
-      <span class="inheritName"><%= linkify object.superclass %></span>
-      <% if object.superclass.name != :BasicObject %>
-        <ul class="fullTree">
-          <li><%= linkify P(:Object) %></li>
-          <% object.inheritance_tree.reverse.each_with_index do |obj, i| %>
-            <li class="next"><%= obj == object ? obj.path : linkify(obj) %></li>
-          <% end %>
-        </ul>
-        <a href="#" class="inheritanceTree">show all</a>
-      <% end %>
-    </dd>
-  </dl>
-  <% end %>
-
-  <% [[:class, "Extended by"], [:instance, "Includes"]].each do |scope, name| %>
-  <% if (mix = run_verifier(object.mixins(scope))).size > 0 %>
-  <dl>
-      <dt><%= name %>:</dt>
-      <dd><%= mix.sort_by {|o| o.path }.map {|o| linkify(o) }.join(", ") %></dd>
-  </dl>
-  <% end %>
-  <% end %>
-
-  <% if (mixed_into = mixed_into(object)).size > 0 %>
-  <dl>
-    <dt>Included in:</dt>
-    <dd><%= mixed_into.sort_by {|o| o.path }.map {|o| linkify(o) }.join(", ") %></dd>
-  </dl>
-  <% end %>
-
-</div>
-
+<div class="box_info">
+  <% if CodeObjects::ClassObject === object && object.superclass %>
+  <dl>
+    <dt>Inherits:</dt>
+    <dd>
+      <span class="inheritName"><%= linkify object.superclass %></span>
+      <% if object.superclass.name != :BasicObject %>
+        <ul class="fullTree">
+          <li><%= linkify P(:Object) %></li>
+          <% object.inheritance_tree.reverse.each_with_index do |obj, i| %>
+            <li class="next"><%= obj == object ? obj.path : linkify(obj) %></li>
+          <% end %>
+        </ul>
+        <a href="#" class="inheritanceTree">show all</a>
+      <% end %>
+    </dd>
+  </dl>
+  <% end %>
+
+  <% [[:class, "Extended by"], [:instance, "Includes"]].each do |scope, name| %>
+  <% if (mix = run_verifier(object.mixins(scope))).size > 0 %>
+  <dl>
+      <dt><%= name %>:</dt>
+      <dd><%= mix.sort_by {|o| o.path }.map {|o| linkify(o) }.join(", ") %></dd>
+  </dl>
+  <% end %>
+  <% end %>
+
+  <% if (mixed_into = mixed_into(object)).size > 0 %>
+  <dl>
+    <dt>Included in:</dt>
+    <dd><%= mixed_into.sort_by {|o| o.path }.map {|o| linkify(o) }.join(", ") %></dd>
+  </dl>
+  <% end %>
+
+</div>
+

data/lib/yard-sketchup/templates/default/module/html/constant_summary.erb

@@ -1,17 +1,17 @@
-<% if constant_listing.size > 0 || object.constants.size > 0 %>
-  <h2>
-    Constant Summary
-    <a
-        id="constant_summary"
-        href="#constant_summary"
-        title="Permalink">#</a>
-  </h2>
-  <% if constant_listing.size > 0 %>
-    <dl class="constants">
-      <% constant_listing.each do |cnst| %>
-        <dt id="<%= anchor_for(cnst) %>" class="<%= cnst.has_tag?(:deprecated) ? 'deprecated' : '' %>"><%= cnst.namespace.to_s.empty? ? '' : "#{cnst.namespace}::" %><%= cnst.name %>
-        </dt>
-      <% end %>
-    </dl>
-  <% end %>
-<% end %>
+<% if constant_listing.size > 0 || object.constants.size > 0 %>
+  <h2>
+    Constant Summary
+    <a
+        id="constant_summary"
+        href="#constant_summary"
+        title="Permalink">#</a>
+  </h2>
+  <% if constant_listing.size > 0 %>
+    <dl class="constants">
+      <% constant_listing.each do |cnst| %>
+        <dt id="<%= anchor_for(cnst) %>" class="<%= cnst.has_tag?(:deprecated) ? 'deprecated' : '' %>"><%= cnst.namespace.to_s.empty? ? '' : "#{cnst.namespace}::" %><%= cnst.name %>
+        </dt>
+      <% end %>
+    </dl>
+  <% end %>
+<% end %>

data/lib/yard-sketchup/templates/default/module/html/method_summary.erb

@@ -1,18 +1,18 @@
-<% if method_listing.size > 0 %>
-  <% groups(method_listing) do |list, name| %>
-    <h2>
-      <%= name %>
-      <a
-          id="<%= name.gsub(' ', '_').downcase %>"
-          href="#<%= name.gsub(' ', '_').downcase %>"
-          title="Permalink">#</a>
-      <small><a href="#" class="summary_toggle">collapse</a></small>
-    </h2>
-
-    <ul class="summary">
-      <% list.each do |meth| %>
-        <%= yieldall :item => meth %>
-      <% end %>
-    </ul>
-  <% end %>
-<% end %>
+<% if method_listing.size > 0 %>
+  <% groups(method_listing) do |list, name| %>
+    <h2>
+      <%= name %>
+      <a
+          id="<%= name.gsub(' ', '_').downcase %>"
+          href="#<%= name.gsub(' ', '_').downcase %>"
+          title="Permalink">#</a>
+      <small><a href="#" class="summary_toggle">collapse</a></small>
+    </h2>
+
+    <ul class="summary">
+      <% list.each do |meth| %>
+        <%= yieldall :item => meth %>
+      <% end %>
+    </ul>
+  <% end %>
+<% end %>

data/lib/yard-sketchup/templates/stubs/fulldoc/text/setup.rb

@@ -1,357 +1,361 @@
-require 'fileutils'
-require 'pathname'
-require 'set'
-require 'stringio'
-
-include Helpers::ModuleHelper
-
-def init
-  generate_stubs
-end
-
-
-# NOTE: Remember to run objects outputted through `run_verifier` first in order
-# to filter out items that should be excluded by command line arguments.
-
-def namespace_objects
-  run_verifier(Registry.all(:class, :module))
-end
-
-def generate_stubs
-  puts "Generating stubs..."
-  generate_module_stubs(Registry.root)
-  namespace_objects.each do |object|
-    generate_module_stubs(object)
-  end
-  generate_autoloader(namespace_objects)
-end
-
-def generate_autoloader(namespace_objects)
-  generator = SketchUpYARD::Stubs::AutoLoadGenerator.new
-  autoload_file = File.join(stubs_gem_path, 'sketchup.rb')
-  File.open(autoload_file, 'w') do |file|
-    generator.generate(namespace_objects, file)
-  end
-end
-
-def print_section(io, title, content)
-  return if content.strip.empty?
-  io.puts
-  io.puts "  # #{title}"
-  io.puts
-  io.puts content
-end
-
-def generate_module_stubs(object)
-  filename = stub_filename(object)
-  ensure_exist(File.dirname(filename))
-  StubFile.open(filename, 'w') { |file|
-    file.puts file_header(object)
-    file.puts
-    file.puts namespace_definition(object)
-    print_section(file, 'Extends', generate_mixins(object, :class))
-    print_section(file, 'Includes', generate_mixins(object, :instance))
-    print_section(file, 'Constants', generate_constants_grouped(object))
-    print_section(file, 'Class Methods', generate_class_methods(object))
-    print_section(file, 'Instance Methods', generate_instance_methods(object))
-    file.puts
-    file.puts file_footer(object)
-  }
-  #trim_trailing_white_space(filename)
-end
-
-def file_header(object)
-  header = StringIO.new
-  header.puts "# Copyright:: Copyright #{Time.now.year} Trimble Inc."
-  header.puts "# License:: The MIT License (MIT)"
-  #header.puts "# Generated:: #{Time.now.strftime('%F %R')}"
-  header.string
-end
-
-def file_footer(object)
-  return if object.root?
-  footer = StringIO.new
-  footer.puts 'end'
-  footer.string
-end
-
-def namespace_definition(object)
-  return if object.root?
-  definition = "#{object.type} #{object.path}"
-  if object.type == :class && object.superclass.name != :Object
-    definition << " < #{object.superclass.path}"
-  end
-  output = StringIO.new
-  output.puts generate_docstring(object)
-  output.puts definition
-  output.string
-end
-
-def output_path
-  options.serializer.options[:basepath] || File.join(Dir.pwd, 'stubs')
-end
-
-def stubs_root_path
-  ensure_exist(output_path)
-end
-
-def stubs_lib_path
-  ensure_exist(File.join(stubs_root_path, 'lib'))
-end
-
-def stubs_gem_path
-  ensure_exist(File.join(stubs_lib_path, 'sketchup-api-stubs'))
-end
-
-def stubs_path
-  ensure_exist(File.join(stubs_gem_path, 'stubs'))
-end
-
-def stub_filename(object)
-  basename = object.path.gsub('::', '/')
-  basename = '_top_level' if basename.empty?
-  File.join(stubs_path, "#{basename}.rb")
-end
-
-# A stable sort_by method.
-#
-# @param [Enumerable]
-# @return [Array]
-def stable_sort_by(list)
-  list.each_with_index.sort_by { |item, i| [yield(item), i] }.map(&:first)
-end
-
-CAMELCASE_CONSTANT = /^([A-Z]+[a-z]+)/
-
-def group_constant(constant)
-  constant_name = constant.name.to_s
-  MANUAL_CONSTANT_GROUPS.each { |rule|
-    if rule[:constants]
-      return rule[:group] if rule[:constants].include?(constant_name)
-    else
-      return rule[:group] if rule[:regex].match(constant_name)
-    end
-  }
-  if constant_name.include?('_')
-    constant_name.split('_').first
-  else
-    constant_name[CAMELCASE_CONSTANT] || constant_name
-  end
-end
-
-# Sorts and groups constants for easier reading.
-def generate_constants_grouped(object)
-  constants = run_verifier(object.constants(object_options))
-  # The constants are not sorted before chunking. This is because `chunk` groups
-  # consecutive items - and we want to chunk them based their relationship
-  # with each other. This ensure that constants that doesn't follow the normal
-  # pattern of PREFIX_SOME_NAME will still be grouped next to each other.
-  groups = constants.chunk { |constant|
-    group_constant(constant)
-  }
-  grouped_output = groups.map { |group, group_constants|
-    output = StringIO.new
-    # Each group itself is sorted in order to more easily scan the list.
-    sorted = stable_sort_by(group_constants, &:name)
-    sorted.each { |constant|
-      output.puts "  #{constant.name} = nil # Stub value."
-    }
-    output.string
-  }
-  # Finally each group is also sorted, again to ease scanning for a particular
-  # name. We simply use the first character of each group.
-  stable_sort_by(grouped_output) { |item| item.lstrip[0] }.join("\n")
-end
-
-# Sort constants without grouping.
-def generate_constants(object)
-  output = StringIO.new
-  constants = run_verifier(object.constants(object_options))
-  constants = stable_sort_by(constants, &:name) 
-  constants.each { |constant|
-    output.puts "  #{constant.name} = nil # Stub value."
-  }
-  output.string
-end
-
-def generate_mixins(object, scope)
-  output = StringIO.new
-  mixin_type = (scope == :class) ? 'extend' : 'include'
-  mixins = run_verifier(object.mixins(scope))
-  mixins = stable_sort_by(mixins, &:path)
-  mixins.each { |mixin|
-    output.puts "  #{mixin_type} #{mixin.path}"
-  }
-  output.string
-end
-
-def generate_class_methods(object)
-  generate_methods(object, :class, 'self.')
-end
-
-def generate_instance_methods(object)
-  generate_methods(object, :instance)
-end
-
-def generate_methods(object, scope, prefix = '')
-  methods = sort_methods(object, scope)
-  signatures = methods.map { |method|
-    output = StringIO.new
-    # Cannot use `methods.signature` here as it would return the C/C++ function
-    # signature. Must generate one from the YARD data.
-    signature = generate_method_signature(method)
-    # NOTE: We must call `generate_docstring` after `generate_method_signature`
-    # because `generate_method_signature` will also clean up docstrings with
-    # a single @overload tag.
-    output.puts generate_docstring(method, 1)
-    output.puts "  def #{prefix}#{signature}"
-    output.puts "  end"
-    output.string
-  }
-  signatures.join("\n")
-end
-
-# NOTE: This may modify the docstring of the object.
-def generate_method_signature(object)
-  signature = "#{object.name}"
-  # If there is a single overload then use that as the parameter list. Many of
-  # the SketchUp Ruby API methods will have this as it was safer to add an
-  # @overload tag instead of renaming the function argument names.
-  overloads = object.docstring.tags(:overload)
-  if overloads.size == 1
-    overload = overloads.first
-    parameters = overload.parameters
-    # Move the tags from the @overload tag to the root of the docstring. No need
-    # for a single overload tag - it's unexpected when reading the source.
-    object.docstring.add_tag(*overload.tags)
-    object.docstring.delete_tags(:overload)
-  else
-    parameters = object.parameters
-  end
-  # Compile the signature for the arguments and default values.
-  params = parameters.map { |param|
-    param.last.nil? ? param.first : param.join(' = ')
-  }.join(', ')
-  signature << "(#{params})" unless params.empty?
-  signature
-end
-
-def generate_docstring(object, indent_step = 0)
-  output = StringIO.new
-  indent = '  ' * indent_step
-  docstring = object.docstring
-  docstring.delete_tags(:par) # Remove obsolete @par tags.
-  docstring.to_raw.lines.each { |line|
-    # Naive check for tags with no indent - if it is we insert an extra line
-    # in order to get some space for easier reader. Doing it this way in order
-    # to avoid hacking YARD too much.
-    output.puts "#{indent}#" if line.start_with?('@')
-    # This is the original docstring line.
-    output.puts "#{indent}# #{line}"
-  }
-  output.string
-end
-
-def sort_methods(object, scope)
-  methods = run_verifier(object.meths(object_options))
-  objects = methods.select { |method|
-    method.scope == scope
-  }
-  stable_sort_by(objects, &:name)
-end
-
-def object_options
-  {
-    :inherited => false,
-    :included => false
-  }
-end
-
-
-def ensure_exist(path)
-  unless File.directory?(path)
-    FileUtils.mkdir_p(path)
-  end
-  path
-end
-
-
-class StubFile < File
-
-  def puts(*args)
-    case args.size
-    when 0
-      super
-    when 1
-      super trim_trailing_white_space(args[0].to_s)
-    else
-      raise NotImplementedError
-    end
-  end
-
-  private
-
-  TRAILING_WHITE_SPACE = /([\t ]+)$/
-  def trim_trailing_white_space(string)
-    string.gsub(TRAILING_WHITE_SPACE, '')
-  end
-
-end
-
-
-MANUAL_CONSTANT_GROUPS = [
-  # UI.messagebox return values.
-  {
-    constants: %w{IDABORT IDCANCEL IDIGNORE IDNO IDOK IDRETRY IDYES},
-    group: 'ID_MESSAGEBOX'
-  },
-  # Axes
-  {
-    constants: %w{X_AXIS Y_AXIS Z_AXIS},
-    group: 'AXES'
-  },
-  # Axes 2D
-  {
-    constants: %w{X_AXIS_2D Y_AXIS_2D},
-    group: 'AXES2D'
-  },
-  # Transformation
-  {
-    constants: %w{IDENTITY IDENTITY_2D},
-    group: 'IDENTITY'
-  },
-  # Geom::PolygonMesh
-  {
-    constants: %w{
-      AUTO_SOFTEN HIDE_BASED_ON_INDEX NO_SMOOTH_OR_HIDE SMOOTH_SOFT_EDGES
-      SOFTEN_BASED_ON_INDEX},
-    group: 'SOFTEN'
-  },
-  # Sketchup::Importer
-  # The other constants start with Import, this was odd one out.
-  {
-    constants: %w{ImporterNotFound},
-    group: 'Import'
-  },
-  # Sketchup::Http
-  {
-    constants: %w{DELETE GET HEAD OPTIONS PATCH POST PUT},
-    group: 'HTTP'
-  },
-  # Sketchup::Licensing
-  {
-    constants: %w{EXPIRED LICENSED NOT_LICENSED TRIAL TRIAL_EXPIRED},
-    group: 'EX_LICENSE'
-  },
-  # Sketchup::Model
-  {
-    constants: %w{Make MakeTrial ProLicensed ProTrial},
-    group: 'SU_LICENSE'
-  },
-  # Sketchup::RenderingOptions
-  # Most ROP constants start with ROPSet, with a handful of exceptions.
-  {
-    regex: /^ROP/,
-    group: 'ROP'
-  },
-]
+require 'fileutils'
+require 'pathname'
+require 'set'
+require 'stringio'
+
+include Helpers::ModuleHelper
+
+def init
+  generate_stubs
+end
+
+
+# NOTE: Remember to run objects outputted through `run_verifier` first in order
+# to filter out items that should be excluded by command line arguments.
+
+def namespace_objects
+  run_verifier(Registry.all(:class, :module))
+end
+
+def generate_stubs
+  puts "Generating stubs..."
+  generate_module_stubs(Registry.root)
+  namespace_objects.each do |object|
+    generate_module_stubs(object)
+  end
+  generate_autoloader(namespace_objects)
+end
+
+def generate_autoloader(namespace_objects)
+  generator = SketchUpYARD::Stubs::AutoLoadGenerator.new
+  autoload_file = File.join(stubs_gem_path, 'sketchup.rb')
+  File.open(autoload_file, 'w') do |file|
+    generator.generate(namespace_objects, file)
+  end
+end
+
+def print_section(io, title, content)
+  return if content.strip.empty?
+  io.puts
+  io.puts "  # #{title}"
+  io.puts
+  io.puts content
+end
+
+def generate_module_stubs(object)
+  filename = stub_filename(object)
+  ensure_exist(File.dirname(filename))
+  StubFile.open(filename, 'w') { |file|
+    file.puts file_header(object)
+    file.puts
+    file.puts namespace_definition(object)
+    print_section(file, 'Extends', generate_mixins(object, :class))
+    print_section(file, 'Includes', generate_mixins(object, :instance))
+    print_section(file, 'Constants', generate_constants_grouped(object))
+    print_section(file, 'Class Methods', generate_class_methods(object))
+    print_section(file, 'Instance Methods', generate_instance_methods(object))
+    file.puts
+    file.puts file_footer(object)
+  }
+  #trim_trailing_white_space(filename)
+end
+
+def file_header(object)
+  header = StringIO.new
+  header.puts "# Copyright:: Copyright #{Time.now.year} Trimble Inc."
+  header.puts "# License:: The MIT License (MIT)"
+  #header.puts "# Generated:: #{Time.now.strftime('%F %R')}"
+  header.string
+end
+
+def file_footer(object)
+  return if object.root?
+  footer = StringIO.new
+  footer.puts 'end'
+  footer.string
+end
+
+def namespace_definition(object)
+  return if object.root?
+  definition = "#{object.type} #{object.path}"
+  if object.type == :class && object.superclass.name != :Object
+    definition << " < #{object.superclass.path}"
+  end
+  output = StringIO.new
+  output.puts generate_docstring(object)
+  output.puts definition
+  output.string
+end
+
+def output_path
+  options.serializer.options[:basepath] || File.join(Dir.pwd, 'stubs')
+end
+
+def stubs_root_path
+  ensure_exist(output_path)
+end
+
+def stubs_lib_path
+  ensure_exist(File.join(stubs_root_path, 'lib'))
+end
+
+def stubs_gem_path
+  ensure_exist(File.join(stubs_lib_path, 'sketchup-api-stubs'))
+end
+
+def stubs_path
+  ensure_exist(File.join(stubs_gem_path, 'stubs'))
+end
+
+def stub_filename(object)
+  basename = object.path.gsub('::', '/')
+  basename = '_top_level' if basename.empty?
+  File.join(stubs_path, "#{basename}.rb")
+end
+
+# A stable sort_by method.
+#
+# @param [Enumerable]
+# @return [Array]
+def stable_sort_by(list)
+  list.each_with_index.sort_by { |item, i| [yield(item), i] }.map(&:first)
+end
+
+CAMELCASE_CONSTANT = /^([A-Z]+[a-z]+)/
+
+def group_constant(constant)
+  constant_name = constant.name.to_s
+  MANUAL_CONSTANT_GROUPS.each { |rule|
+    if rule[:constants]
+      return rule[:group] if rule[:constants].include?(constant_name)
+    else
+      return rule[:group] if rule[:regex].match(constant_name)
+    end
+  }
+  if constant_name.include?('_')
+    constant_name.split('_').first
+  else
+    constant_name[CAMELCASE_CONSTANT] || constant_name
+  end
+end
+
+# Sorts and groups constants for easier reading.
+def generate_constants_grouped(object)
+  constants = run_verifier(object.constants(object_options))
+  # The constants are not sorted before chunking. This is because `chunk` groups
+  # consecutive items - and we want to chunk them based their relationship
+  # with each other. This ensure that constants that doesn't follow the normal
+  # pattern of PREFIX_SOME_NAME will still be grouped next to each other.
+  groups = constants.chunk { |constant|
+    group_constant(constant)
+  }
+  grouped_output = groups.map { |group, group_constants|
+    output = StringIO.new
+    # Each group itself is sorted in order to more easily scan the list.
+    sorted = stable_sort_by(group_constants, &:name)
+    sorted.each { |constant|
+      output.puts "  #{constant.name} = nil # Stub value."
+    }
+    output.string
+  }
+  # Finally each group is also sorted, again to ease scanning for a particular
+  # name. We simply use the first character of each group.
+  stable_sort_by(grouped_output) { |item| item.lstrip[0] }.join("\n")
+end
+
+# Sort constants without grouping.
+def generate_constants(object)
+  output = StringIO.new
+  constants = run_verifier(object.constants(object_options))
+  constants = stable_sort_by(constants, &:name)
+  constants.each { |constant|
+    output.puts "  #{constant.name} = nil # Stub value."
+  }
+  output.string
+end
+
+def generate_mixins(object, scope)
+  output = StringIO.new
+  mixin_type = (scope == :class) ? 'extend' : 'include'
+  mixins = run_verifier(object.mixins(scope))
+  mixins = stable_sort_by(mixins, &:path)
+  mixins.each { |mixin|
+    output.puts "  #{mixin_type} #{mixin.path}"
+  }
+  output.string
+end
+
+def generate_class_methods(object)
+  generate_methods(object, :class, 'self.')
+end
+
+def generate_instance_methods(object)
+  generate_methods(object, :instance)
+end
+
+def generate_methods(object, scope, prefix = '')
+  methods = sort_methods(object, scope)
+  signatures = methods.map { |method|
+    output = StringIO.new
+    # Cannot use `methods.signature` here as it would return the C/C++ function
+    # signature. Must generate one from the YARD data.
+    signature = generate_method_signature(method)
+    # NOTE: We must call `generate_docstring` after `generate_method_signature`
+    # because `generate_method_signature` will also clean up docstrings with
+    # a single @overload tag.
+    output.puts generate_docstring(method, 1)
+    output.puts "  def #{prefix}#{signature}"
+    output.puts "  end"
+    # Include aliases.
+    method.aliases.each { |method_alias|
+      output.puts "  alias_method :#{method_alias.name}, :#{method.name}"
+    }
+    output.string
+  }
+  signatures.join("\n")
+end
+
+# NOTE: This may modify the docstring of the object.
+def generate_method_signature(object)
+  signature = "#{object.name}"
+  # If there is a single overload then use that as the parameter list. Many of
+  # the SketchUp Ruby API methods will have this as it was safer to add an
+  # @overload tag instead of renaming the function argument names.
+  overloads = object.docstring.tags(:overload)
+  if overloads.size == 1
+    overload = overloads.first
+    parameters = overload.parameters
+    # Move the tags from the @overload tag to the root of the docstring. No need
+    # for a single overload tag - it's unexpected when reading the source.
+    object.docstring.add_tag(*overload.tags)
+    object.docstring.delete_tags(:overload)
+  else
+    parameters = object.parameters
+  end
+  # Compile the signature for the arguments and default values.
+  params = parameters.map { |param|
+    param.last.nil? ? param.first : param.join(' = ')
+  }.join(', ')
+  signature << "(#{params})" unless params.empty?
+  signature
+end
+
+def generate_docstring(object, indent_step = 0)
+  output = StringIO.new
+  indent = '  ' * indent_step
+  docstring = object.docstring
+  docstring.delete_tags(:par) # Remove obsolete @par tags.
+  docstring.to_raw.lines.each { |line|
+    # Naive check for tags with no indent - if it is we insert an extra line
+    # in order to get some space for easier reader. Doing it this way in order
+    # to avoid hacking YARD too much.
+    output.puts "#{indent}#" if line.start_with?('@')
+    # This is the original docstring line.
+    output.puts "#{indent}# #{line}"
+  }
+  output.string
+end
+
+def sort_methods(object, scope)
+  methods = run_verifier(object.meths(object_options))
+  objects = methods.select { |method|
+    !method.is_alias? && method.scope == scope
+  }
+  stable_sort_by(objects, &:name)
+end
+
+def object_options
+  {
+    :inherited => false,
+    :included => false
+  }
+end
+
+
+def ensure_exist(path)
+  unless File.directory?(path)
+    FileUtils.mkdir_p(path)
+  end
+  path
+end
+
+
+class StubFile < File
+
+  def puts(*args)
+    case args.size
+    when 0
+      super
+    when 1
+      super trim_trailing_white_space(args[0].to_s)
+    else
+      raise NotImplementedError
+    end
+  end
+
+  private
+
+  TRAILING_WHITE_SPACE = /([\t ]+)$/
+  def trim_trailing_white_space(string)
+    string.gsub(TRAILING_WHITE_SPACE, '')
+  end
+
+end
+
+
+MANUAL_CONSTANT_GROUPS = [
+  # UI.messagebox return values.
+  {
+    constants: %w{IDABORT IDCANCEL IDIGNORE IDNO IDOK IDRETRY IDYES},
+    group: 'ID_MESSAGEBOX'
+  },
+  # Axes
+  {
+    constants: %w{X_AXIS Y_AXIS Z_AXIS},
+    group: 'AXES'
+  },
+  # Axes 2D
+  {
+    constants: %w{X_AXIS_2D Y_AXIS_2D},
+    group: 'AXES2D'
+  },
+  # Transformation
+  {
+    constants: %w{IDENTITY IDENTITY_2D},
+    group: 'IDENTITY'
+  },
+  # Geom::PolygonMesh
+  {
+    constants: %w{
+      AUTO_SOFTEN HIDE_BASED_ON_INDEX NO_SMOOTH_OR_HIDE SMOOTH_SOFT_EDGES
+      SOFTEN_BASED_ON_INDEX},
+    group: 'SOFTEN'
+  },
+  # Sketchup::Importer
+  # The other constants start with Import, this was odd one out.
+  {
+    constants: %w{ImporterNotFound},
+    group: 'Import'
+  },
+  # Sketchup::Http
+  {
+    constants: %w{DELETE GET HEAD OPTIONS PATCH POST PUT},
+    group: 'HTTP'
+  },
+  # Sketchup::Licensing
+  {
+    constants: %w{EXPIRED LICENSED NOT_LICENSED TRIAL TRIAL_EXPIRED},
+    group: 'EX_LICENSE'
+  },
+  # Sketchup::Model
+  {
+    constants: %w{Make MakeTrial ProLicensed ProTrial},
+    group: 'SU_LICENSE'
+  },
+  # Sketchup::RenderingOptions
+  # Most ROP constants start with ROPSet, with a handful of exceptions.
+  {
+    regex: /^ROP/,
+    group: 'ROP'
+  },
+]