Class: Vagrant::Plugin::StateFile
- Inherits:
-
Object
- Object
- Vagrant::Plugin::StateFile
- Defined in:
- lib/vagrant/plugin/state_file.rb
Overview
This is a helper to deal with the plugin state file that Vagrant uses to track what plugins are installed and activated and such.
Instance Attribute Summary collapse
-
#path ⇒ Pathname
readonly
Path to file.
Instance Method Summary collapse
-
#add_plugin(name, **opts) ⇒ Object
Add a plugin that is installed to the state file.
-
#add_source(url) ⇒ Object
Adds a RubyGems index source to look up gems.
-
#has_plugin?(name) ⇒ Boolean
Returns true/false if the plugin is present in this state file.
-
#initialize(path) ⇒ StateFile
constructor
A new instance of StateFile.
-
#installed_plugins ⇒ Hash
This returns a hash of installed plugins according to the state file.
-
#remove_plugin(name) ⇒ Object
Remove a plugin that is installed from the state file.
-
#remove_source(url) ⇒ Object
Remove a source for RubyGems.
-
#save! ⇒ Object
This saves the state back into the state file.
-
#sources ⇒ Array<String>
Returns the list of RubyGems sources that will be searched for plugins.
Constructor Details
#initialize(path) ⇒ StateFile
Returns a new instance of StateFile.
14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 |
# File 'lib/vagrant/plugin/state_file.rb', line 14 def initialize(path) @path = path @data = {} if @path.exist? begin @data = JSON.parse(@path.read) rescue JSON::ParserError => e raise Vagrant::Errors::PluginStateFileParseError, path: path, message: e. end upgrade_v0! if !@data["version"] end @data["version"] ||= "1" @data["installed"] ||= {} end |
Instance Attribute Details
#path ⇒ Pathname (readonly)
Returns path to file.
12 13 14 |
# File 'lib/vagrant/plugin/state_file.rb', line 12 def path @path end |
Instance Method Details
#add_plugin(name, **opts) ⇒ Object
Add a plugin that is installed to the state file.
36 37 38 39 40 41 42 43 44 45 46 47 48 |
# File 'lib/vagrant/plugin/state_file.rb', line 36 def add_plugin(name, **opts) @data["installed"][name] = { "ruby_version" => RUBY_VERSION, "vagrant_version" => Vagrant::VERSION, "gem_version" => opts[:version] || "", "require" => opts[:require] || "", "sources" => opts[:sources] || [], "installed_gem_version" => opts[:installed_gem_version], "env_local" => !!opts[:env_local] } save! end |
#add_source(url) ⇒ Object
Adds a RubyGems index source to look up gems.
53 54 55 56 57 |
# File 'lib/vagrant/plugin/state_file.rb', line 53 def add_source(url) @data["sources"] ||= [] @data["sources"] << url if !@data["sources"].include?(url) save! end |
#has_plugin?(name) ⇒ Boolean
Returns true/false if the plugin is present in this state file.
71 72 73 |
# File 'lib/vagrant/plugin/state_file.rb', line 71 def has_plugin?(name) @data["installed"].key?(name) end |
#installed_plugins ⇒ Hash
This returns a hash of installed plugins according to the state file. Note that this may not directly match over to actually installed gems.
64 65 66 |
# File 'lib/vagrant/plugin/state_file.rb', line 64 def installed_plugins @data["installed"] end |
#remove_plugin(name) ⇒ Object
Remove a plugin that is installed from the state file.
78 79 80 81 |
# File 'lib/vagrant/plugin/state_file.rb', line 78 def remove_plugin(name) @data["installed"].delete(name) save! end |
#remove_source(url) ⇒ Object
Remove a source for RubyGems.
86 87 88 89 90 |
# File 'lib/vagrant/plugin/state_file.rb', line 86 def remove_source(url) @data["sources"] ||= [] @data["sources"].delete(url) save! end |
#save! ⇒ Object
This saves the state back into the state file.
101 102 103 104 105 106 107 108 109 110 |
# File 'lib/vagrant/plugin/state_file.rb', line 101 def save! Tempfile.open(@path.basename.to_s, @path.dirname.to_s) do |f| f.binmode f.write(JSON.dump(@data)) f.fsync f.chmod(0644) f.close FileUtils.mv(f.path, @path) end end |
#sources ⇒ Array<String>
Returns the list of RubyGems sources that will be searched for plugins.
96 97 98 |
# File 'lib/vagrant/plugin/state_file.rb', line 96 def sources @data["sources"] || [] end |