Class: Sprinkle::Installers::Source

Inherits:
Installer show all
Defined in:
lib/sprinkle/installers/source.rb

Overview

Source Package Installer

The source package installer installs software from source. It handles downloading, extracting, configuring, building, and installing software.

Configuration Options

The source installer has many configuration options:

  • prefix - The prefix directory that is configured to.

  • archives - The location all the files are downloaded to.

  • builds - The directory the package is extracted to to configure and install

Pre/Post Hooks

The source installer defines a myriad of new stages which can be hooked into:

  • prepare - Prepare is the stage which all the prefix, archives, and build directories are made.

  • download - Download is the stage which the software package is downloaded.

  • extract - Extract is the stage which the software package is extracted.

  • configure - Configure is the stage which the ./configure script is run.

  • build - Build is the stage in which ‘make` is called.

  • install - Install is the stage which ‘make install` is called.

Example Usage

First, a simple package, no configuration:

package :magic_beans do
  source 'http://magicbeansland.com/latest-1.1.1.tar.gz'
end

Second, specifying exactly where I want my files:

package :magic_beans do
  source 'http://magicbeansland.com/latest-1.1.1.tar.gz' do
    prefix    '/usr/local'
    archives  '/tmp'
    builds    '/tmp/builds'
  end
end

Third, specifying some hooks:

package :magic_beans do
  source 'http://magicbeansland.com/latest-1.1.1.tar.gz' do
    prefix    '/usr/local'

    pre :prepare { 'echo "Here we go folks."' }
    post :extract { 'echo "I believe..."' }
    pre :build { 'echo "Cross your fingers!"' }
  end
end

As you can see, setting options is as simple as creating a block and calling the option as a method with the value as its parameter.

Instance Attribute Summary collapse

Attributes inherited from Installer

#delivery, #options, #package, #post, #pre

Attributes included from Configurable

#delivery

Instance Method Summary collapse

Methods inherited from Installer

#process

Methods included from Configurable

#assert_delivery, #defaults, #method_missing

Constructor Details

#initialize(parent, source, options = {}, &block) ⇒ Source

:nodoc:



62
63
64
65
 
# File 'lib/sprinkle/installers/source.rb', line 62

def initialize(parent, source, options = {}, &block) #:nodoc:
  @source = source
  super parent, options, &block
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class Sprinkle::Configurable

Instance Attribute Details

#source ⇒ Object

:nodoc:



60
61
62
 
# File 'lib/sprinkle/installers/source.rb', line 60

def source
  @source
end