Class: Rails::API::Task

Inherits:
RDoc::Task
  • Object
show all
Defined in:
railties/lib/rails/api/task.rb

Direct Known Subclasses

RepoTask

Constant Summary collapse

RDOC_FILES =
{
  "activesupport" => {
    include: %w(
      README.rdoc
      lib/active_support.rb
      lib/active_support/**/*.rb
    )
  },

  "activerecord" => {
    include: %w(
      README.rdoc
      lib/active_record.rb
      lib/active_record/**/*.rb
      lib/arel.rb
    )
  },

  "activemodel" => {
    include: %w(
      README.rdoc
      lib/active_model.rb
      lib/active_model/**/*.rb
    )
  },

  "actionpack" => {
    include: %w(
      README.rdoc
      lib/abstract_controller/**/*.rb
      lib/action_controller.rb
      lib/action_controller/**/*.rb
      lib/action_dispatch.rb
      lib/action_dispatch/**/*.rb
    )
  },

  "actionview" => {
    include: %w(
      README.rdoc
      lib/action_view.rb
      lib/action_view/**/*.rb
    ),
    exclude: "lib/action_view/vendor/*"
  },

  "actionmailer" => {
    include: %w(
      README.rdoc
      lib/action_mailer.rb
      lib/action_mailer/**/*.rb
    )
  },

  "activejob" => {
    include: %w(
      README.md
      lib/active_job.rb
      lib/active_job/**/*.rb
    )
  },

  "actioncable" => {
    include: %w(
      README.md
      lib/action_cable.rb
      lib/action_cable/**/*.rb
    )
  },

  "activestorage" => {
    include: %w(
      README.md
      app/**/active_storage/**/*.rb
      lib/active_storage.rb
      lib/active_storage/**/*.rb
    )
  },

  "actionmailbox" => {
    include: %w(
      README.md
      app/**/action_mailbox/**/*.rb
      lib/action_mailbox.rb
      lib/action_mailbox/**/*.rb
    )
  },

  "actiontext" => {
    include: %w(
      README.md
      app/**/action_text/**/*.rb
      lib/action_text.rb
      lib/action_text/**/*.rb
    )
  },

  "railties" => {
    include: %w(
      README.rdoc
      lib/**/*.rb
    ),
    exclude: %w(
      lib/rails/generators/**/templates/**/*.rb
      lib/rails/test_unit/*
      lib/rails/api/generator.rb
    )
  }
}

Instance Method Summary collapse

Constructor Details

#initialize(name) ⇒ Task

Returns a new instance of Task.



119
120
121
122
123
124
125
126
127
128
129
130
# File 'railties/lib/rails/api/task.rb', line 119

def initialize(name)
  super

  # Every time rake runs this task is instantiated as all the rest.
  # Be lazy computing stuff to have as light impact as possible to
  # the rest of tasks.
  before_running_rdoc do
    configure_sdoc
    configure_rdoc_files
    setup_horo_variables
  end
end

Instance Method Details

#api_mainObject



185
186
187
# File 'railties/lib/rails/api/task.rb', line 185

def api_main
  component_root_dir("railties") + "/RDOC_MAIN.md"
end

#configure_rdoc_filesObject



148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
# File 'railties/lib/rails/api/task.rb', line 148

def configure_rdoc_files
  rdoc_files.include(api_main)

  RDOC_FILES.each do |component, cfg|
    cdr = component_root_dir(component)

    Array(cfg[:include]).each do |pattern|
      rdoc_files.include("#{cdr}/#{pattern}")
    end

    Array(cfg[:exclude]).each do |pattern|
      rdoc_files.exclude("#{cdr}/#{pattern}")
    end
  end

  # Only generate documentation for files that have been
  # changed since the API was generated.
  if Dir.exist?(api_dir) && !ENV["ALL"]
    last_generation = DateTime.rfc2822(File.open("#{api_dir}/created.rid", &:readline))

    rdoc_files.keep_if do |file|
      File.mtime(file).to_datetime > last_generation
    end

    # Nothing to do
    exit(0) if rdoc_files.empty?
  end
end

#configure_sdocObject



137
138
139
140
141
142
143
144
145
146
# File 'railties/lib/rails/api/task.rb', line 137

def configure_sdoc
  self.title    = "Ruby on Rails API"
  self.rdoc_dir = api_dir

  options << "-m"  << api_main
  options << "-e"  << "UTF-8"

  options << "-f"  << "api"
  options << "-T"  << "rails"
end

#desc(description) ⇒ Object

Hack, ignore the desc calls performed by the original initializer.



133
134
135
# File 'railties/lib/rails/api/task.rb', line 133

def desc(description)
  # no-op
end

#setup_horo_variablesObject

These variables are used by the sdoc template



178
179
180
181
182
183
# File 'railties/lib/rails/api/task.rb', line 178

def setup_horo_variables # :nodoc:
  ENV["HORO_PROJECT_NAME"]    = "Ruby on Rails"
  ENV["HORO_PROJECT_VERSION"] = rails_version
  ENV["HORO_BADGE_VERSION"]   = badge_version
  ENV["HORO_CANONICAL_URL"]   = canonical_url
end