123456789_123456789_123456789_123456789_123456789_

Class: Bundler::Plugin::Index

Relationships & Source Files
Namespace Children
Exceptions:
CommandConflict, SourceConflict
Inherits: Object
Defined in: lib/bundler/plugin/index.rb

Class Method Summary

Instance Attribute Summary

Instance Method Summary

Constructor Details

.new ⇒ Index

[ GitHub ] 

  


# File 'lib/bundler/plugin/index.rb', line 25



def initialize
  @plugin_paths = {}
  @commands = {}
  @sources = {}
  @hooks = {}
  @load_paths = {}

  begin
    load_index(global_index_file, true)
  rescue GenericSystemCallError
    # no need to fail when on a read-only FS, for example
    nil
  end
  load_index(local_index_file) if SharedHelpers.in_bundle?
end


  







Instance Attribute Details



  

    #commands   (readonly)
  

  [ GitHub ]


  

  


# File 'lib/bundler/plugin/index.rb', line 23



attr_reader :commands


  







Instance Method Details



  

    #command_plugin(command)  
  



  

    

Fetch the name of plugin handling the command


  



  [ GitHub ]


  

  


# File 'lib/bundler/plugin/index.rb', line 95



def command_plugin(command)
  @commands[command]
end


  








  

    #global_index_file  
  



  

    

Path where the global index file is stored


  



  [ GitHub ]


  

  


# File 'lib/bundler/plugin/index.rb', line 77



def global_index_file
  Plugin.global_root.join("index")
end


  








  

    #hook_plugins(event)  
  



  

    

Returns the list of plugin names handling the passed event


  



  [ GitHub ]


  

  


# File 'lib/bundler/plugin/index.rb', line 112



def hook_plugins(event)
  @hooks[event] || []
end


  








  

    #index_file  
  



  

    

Path of default index file


  



  [ GitHub ]


  

  


# File 'lib/bundler/plugin/index.rb', line 72



def index_file
  Plugin.root.join("index")
end


  








  

    #installed?(name)  ⇒ Boolean 
  



  

    
  





  


  [ GitHub ]


  

  


# File 'lib/bundler/plugin/index.rb', line 99



def installed?(name)
  @plugin_paths[name]
end


  








  

    #load_index(index_file, global = false)   (private)
  



  

    

Reads the index file from the directory and initializes the instance variables.



It skips the sources if the second param is true


  





  
Parameters:


    
  
  • 
    index
    (Pathname)
—    
    

    file path
    

    
  
    • 
  
  • 
    is
    (Boolean)
—    
    

    the index file global index
    

    
  
    • 





  [ GitHub ]


  

  


# File 'lib/bundler/plugin/index.rb', line 124



def load_index(index_file, global = false)
  SharedHelpers.filesystem_access(index_file, :read) do |index_f|
    valid_file = index_f && index_f.exist? && !index_f.size.zero?
    break unless valid_file

    data = index_f.read

    require "bundler/yaml_serializer"
    index = YAMLSerializer.load(data)

    @commands.merge!(index["commands"])
    @hooks.merge!(index["hooks"])
    @load_paths.merge!(index["load_paths"])
    @plugin_paths.merge!(index["plugin_paths"])
    @sources.merge!(index["sources"]) unless global
  end
end


  








  

    #load_paths(name)  
  

  [ GitHub ]


  

  


# File 'lib/bundler/plugin/index.rb', line 90



def load_paths(name)
  @load_paths[name]
end


  








  

    #local_index_file  
  



  

    

Path where the local index file is stored


  



  [ GitHub ]


  

  


# File 'lib/bundler/plugin/index.rb', line 82



def local_index_file
  Plugin.local_root.join("index")
end


  








  

    #plugin_path(name)  
  

  [ GitHub ]


  

  


# File 'lib/bundler/plugin/index.rb', line 86



def plugin_path(name)
  Pathname.new @plugin_paths[name]
end


  








  

    #register_plugin(name, path, load_paths, commands, sources, hooks)  
  



  

    

This function is to be called when a new plugin is installed. This function shall add the functions of the plugin to existing maps and also the name to source location.


  





  
Parameters:


    
  
  • 
    name
    (String)
—    
    

    of the plugin to be registered
    

    
  
    • 
  
  • 
    path
    (String)
—    
    

    where the plugin is installed
    

    
  
    • 
  
  • 
    load_paths
    (Array<String>)
—    
    

    for the plugin
    

    
  
    • 
  
  • 
    commands
    (Array<String>)
—    
    

    that are handled by the plugin
    

    
  
    • 
  
  • 
    sources
    (Array<String>)
—    
    

    that are handled by the plugin
    

    
  
    • 





  [ GitHub ]


  

  


# File 'lib/bundler/plugin/index.rb', line 50



def register_plugin(name, path, load_paths, commands, sources, hooks)
  old_commands = @commands.dup

  common = commands & @commands.keys
  raise CommandConflict.new(name, common) unless common.empty?
  commands.each {|c| @commands[c] = name }

  common = sources & @sources.keys
  raise SourceConflict.new(name, common) unless common.empty?
  sources.each {|k| @sources[k] = name }

  hooks.each {|e| (@hooks[e] ||= []) << name }

  @plugin_paths[name] = path
  @load_paths[name] = load_paths
  save_index
rescue StandardError
  @commands = old_commands
  raise
end


  








  

    #save_index   (private)
  



  

    

Should be called when any of the instance variables change. Stores the instance variables in YAML format. (The instance variables are supposed to be only String key value pairs)


  



  [ GitHub ]


  

  


# File 'lib/bundler/plugin/index.rb', line 145



def save_index
  index = {
    "commands"     => @commands,
    "hooks"        => @hooks,
    "load_paths"   => @load_paths,
    "plugin_paths" => @plugin_paths,
    "sources"      => @sources,
  }

  require "bundler/yaml_serializer"
  SharedHelpers.filesystem_access(index_file) do |index_f|
    FileUtils.mkdir_p(index_f.dirname)
    File.open(index_f, "w") {|f| f.puts YAMLSerializer.dump(index) }
  end
end


  








  

    #source?(source)  ⇒ Boolean 
  



  

    
  





  


  [ GitHub ]


  

  


# File 'lib/bundler/plugin/index.rb', line 103



def source?(source)
  @sources.key? source
end


  








  

    #source_plugin(name)  
  

  [ GitHub ]


  

  


# File 'lib/bundler/plugin/index.rb', line 107



def source_plugin(name)
  @sources[name]
end