class Webgen::Task

Namespace for all tasks.

About ↑

Tasks provide the main entrance point for doing things with a website, like creating it, generating it, and much more.

Implementing a task ↑

A task object only needs to respond to one method called call which takes the website as first parameter and may take an arbitrary number of additional arguments. The method should return true if the task was executed sucessfully or else false.

Due to this there are basically two ways to implement a task since: Either as a class with a class method called call. Or as a Proc object.

If the task needs to be configured to work correctly, use additional parameters or configuration options.

The task has to be registered so that webgen knows about it, see register for more information.

Sample Task ↑

The following sample task just outputs the value of its configuration option:

class OutputTask

  def self.call(website, options)
    website.logger.vinfo("The output task configuration value follows")
    website.logger.info(website.config['task.output.option'])
    true
  end

end

website.config.define_option('task.output.option', nil, 'The configuration option')
website.ext.task.register OutputTask, :name => 'output'

Public Class Methods

new(website) click to toggle source

Create a new task manager for the given website.

Calls superclass method Webgen::ExtensionManager.new 
# File lib/webgen/task.rb, line 49
def initialize(website)
  super()
  @website = website
end

Public Instance Methods

data(name) click to toggle source

Return the task data for the given task.

# File lib/webgen/task.rb, line 92
def data(name)
  ext_data(name).data
end
execute(name, *options) click to toggle source

Execute the task identified by the given name.

# File lib/webgen/task.rb, line 87
def execute(name, *options)
  extension(name).call(@website, *options)
end
register(klass, options={}, &block) click to toggle source

Register a task.

The parameter klass can either be a String containing the name of a class/module (which has to respond to :call) or an object that responds to :call. If the class is located under this namespace, only the class name without the hierarchy part is needed, otherwise the full class/module name including parent module/class names is needed.

Instead of registering an object that responds to :call, you can also provide a block.

Options: ↑

:name

The name for the task. If not set, it defaults to the snake-case version of the class name (without the hierarchy part). It should only contain letters.

:data

Associates arbitrary data with the task object. This data can be retrieved using the data method.

Examples: ↑

task.register('CreateWebsite')     # registers Webgen::Task::CreateWebsite

task.register('::CreateWebsite')   # registers CreateWebsite !!!

task.register('doit') do |website|
  # task commands go here
end

# File lib/webgen/task.rb, line 81
def register(klass, options={}, &block)
  name = do_register(klass, options, true, &block)
  ext_data(name).data = options[:data]
end