topaz 1.0

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2008 Hans Engel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,24 @@
+=begin
+Copyright (c) 2008 Hans Engel
+See the file LICENSE for licensing details.
+=end
+
+require 'rubygems'
+Gem.manage_gems
+require 'rake/gempackagetask'
+
+spec = eval( File.read('topaz.gemspec') )
+
+Rake::GemPackageTask.new(spec) do |pkg|
+	pkg.need_tar = true
+end
+
+target = "pkg/#{spec.name}-#{spec.version}.gem"
+
+task :default => target do
+	puts "generated latest version"
+end
+
+task :bni => target do
+	puts `sudo gem install #{target}`
+end

data/lib/topaz.rb

@@ -0,0 +1,172 @@
+=begin
+Copyright (c) 2008 Hans Engel
+See the file LICENSE for licensing details.
+=end
+
+require 'rubygems'
+
+module Topaz
+	class Contents
+		class << self
+			# Lists all files associated with a gem.
+			def contents(gem, version = '> 0.0.0')
+				s = Gem::SourceIndex.installed_spec_directories
+				spec = Gem::SourceIndex.from_gems_in(*s).search(gem, version).last
+				raise 'Gem provided could not be found' unless spec
+				files = []
+				spec.files.each do |f|
+					files.push File.join(spec.full_gem_path, f)
+				end
+				files
+			end
+		end
+	end
+	
+	class Dependency
+		class << self
+			# Finds dependencies for a gem. Restrict by version with the `version`
+			# parameter. If `ret == :gem`, then an array of `Gem::Dependency` objects
+			# will be returned. If `ret == :raw`, then an array of arrays will be
+			# returned. Each array will have three elements: the name of the gem,
+			# its relation to the requirement `>=`, `<`, etc., and the version
+			# required (`0.4.1`, et al.)
+			def dependency(gem, version = '> 0.0.0', ret = :gem)
+				dependencies = []
+				source_index = Gem::SourceIndex.from_installed_gems
+				speclist = source_index.search(gem, version)
+				speclist.each do |spec|
+					dependencies << spec.dependencies
+				end
+				case ret
+					when :gem
+						dependencies
+					when :raw
+						raw = []
+						dependencies.first.each do |d|
+							raw << [d.name, d.version_requirements.requirements[0][0], d.version_requirements.requirements[0][1].to_s]
+						end
+						raw
+				end
+			end
+		end
+	end
+	
+	class Environment
+		class << self
+			# Describes the current RubyGems environment.
+			def environment
+				{
+					:gem_path => Gem.path,
+					:installation_directory => Gem.dir,
+					:package_version => Gem::RubyGemsPackageVersion,
+					:remote_sources => Gem.sources,
+					:version => Gem::RubyGemsVersion
+				}
+			end
+		end
+	end
+	
+	class Install
+		class << self
+			# Installs a gem with the name of `gem`, and optionally with the version
+			# of `version`.
+			def install(gem, version = '> 0.0.0')
+				`sudo gem install "#{gem}" -v "#{version}"`
+			end
+		end
+	end
+	
+	class List
+		class << self
+			# Returns an array of RubyGems. Set the `type` parameter to `:local`,
+			# `:remote`, or `:both` to have local or remote gems listed, respectively.
+			def list(type = :local)
+				type = case type
+					when :local
+						'-l'
+					when :remote
+						'-r'
+					when :both
+						'-b'
+				end
+				if type == '-l'
+					gems = Gem::cache.search ''
+					list = []
+					gems.each do |g|
+						list << [g.name, g.version.to_s]
+					end
+					list
+				else
+					`gem list #{type}`.scan(/^(\w+) \(([\d\.]+)/)
+				end
+			end
+		end
+	end
+	
+	class Sources
+		class << self
+			# Adds a source.
+			def add(url)
+				out = `gem sources -a "#{url}"`
+				if out =~ /(.+) is not a URI/
+					raise 'URL provided is not valid'
+				elsif out =~ /While executing gem \.\.\. \(Zlib::GzipFile::Error\)/
+					raise 'Failed to access RubyGem repository'
+				elsif out =~ /added to sources/
+					return true
+				end
+			end
+			
+			# Returns an array of sources.
+			def list
+				sources = `gem sources -l`.scan(/^.+/)
+				sources.delete('*** CURRENT SOURCES ***')
+				return sources
+			end
+			alias :sources :list
+			
+			# Removes a source.
+			def remove(url)
+				out = `gem sources -r "#{url}"`
+				if out =~ /not present in cache/
+					raise 'Provided source is not in the cache'
+				elsif out =~ /removed from sources/
+					return true
+				end
+			end
+			
+			# Updates the source cache
+			def update
+				`gem sources -u`
+			end
+		end
+	end
+	
+	class Specification
+		class << self
+			# Retrieve a specification object for the gem `gem`. Optionally a version
+			# can be specified with `version`. Returns a Gem::Specification instance.
+			def specification(gem, version = '> 0.0.0')
+				spec = Gem::SourceIndex.from_installed_gems.search(gem, version).first
+			end
+			
+			# Retrieves a gem with the name of `gem`, and optionally with the version
+			# of `version`.
+			def method_missing(id, *args)
+				return unless args.length == 2 or args.length == 1
+				args[1] ||= '> 0.0.0'
+				eval('specification(args[0], args[1]).' + id.to_s)
+			end
+		end
+	end
+	
+	class Uninstall
+		class << self
+			# Uninstalls a gem with the name of `gem`, and optionally with the version
+			# of `version`.
+			def uninstall(gem, version = '> 0.0.0')
+				`sudo gem uninstall "#{gem}" -v "#{version}"`
+			end
+		end
+	end
+end

data/topaz.gemspec

@@ -0,0 +1,21 @@
+=begin
+Copyright (c) 2008 Hans Engel
+See the file LICENSE for licensing details.
+=end
+
+Gem::Specification.new do |s|
+	s.author = 'Hans Engel'
+	s.date = Time.now
+	s.email = 'spam.me@engel.uk.to'
+	s.files = [
+		'LICENSE',
+		'Rakefile',
+		'topaz.gemspec',
+		'lib/topaz.rb']
+	s.homepage = 'http://github.com/hans/topaz'
+	s.name = 'topaz'
+	s.platform = Gem::Platform::RUBY
+	s.require_paths = ['lib']
+	s.summary = 'A library for manipulating RubyGems'
+	s.version = '1.0'
+end

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification 
+name: topaz
+version: !ruby/object:Gem::Version 
+  version: "1.0"
+platform: ruby
+authors: 
+- Hans Engel
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-09-23 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: 
+email: spam.me@engel.uk.to
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- LICENSE
+- Rakefile
+- topaz.gemspec
+- lib/topaz.rb
+has_rdoc: false
+homepage: http://github.com/hans/topaz
+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.2.0
+signing_key: 
+specification_version: 2
+summary: A library for manipulating RubyGems
+test_files: []
+