?HAMA

Navigation

Breadcrumbs

/ / proc / thread-self / root / opt / alt / ruby21 / lib64 / ruby / 2.1.0 / rdoc

Create

Create File | Create Folder | Upload Files | Run Command

Edit File Size: 5.17 KB

/proc/thread-self/root/opt/alt/ruby21/lib64/ruby/2.1.0/rdoc/rubygems_hook.rb

Text Base64

require 'rubygems'
require 'rubygems/user_interaction'
require 'fileutils'
require 'rdoc'

##
# Gem::RDoc provides methods to generate RDoc and ri data for installed gems
# upon gem installation.
#
# This file is automatically required by RubyGems 1.9 and newer.

class RDoc::RubygemsHook

include Gem::UserInteraction
  extend  Gem::UserInteraction

@rdoc_version = nil
  @specs = []

##
  # Force installation of documentation?

attr_accessor :force

##
  # Generate rdoc?

attr_accessor :generate_rdoc

##
  # Generate ri data?

attr_accessor :generate_ri

class << self

##
    # Loaded version of RDoc.  Set by ::load_rdoc

attr_reader :rdoc_version

end

##
  # Post installs hook that generates documentation for each specification in
  # +specs+

def self.generation_hook installer, specs
    start = Time.now
    types = installer.document

generate_rdoc = types.include? 'rdoc'
    generate_ri   = types.include? 'ri'

specs.each do |spec|
      new(spec, generate_rdoc, generate_ri).generate
    end

return unless generate_rdoc or generate_ri

duration = (Time.now - start).to_i
    names    = specs.map(&:name).join ', '

say "Done installing documentation for #{names} after #{duration} seconds"
  end

##
  # Loads the RDoc generator

def self.load_rdoc
    return if @rdoc_version

require 'rdoc/rdoc'

@rdoc_version = Gem::Version.new ::RDoc::VERSION
  end

##
  # Creates a new documentation generator for +spec+.  RDoc and ri data
  # generation can be enabled or disabled through +generate_rdoc+ and
  # +generate_ri+ respectively.
  #
  # Only +generate_ri+ is enabled by default.

def initialize spec, generate_rdoc = false, generate_ri = true
    @doc_dir   = spec.doc_dir
    @force     = false
    @rdoc      = nil
    @spec      = spec

@generate_rdoc = generate_rdoc
    @generate_ri   = generate_ri

@rdoc_dir = spec.doc_dir 'rdoc'
    @ri_dir   = spec.doc_dir 'ri'
  end

##
  # Removes legacy rdoc arguments from +args+
  #--
  # TODO move to RDoc::Options

def delete_legacy_args args
    args.delete '--inline-source'
    args.delete '--promiscuous'
    args.delete '-p'
    args.delete '--one-file'
  end

##
  # Generates documentation using the named +generator+ ("darkfish" or "ri")
  # and following the given +options+.
  #
  # Documentation will be generated into +destination+

def document generator, options, destination
    generator_name = generator

options = options.dup
    options.exclude ||= [] # TODO maybe move to RDoc::Options#finish
    options.setup_generator generator
    options.op_dir = destination
    options.finish

generator = options.generator.new @rdoc.store, options

@rdoc.options = options
    @rdoc.generator = generator

say "Installing #{generator_name} documentation for #{@spec.full_name}"

FileUtils.mkdir_p options.op_dir

Dir.chdir options.op_dir do
      begin
        @rdoc.class.current = @rdoc
        @rdoc.generator.generate
      ensure
        @rdoc.class.current = nil
      end
    end
  end

##
  # Generates RDoc and ri data

def generate
    return if @spec.default_gem?
    return unless @generate_ri or @generate_rdoc

setup

options = nil

args = @spec.rdoc_options
    args.concat @spec.require_paths
    args.concat @spec.extra_rdoc_files

case config_args = Gem.configuration[:rdoc]
    when String then
      args = args.concat config_args.split
    when Array then
      args = args.concat config_args
    end

delete_legacy_args args

Dir.chdir @spec.full_gem_path do
      options = ::RDoc::Options.new
      options.default_title = "#{@spec.full_name} Documentation"
      options.parse args
    end

options.quiet = !Gem.configuration.really_verbose

@rdoc = new_rdoc
    @rdoc.options = options

store = RDoc::Store.new
    store.encoding = options.encoding if options.respond_to? :encoding
    store.dry_run  = options.dry_run
    store.main     = options.main_page
    store.title    = options.title

@rdoc.store = store

say "Parsing documentation for #{@spec.full_name}"

Dir.chdir @spec.full_gem_path do
      @rdoc.parse_files options.files
    end

document 'ri',       options, @ri_dir if
      @generate_ri   and (@force or not File.exist? @ri_dir)

document 'darkfish', options, @rdoc_dir if
      @generate_rdoc and (@force or not File.exist? @rdoc_dir)
  end

##
  # #new_rdoc creates a new RDoc instance.  This method is provided only to
  # make testing easier.

def new_rdoc # :nodoc:
    ::RDoc::RDoc.new
  end

##
  # Is rdoc documentation installed?

def rdoc_installed?
    File.exist? @rdoc_dir
  end

##
  # Removes generated RDoc and ri data

def remove
    base_dir = @spec.base_dir

raise Gem::FilePermissionError, base_dir unless File.writable? base_dir

FileUtils.rm_rf @rdoc_dir
    FileUtils.rm_rf @ri_dir
  end

##
  # Is ri data installed?

def ri_installed?
    File.exist? @ri_dir
  end

##
  # Prepares the spec for documentation generation

def setup
    self.class.load_rdoc

raise Gem::FilePermissionError, @doc_dir if
      File.exist?(@doc_dir) and not File.writable?(@doc_dir)

FileUtils.mkdir_p @doc_dir unless File.exist? @doc_dir
  end

end

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Directory Contents

Dirs: 8 × Files: 45

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
context DIR	-	drwxr-xr-x	2024-03-03 22:43:10	Edit Download recursive recursive
generator DIR	-	drwxr-xr-x	2024-03-03 22:43:10	Edit Download recursive recursive
markdown DIR	-	drwxr-xr-x	2024-03-03 22:43:10	Edit Download recursive recursive
markup DIR	-	drwxr-xr-x	2024-03-03 22:43:10	Edit Download recursive recursive
parser DIR	-	drwxr-xr-x	2024-03-03 22:43:10	Edit Download recursive recursive
rd DIR	-	drwxr-xr-x	2024-03-03 22:43:10	Edit Download recursive recursive
ri DIR	-	drwxr-xr-x	2024-03-03 22:43:10	Edit Download recursive recursive
stats DIR	-	drwxr-xr-x	2024-03-03 22:43:10	Edit Download recursive recursive
alias.rb	2.09 KB	lrw-r--r--	2012-11-27 04:28:14	Edit Download recursive recursive
anon_class.rb	142 B	lrw-r--r--	2012-11-27 04:28:14	Edit Download recursive recursive
any_method.rb	6.82 KB	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
attr.rb	3.73 KB	lrw-r--r--	2013-01-23 01:02:24	Edit Download recursive recursive
class_module.rb	19.73 KB	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
code_object.rb	9.38 KB	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
code_objects.rb	121 B	lrw-r--r--	2012-11-27 04:28:14	Edit Download recursive recursive
comment.rb	5.29 KB	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
constant.rb	3.55 KB	lrw-r--r--	2013-12-03 03:18:52	Edit Download recursive recursive
context.rb	28.76 KB	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
cross_reference.rb	5.82 KB	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
encoding.rb	2.74 KB	lrw-r--r--	2012-12-18 08:24:57	Edit Download recursive recursive
erbio.rb	794 B	lrw-r--r--	2011-05-15 11:55:52	Edit Download recursive recursive
erb_partial.rb	370 B	lrw-r--r--	2012-11-27 04:28:14	Edit Download recursive recursive
extend.rb	140 B	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
generator.rb	1.72 KB	lrw-r--r--	2012-11-27 04:28:14	Edit Download recursive recursive
ghost_method.rb	114 B	lrw-r--r--	2012-11-27 04:28:14	Edit Download recursive recursive
include.rb	142 B	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
known_classes.rb	2.63 KB	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
markdown.rb	370.01 KB	lrw-r--r--	2013-09-19 07:22:13	Edit Download recursive recursive
markup.rb	28.22 KB	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
meta_method.rb	99 B	lrw-r--r--	2012-11-27 04:28:14	Edit Download recursive recursive
method_attr.rb	8.78 KB	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
mixin.rb	2.72 KB	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
normal_class.rb	2.10 KB	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
normal_module.rb	1.40 KB	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
options.rb	29.70 KB	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
parser.rb	8.06 KB	lrw-r--r--	2013-12-03 00:42:49	Edit Download recursive recursive
rd.rb	3.54 KB	lrw-r--r--	2012-11-27 04:28:14	Edit Download recursive recursive
rdoc.rb	13.40 KB	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
require.rb	935 B	lrw-r--r--	2012-11-27 04:28:14	Edit Download recursive recursive
ri.rb	315 B	lrw-r--r--	2012-11-27 04:28:14	Edit Download recursive recursive
rubygems_hook.rb	5.17 KB	lrw-r--r--	2013-11-18 20:55:18	Edit Download recursive recursive
ruby_lex.rb	27.71 KB	lrw-r--r--	2013-11-19 00:47:33	Edit Download recursive recursive
ruby_token.rb	11.28 KB	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
servlet.rb	11.84 KB	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
single_class.rb	330 B	lrw-r--r--	2012-11-27 04:28:14	Edit Download recursive recursive
stats.rb	10.37 KB	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
store.rb	22.37 KB	lrw-r--r--	2013-11-19 00:51:06	Edit Download recursive recursive
task.rb	7.66 KB	lrw-r--r--	2012-11-27 04:28:14	Edit Download recursive recursive
test_case.rb	4.14 KB	lrw-r--r--	2013-11-22 02:06:23	Edit Download recursive recursive
text.rb	7.60 KB	lrw-r--r--	2015-02-17 15:18:40	Edit Download recursive recursive
token_stream.rb	2.46 KB	lrw-r--r--	2012-11-27 04:28:14	Edit Download recursive recursive
tom_doc.rb	6.26 KB	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive
top_level.rb	5.41 KB	lrw-r--r--	2013-09-18 23:33:36	Edit Download recursive recursive