webget_gemini 1.2.3

data/lib/webget_gemini.rb

@@ -0,0 +1,156 @@
+# = Gemini: Gem Initialization Helper
+#
+# Simple gem methods.
+#
+# Example:
+#   require 'gemini'
+#
+#   Gemini.installed?(:name=>'passenger',:version=>'2.0.0')
+#   => true
+#
+#   Gemini.install(:name=>'passenger',:version=>'2.0.0')
+#   => install passenger 2.0.0 if necessary
+#
+#   Gemini.find(:name=>'passenger')
+#   => all gemspecs with name 'passenger'
+#
+#   Gemini.find(:name=>'passenger',:version=>version_requiremens)
+#   => all gemspecs with name 'passenger' that match the requirments
+#
+##
+
+require 'rexml/document'
+require 'rubygems'
+require 'webget_commander'
+
+class Gemini
+
+  TRUST_POLICY_NICKNAME={'no'=>'NoSecurity','low'=>'LowSecurity','medium'=>'MediumSecurity','high'=>'HighSecurity'}
+
+  # Return true iff a given name is installed
+  #
+  # Options
+  # - name e.g. "foo" [required]
+  # - version string e.g. ">=1.2.3"
+
+  def self.installed?(ops)
+    name,version = [:name,:version].map{|k| ops[k]||ops[k.to_s]}
+    dep = Gem::Dependency.new name, (version||Gem::Requirement.default)
+    !Gem.source_index.search(dep).empty?
+  end
+
+
+  # Return an array of all gemspecs that match the name and version requirements
+  # 
+  # Options:
+  # - name e.g. "foo" [required]
+  # - version: version requirements as defined in Gem.source_index.find_name
+
+  def self.find(ops)
+    name,version = [:name,:version].map{|k| ops[k]||ops[k.to_s]}
+    return Gem.source_index.find_name(name,version||[])
+  end
+
+
+  # Install a gem, if needed, by running a system command.
+  #
+  # This dispatches on the first parameter:
+  # - nil: install_from_rails_root_cofig_gems_xml
+  # - File: install_from_xml_file
+  # - String: install_from_xml_text
+  # - REXML::Document: install_from_xml_doc
+  # - Array: install_from_array
+  # - Hash: install_from_options
+  #
+  # Return status, stdout, stderr
+
+  def self.install(x=nil)
+    if x.class==NilClass         then return self.install_from_rails_root_config_gems_xml end
+    if x.class==File             then return self.install_from_file(x) end
+    if x.class==String           then return self.install_from_xml_text(x) end
+    if x.class==REXML::Document  then return self.install_from_xml_doc(x) end
+    if x.class==Array            then return self.install_from_array(x) end
+    return self.install_from_options(x)
+  end
+
+  def self.install_from_rails_root_config_gems_xml
+    return self.install_from_xml_file(File.new(RAILS_ROOT+'/config/gems.xml'))
+  end
+
+  def self.install_from_xml_file(file)
+    return self.install_from_xml_text(File.read(x))
+  end
+
+  def self.install_from_xml_text
+    return self.install_from_xml_doc(REXML::Document.new(x))
+  end
+
+  def self.install_from_xml_doc
+    return self.install_from_array(x.elements.each('gems/gem'){}.map{|e| e.attributes})
+  end
+
+  def self.install_from_array(array)
+    return x.map{|options| self.install(options)}
+  end
+
+
+  public
+
+  # Install a gem, if needed, by running a system command.
+  #
+  # Options
+  # - name e.g. "foo" [required]
+  # - version e.g. ">=1.2.3"
+  # - trust: no|low|medium|high (same as NoSecurity|LowSecurity|MediumSecurity|HighSecurity)
+  # - append: anything to append to the gem command e.g. " --no-ri --no-rdoc --no-user-install"
+  #
+
+  def self.install_from_options(options)
+    return installed?(options) \
+    ? [nil,nil,nil] \
+    : commander(self.install_command(options))
+  end
+
+
+  # Create the system command to do a gem install
+  #
+  # Options
+  # - name e.g. "foo" [required]
+  # - version e.g. ">=1.2.3"
+  # - trust: no|low|medium|high (aka NoSecurity|LowSecurity|MediumSecurity|HighSecurity)
+  # - append (aka installing): anything to append to the gem install command e.g. " --no-ri --no-rdoc --no-user-install"
+  #
+  # Return the command as a string
+
+  def self.install_command(ops)
+    name,version,trust,source,append,installing = [:name,:version,:trust,:source,:append,:installing].map{|k| ops[k]||ops[k.to_s]}
+    append||=installing
+    return "sudo gem install #{name}" +
+      (version ? " --version \"#{version}\"" : '' ) +
+      (trust ? " --trust-policy #{TRUST_POLICY_NICKNAME[trust]||trust}" : '') +
+      (source ? [*source].map{|x| " --source \"#{x}\""}.join : '') +
+      (append ? (' '+append) : '')
+  end
+
+
+
+  # Return a lookup hash of all the gems installed on the system,
+  # by running the system command 'sudo gem list'.
+  #
+  # - hash key is a gem name.
+  # - hash value is an array of the gem's installed version numbers.
+
+  def self.sudo_gem_list
+    @sudo_gem_list=`sudo gem list`.split(/\n/).map{|line| line.split(/[ \,\(\)]+/)}.inject({}){|h,v| h[v[0]]=v[1,v.length]; h}
+  end
+
+
+  # Return true iff the sudo_gem_list hash shows a given gem is installed.
+
+  def self.sudo_gem_list_installed?(ops)
+    name,version = [:name,:version].map{|k| ops[k]||ops[k.to_s]}
+    self.sudo_gem_list[name] and (!version or self.sudo_gem_list[name].include?(version))
+  end
+  
+end
+

data/test/webget_gemini/webget_gemini_test.rb

@@ -0,0 +1,23 @@
+require 'test/unit'
+require 'webget_gemini'
+
+class GeminiTest < Test::Unit::TestCase
+
+ def test_gemini_installed_false
+  assert(!Gemini.installed?(:name=>'gem-should-not-exist',:version=>'9.9.9'))
+ end
+
+ def test_gemini_install_command
+  assert_equal('sudo gem install foo',Gemini.install_command(:name=>'foo'))
+  assert_equal('sudo gem install foo --version "9.9.9"',Gemini.install_command(:name=>'foo',:version=>'9.9.9'))
+  assert_equal('sudo gem install foo --trust-policy HighSecurity',Gemini.install_command(:name=>'foo',:trust=>'high'))
+ end
+
+ def test_gemini_install
+  status,stdout,stderr=Gemini.install(:name=>'gem-should-not-exist',:version=>'9.9.9')
+  assert_equal(2,status)
+  assert_equal('',stdout)
+  assert_equal('ERROR:  could not find gem gem-should-not-exist locally or in a repository',stderr)
+ end
+
+end

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification 
+name: webget_gemini
+version: !ruby/object:Gem::Version 
+  version: 1.2.3
+platform: ruby
+authors: 
+- WebGet
+autorequire: 
+bindir: bin
+cert_chain: 
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIDvDCCAyWgAwIBAgIJAIlSqEkDQaZIMA0GCSqGSIb3DQEBBQUAMIGbMQswCQYD
+  VQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTEWMBQGA1UEBxMNU2FuIEZyYW5j
+  aXNjbzETMBEGA1UEChMKV2ViR2V0LmNvbTETMBEGA1UECxMKV2ViR2V0LmNvbTET
+  MBEGA1UEAxMKV2ViR2V0LmNvbTEgMB4GCSqGSIb3DQEJARYRd2ViZ2V0QHdlYmdl
+  dC5jb20wHhcNMDkwMjI2MTk0NDU4WhcNMTExMTIzMTk0NDU4WjCBmzELMAkGA1UE
+  BhMCVVMxEzARBgNVBAgTCkNhbGlmb3JuaWExFjAUBgNVBAcTDVNhbiBGcmFuY2lz
+  Y28xEzARBgNVBAoTCldlYkdldC5jb20xEzARBgNVBAsTCldlYkdldC5jb20xEzAR
+  BgNVBAMTCldlYkdldC5jb20xIDAeBgkqhkiG9w0BCQEWEXdlYmdldEB3ZWJnZXQu
+  Y29tMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDXCFYfW6hCQl0ToNjaMIXG
+  ZfPF6OoR20BO/Tg6V37qPi7gDSZ6vIC6Mxcs8LtEcju85cD9lnKKl/lo4S5/w9Ha
+  hGD2ZFFfbF8420X5Za5G2KuriS3GzRz7F5dKCTjb1NH9TPlgOc71bcrDmCwwtFJl
+  T+tdfBju0YxLSBiMXf4y5QIDAQABo4IBBDCCAQAwHQYDVR0OBBYEFHB1kXO/Xd4g
+  G+AJ2/wwh6JOWXzNMIHQBgNVHSMEgcgwgcWAFHB1kXO/Xd4gG+AJ2/wwh6JOWXzN
+  oYGhpIGeMIGbMQswCQYDVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTEWMBQG
+  A1UEBxMNU2FuIEZyYW5jaXNjbzETMBEGA1UEChMKV2ViR2V0LmNvbTETMBEGA1UE
+  CxMKV2ViR2V0LmNvbTETMBEGA1UEAxMKV2ViR2V0LmNvbTEgMB4GCSqGSIb3DQEJ
+  ARYRd2ViZ2V0QHdlYmdldC5jb22CCQCJUqhJA0GmSDAMBgNVHRMEBTADAQH/MA0G
+  CSqGSIb3DQEBBQUAA4GBADzVXlwuff0/w3yK4LflGKKhtC3oChIrwmSyP6tk628N
+  BHokpc4Kz63xSXqzYTnBS7rFBwlYThtNalQeWmoUjGh3Z0ZR0JlhU0ln8899LuJ3
+  DXnLFY0cVuBnNDMOOFl8vk1qIcZjcTovhzgcixpG6Uk5qmUsKHRLQf4oQJx7TfLK
+  -----END CERTIFICATE-----
+
+date: 2009-10-27 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: open4
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.9.6
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: webget_commander
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.1
+    version: 
+description: 
+email: webget@webget.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/webget_gemini.rb
+has_rdoc: true
+homepage: http://webget.com/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: "WebGet Gemini: provides gem initial setup method to see if a gem is installed"
+test_files: 
+- test/webget_gemini/webget_gemini_test.rb