shredder 0.0.0

data/README.txt

@@ -0,0 +1,27 @@
+### SYNOPSIS ###
+
+require 'shredder'
+
+# Shreds text.txt into test.f.1, test.f.2, test.f.3
+Shredder::Files.new('test.txt', ['test.f.1','test.f.2','test.f.3'] ).shred
+
+# Sews test.f.1, test.f.2, test.f.3 into restored.f.txt
+Shredder::Files.new('restored.f.txt', ['test.f.1','test.f.2','test.f.3'] ).sew
+
+# or #
+
+# shred streams #
+reader = File.open('test.txt','r')
+writers = []; ['test.s.1','test.s.2','test.s.3'].each{|writer| writers.push(File.open(writer,'wb'))}
+Shredder::Streams.new(reader,writers).shred
+reader.close
+writers.each{|writer| writer.close}
+
+# sew streams
+writer = File.open('restored.s.txt','wb')
+readers = []; ['test.s.1','test.s.2','test.s.3'].each{|writer| readers.push(File.open(writer,'r'))}
+Shredder::Streams.new(writer,readers).sew
+writer.close
+readers.each{|reader| reader.close}
+
+# Also available, Shredder.shred( writer, readers) and Shredder.sew( reader, writers )

data/lib/shredder.rb

@@ -0,0 +1,95 @@
+module Shredder
+  VERSION = '0.0.0'
+
+  # note that these are streams
+  def self.shred(reader,writers,limit=0)
+    shreds = writers.length
+    xor = count = 0
+    while byte = reader.getbyte do
+      writers[ count % shreds ].putc byte^xor
+      xor = byte
+      count += 1
+      # note: will not break if limit is zero
+      break if count == limit
+    end
+    return count
+  end
+
+  # note that these are streams
+  def self.sew(writer,readers,limit=0)
+    shreds = readers.length
+    xor = count = 0
+    while byte = readers[ count % shreds ].getbyte do
+      chr = byte^xor
+      xor = chr
+      writer.putc chr
+      count += 1
+      # note: will not break if limit is zero
+      break if count == limit
+    end
+    return count
+  end
+
+  class Streams
+    # this one takes streams
+    def initialize(sew,shreds,limit=0)
+      @sew = sew
+      @shreds = shreds
+      @limit = limit
+    end
+
+    def shred(limit=@limit)
+      Shredder.shred(@sew,@shreds,limit)
+    end
+
+    def sew(limit=@limit)
+      Shredder.sew(@sew,@shreds,limit)
+    end
+  end
+
+  class Files
+     # this one takes filenames
+    def initialize(sew,shreds,limit=0)
+      @sew = sew
+      @shreds = shreds
+      @limit = limit
+    end
+
+    def shred(limit=@limit)
+      reader = File.open(@sew,'r')
+      writers = []
+      @shreds.each{|shred| writers.push( File.open(shred,'wb') ) }
+
+      count = nil
+      begin
+        count = Shredder.shred( reader, writers, limit )
+      rescue Exception
+        raise $!
+      ensure
+        writers.each{|writer| writer.close}
+        reader.close
+       end
+
+      return count
+    end
+
+    def sew(limit=@limit)
+      writer = File.open(@sew,'wb')
+      readers = []
+      @shreds.each{|shred| readers.push( File.open(shred,'r') ) }
+
+      count = nil
+      begin
+        count = Shredder.sew( writer, readers, limit )
+      rescue Exception
+        raise $!
+      ensure
+        writer.close
+        readers.each{|reader| reader.close}
+      end
+
+      return count
+    end
+  end
+
+end

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification 
+name: shredder
+version: !ruby/object:Gem::Version 
+  hash: 31
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 0
+  version: 0.0.0
+platform: ruby
+authors: 
+- carlosjhr64@gmail.com
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-06-12 00:00:00 Z
+dependencies: []
+
+description: |
+  The idea is to disperse file shreds in separate depositories
+  such that no one depository has the entire file.
+  Note: These are not file segments, they're shreds.
+
+email: carlosjhr64@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- ./lib/shredder.rb
+- ./README.txt
+homepage: https://sites.google.com/site/carlosjhr64/rubygems/shredder
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+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: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.4
+signing_key: 
+specification_version: 3
+summary: Shred a file into file fragments, and join fragments back into a restored file.
+test_files: []
+