ipfs-api 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f5f308798c9180262f9aa758b6010b910142a0d9
+  data.tar.gz: 13fde3fde504683f14df8e5d891d5291ac3624ba
+SHA512:
+  metadata.gz: 9932b1d74862af972ded69d873a42b719b3be8dbbd8cc2977106e746b87282d0eb84efa97f9e288b60e13ef04290b1d42eead4cdaf4f88b072b88420e7a264c6
+  data.tar.gz: e0ddc8dd3188cdce71cb4f64f738f71fc33f78d92521b03c154d6b861d427bffc77230cfa77f42111bf5154d21a803635321e496a0dbaad12b66f186851bedc9

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (C) 2015 Holger Joest <holger(at)joest.org>
+
+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.md

@@ -0,0 +1,59 @@
+# Overview
+
+IPFS4R is a client library to access the [Interplanetary Filesystem (IPFS)](https://ipfs.io) from Ruby.
+
+You can find more examples in the
+[examples directory](https://github.com/hjoest/ruby-ipfs-api/tree/master/examples).
+
+## Installation
+
+Use ``gem`` to install it
+
+```bash
+gem install ipfs-api
+```
+
+or simply add this line to your ``Gemfile``
+
+```ruby
+gem 'ipfs-api', '~> 0.1.0'
+```
+
+## Basic examples
+
+This example will add a directory to *IPFS*. The directory ``data``
+must exist or otherwise an ``Errno::ENOENT`` error will be raised.
+
+```ruby
+require 'ipfs-api'
+
+ipfs = IPFS::Connection.new
+ipfs.add Dir.new('data')
+```
+
+## Advanced
+
+Dynamically add folders and files to *IPFS*, without creating them
+on the local file system:
+
+```ruby
+require 'ipfs-api'
+
+ipfs = IPFS::Connection.new
+folder = IPFS::Upload.folder('test') do |test|
+  test.add_file('hello.txt') do |fd|
+    fd.write 'Hello'
+  end
+  test.add_file('world.txt') do |fd|
+    fd.write 'World'
+  end
+end
+ipfs.add folder do |node|
+  # display each uploaded node:
+  print "#{node.name}: #{node.hash}\n" if node.finished?
+end
+```
+
+## License
+
+This library is distributed under the [MIT License](https://github.com/hjoest/ruby-ipfs-api/tree/master/LICENSE).

data/Rakefile

@@ -0,0 +1,103 @@
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+require 'rdoc/task'
+require 'rubygems/package_task'
+
+$:.unshift 'lib'
+require 'ipfs-api/version'
+
+PKG_NAME = 'ipfs-api'
+PKG_VERSION = IPFS::VERSION
+AUTHORS = ['Holger Joest']
+EMAIL = 'holger@joest.org'
+HOMEPAGE = 'http://ruby-ipfs-api.github.io'
+SUMMARY = 'Interplanetary File System for Ruby'
+DESCRIPTION = 'This is a client library to access the IPFS from Ruby'
+RDOC_OPTIONS = [ '--title', SUMMARY, '--quiet', '--main', 'lib/ipfs-api.rb' ]
+BUILD_FILES = [ 'Rakefile', 'ipfs-api.gemspec' ].sort
+RDOC_FILES = [ 'README.md', 'LICENSE' ].sort
+PKG_FILES = (BUILD_FILES + RDOC_FILES + Dir['{lib,test,examples}/**/*']).reject { |f| File.directory?(f) }.sort
+
+task :default => [:test]
+
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.test_files = ['test/test_*.rb']
+end
+
+RDoc::Task.new do |rd|
+  rd.rdoc_dir = 'rdoc'
+  rd.rdoc_files.include(RDOC_FILES, "lib/**/*.rb")
+  rd.options = RDOC_OPTIONS
+end
+
+CLEAN.include [ "*.gem*", "pkg", "rdoc" ]
+
+spec = Gem::Specification.new do |s|
+  s.name = PKG_NAME
+  s.version = PKG_VERSION
+  s.authors = AUTHORS
+  s.email = EMAIL
+  s.homepage = HOMEPAGE
+  s.rubyforge_project = PKG_NAME
+  s.summary = SUMMARY
+  s.description = DESCRIPTION
+  s.platform = Gem::Platform::RUBY
+  s.licenses = ["MIT"]
+  s.require_path = 'lib'
+  s.executables = []
+  s.files = PKG_FILES
+  s.test_files = []
+  s.has_rdoc = true
+  s.extra_rdoc_files = RDOC_FILES
+  s.rdoc_options = RDOC_OPTIONS
+  s.required_ruby_version = ">= 1.9.3"
+end
+
+# also keep the gemspec up to date each time we package a tarball or gem
+task :package => ['gem:update_gemspec']
+task :gem => ['gem:update_gemspec']
+
+Gem::PackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+  pkg.need_tar = true
+  pkg.need_zip = true
+end
+
+namespace :gem do
+
+  # thanks to the Merb project for this code.
+  desc "Update Github Gemspec"
+  task :update_gemspec do
+    skip_fields = %w(new_platform original_platform date cache_dir cache_file loaded)
+
+    result = "# WARNING : RAKE AUTO-GENERATED FILE.  DO NOT MANUALLY EDIT!\n"
+    result << "# RUN : 'rake gem:update_gemspec'\n\n"
+    result << "Gem::Specification.new do |s|\n"
+    spec.instance_variables.sort.each do |ivar|
+      value = spec.instance_variable_get(ivar)
+      name  = ivar.to_s.split("@").last
+      next if skip_fields.include?(name) || value.nil? || value == "" || (value.respond_to?(:empty?) && value.empty?)
+      if name == "dependencies"
+        value.each do |d|
+          dep, *ver = d.to_s.split(" ")
+          result <<  "  s.add_dependency #{dep.inspect}, #{ver.join(" ").inspect.gsub(/[()]/, "")}\n"
+        end
+      else
+        case value
+        when Array
+          value =  name != "files" ? value.inspect : value.sort.uniq.inspect.split(",").join(",\n")
+        when String, Fixnum, true, false
+          value = value.inspect
+        else
+          value = value.to_s.inspect
+        end
+        result << "  s.#{name} = #{value}\n"
+      end
+    end
+    result << "end"
+    File.open(File.join(File.dirname(__FILE__), "#{spec.name}.gemspec"), "w"){|f| f << result}
+  end
+
+end

data/examples/basic.rb

@@ -0,0 +1,4 @@
+require 'ipfs-api'
+
+ipfs = IPFS::Connection.new
+ipfs.add Dir.new('data')

data/examples/data/hello.txt

@@ -0,0 +1 @@
+Hello World!

data/examples/upload.rb

@@ -0,0 +1,15 @@
+require 'ipfs-api'
+
+ipfs = IPFS::Connection.new
+folder = IPFS::Upload.folder('test') do |test|
+  test.add_file('hello.txt') do |fd|
+    fd.write 'Hello'
+  end
+  test.add_file('world.txt') do |fd|
+    fd.write 'World'
+  end
+end
+ipfs.add folder do |node|
+  # display each uploaded node:
+  print "#{node.name}: #{node.hash}\n" if node.finished?
+end

data/ipfs-api.gemspec

@@ -0,0 +1,48 @@
+# WARNING : RAKE AUTO-GENERATED FILE.  DO NOT MANUALLY EDIT!
+# RUN : 'rake gem:update_gemspec'
+
+Gem::Specification.new do |s|
+  s.activated = false
+  s.authors = ["Holger Joest"]
+  s.bindir = "bin"
+  s.description = "This is a client library to access the IPFS from Ruby"
+  s.email = "holger@joest.org"
+  s.extra_rdoc_files = ["LICENSE", "README.md"]
+  s.files = ["LICENSE",
+ "README.md",
+ "Rakefile",
+ "examples/basic.rb",
+ "examples/data/hello.txt",
+ "examples/upload.rb",
+ "ipfs-api.gemspec",
+ "lib/ipfs-api.rb",
+ "lib/ipfs-api/connection.rb",
+ "lib/ipfs-api/io.rb",
+ "lib/ipfs-api/upload.rb",
+ "lib/ipfs-api/version.rb",
+ "test/common.rb",
+ "test/samples.rb",
+ "test/test_cmd_add.rb",
+ "test/test_cmd_cat.rb",
+ "test/test_cmd_get.rb",
+ "test/test_cmd_id.rb",
+ "test/test_cmd_ls.rb",
+ "test/test_cmd_name.rb",
+ "test/test_io.rb",
+ "test/test_upload.rb"]
+  s.full_name = "ipfs-api-0.1.0"
+  s.has_rdoc = true
+  s.homepage = "http://ruby-ipfs-api.github.io"
+  s.licenses = ["MIT"]
+  s.name = "ipfs-api"
+  s.platform = "ruby"
+  s.rdoc_options = ["--title", "Interplanetary File System for Ruby", "--quiet", "--main", "lib/ipfs-api.rb"]
+  s.require_paths = ["lib"]
+  s.required_ruby_version = ">= 1.9.3"
+  s.required_rubygems_version = ">= 0"
+  s.rubyforge_project = "ipfs-api"
+  s.rubygems_version = "2.4.8"
+  s.specification_version = 4
+  s.summary = "Interplanetary File System for Ruby"
+  s.version = "0.1.0"
+end

data/lib/ipfs-api.rb

@@ -0,0 +1,12 @@
+# =IPFS4R - Interplanetary Filesystem Library for Ruby
+# License:: MIT (see the LICENSE file)
+# Website:: https://ruby-ipfs-api.github.io
+#
+# ==Introduction
+#
+# IPFS4R is an IPFS[https://ipfs.io] library for Ruby.
+#
+require 'ipfs-api/version'
+require 'ipfs-api/io'
+require 'ipfs-api/upload'
+require 'ipfs-api/connection'

data/lib/ipfs-api/connection.rb

@@ -0,0 +1,150 @@
+require 'cgi'
+require 'json'
+require 'net/http'
+
+module IPFS
+
+  class Connection
+
+    def initialize base_url = 'http://127.0.0.1:5001'
+      @base_url = base_url
+    end
+
+    def add nodes, &block
+      boundaries = [ generate_boundary ]
+      headers = {
+        'Content-Disposition' => 'form-data: name="files"',
+        'Content-Type' => "multipart/form-data; boundary=#{boundaries[0]}"
+      }
+      walker = Upload::TreeWalker.depth_first(nodes)
+      node_map = {}
+      stream = IO::ReadFromWriterIO.new do |buf|
+        next if walker.nil?
+        begin
+          node, depth = walker.next
+          node_map[node.path] = node
+        rescue StopIteration
+          depth = -1
+          walker = nil
+        end
+        while boundaries.size > depth+1 && boundary = boundaries.shift
+          buf << %Q{\
+--#{boundary}--\r\n\
+\r\n\
+\r\n\
+}
+        end
+        next if walker.nil?
+        if node.folder?
+          boundaries.unshift generate_boundary
+          buf << %Q{\
+--#{boundaries[1]}\r\n\
+Content-Disposition: form-data; name="file"; filename="#{node.path}"\r\n\
+Content-Type: multipart/mixed; boundary=#{boundaries[0]}\r\n\
+\r\n\
+\r\n\
+}
+        elsif node.file?
+          buf << %Q{\
+--#{boundaries[0]}\r\n\
+Content-Disposition: file; filename="#{node.path}"\r\n\
+Content-Type: application/octet-stream\r\n\
+\r\n\
+#{node.content}\r\n\
+}
+        else
+          raise "Unknown node type: #{node}"
+        end
+      end
+      nodes = []
+      post("add?encoding=json&r=true&progress=true", stream, headers) do |chunk|
+        next if chunk.empty?
+        upload = JSON.parse(chunk)
+        path, bytes, hash = ['Name', 'Bytes', 'Hash'].map { |p| upload[p] }
+        node = node_map[path]
+        node.bytes = bytes if bytes
+        node.hash = hash if hash
+        if block_given?
+          block.call(node)
+        elsif hash
+          nodes << node
+        end
+      end
+      block_given? ? nil : nodes
+    end
+
+    def cat path
+      result = ''
+      post("cat?arg=#{CGI.escape(path)}") do |chunk|
+        result << chunk
+      end
+      result
+    end
+
+    # FIXME: provides only raw response yet
+    def get path
+      result = ''
+      post("get?arg=#{CGI.escape(path)}") do |chunk|
+        result << chunk
+      end
+      result
+    end
+
+    def id
+      JSON.parse(post('id').body)['ID']
+    end
+
+    def ls path
+      JSON.parse(post("ls?arg=#{CGI.escape(path)}").body)
+    end
+
+    def name
+      NameCommand.new(self)
+    end
+
+    private
+    def post command, stream = nil, headers = {}, params = {}, &block # :nodoc:
+      uri = URI.parse("#{@base_url}/api/v0/#{command}")
+      http = Net::HTTP.new(uri.host, uri.port)
+#http.set_debug_output $stderr
+      headers['User-Agent'] = "ruby-ipfs-api/#{VERSION}/"
+      headers['Transfer-Encoding'] = 'chunked'
+      request = Net::HTTP::Post.new(uri.request_uri, headers)
+      if stream
+        request.body_stream = stream
+      else
+        params['encoding'] = 'json'
+        params['stream-channels'] = 'true'
+        request.set_form_data(params)
+      end
+      http.request(request) do |response|
+        raise "Request failed: #{response.body}" if !response.kind_of?(Net::HTTPOK)
+        if block
+          response.read_body do |chunk|
+            block.call chunk
+          end
+        end
+      end
+    end
+
+    def generate_boundary # :nodoc:
+      (1..60).map { rand(16).to_s(16) }.join
+    end
+
+    class NameCommand # :nodoc:
+
+      def initialize connection
+        @connection = connection
+      end
+
+      def resolve
+        @connection.instance_exec(self) do
+          JSON.parse(post('name/resolve').body)['Path']
+        end
+      end
+
+    end
+
+  end
+
+end

data/lib/ipfs-api/io.rb

@@ -0,0 +1,39 @@
+require 'stringio'
+
+module IPFS; end
+module IPFS::IO # :nodoc:
+
+  class ReadFromWriterIO # :nodoc:
+
+    def initialize &block
+      @block = block
+      @stream = StringIO.new
+      fetch_data
+    end
+
+    def read length = nil, outbuf = ''
+      return nil if @stream.size == 0
+      outbuf.slice!(length..-1) if !length.nil?
+      q = 0
+      while @stream.size > 0
+        s = @stream.size - @p
+        s = [length - q, s].min if !length.nil?
+        outbuf[q, s] = @stream.string[@p, s]
+        @p += s
+        q += s
+        break if q == length
+        fetch_data if @stream.size == @p
+      end
+      outbuf
+    end
+
+    private
+      def fetch_data
+        @p = 0
+        @stream.string = ""
+        @block.call @stream if not @stream.closed?
+      end
+
+  end
+
+end

data/lib/ipfs-api/upload.rb

@@ -0,0 +1,182 @@
+module IPFS; end
+module IPFS::Upload
+
+  ##
+  # Define a file with the given name.
+  #    file = IPFS::Upload.file('hello.txt') do |fd|
+  #      fd.write 'Hello'
+  #    end
+  #    ipfs.add file do |node|
+  #      print "Successfully uploaded #{node.path}\n" if node.finished?
+  #    end
+  def file name, content = nil, &block
+    FileNode.new(name, content, &block)
+  end
+
+  ##
+  # Define a folder with the given *name*.
+  #    folder = IPFS::Upload.folder('test') do |test|
+  #      test.add_file('hello.txt') do |fd|
+  #        fd.write 'Hello'
+  #      end
+  #    end
+  #    ipfs.add folder do |node|
+  #      print "Successfully uploaded #{node.path}\n" if node.finished?
+  #    end
+  def folder name, &block
+    FolderNode.new(name, &block)
+  end
+
+  module_function :file, :folder
+
+  private
+
+    class Node # :nodoc:
+
+      attr_accessor :name, :parent, :bytes, :hash
+
+      def initialize name, parent = nil
+        raise "Name #{} must be a String" if not name.is_a?(String)
+        @name = name
+        @parent = parent
+      end
+
+      def path
+        @parent.nil? ? "/#{@name}" : "#{@parent.path}/#{@name}"
+      end
+
+      def file?
+        false
+      end
+
+      def folder?
+        false
+      end
+
+      def to_s
+        inspect
+      end
+
+      def finished?
+        !@hash.nil?
+      end
+
+      def inspect
+        s = "<#{@name}"
+        s << ":#{@bytes}" if @bytes
+        s << ":#{@hash}" if @hash
+        s << '>'
+      end
+
+    end
+
+    class FileNode < Node # :nodoc:
+
+      attr_reader :content
+
+      def initialize name, parent = nil, content = nil
+        super(name, parent)
+        if block_given?
+          @content = ''
+          yield self
+        else
+          @content = content.to_s
+        end
+      end
+
+      def write s
+        @content << s
+      end
+
+      def file?
+        true
+      end
+
+      def inspect
+        "file:#{super}"
+      end
+
+    end
+
+    class FolderNode < Node # :nodoc:
+
+      attr_accessor :children
+
+      def initialize name, parent = nil, &block
+        super(name, parent)
+        @children = []
+        block.call(self) if block_given?
+      end
+
+      def folder?
+        true
+      end
+
+      def add_node node
+        node.parent = self
+        (@children << node).last
+      end
+
+      def add_file file, content = nil, &block
+        (@children << FileNode.new(file, self, content, &block)).last
+      end
+
+      def add_folder folder, &block
+        (@children << FolderNode.new(folder, self, &block)).last
+      end
+
+      def inspect
+        "folder:#{super}#{children}"
+      end
+
+    end
+
+    module TreeWalker # :nodoc:
+
+      def depth_first nodes
+        nodes = [ nodes ] if not nodes.is_a?(Array)
+        stack = [ [ nodes.shift, 0 ] ]
+        Enumerator.new do |yielder|
+          while not stack.empty?
+            node, depth = stack.pop
+            node = resolve_node(node)
+            next if not node
+            yielder << [ node, depth ]
+            if node.folder?
+              stack += node.children.reverse.map { |n| [ n, depth + 1 ] }
+            end
+            if stack.empty? and not nodes.empty?
+              stack << [ nodes.shift, 0 ]
+            end
+          end
+        end
+      end
+
+      def resolve_node node
+        if node.is_a?(Node)
+          node
+        elsif node.is_a?(Dir)
+          FolderNode.new(File.basename(node.path)) do |d|
+            node.each do |child|
+              if child != '.' and child != '..'
+                child_path = File.join(node.path, child)
+                if File.directory?(child_path)
+                  d.add_node resolve_node(Dir.new(child_path))
+                else
+                  d.add_node resolve_node(File.new(child_path))
+                end
+              end
+            end
+          end
+        elsif node.is_a?(File)
+          FileNode.new(File.basename(node.path)) do |d|
+            d.write File.read(node.path)
+          end
+        end
+      end
+
+      module_function :depth_first, :resolve_node
+
+    end
+
+end

data/lib/ipfs-api/version.rb

@@ -0,0 +1,4 @@
+module IPFS
+  VERSION = '0.1.0'
+end
+

data/test/common.rb

@@ -0,0 +1,4 @@
+require 'minitest/autorun'
+require 'byebug'
+
+$:.unshift File.expand_path('../../lib', __FILE__)

data/test/samples.rb

@@ -0,0 +1,84 @@
+require 'tmpdir'
+require 'test/common'
+require 'ipfs-api/upload'
+
+module Samples
+
+  include IPFS
+
+  def some_virtual_folders
+    fixture = [
+      Upload.folder('a1') { |a1|
+        a1.add_file('hello.txt') { |io|
+          io.write "Hello World!\n"
+        }
+        a1.add_file('foo.txt') { |io|
+          io.write "bar\n"
+        }
+      },
+      Upload.folder('a2') { |a2|
+        a2.add_file 'b1.txt', 'B1'
+        a2.add_folder('b2') { |b2|
+          b2.add_folder('c1') { |c1|
+            c1.add_file 'd1.txt', 'D1'
+          }
+        }
+        a2.add_file 'b3.txt', 'B3'
+      },
+      Upload.folder('a3') { |a3|
+        a3.add_folder('b1') { |b1|
+          b1.add_folder('c1') { |c1|
+            c1.add_folder('d1') { |d1|
+              d1.add_folder('e1') { |e1|
+                e1.add_file('thanks.txt') { |io|
+                  io.write 'This is the end.'
+                }
+              }
+            }
+          }
+        }
+      }
+    ]
+    expectation = {
+      '/a1' => 'QmcsmfcY8SQzNxJQYGZMHLXCkeTgxDBhASDPJyVEGi8Wrv',
+      '/a1/hello.txt' => 'QmfM2r8seH2GiRaC4esTjeraXEachRt8ZsSeGaWTPLyMoG',
+      '/a1/foo.txt' => 'QmTz3oc4gdpRMKP2sdGUPZTAGRngqjsi99BPoztyP53JMM',
+      '/a2' => 'QmcfeG6dVvXufGXzxe6cBHP3ZbFx15yRzh7DSg8W67soto',
+      '/a2/b1.txt' => 'QmSwyJZAaxRqo8v2itCErP8U4DKa3dkSu7qTpDF1qG64Vw',
+      '/a2/b2' => 'QmQZ7ek8ss65DQFbCxXgFBzZeyJA6ZYJ9SfrTWZDSSQ2jj',
+      '/a2/b2/c1' => 'QmU2K25J3hBJQeKuUTJeXpeCovev8Bp2m2FzFHU2ANznnE',
+      '/a2/b2/c1/d1.txt' => 'QmNPDoyE8HaJWj7Bb7p2h3usA2nmbmUCx2712jXK2nftxz',
+      '/a2/b3.txt' => 'QmdoSx7tA3ybphBXDR9TBNteYPHKKb8aySPLVStNkSaTy2',
+      '/a3' => 'QmeQ7BYviWZynBhhzMCJVZRv5izgCFBfkGMU8fJJtzUA3f',
+      '/a3/b1' => 'QmW7zVapNEqc7Gmhx6ZGkeNzgUMgcRxpjXkXSkWdoyUWd5',
+      '/a3/b1/c1' => 'QmfHyLbTMjfUeD95wCmNNf4h5kJo3D65tEERs54zbRbWvv',
+      '/a3/b1/c1/d1' => 'QmRMzLcUNFghRE9Cn62wBHThKJoS6ChjpgEmJwApJBPoVo',
+      '/a3/b1/c1/d1/e1' => 'QmdJWhD7iU2kW5wTWP2hXoworetabt3n5tEtfEUyBoXCTv',
+      '/a3/b1/c1/d1/e1/thanks.txt' => 'QmWu5tSQetrKPxhDff2AF8owzqcMreXdXqeVjr3LL4WyJX'
+    }
+    yield fixture, expectation
+  end
+  module_function :some_virtual_folders
+
+  def some_filesystem_folders
+    Dir.mktmpdir('ruby-ipfs-api-unit-test-') do |root|
+      a1 = File.join(root, 'a1')
+      Dir.mkdir(a1, 0755)
+      b1 = File.join(a1, 'b1')
+      Dir.mkdir(b1, 0755)
+      hello = File.join(b1, 'hello.txt')
+      File.open hello, 'w' do |fd|
+        fd.write "Hello World!\n"
+      end
+      fixture = [ Dir.new(a1) ]
+      expectation = {
+        '/a1'=>'QmedYJNEKn656faSHaMv5UFVkgfSzwYf9u4zsYoXqgvnch',
+        '/a1/b1' => 'QmSh4Xjoy16v6XmnREE1yCrPM1dnizZc2h6LfrqXsnbBV7',
+        '/a1/b1/hello.txt' => 'QmfM2r8seH2GiRaC4esTjeraXEachRt8ZsSeGaWTPLyMoG'
+      }
+      yield fixture, expectation
+    end
+  end
+  module_function :some_filesystem_folders
+
+end

data/test/test_cmd_add.rb

@@ -0,0 +1,40 @@
+$:.unshift File.expand_path('../..', __FILE__)
+
+require 'test/samples'
+require 'ipfs-api'
+
+include IPFS
+
+class CommandAddTest < Minitest::Test
+
+  def test_adding_some_filesystem_folders
+    ipfs = Connection.new
+    Samples.some_filesystem_folders do |fixture, expectation|
+      actual = ipfs.add(fixture)
+      assert_equal expectation, Hash[actual.map { |n| [ n.path, n.hash ] }]
+    end
+  end
+
+  def test_adding_some_filesystem_folders_with_block
+    ipfs = Connection.new
+    Samples.some_filesystem_folders do |fixture, expectation|
+      actual = {}
+      ipfs.add fixture do |node|
+        actual[node.path] = node.hash
+      end
+      assert_equal expectation, actual
+    end
+  end
+
+  def test_adding_some_virtual_folders
+    ipfs = Connection.new
+    Samples.some_virtual_folders do |fixture, expectation|
+      actual = {}
+      ipfs.add fixture do |node|
+        actual[node.path] = node.hash
+      end
+      assert_equal expectation, actual
+    end
+  end
+
+end

data/test/test_cmd_cat.rb

@@ -0,0 +1,19 @@
+$:.unshift File.expand_path('../..', __FILE__)
+
+require 'test/samples'
+require 'ipfs-api'
+
+include IPFS
+
+class CommandCatTest < Minitest::Test
+
+  def test_cat
+    ipfs = Connection.new
+    Samples.some_virtual_folders do |fixture, expectation|
+      ipfs.add fixture
+      actual = ipfs.cat('QmfM2r8seH2GiRaC4esTjeraXEachRt8ZsSeGaWTPLyMoG')
+      assert_equal "Hello World!\n", actual
+    end
+  end
+
+end

data/test/test_cmd_get.rb

@@ -0,0 +1,19 @@
+$:.unshift File.expand_path('../..', __FILE__)
+
+require 'test/samples'
+require 'ipfs-api'
+
+include IPFS
+
+class CommandGetTest < Minitest::Test
+
+  def test_get
+    ipfs = Connection.new
+    Samples.some_virtual_folders do |fixture, expectation|
+      ipfs.add fixture
+      # FIXME: provides only raw response yet
+      actual = ipfs.get('QmedYJNEKn656faSHaMv5UFVkgfSzwYf9u4zsYoXqgvnch')
+    end
+  end
+
+end

data/test/test_cmd_id.rb

@@ -0,0 +1,17 @@
+$:.unshift File.expand_path('../..', __FILE__)
+
+require 'test/common'
+require 'ipfs-api'
+
+include IPFS
+
+class CommandIdTest < Minitest::Test
+
+  def test_id
+    ipfs = Connection.new
+    id = ipfs.id
+    assert_equal 46, id.size
+    assert id.start_with?('Qm')
+  end
+
+end

data/test/test_cmd_ls.rb

@@ -0,0 +1,40 @@
+$:.unshift File.expand_path('../..', __FILE__)
+
+require 'test/samples'
+require 'ipfs-api'
+
+include IPFS
+
+class CommandLsTest < Minitest::Test
+
+  def test_ls
+    ipfs = Connection.new
+    Samples.some_virtual_folders do |fixture, expectation|
+      ipfs.add fixture
+      actual = ipfs.ls('QmcsmfcY8SQzNxJQYGZMHLXCkeTgxDBhASDPJyVEGi8Wrv')
+      expectation = {
+        'Objects' => [
+          {
+            'Hash' => 'QmcsmfcY8SQzNxJQYGZMHLXCkeTgxDBhASDPJyVEGi8Wrv',
+            'Links' => [
+              {
+                'Name' => 'foo.txt',
+                'Hash' => 'QmTz3oc4gdpRMKP2sdGUPZTAGRngqjsi99BPoztyP53JMM',
+                'Size' => 12,
+                'Type' => 2
+              },
+              {
+                'Name' => 'hello.txt',
+                'Hash' => 'QmfM2r8seH2GiRaC4esTjeraXEachRt8ZsSeGaWTPLyMoG',
+                'Size' => 21,
+                'Type' => 2
+              }
+            ]
+          }
+        ]
+      }
+      assert_equal expectation, actual
+    end
+  end
+
+end

data/test/test_cmd_name.rb

@@ -0,0 +1,16 @@
+$:.unshift File.expand_path('../..', __FILE__)
+
+require 'test/common'
+require 'ipfs-api'
+
+include IPFS
+
+class CommandNameTest < Minitest::Test
+
+  def test_name_resolve
+    ipfs = Connection.new
+    resolved = ipfs.name.resolve
+    assert resolved.start_with?('/ipfs/Qm')
+  end
+
+end

data/test/test_io.rb

@@ -0,0 +1,20 @@
+$:.unshift File.expand_path('../..', __FILE__)
+
+require 'test/samples'
+require 'ipfs-api/io'
+
+include IPFS::IO
+
+class ReadFromWriterIOTest < Minitest::Test
+
+  def test_read_write_io
+    msg = ('a'..'z').to_a.join
+    reader = ReadFromWriterIO.new do |writer|
+      writer << msg
+      writer.close
+    end
+    result = reader.read
+    assert_equal msg, result
+  end
+
+end

data/test/test_upload.rb

@@ -0,0 +1,20 @@
+$:.unshift File.expand_path('../..', __FILE__)
+
+require 'test/samples'
+require 'ipfs-api/upload'
+
+class NodeTest < Minitest::Test
+
+  include IPFS
+
+  def test_tree_walker
+    Samples.some_virtual_folders do |fixture, expectations|
+      walker = Upload::TreeWalker.depth_first(fixture)
+      actual = walker.to_a
+      assert_equal 15, actual.size
+      paths = actual.map { |item| item.first.path }
+      assert_equal expectations.map { |item| item.first }, paths
+    end
+  end
+
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification
+name: ipfs-api
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Holger Joest
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-10-10 00:00:00.000000000 Z
+dependencies: []
+description: This is a client library to access the IPFS from Ruby
+email: holger@joest.org
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE
+- README.md
+files:
+- LICENSE
+- README.md
+- Rakefile
+- examples/basic.rb
+- examples/data/hello.txt
+- examples/upload.rb
+- ipfs-api.gemspec
+- lib/ipfs-api.rb
+- lib/ipfs-api/connection.rb
+- lib/ipfs-api/io.rb
+- lib/ipfs-api/upload.rb
+- lib/ipfs-api/version.rb
+- test/common.rb
+- test/samples.rb
+- test/test_cmd_add.rb
+- test/test_cmd_cat.rb
+- test/test_cmd_get.rb
+- test/test_cmd_id.rb
+- test/test_cmd_ls.rb
+- test/test_cmd_name.rb
+- test/test_io.rb
+- test/test_upload.rb
+homepage: http://ruby-ipfs-api.github.io
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--title"
+- Interplanetary File System for Ruby
+- "--quiet"
+- "--main"
+- lib/ipfs-api.rb
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: ipfs-api
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: Interplanetary File System for Ruby
+test_files: []