rankmirror 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 69987a6f2bf817b2ff3779548e775e3c86042b00
+  data.tar.gz: fc92243a24cf327ada2a959163911ea6a968f8b2
+SHA512:
+  metadata.gz: 468c53d68cb63777996a305174670af8be0de74f155ac31330ed9389fa0349abf21a6bcb426b5eaac8524a0726b3b3d7c1a59b53654d6e0fb5d7a2872c5229de
+  data.tar.gz: d71507f6738690b169adceb79e60d56570e6f717e97da0d6cec166d9c9547bdd75127aa71c236f77bf40ff9e762b3c2b3edfaa8fc1d2196978ad58fc20ab8efa

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.3
+before_install: gem install bundler -v 1.13.7

data/COPYING

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 marguerite
+
+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/Gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in rankmirror.gemspec
+gemspec
+gem 'nokogiri', '>= 1.6.0'
+gem 'colorize', '>= 0.8.0'
+gem 'curb', '>= 0.9.0'

data/README.md

@@ -0,0 +1,23 @@
+# Rankmirror
+
+RankMirror is a ruby implementation of `rankmirrors` in ArchLinux but for all modern Linux distributions.
+
+## Installation
+
+    $ gem install rankmirror
+
+## Usage
+
+    $ rankmirror --help
+
+eg. `rankmirror -o opensuse --flavor tumbleweed --continent asia` will get you: the fastest Tumbleweed mirror located in Asia. Those 3 options
+are mandatory for openSUSE.
+
+`rankmirror -o packman -s` will get you: the fastest Packman mirror from the World. And save that to a packman.mirrorlist in your `~/.rankmirror`.
+Next time, just `rankmirror -l -o packman -s`, which is faster^2. Because most of the times, there're only a few mirrors that are fast to you.
+This technology applies to openSUSE too.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/TODO

@@ -0,0 +1,3 @@
+* archlinux
+* fedora
+* ubuntu

data/bin/rankmirror

@@ -0,0 +1,147 @@
+#!/usr/bin/env ruby
+
+$:.push(File.expand_path(File.dirname(__FILE__) + "/../lib"))
+
+require 'rankmirror'
+require 'optparse'
+require 'colorize'
+
+options = RankMirror::Options.new
+
+parser = OptionParser.new do |opts|
+	opts.banner = "Usage: rankmirror [options]"
+	opts.separator ""
+	opts.separator "Specific options:"
+
+	opts.on("-l", "--localonly",
+		"Check mirrors in your local mirrorlist file ONLY.") do |local|
+		options.local = true	
+	end
+
+	opts.on("-o", "--os [Distribution]", 
+		"Check mirrors for this distro. Now supported: 'opensuse', 'packman'.") do |os|
+		case os
+		when "opensuse"
+			options.os = "opensuse"
+			options.path = "tumbleweed/repo/oss/suse/repodata/"
+		when "packman"
+			options.os = "packman"
+			options.path = "openSUSE_Tumbleweed/Essentials/repodata/"
+		else
+			raise RankMirror::DistributionNotImplemented
+		end
+
+		if options.os.nil?
+			raise RankMirror::MandatoryOptionNotSpecified
+		end
+	end
+
+	opts.on("--continent [Continent]", "Check mirrors on this continent. openSUSE ONLY.
+		Available Continents: 'africa', 'asia', 'europe', 'northamerica',
+		'southamerica', 'oceania'.") do |cont|
+		unless options.os != "opensuse"
+			options.continent = cont.downcase.delete("\s")
+		else
+			raise RankMirror::SuboptionNotSupported
+		end
+	end
+
+	opts.on("--flavor [Flavor]","Check mirrors for this flavor. openSUSE ONLY.
+		Now supported: '4220', '4210', 'tumbleweed'.") do |flavor|
+		case options.os
+		when "opensuse","packman"
+			case flavor
+			when "4220"
+				options.flavor = "leap4220"
+			when "4210"
+				options.flavor = "leap4210"
+			when "tumbleweed","tw"
+				options.flavor = "tumbleweed"
+			else
+				raise RankMirror::FlavorNotImplemented
+			end
+		else
+			raise RankMirror::DistributionNotImplemented
+		end
+	end
+
+	opts.on("-q", "--quick [1/0]", "Check mirrors quickly/slowly.
+		The quick check will download a tiny file from the mirror, thus
+		response quickly but the result will be less accurate. Default: 1") do |quick|
+		unless quick.to_i > 0
+			options.quick = false
+			case options.os
+			when "opensuse"
+				options.file = "appdata.xml.gz"
+			when "packman"
+				options.file = "primary.xml.gz"
+			else
+				raise RankMirror::DistributionNotImplemented
+			end
+		end
+	end
+
+	opts.on("-s","--save","Save the mirrorlist in your .rankmirror directory") do |save|
+		options.save = true
+	end
+
+	opts.separator ""
+	opts.separator "Common Options:"
+
+	opts.on_tail("-h", "--help", "Show this message") do
+		puts opts
+		exit
+	end
+
+	opts.on_tail("--version","Show version") do
+		puts RankMirror::VERSION
+		exit
+	end
+
+end
+
+parser.parse!(ARGV)
+
+mirrors = Array.new
+config = RankMirror::Config.new(options)
+
+case options.os
+when "opensuse"
+	local = RankMirror::LocalOSS.new(config.path,options).sort
+	mirrors = unless options.local
+			remote = RankMirror::RemoteOSS.new(options).fetch
+			remote.concat(local)
+		  else
+			local
+		  end
+when "packman"
+	local = RankMirror::LocalPackman.new(config.path,options).sort
+	mirrors = unless options.local
+			remote = RankMirror::RemotePackman.new.fetch
+			remote.concat(local)
+		  else
+			local
+		  end
+else
+	raise RankMirror::DistributionNotImplemented
+end
+
+sorted = RankMirror::Mirrors.new(mirrors).sort_by_speed(options).select {|k,v| v > 0}
+
+if options.save
+	config.save(sorted.keys)
+end
+
+i = 1
+
+sorted.each do |k,v|
+	speed = v.round(2)
+	if i < 4
+		puts "#{i}\t#{k}\t#{speed}\sKiB/s".green
+	elsif i > 3 && i < 6
+		puts "#{i}\t#{k}\t#{speed}\sKiB/s".yellow
+	else
+		puts "#{i}\t#{k}\t#{speed}\sKiB/s".red
+	end
+	i += 1
+end

data/lib/rankmirror.rb

@@ -0,0 +1,14 @@
+require 'rankmirror/version'
+require 'rankmirror/exception'
+require 'rankmirror/reachable'
+require 'rankmirror/speed'
+require 'rankmirror/options'
+require 'rankmirror/mirrors'
+require 'rankmirror/remoteoss'
+require 'rankmirror/localoss'
+require 'rankmirror/cache'
+require 'rankmirror/remotepackman'
+require 'rankmirror/localpackman'
+require 'rankmirror/status'
+require 'rankmirror/config'
+

data/lib/rankmirror/cache.rb

@@ -0,0 +1,50 @@
+require 'curb'
+require 'nokogiri'
+module RankMirror
+	class Cache
+		def initialize(uri)
+			@uri = uri
+			@host = @uri.gsub(/^http(s):\/\//,"").gsub("/","_")
+			@filename = File.join("/tmp",@host)
+		end
+
+		def fetch
+			unless is_recent?
+				buffer = open(@filename,'w')
+				r = Curl::Easy.new(@uri)
+				r.on_body do |b|
+					buffer.write b
+				end
+				r.perform
+				buffer.close
+				to_xml
+			end
+			return @filename + ".xml"
+		end
+
+		def to_xml
+			buffer = open(@filename) {|f|
+					f.read
+				}
+			doc = Nokogiri::XML(buffer)
+			f = open(@filename + ".xml",'w')
+			doc.write_xml_to(f)
+			f.close
+		end
+
+		def is_recent?
+			if File.exist?(@filename + ".xml")
+				last_time = File.mtime(@filename + ".xml")
+				# one week
+				if Time.now - last_time < 60*60*24*7
+					true
+				else
+					false
+				end
+			else
+				false
+			end
+		end
+
+	end
+end

data/lib/rankmirror/config.rb

@@ -0,0 +1,107 @@
+require 'fileutils'
+require 'uri'
+require 'ostruct'
+
+module RankMirror
+	class Config
+
+		def initialize(options)
+			@options = options
+			@name = @options.os
+			@file = @name + ".mirrorlist"
+			@systempath = File.expand_path(File.dirname(__FILE__))
+			@localpath = ENV['HOME'] + "/.rankmirror/"
+		end
+
+		def localconfig
+			File.join(@localpath,@file)
+		end
+
+		def systemconfig
+			File.join(@systempath,@file)
+		end
+
+		def path
+			if File.exist?(systemconfig) && File.readable?(systemconfig)
+				if File.exist?(localconfig)
+					m = merge(systemconfig,localconfig)
+					write(m,localconfig)
+					localconfig
+				else
+					systemconfig
+				end
+			else
+				if File.exist?(localconfig)
+					localconfig
+				else
+					nil
+				end
+			end
+		end
+
+		def merge(systemconfig,localconfig)
+			system_mirrors = parse(systemconfig)
+			local_mirrors = parse(localconfig)
+			system_mirrors.each do |system_mirror|
+				http_match = false
+				local_mirrors.each do |local_mirror|
+					if system_mirror.http == local_mirror.http
+						http_match = true
+						local_mirror.continent = system_mirror.continent
+						local_mirror.country = system_mirror.country
+					end
+				end
+				if http_match == false
+					local_mirrors << system_mirror
+				end
+			end
+			return local_mirrors
+		end
+
+		def parse(config)
+			f = open(config)
+			mirrors = f.readlines.map!{|l|
+				unless l.start_with?("#")
+					elements = l.strip.split("\t")
+					mirror = OpenStruct.new
+					mirror.name = elements[0]
+					mirror.continent = elements[1]
+					mirror.country = elements[2]
+					mirror.http = elements[3]
+					mirror.tumbleweed = elements[4]
+					mirror.leap4220 = elements[5]
+					mirror.leap4210 = elements[6]
+					mirror.leap4230 = elements[7]
+					mirror
+				end
+				}.compact!
+			f.close
+			return mirrors
+		end
+
+		def write(mirrors_array,file)
+			f = open(file,'w')
+			f.write "#sitename\tcontinent\tcountry\thttp\ttumbleweed\tleap4220\tleap4210\tleap4230\n"
+			mirrors_array.each do |mirror_struct|
+				str = String.new
+				m = mirror_struct
+				str = m.name + "\t" + m.continent + "\t" + m.country + "\t" + m.http + "\t" + m.tumbleweed.to_s + "\t" + m.leap4220.to_s + "\t" + m.leap4210.to_s + "\t" + m.leap4230.to_s + "\n"
+				f.write str
+			end
+			f.close
+		end
+        
+		def save(array)
+			FileUtils.mkdir_p @localpath unless File.directory?(@localpath)
+			mirrors_array = array.map! do |uri|
+				mirror = RankMirror::Status.new(uri,@options.os).get
+				mirror.name = URI.parse(uri).host if mirror.name.nil?
+				mirror.continent = "world"
+				mirror.country = "world"
+				mirror
+			end
+			write(mirrors_array,localconfig)
+		end
+	end
+end
+

data/lib/rankmirror/exception.rb

@@ -0,0 +1,12 @@
+module RankMirror
+	class DistributionNotImplemented < StandardError
+	end
+	class MandatoryOptionNotSpecified < StandardError
+	end
+	class SuboptionNotSupported < StandardError
+	end
+	class FlavorNotImplemented < StandardError
+	end
+	class ConfigurationNotFound < StandardError
+	end
+end

data/lib/rankmirror/localoss.rb

@@ -0,0 +1,18 @@
+require 'ostruct'
+
+module RankMirror
+	class LocalOSS
+		def initialize(mirrorlist,options)
+			@options = options
+			@mirrorlist = RankMirror::Config.new(@options).parse(mirrorlist)
+		end
+
+		def sort
+			sorted = @mirrorlist.map! { |m|
+				m.http if @options.continent == m.continent && m[@options.flavor] == "true"
+			}.compact!
+			return sorted
+		end
+	end
+end
+

data/lib/rankmirror/localpackman.rb

@@ -0,0 +1,18 @@
+require 'ostruct'
+
+module RankMirror
+	class LocalPackman
+		def initialize(mirrorlist,options)
+			@options = options
+			@mirrorlist = RankMirror::Config.new(@options).parse(mirrorlist)	
+		end
+
+		def sort
+			sorted = @mirrorlist.map!{|m|
+					m.http if @options.continent == m.continent && m[@options.flavor] == "true"
+			}.compact!
+			return sorted
+		end
+	end
+end
+

data/lib/rankmirror/mirrors.rb

@@ -0,0 +1,37 @@
+module RankMirror
+	class Mirrors
+
+		def initialize(mirrors)
+			@mirrors = mirrors
+		end
+
+		def sort_by_speed(options)
+			speed_matrix = Hash.new
+			size = @mirrors.length
+			jobs = Queue.new
+			@mirrors.each {|i| jobs.push i}
+
+			workers = size.times.map do
+				Thread.new do 
+					begin
+						while x = jobs.pop(true)
+							x << "/" unless x.index(/\/$/)
+							uri = x + options.path + options.file
+							speed = RankMirror::Speed.new(uri).get
+							speed_matrix[x] = speed
+						end
+					rescue ThreadError
+					end
+				end
+			end
+
+			workers.map(&:join)
+
+			speed_sorted = speed_matrix.values.sort.reverse
+			sorted = Hash.new
+			speed_sorted.each {|v| sorted[speed_matrix.key(v)] = v}
+			
+			return sorted
+		end
+	end
+end

data/lib/rankmirror/opensuse.mirrorlist

@@ -0,0 +1,8 @@
+# sitename	continent	country		http	tumbleweed	leap-4220	leap-4210	leap 4230
+Aliyun	asia	china	http://mirrors.aliyun.com/opensuse	true	true	true	false
+Capital Online	asia	china	http://mirrors.yun-idc.com/opensuse	true	true	true	true
+Beijing Institute of Techfalselogy	asia	china	http://mirror.bit.edu.cn/opensuse	true	true	true	true
+Zhejiang University	asia	china	http://mirrors.zju.edu.cn/opensuse	true	true	true	true
+Xiamen University	asia	china	http://mirrors.xmu.edu.cn/opensuse	true	false	true	false
+Zhengzhou University	asia	china	https://mirrors.zzu.edu.cn/opensuse	true	true	true	false
+Chongqing University	asia	china	https://mirrors.cqu.edu.cn/opensuse	true	true	true	false

data/lib/rankmirror/options.rb

@@ -0,0 +1,100 @@
+require 'ostruct'
+
+module RankMirror
+	class Options
+		def initialize
+			@options = OpenStruct.new
+			@options.local = false
+			@options.os = "opensuse"
+			@options.continent = "asia"
+			@options.flavor = "leap4220"
+			@options.quick = true
+			@options.path = nil
+			@options.file = "repomd.xml"
+		end
+
+		def show
+			return @options
+		end
+
+		def add(k,v)
+			@options[k] = v
+			return @options
+		end
+
+		def delete_by_key(key)
+			@options.delete_field(key)
+			return @options
+		end
+
+		def delete_by_value(value)
+			h = @options.to_h
+			@options.delete_field(h.key(value))
+			return @options
+		end
+
+		def local=(v)
+			@options.local = v
+		end
+
+		def local
+			@local ||= @options.local
+		end
+
+		def os=(v)
+			@options.os = v
+		end
+
+		def os
+			@os ||= @options.os
+		end
+
+		def continent=(v)
+			@options.continent = v
+		end
+
+		def continent
+			@continent ||= @options.continent
+		end
+
+		def flavor=(v)
+			@options.flavor = v
+		end
+
+		def flavor
+			@flavor ||= @options.flavor
+		end
+
+		def quick=(v)
+			@options.quick = v
+		end
+
+		def quick
+			@quick ||= @options.quick
+		end
+
+		def path=(v)
+			@options.path = v
+		end
+
+		def path
+			@path ||= @options.path
+		end
+
+		def file=(v)
+			@options.file = v
+		end
+
+		def file
+			@file ||= @options.file
+		end
+
+		def save=(v)
+			@options.save = v
+		end
+
+		def save
+			@save ||= @options.save
+		end
+	end
+end

data/lib/rankmirror/packman.mirrorlist

@@ -0,0 +1,2 @@
+# sitename	continent	country		http		tumbleweed	leap4220	leap4210	leap4230
+Aliyun	asia	china	http://mirrors.aliyun.com/packman/	true	true	true	false

data/lib/rankmirror/reachable.rb

@@ -0,0 +1,25 @@
+require 'curb'
+
+module RankMirror
+	class Reachable
+		def initialize(uri,timeout)
+			@uri = uri
+			@timeout = timeout
+		end
+
+		def reachable?
+			begin
+				r = Curl::Easy.new(@uri)
+				r.timeout_ms = @timeout
+				r.perform
+				if r.response_code == 404
+					false
+				else
+					true
+				end
+			rescue
+				return false
+			end
+		end
+	end
+end

data/lib/rankmirror/remoteoss.rb

@@ -0,0 +1,47 @@
+require 'nokogiri'
+
+module RankMirror
+	class RemoteOSS
+		def initialize(options)
+			@mirrors = []
+			@continent = ""
+			@options = options
+		end
+
+		def fetch
+			cache = RankMirror::Cache.new("http://mirrors.opensuse.org").fetch
+			doc = Nokogiri::HTML(open(cache))
+			doc.root.element_children.last.element_children[-2].element_children[-1].element_children.each do |tr|
+				unless tr.children[1].attribute("class").nil?
+					@continent = tr.children[1].inner_text.delete!(":").delete("\s").downcase!
+				else
+					if @continent == @options.continent || @options.continent == "world"
+						country = tr.children[1].inner_text.strip!
+						unless country.nil?
+							tumbleweed = tr.children[15].children[0].nil? ? false : true
+							leap4220 = tr.children[17].children[0].nil? ? false : true
+							leap4210 = tr.children[27].children[0].nil? ? false : true
+
+							ftpobj = tr.children[7].children[0]
+							ftp = ftpobj.nil? ? nil : ftpobj.attribute("href").inner_text
+							httpobj = tr.children[5].children[0]
+							http = httpobj.nil? ? ftp : httpobj.attribute("href").inner_text
+
+							unless leap4210 || leap4220 || tumbleweed
+								status = RankMirror::Status.new(http,@options.os).get
+								unless status.nil?
+									tumbleweed = status["tumbleweed"]
+									leap4220 = status["leap4220"]
+									leap4210 = status["leap4210"]
+								end
+							end
+
+							@mirrors << http if eval(@options.flavor)
+						end
+					end
+				end
+			end
+			return @mirrors
+		end
+	end
+end

data/lib/rankmirror/remotepackman.rb

@@ -0,0 +1,23 @@
+require 'nokogiri'
+
+module RankMirror
+	class RemotePackman
+		def initialize
+			@mirrors = []
+		end
+
+		def fetch
+			cache = RankMirror::Cache.new("http://packman.links2linux.de/mirrors").fetch
+			doc = Nokogiri::HTML(open(cache))
+			doc.xpath('//td[@class="mirrortable mirror"]').each do |td|
+				unless td.at_xpath("a").nil? # ignore rsync mirror
+					v = td.at_xpath("a/@href").value
+					v << "/" unless /^.*\/$/.match(v)
+					v << "suse/"
+					@mirrors << v unless v.index("ftp://")
+				end
+			end
+			return @mirrors
+		end
+	end
+end

data/lib/rankmirror/speed.rb

@@ -0,0 +1,23 @@
+require 'curb'
+
+module RankMirror
+	class Speed
+		def initialize(uri)
+			@uri = uri
+		end
+
+		def get
+			if RankMirror::Reachable.new(@uri,500).reachable?
+				r = Curl::Easy.new(@uri)
+				r.perform
+				return r.download_speed / 1024.0
+			#else
+				# usually in this case, the mirror is online but:
+				# 1. has bad repodata. eg. not fully rsync the origin, or even empty. 
+				# 2. volatile. sometimes at good speed, sometimes unreachable.
+				# 3. too slow. takes more than 5 seconds to start a download.
+				# not break here because we're about to find out the good mirrors, not the bad ones.
+			end
+		end
+	end
+end

data/lib/rankmirror/status.rb

@@ -0,0 +1,57 @@
+require 'ostruct'
+
+module RankMirror
+	class Status
+		def initialize(uri,distro)
+			uri << "/" unless /^.*\/$/.match(uri)
+			@uri = uri
+			@distro = distro
+		end
+
+		def get
+			if RankMirror::Reachable.new(@uri,500).reachable?
+				case @distro
+				when "opensuse"
+					tumbleweed = "tumbleweed/repo/oss/suse/repodata/"
+					leap4220 = "distribution/leap/42.2/repo/oss/suse/repodata/"
+					leap4210 = "distribution/leap/42.1/repo/oss/suse/repodata/"
+					leap4230 = "distribution/leap/42.3/repo/oss/suse/repodata/"
+					
+					checklist = {"tumbleweed"=>tumbleweed,"leap4220"=>leap4220,"leap4210"=>leap4210,"leap4230"=>leap4230}
+					mirror = OpenStruct.new
+					mirror.http = @uri
+					
+					checklist.each do |k,v|
+						if RankMirror::Reachable.new(@uri + v,500).reachable?
+							mirror[k] = true
+						else
+							mirror[k] = false
+						end
+					end
+					return mirror
+				when "packman"
+					tumbleweed = "Tumbleweed"
+					leap4220 = "Leap_42.2"
+					leap4210 = "Leap_42.1"
+					leap4230 = "Leap_42.3"
+					checklist = {"tumbleweed"=>tumbleweed,"leap4220"=>leap4220,"leap4210"=>leap4210,"leap4230"=>leap4230}
+
+					mirror = OpenStruct.new
+					mirror.http = @uri
+
+					checklist.each do |k,v|
+						if RankMirror::Reachable.new(@uri + "openSUSE_" + v + "/Essentials/repodata/",500).reachable?
+							mirror[k] = true
+						else
+							mirror[k] = false
+						end
+					end
+					return mirror
+				else
+				end
+			else
+				return nil
+			end
+		end
+	end
+end

data/lib/rankmirror/version.rb

@@ -0,0 +1,3 @@
+module RankMirror
+	VERSION = '1.0.0'
+end

data/rankmirror.gemspec

@@ -0,0 +1,39 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'rankmirror/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "rankmirror"
+  spec.version       = RankMirror::VERSION
+  spec.authors       = ["marguerite"]
+  spec.email         = ["i@marguerite.su"]
+
+  spec.summary       = %q{Rank mirrors by speed for common Linux distributions}
+  spec.description   = %q{rankmirror is a command-line tool to sort mirrors by the real download speed for common Linux distributions. it supports both mirrors listed on the distro's website and the ones held in your local mirrorlists.}
+  spec.homepage      = "http://github.com/marguerite/rankmirror"
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+	  spec.metadata['allowed_push_host'] = "https://rubygems.org"
+  else
+    raise "RubyGems 2.0 or newer is required to protect against " \
+      "public gem pushes."
+  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "bin"
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "nokogiri", ">= 1.6.0"
+  spec.add_runtime_dependency "colorize", ">= 0.8.0"
+  spec.add_runtime_dependency "curb", ">= 0.9.0"
+  spec.add_development_dependency "bundler", "~> 1.13"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

metadata

@@ -0,0 +1,158 @@
+--- !ruby/object:Gem::Specification
+name: rankmirror
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- marguerite
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-01-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.6.0
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+- !ruby/object:Gem::Dependency
+  name: curb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: rankmirror is a command-line tool to sort mirrors by the real download
+  speed for common Linux distributions. it supports both mirrors listed on the distro's
+  website and the ones held in your local mirrorlists.
+email:
+- i@marguerite.su
+executables:
+- rankmirror
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- COPYING
+- Gemfile
+- README.md
+- Rakefile
+- TODO
+- bin/rankmirror
+- lib/rankmirror.rb
+- lib/rankmirror/cache.rb
+- lib/rankmirror/config.rb
+- lib/rankmirror/exception.rb
+- lib/rankmirror/localoss.rb
+- lib/rankmirror/localpackman.rb
+- lib/rankmirror/mirrors.rb
+- lib/rankmirror/opensuse.mirrorlist
+- lib/rankmirror/options.rb
+- lib/rankmirror/packman.mirrorlist
+- lib/rankmirror/reachable.rb
+- lib/rankmirror/remoteoss.rb
+- lib/rankmirror/remotepackman.rb
+- lib/rankmirror/speed.rb
+- lib/rankmirror/status.rb
+- lib/rankmirror/version.rb
+- rankmirror.gemspec
+homepage: http://github.com/marguerite/rankmirror
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.8
+signing_key: 
+specification_version: 4
+summary: Rank mirrors by speed for common Linux distributions
+test_files: []