Class: Compass::Installers::Base

Inherits:
Object
  • Object
show all
Includes:
Actions
Defined in:
lib/compass/installers/base.rb,
lib/compass/app_integration/rails/installer.rb,
lib/compass/app_integration/stand_alone/installer.rb

Direct Known Subclasses

BareInstaller, ManifestInstaller

Instance Attribute Summary collapse

Attributes included from Actions

#logger

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Actions

#basename, #compile, #copy, #directory, #process_erb, #relativize, #remove, #separate, #strip_trailing_separator, #write_file

Constructor Details

#initialize(template_path, target_path, options = {}) ⇒ Base

Returns a new instance of Base.



11
12
13
14
15
16
17
 
# File 'lib/compass/installers/base.rb', line 11

def initialize(template_path, target_path, options = {})
  @template_path = template_path
  @target_path = target_path
  @working_path = Dir.getwd
  @options = options
  self.logger = options[:logger]
end

Instance Attribute Details

#options ⇒ Object

Returns the value of attribute options.



9
10
11
 
# File 'lib/compass/installers/base.rb', line 9

def options
  @options
end

#target_path ⇒ Object

Returns the value of attribute target_path.



8
9
10
 
# File 'lib/compass/installers/base.rb', line 8

def target_path
  @target_path
end

#template_path ⇒ Object

Returns the value of attribute template_path.



8
9
10
 
# File 'lib/compass/installers/base.rb', line 8

def template_path
  @template_path
end

#working_path ⇒ Object

Returns the value of attribute working_path.



8
9
10
 
# File 'lib/compass/installers/base.rb', line 8

def working_path
  @working_path
end

Class Method Details

.installer(type, installer_opts = {}, &locator) ⇒ Object 



60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
 
# File 'lib/compass/installers/base.rb', line 60

def self.installer(type, installer_opts = {}, &locator)
  locator ||= lambda{|to| to}
  loc_method = "install_location_for_#{type}".to_sym
  define_method("simple_#{loc_method}", locator)
  define_method(loc_method) do |to, options|
    if options[:like] && options[:like] != type
      send("install_location_for_#{options[:like]}", to, options)
    else
      send("simple_#{loc_method}", to)
    end
  end
  define_method "install_#{type}" do |from, to, options|
    from = templatize(from)
    to = targetize(send(loc_method, to, options))
    copy from, to, nil, (installer_opts[:binary] || options[:binary])
  end
end

Instance Method Details

#compilation_required? ⇒ Boolean

Returns:

  • (Boolean) 


52
53
54
 
# File 'lib/compass/installers/base.rb', line 52

def compilation_required?
  false
end

#finalize(options = {}) ⇒ Object

The default finalize method – it is a no-op. This could print out a message or something.



49
50
 
# File 'lib/compass/installers/base.rb', line 49

def finalize(options = {})
end

#install ⇒ Object

The install method override this to install



43
44
45
 
# File 'lib/compass/installers/base.rb', line 43

def install
  raise "Not Yet Implemented"
end

#install_html(from, to, options) ⇒ Object 



107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
 
# File 'lib/compass/installers/base.rb', line 107

def install_html(from, to, options)
  if to =~ /\.haml$/
    require 'haml'
    to = to[0..-(".haml".length+1)]
    if respond_to?(:install_location_for_html)
      to = install_location_for_html(to, options)
    end
    contents = File.read(templatize(from))
    if options.delete(:erb)
      ctx = TemplateContext.ctx(:to => to, :options => options)
      contents = process_erb(contents, ctx)
    end
    Compass.configure_sass_plugin!
    html = Haml::Engine.new(contents, :filename => templatize(from)).render
    write_file(targetize(to), html, options)
  else
    install_html_without_haml(from, to, options)
  end
end

#install_html_without_haml ⇒ Object 



106
 
# File 'lib/compass/installers/base.rb', line 106

alias install_html_without_haml install_html

#pattern_name_as_dir ⇒ Object 



56
57
58
 
# File 'lib/compass/installers/base.rb', line 56

def pattern_name_as_dir
  "#{options[:pattern_name]}/" if options[:pattern_name]
end

#prepare ⇒ Object

The default prepare method – it is a no-op. Generally you would create required directories, etc.



39
40
 
# File 'lib/compass/installers/base.rb', line 39

def prepare
end

#run(options = {}) ⇒ Object

Runs the installer. Every installer must conform to the installation strategy of prepare, install, and then finalize. A default implementation is provided for each step.



31
32
33
34
35
 
# File 'lib/compass/installers/base.rb', line 31

def run(options = {})
  prepare
  install
  finalize(options) unless options[:skip_finalization]
end

#stylesheet_links ⇒ Object

Emits an HTML fragment that can be used to link to the compiled css files



140
141
142
 
# File 'lib/compass/installers/base.rb', line 140

def stylesheet_links
  ""
end

#targetize(path) ⇒ Object

returns an absolute path given a path relative to the current installation target. Paths can use unix style “/” and will be corrected for the current platform.



129
130
131
 
# File 'lib/compass/installers/base.rb', line 129

def targetize(path)
  strip_trailing_separator File.join(target_path, separate(path))
end

#templatize(path) ⇒ Object

returns an absolute path given a path relative to the current template. Paths can use unix style “/” and will be corrected for the current platform.



135
136
137
 
# File 'lib/compass/installers/base.rb', line 135

def templatize(path)
  strip_trailing_separator File.join(template_path, separate(path))
end