Class: Halite::Gem

Inherits:
Object
  • Object
show all
Defined in:
lib/halite/gem.rb

Overview

A model for a gem/cookbook within Halite.

Examples:

g = Halite::Gem.new('chef-mycookbook', '1.1.0')
puts(g.cookbook_name) #=> mycookbook

Since:

  • 1.0.0

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(name, version = nil) ⇒ Gem

name can be either a string name, Gem::Dependency, or Gem::Specification

Parameters:

  • name (String, Gem::Dependency, Gem::Specification)

Since:

  • 1.0.0



46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
 
# File 'lib/halite/gem.rb', line 46

def initialize(name, version=nil)
  # Allow passing a Dependency by just grabbing its spec.
  name = dependency_to_spec(name) if name.is_a?(::Gem::Dependency)
  # Stubs don't load enough data for us, grab the real spec. RIP IOPS.
  name = name.to_spec if name.is_a?(::Gem::StubSpecification) || (defined?(Bundler::StubSpecification) && name.is_a?(Bundler::StubSpecification))
  if name.is_a?(::Gem::Specification)
    raise Error.new("Cannot pass version when using an explicit specficiation") if version
    @spec = name
    @name = spec.name
  else
    @name = name
    @version = version
    raise Error.new("Gem #{name}#{version ? " v#{version}" : ''} not found") unless spec
  end
end

Instance Attribute Details

#name ⇒ Object (readonly)

Since:

  • 1.0.0



42
43
44
 
# File 'lib/halite/gem.rb', line 42

def name
  @name
end

Instance Method Details

#as_cookbook_version ⇒ Chef::CookbookVersion

Create a Chef::CookbookVersion object that represents this gem. This can be injected in to Chef to simulate the cookbook being available.

Examples:

run_context.cookbook_collection[gem.cookbook_name] = gem.as_cookbook_version

Returns:

  • (Chef::CookbookVersion)

Since:

  • 1.0.0



174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
 
# File 'lib/halite/gem.rb', line 174

def as_cookbook_version
  # Put this in a local variable for a closure below.
  path = spec.full_gem_path
  Chef::CookbookVersion.new(cookbook_name, File.join(path, 'chef')).tap do |c|
    c.attribute_filenames = each_file('chef/attributes').map(&:first)
    c.file_filenames = each_file('chef/files').map(&:first)
    c.recipe_filenames = each_file('chef/recipes').map(&:first)
    c.template_filenames = each_file('chef/templates').map(&:first)
    # Haxx, rewire the filevendor for this cookbook to look up in our folder.
    # This is touching two different internal interfaces, but ¯\_(ツ)_/¯
    c.send(:file_vendor).define_singleton_method(:get_filename) do |filename|
      File.join(path, 'chef', filename)
    end
    # Store the true root for use in other tools.
    c.define_singleton_method(:halite_root) { path }
  end
end

#cookbook_dependencies ⇒ Object

Since:

  • 1.0.0



159
160
161
 
# File 'lib/halite/gem.rb', line 159

def cookbook_dependencies
  @cookbook_dependencies ||= Dependencies.extract(spec)
end

#cookbook_name ⇒ Object

Since:

  • 1.0.0



70
71
72
73
74
75
76
 
# File 'lib/halite/gem.rb', line 70

def cookbook_name
  if spec.metadata.include?('halite_name')
    spec.metadata['halite_name']
  else
    spec.name.gsub(/(^(chef|cookbook)[_-])|([_-](chef|cookbook))$/, '')
  end
end

#cookbook_version ⇒ String

Version of the gem sanitized for Chef. This means no non-numeric tags and only three numeric components.

Returns:

  • (String)

Since:

  • 1.0.0



82
83
84
85
86
87
88
 
# File 'lib/halite/gem.rb', line 82

def cookbook_version
  if match = version.match(/^(\d+\.\d+\.(\d+)?)/)
    match[1]
  else
    raise Halite::Error.new("Unable to parse #{version.inspect} as a Chef cookbook version")
  end
end

#each_file(prefix_paths = nil, &block) ⇒ Array<Array<String>>

Iterate over all the files in the gem, with an optional prefix. Each element in the iterable will be [full_path, relative_path], where relative_path is relative to the prefix or gem path.

Examples:

gem_data.each_file do |full_path, rel_path|
  # ...
end

Parameters:

  • prefix_paths (String, Array<String>, nil) (defaults to: nil) —

    Option prefix paths.

  • block (Proc) —

    Callable for iteration.

Returns:

  • (Array<Array<String>>)

Since:

  • 1.0.0



130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
 
# File 'lib/halite/gem.rb', line 130

def each_file(prefix_paths=nil, &block)
  globs = if prefix_paths
    Array(prefix_paths).map {|path| File.join(spec.full_gem_path, path) }
  else
    [spec.full_gem_path]
  end
  [].tap do |files|
    globs.each do |glob|
      Dir[File.join(glob, '**', '*')].each do |path|
        next unless File.file?(path)
        val = [path, path[glob.length+1..-1]]
        block.call(*val) if block
        files << val
      end
    end
    # Make sure the order is stable for my tests. Probably overkill, I think
    # Dir#[] sorts already.
    files.sort!
  end
end

#each_library_file(&block) ⇒ Array<Array<String>>

Special case of the #each_file the gem's require paths.

Parameters:

  • block (Proc) —

    Callable for iteration.

Returns:

  • (Array<Array<String>>)

Since:

  • 1.0.0



155
156
157
 
# File 'lib/halite/gem.rb', line 155

def each_library_file(&block)
  each_file(spec.require_paths, &block)
end

#find_misc_path(name) ⇒ String+

Search for a file like README.md or LICENSE.txt in the gem.

Examples:

gem.misc_file('Readme') => /path/to/readme.txt

Parameters:

  • name (String) —

    Basename to search for.

Returns:

  • (String, Array<String>)

Since:

  • 1.0.0



198
199
200
201
202
203
204
205
206
207
 
# File 'lib/halite/gem.rb', line 198

def find_misc_path(name)
  [name, name.upcase, name.downcase].each do |base|
    ['.md', '', '.txt', '.html'].each do |suffix|
      path = File.join(spec.full_gem_path, base+suffix)
      return path if File.exist?(path) && Dir.entries(File.dirname(path)).include?(File.basename(path))
    end
  end
  # Didn't find anything
  nil
end

#is_halite_cookbook? ⇒ Boolean

Is this gem really a cookbook? (anything that depends directly on halite and doesn't have the ignore flag)

Returns:

  • (Boolean)

Since:

  • 1.0.0



164
165
166
 
# File 'lib/halite/gem.rb', line 164

def is_halite_cookbook?
  spec.dependencies.any? {|subdep| subdep.name == 'halite'} && !spec.metadata.include?('halite_ignore')
end

#issues_url ⇒ String?

URL to the issue tracker for this project.

Returns:

  • (String, nil)

Since:

  • 1.0.0



111
112
113
114
115
116
117
 
# File 'lib/halite/gem.rb', line 111

def issues_url
  if spec.metadata['issues_url']
    spec.metadata['issues_url']
  elsif spec.homepage =~ /^http(s)?:\/\/(www\.)?github\.com/
    spec.homepage.chomp('/') + '/issues'
  end
end

#license_header ⇒ String

License header extacted from the gemspec. Suitable for inclusion in other Ruby source files.

Returns:

  • (String)

Since:

  • 1.0.0



104
105
106
 
# File 'lib/halite/gem.rb', line 104

def license_header
  IO.readlines(spec_file).take_while { |line| line.strip.empty? || line.strip.start_with?('#') }.join('')
end

#spec ⇒ Object

Since:

  • 1.0.0



62
63
64
 
# File 'lib/halite/gem.rb', line 62

def spec
  @spec ||= dependency_to_spec(::Gem::Dependency.new(@name, ::Gem::Requirement.new(@version)))
end

#spec_file ⇒ String

Path to the .gemspec for this gem. This is different from Gem::Specification#spec_file because the Rubygems API is shit and just assumes the file layout matches normal, which is not the case with Bundler and path or git sources.

Returns:

  • (String)

Since:

  • 1.0.0



96
97
98
 
# File 'lib/halite/gem.rb', line 96

def spec_file
  File.join(spec.full_gem_path, spec.name + '.gemspec')
end

#version ⇒ Object

Since:

  • 1.0.0



66
67
68
 
# File 'lib/halite/gem.rb', line 66

def version
  spec.version.to_s
end