Class: Wright::Resource::Package

Inherits:
Wright::Resource show all
Extended by:
Forwardable
Defined in:
lib/wright/resource/package.rb

Overview

Package resource, represents a package.

Examples:

vim = Wright::Resource::Package.new('vim')
vim.installed_versions
# => []
vim.install
vim.installed_versions
# => ["2:7.3.547-7"]

htop = Wright::Resource::Package.new('htop')
htop.installed_versions
# => ["1.0.1-1"]
htop.remove
htop.installed_versions
# => []

Instance Attribute Summary collapse

Attributes inherited from Wright::Resource

#action, #ignore_failure, #name, #resource_name

Instance Method Summary collapse

Methods inherited from Wright::Resource

#on_update=, #run_action

Constructor Details

#initialize(name) ⇒ Package

Initializes a Package.

Parameters:

  • name (String) —

    the package’s name



37
38
39
40
41
42
 
# File 'lib/wright/resource/package.rb', line 37

def initialize(name)
  super
  @version = nil
  @options = nil
  @action = :install
end

Instance Attribute Details

#options ⇒ String+

Returns the options passed to the package manager.

Returns:

  • (String, Array<String>) —

    the options passed to the package manager



32
33
34
 
# File 'lib/wright/resource/package.rb', line 32

def options
  @options
end

#version ⇒ String

Returns the package version to install or remove.

Returns:

  • (String) —

    the package version to install or remove



28
29
30
 
# File 'lib/wright/resource/package.rb', line 28

def version
  @version
end

Instance Method Details

#install ⇒ Bool

Installs the Package.

Returns:

  • (Bool) —

    true if the package was updated and false otherwise



56
57
58
59
60
 
# File 'lib/wright/resource/package.rb', line 56

def install
  might_update_resource do
    @provider.install
  end
end

#installed? ⇒ Bool

Returns true if the package is installed.

Returns:

  • (Bool) —

    true if the package is installed



50
 
# File 'lib/wright/resource/package.rb', line 50

def_delegator :@provider, :installed?

#installed_versions ⇒ Array<String>

Returns the installed package versions.

Returns:

  • (Array<String>) —

    the installed package versions



46
 
# File 'lib/wright/resource/package.rb', line 46

def_delegator :@provider, :installed_versions

#remove ⇒ Bool Also known as: uninstall

Removes the Package.

Returns:

  • (Bool) —

    true if the package was updated and false otherwise



66
67
68
69
70
 
# File 'lib/wright/resource/package.rb', line 66

def remove
  might_update_resource do
    @provider.remove
  end
end