uri_pathname 0.0.0.pre2

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,26 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC
+*.gem
+examples/pr_*
+
+## NETBEANS
+nbproject/*

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Marcel Massana
+
+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/README.rdoc

@@ -0,0 +1,150 @@
+= uri_pathname
+
+UriPathname eases the conversions between URIs and unique valid pathnames. This
+feature might be useful, for instance, when:
+
+* Web Spidering: You want to save webpages to files, or save all their contents within a directory, or only some scraped data, ... and don't know how to name them. UriPathname can assign easily unique valide names to files or directories from already known URIs, combinig scheme, hostname, path and vars.
+
+* Web Stubbing / Testing: You need to retrieve previously saved webpages by means of their URIs. UriPathname guesses the pathname from a given URI, then you can use, for instance, your File.read to read that file/page.
+
+== Installation
+
+  $ sudo gem install uri_pathname
+
+The main source repository is http://github.com/syborg/uri_pathname.
+
+== Examples
+
+(see examples directory)
+
+=== First of all
+
+Require at least ...
+
+  require 'rubygems'
+  require 'uri_pathname'
+
+=== Generate pathnames from URIs
+
+Theses examples are useful when web spidering. You will need to generate a
+pathname given an URI.
+
+  # From URI with path and query
+  puts up.uri_to_pathname("http://www.fake.fak/path1/path2?query")
+  # => www.fake.fak__|path1_|_path2?query(http)
+
+  # From URI without path and query
+  puts up.uri_to_pathname("http://www.fake.fak")
+  # => www.fake.fak__|_NOPATH_(http)
+
+  # Fragments or other URI parts are silently ignored
+  puts up.uri_to_pathname('http://donaldfagen.com/disc_nightfly.php#rubybaby')
+  # => donaldfagen.com__|disc_nightfly.php(http)
+
+  # If a directory is given as a second arg, pathname will be prepended with that
+  # expanded directory
+  puts up.uri_to_pathname("http://www.fake.fak", "~/my_webdumps")
+  # => /home/marcel/my_webdumps/www.fake.fak__|_NOPATH_(http)
+
+  # Also a third argument can be given and will be appended as an extension
+  puts up.uri_to_pathname("http://www.fake.fak/path","", ".html")
+  # => www.fake.fak__|path(http).html
+
+=== Recovering URIs from (correct) pathnames
+
+When stubbing with tools like fakeweb, you can use reverse conversion to
+register fake accesses to real URIs.
+
+  # pathnames can be parsed if correctly generated as above examples (see docs)
+  p up.parse('/home/marcel/my_webdumps/www.fake.fak__|path1_|_path2?query(http).html.gz')
+
+  # URI can be also retrieved from correct (Uri)pathnames
+  puts up.pathname_to_uri('/home/marcel/my_webdumps/www.fake.fak__|_NOPATH_(http).html.gz')
+  # => http://www.fake.fak
+  puts up.pathname_to_uri('www.fake.fak__|path?query(http).html.gz')
+  # => http://www.fake.fak/path?query
+
+=== Web Spidering / Dumping / Stubbing
+
+This example shows how tu use UriPathname to assign names to files and also
+registering those files to stubb real accesses later.
+
+require 'rubygems'
+require 'fileutils'
+require 'open-uri'
+require 'uri_pathname'
+require 'fakeweb' # gem install fakeweb
+
+# put here whatever temporary directory name to use
+MY_DIR=File.expand_path '~/my_dumps'
+# put here whatever URIs u want to access
+MY_URIS = [
+  'http://en.wikipedia.org/wiki/Ruby_Bridges',
+  'http://donaldfagen.com/disc_nightfly.php',
+  'http://www.rubi.cat/ajrubi/portada/index.php',
+  'http://www.google.com/cse?q=array&cx=013598269713424429640%3Ag5orptiw95w&ie=UTF-8&sa=Search'
+]
+
+# some convenient defs
+def prepare_example
+  File.makedirs(MY_DIR) unless (File.exist?(MY_DIR) and File.directory?(MY_DIR))
+end
+
+# preparation (comment this if you've already got your test dir)
+prepare_example
+
+up = UriPathname.new
+
+# 1st round: Capture MY_URIS, and save them with appropiate UriPathname
+puts "1- Capturing URIs"
+data = nil
+sizes = []
+MY_URIS.each do |uri|
+  open uri do |u|
+    data=u.read
+    pathname = up.uri_to_pathname(uri,MY_DIR,".html")
+    File.open(pathname,'w') do |f|
+      f.write data
+      sizes << data.size
+      puts "SAVED #{uri} : #{data.size} bytes"
+    end
+  end
+end
+
+# 2nd round: checking saved files and preparing
+puts "\n2- CHECKING CAPTURED FILES AND PREPARING FAKE WEB ACCESSES"
+FakeWeb.allow_net_connect=false
+Dir[File.join(MY_DIR,"*")].each do |name|
+  uri = up.pathname_to_uri name
+  FakeWeb.register_uri :any, uri, :body=>name, :content_type=>"text/html"
+  puts "#{name}\n\tcorresponds to #{uri}"
+end
+
+# 3nd round: Access Web without actually accessing web
+puts "\n3- FAKE WEB ACCESSES"
+MY_URIS.each_with_index do |uri,i|
+  open uri do |u|
+    data=u.read
+    puts "FAKE #{uri} ACCESS #{(data.size == sizes[i]) ? 'OK' : 'KO'}: #{data.size} bytes"
+  end
+end
+
+== Release Notes
+
+* At present, UriPathname uses only some parts of an URI (scheme, hostname, path and query) to generate a valid and unique pathname that can be backconverted to URI. Port, User and other URI features are not yet used. I haven't had the necessity to include them too ;-).
+
+* Only Linux pathnames have been taken into account. I don't know if UriPathname will generate correct Windows or OSX pathnames, for instance. Test it and feel free to collaborate.
+
+* This is a very early release. I haven't got the time to study and prepare tests, nonetheless, some examples will become tests in the future
+
+== Note on Patches/Pull Requests
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a future version unintentionally.
+* Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2011 Marcel Massana. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,60 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  require './lib/uri_pathname/version'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "uri_pathname"
+    gem.summary = %Q{Simple converter between URIs and Pathnames}
+    gem.description = %Q{Simple converter between URIs and Pathnames. 
+      It creates valid, unique and readable filenames from URIs and 
+      viceversa. It can be used to name files while saving data from 
+      websites and conversely, read files assigned to URIs while, for
+      instance, simulating or stubbing web accesses by means of reading
+      files}.gsub(/\s+/,' ')
+    gem.email = "xaxaupua@gmail.com"
+    gem.homepage = "http://github.com/syborg/uri_pathname"
+    gem.authors = ["Marcel Massana"]
+    # gem.add_development_dependency "thoughtbot-shoulda", ">= 0"
+    gem.version = UriPathname::Version::STRING
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/test_*.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "uri_pathname #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/examples/simple_examples.rb

@@ -0,0 +1,44 @@
+# simple_examples
+# MME 26/8/2011
+
+require 'uri_pathname'
+
+up = UriPathname.new
+
+# GENERATE PATHNAMES
+
+  # From URI with path and query
+  puts up.uri_to_pathname("http://www.fake.fak/path1/path2?query")
+  # => www.fake.fak__|path1_|_path2?query(http)
+
+  # From URI without path and query
+  puts up.uri_to_pathname("http://www.fake.fak")
+  # => www.fake.fak__|_NOPATH_(http)
+
+  # Fragments or other URI parts are silently ignored
+  puts up.uri_to_pathname('http://donaldfagen.com/disc_nightfly.php#rubybaby')
+  # => donaldfagen.com__|disc_nightfly.php(http)
+
+  # If a directory is given as a second arg, pathname will be prepended with that
+  # expanded directory
+  puts up.uri_to_pathname("http://www.fake.fak", "~/my_webdumps")
+  # => /home/marcel/my_webdumps/www.fake.fak__|_NOPATH_(http)
+
+  # Also a third argument can be given and will be appended as an extension
+  puts up.uri_to_pathname("http://www.fake.fak/path","", ".html")
+  # => www.fake.fak__|path(http).html
+
+# RECOVERING URIs FROM PATHNAMES
+
+  # pathnames can be parsed if correctly generated as above examples (see docs)
+  p up.parse('/home/marcel/my_webdumps/www.fake.fak__|path1_|_path2?query(http).html.gz')
+
+  # URI can be also retrieved from correct (Uri)pathnames
+  puts up.pathname_to_uri('/home/marcel/my_webdumps/www.fake.fak__|_NOPATH_(http).html.gz')
+  # => http://www.fake.fak
+  puts up.pathname_to_uri('www.fake.fak__|path?query(http).html.gz')
+  # => http://www.fake.fak/path?query
+
+
+
+

data/examples/using_fakeweb.rb

@@ -0,0 +1,66 @@
+# fakeweb
+# MME 27/8/2011
+#
+# This example demonstrates how uri_pathname should be used to save and restore
+# pages, including a demo with fakeweb (a web stub utility) to simulate web
+# accesses.
+
+require 'rubygems'
+require 'fileutils'
+require 'open-uri'
+require 'uri_pathname'
+require 'fakeweb' # gem install fakeweb
+
+# put here whatever temporary directory name to use
+MY_DIR=File.expand_path '~/my_dumps' 
+# put here whatever URIs u want to access
+MY_URIS = [
+  'http://en.wikipedia.org/wiki/Ruby_Bridges',
+  'http://donaldfagen.com/disc_nightfly.php',
+  'http://www.rubi.cat/ajrubi/portada/index.php',
+  'http://www.google.com/cse?q=array&cx=013598269713424429640%3Ag5orptiw95w&ie=UTF-8&sa=Search'
+]
+
+# some convenient defs
+def prepare_example
+  File.makedirs(MY_DIR) unless (File.exist?(MY_DIR) and File.directory?(MY_DIR))
+end
+
+# preparation (comment this if you've already got your test dir)
+prepare_example
+
+up = UriPathname.new
+
+# 1st round: Capture MY_URIS, and save them with appropiate UriPathname
+puts "1- Capturing URIs"
+data = nil
+sizes = []
+MY_URIS.each do |uri|
+  open uri do |u|
+    data=u.read
+    pathname = up.uri_to_pathname(uri,MY_DIR,".html")
+    File.open(pathname,'w') do |f|
+      f.write data
+      sizes << data.size
+      puts "SAVED #{uri} : #{data.size} bytes"
+    end
+  end
+end
+
+# 2nd round: checking saved files and preparing
+puts "\n2- CHECKING CAPTURED FILES AND PREPARING FAKE WEB ACCESSES"
+FakeWeb.allow_net_connect=false
+Dir[File.join(MY_DIR,"*")].each do |name|
+  uri = up.pathname_to_uri name
+  FakeWeb.register_uri :any, uri, :body=>name, :content_type=>"text/html"
+  puts "#{name}\n\tcorresponds to #{uri}"
+end
+
+# 3nd round: Access Web without actually accessing web
+puts "\n3- FAKE WEB ACCESSES"
+MY_URIS.each_with_index do |uri,i|
+  open uri do |u|
+    data=u.read
+    puts "FAKE #{uri} ACCESS #{(data.size == sizes[i]) ? 'OK' : 'KO'}: #{data.size} bytes"
+  end
+end

data/lib/uri_pathname/version.rb

@@ -0,0 +1,16 @@
+# it's only a version number
+
+class UriPathname
+
+  module Version
+
+    MAJOR = 0
+    MINOR = 0
+    PATCH = 0
+    BUILD = 'pre2'
+	
+    STRING = [MAJOR, MINOR, PATCH, BUILD].compact.join(".")
+
+  end
+
+end

data/lib/uri_pathname.rb

@@ -0,0 +1,141 @@
+# uri_pathname
+# MME 25/8/2011
+
+require 'uri'
+require 'uri_pathname/version'
+
+class UriPathname
+
+  # Error codes
+  class InvalidPathName < StandardError; end
+  class InvalidURI < StandardError; end
+  
+  PTH_SEP = '_|_' # used to swap chars from and to '/' while converting to
+  # pathname and viceversa. To work it should be a String that
+  # doesn't exist in URIs and that can be used in pathnames.
+
+  HOST_SEP = '__|' # used to separate hostname from the
+
+  NO_PTH = '_NOPATH_' # used to make a filename for root uris (empty path).
+  # To work it should be a String that doesn't exist in uris
+
+  BASE_DIR = '' # dir prepended to all pathnames
+  
+  HOST_2_DIR = true # URI hostname will become a subdirectory?
+
+  #default attributes
+  DEFAULT_ATTRS = {
+      :pth_sep => PTH_SEP,
+      :host_sep => HOST_SEP,
+      :no_pth => NO_PTH,
+      :base_dir => BASE_DIR,
+      :host_2_dir => HOST_2_DIR
+    }
+
+  attr_accessor *(DEFAULT_ATTRS.keys)
+
+  # Initializes an UriPathname that can be used to convert between URIs and
+  # pathnames. +options+ is a hash that can contain any of:
+  #      :pth_sep => String that will be used to substitute '/' inside URI's path and queries (default UriPathname::PTH_SEP)
+  #      :host_sep => String that will be used to substitute '/' between host and path (default UriPathname::HOST_SEP)
+  #      :no_pth => String that will be used as a path placeholder when no URI's path exists, (default UriPathname::NO_PTH)
+  #      :base_dir => String containing base directory prepended to any pathname, (default UriPathname::DEFAULT_DIR)
+  #      :host_2_dir => If true, hostnames will become subdirectories (default UriPathname::HOST_2_DIR)
+  def initialize(options = {})
+
+    attributes = DEFAULT_ATTRS.merge options if options.is_a? Hash
+
+    attributes.each { |k,v| instance_eval("@#{k}='#{v}'") if DEFAULT_ATTRS.keys.include?(k) }
+
+  end
+
+  # Converts an uri to a valid pathname, that is:
+  #   [_DIR_/]_hostname_HS_path_?_query_(_scheme_)[._extension_]
+  # where
+  #   DIR is +basedirpath+ if given else _@base_dir_
+  #   HS is UriPathname::HOST_SEP
+  #   all '/' within _path_ and _query_ will be substituted by
+  # UriPathname::PTH_SEP value.
+  def uri_to_pathname(uri,basedirpath=nil,extension="")
+    arr = URI.split uri
+    # raise(InvalidURI, "#{uri} lacks scheme and/or host") unless (arr[0] && arr[2])
+    return nil unless (arr[0] && arr[2])
+    scheme = "(" << arr[0] << ")"
+    host = arr[2]
+    path = arr[5]
+    if path.size <= 1 # "" or "/"
+      path = @no_pth
+    else
+      path=path[1..-1].gsub("/",@pth_sep) # first '/' isn't necessary
+    end
+    query = arr[7]
+    query = if query
+      "?" << query.gsub("/",@pth_sep)
+    else
+      ""
+    end
+    extension.insert(0,'.') unless extension.empty? or extension.start_with? '.'
+    pathname = host << @host_sep << path << query << scheme << extension
+    basedirpath = @base_dir unless basedirpath
+    basedirpath.size > 0 ? File.expand_path(pathname, basedirpath) : pathname
+  end
+
+  # converts +pathname+ to an URI. UriPathname::PTH_SEP appearances will be
+  # substituted by "/" (the standard path separator).
+  # returns the URI String if +pathname+ was convertible or nil in other case.
+  def pathname_to_uri(pathname)
+    pn = self.parse(pathname)
+    pn ? pn[7] : nil
+  end
+
+  # splits up a +pathname+ and returns an array where:
+  # 1. the 3 first elements correspond to Pathname
+  #   - arr[0] = dirname
+  #   - arr[1] = basename (without extension)
+  #   - arr[2] = extension
+  # 2. the last elements correspond to URI
+  #   - arr[3] = scheme
+  #   - arr[4] = hostname
+  #   - arr[5] = path
+  #   - arr[6] = query
+  #   - arr[7] = URI (complete)
+  # returns nil if +pathname+ doesn't correspond to UriPathname format (see
+  # UriPathname::uri_to_pathname)
+  def parse(pathname)
+    # raise(InvalidPathName, "pathname should be a String") \
+    #   unless pathname.respond_to? :to_s
+    return nil unless pathname.respond_to? :to_s
+    complete_pathname = File.expand_path(pathname.to_s)
+
+    # pathname parsed from complete_pathname
+    extension = complete_pathname.slice!(/(\.[^\)\(\/]*)?$/)
+    dirname, basename = File.split(complete_pathname)
+    
+    # further uri restored
+    # hostname
+    if @host_sep == '/'
+      path_to_host, rest_of_thing = dirname, basename
+      hostname = File.basename(path_to_host)
+    else
+      rest_of_thing = basename
+      hostname, rest_of_thing = rest_of_thing.split(@host_sep)
+    end
+    # path, query and scheme
+    return nil unless rest_of_thing =~ /(.*)\(([^\(]+)\)$/ and !hostname.empty?
+    path_query, scheme= rest_of_thing.match(/(.*)\(([^\(]+)\)$/)[1..2]
+    uri = scheme + '://' + hostname
+    case path_query
+    when @no_pth
+      path = ''
+      query = ''
+    else
+      path, query = path_query.gsub(@pth_sep,"/").split("?")
+    end
+    uri += "/" + path unless path.nil? or path.empty?
+    uri += "?" + query unless query.nil? or query.empty?
+    arr = []
+    arr << dirname << basename << extension << scheme << hostname << path << query << uri
+  end
+
+end
+

data/test/test_uri_pathname.rb

@@ -0,0 +1,58 @@
+require 'test/unit'
+require 'uri_pathname'
+
+class TC_Uri2Pathname < Test::Unit::TestCase
+
+  def setup
+    @up = UriPathname.new
+  end
+
+  def test_uri_without_path
+    assert_equal('www.fake.fak__|_NOPATH_(http)',@up.uri_to_pathname('http://www.fake.fak'))
+    assert_equal('www.fake.fak__|_NOPATH_(http)',@up.uri_to_pathname('http://www.fake.fak/'))
+  end
+
+  def test_uri_with_path
+    assert_equal('www.fake.fak__|path1_|_path2(http)',@up.uri_to_pathname('http://www.fake.fak/path1/path2'))
+    assert_equal('foo-bar.com__|yay?_|_hi(http)',@up.uri_to_pathname('http://foo-bar.com/yay?/hi'))
+  end
+
+  def test_uri_with_path_and_fragment
+    assert_equal('donaldfagen.com__|disc_nightfly.php(http)',@up.uri_to_pathname('http://donaldfagen.com/disc_nightfly.php#rubybaby'))
+  end
+
+  def test_uri_with_path_and_query
+    assert_equal('www.fake.fak__|path1_|_path2?query(http)',@up.uri_to_pathname('http://www.fake.fak/path1/path2?query'))
+    assert_equal('foo-bar.com__|yay_|_?foo=bar&a=22(http)',@up.uri_to_pathname('http://foo-bar.com/yay/?foo=bar&a=22'))
+  end
+
+  def test_uri_dir_expansion_and_exension
+    assert_equal('/tmp/my_webdumps/www.fake.fak__|path1_|_path2?query(http).html',@up.uri_to_pathname("http://www.fake.fak/path1/path2?query", "/tmp/my_webdumps",".html"))
+    assert_equal('/tmp/my_webdumps/www.fake.fak__|path1_|_path2?query(http).html',@up.uri_to_pathname("http://www.fake.fak/path1/path2?query", "/tmp/my_webdumps","html"))
+  end
+
+end
+
+class TC_Pathname2Uri < Test::Unit::TestCase
+
+  def setup
+    @up = UriPathname.new
+  end
+
+  def test_pn_absolute
+    assert_equal('http://www.fake.fak',@up.pathname_to_uri('/home/marcel/my_webdumps/www.fake.fak__|_NOPATH_(http).html.gz'))
+  end
+
+  def test_pn_relative
+    assert_equal('http://www.fake.fak',@up.pathname_to_uri('my_webdumps/www.fake.fak__|_NOPATH_(http).html.gz'))
+  end
+
+  def test_pn_malformed
+    assert_equal(nil,@up.pathname_to_uri('my_webdumps/www.fake.fak__|_NOPATH_(http)html.gz'), "No dot after last )")
+    assert_equal(nil,@up.pathname_to_uri('my_webdumps/www.fake.fak__|_NOPATH_(http.html.gz'), "No clossing )")
+    assert_equal(nil,@up.pathname_to_uri('my_webdumps/www.fake.fak__|_NOPATH_http).html.gz'), "No opening (")
+    assert_equal(nil,@up.pathname_to_uri('my_webdumps/__|_NOPATH_(http).html.gz'), "No host")
+    assert_equal(nil,@up.pathname_to_uri('my_webdumps/www.fake.fak__|_NOPATH_().html.gz'), "No scheme")
+  end
+
+end

data/uri_pathname.gemspec

@@ -0,0 +1,52 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "uri_pathname"
+  s.version = "0.0.0.pre2"
+
+  s.required_rubygems_version = Gem::Requirement.new("> 1.3.1") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Marcel Massana"]
+  s.date = "2011-08-30"
+  s.description = "Simple converter between URIs and Pathnames. It creates valid, unique and readable filenames from URIs and viceversa. It can be used to name files while saving data from websites and conversely, read files assigned to URIs while, for instance, simulating or stubbing web accesses by means of reading files"
+  s.email = "xaxaupua@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "examples/simple_examples.rb",
+     "examples/using_fakeweb.rb",
+     "lib/uri_pathname.rb",
+     "lib/uri_pathname/version.rb",
+     "test/test_uri_pathname.rb",
+     "uri_pathname.gemspec"
+  ]
+  s.homepage = "http://github.com/syborg/uri_pathname"
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.10"
+  s.summary = "Simple converter between URIs and Pathnames"
+  s.test_files = [
+    "test/test_uri_pathname.rb",
+     "examples/simple_examples.rb",
+     "examples/using_fakeweb.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification 
+name: uri_pathname
+version: !ruby/object:Gem::Version 
+  hash: -223651667
+  prerelease: 6
+  segments: 
+  - 0
+  - 0
+  - 0
+  - pre
+  - 2
+  version: 0.0.0.pre2
+platform: ruby
+authors: 
+- Marcel Massana
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-08-30 00:00:00 Z
+dependencies: []
+
+description: Simple converter between URIs and Pathnames. It creates valid, unique and readable filenames from URIs and viceversa. It can be used to name files while saving data from websites and conversely, read files assigned to URIs while, for instance, simulating or stubbing web accesses by means of reading files
+email: xaxaupua@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- README.rdoc
+- Rakefile
+- examples/simple_examples.rb
+- examples/using_fakeweb.rb
+- lib/uri_pathname.rb
+- lib/uri_pathname/version.rb
+- test/test_uri_pathname.rb
+- uri_pathname.gemspec
+homepage: http://github.com/syborg/uri_pathname
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      hash: 25
+      segments: 
+      - 1
+      - 3
+      - 1
+      version: 1.3.1
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Simple converter between URIs and Pathnames
+test_files: 
+- test/test_uri_pathname.rb
+- examples/simple_examples.rb
+- examples/using_fakeweb.rb