shredder 2.0.200126 → 3.1.221230

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 498eeb86b0aea1ba926ec9c2dd168d41ef4467dd64ff79e7e712f3141aec4e02
-  data.tar.gz: 654802da4b46624cc48f87ca2d6aa949ba451fade334c6ce77a5c7836465938d
+  metadata.gz: 2ba5d85280357dd18d03bad08517e9c7d4b7ef3e914c6939f758cfb066b0f9fd
+  data.tar.gz: b52e79f345d49b690850add5a60a9c22d72f9b0c0156f51dd421b96902813599
 SHA512:
-  metadata.gz: 52830fd82dd9711003bd78e039df4467e66b95b013ca622c28103e65265dbe8b02841f886008db00b66508e2e34a47eb8f586c398b11fecf41e2ed5bcc6274c2
-  data.tar.gz: 766b712345d5efa6783a730d4f9afb4a00fe48e40a7f805a65252c7075edf1bad5f6cb750ab388f842e4accd2e58bb26612d6ed1b6d43eb85f57dbcdb9f5d929
+  metadata.gz: 2d1267dc8c07c547304af86c273379f498c4ea033878cc244d0d02d8946d720e6d2592acd768288f885ca31830685cd93ed037ad4d4d349a9c9e36bef4b07999
+  data.tar.gz: 2f16d4adf30f708116eb5875435b650b6aa9e76a6afcbae0768a24c5abf6e527fe61dd62bf7ce3a4deb35364c022bf8c1c1e7e0559a258087d965c1ee08562e3

data/README.md

@@ -1,6 +1,6 @@
-# shredder
+# Shredder
 
-* [VERSION 2.0.200126](https://github.com/carlosjhr64/shredder/releases)
+* [VERSION 3.1.221230](https://github.com/carlosjhr64/shredder/releases)
 * [github](https://github.com/carlosjhr64/shredder)
 * [rubygems](https://rubygems.org/gems/shredder)
 
@@ -8,89 +8,89 @@
 
 Shred a file into file fragments, and join fragments back into a restored file.
 
+## INSTALL:
+```console
+$ gem install shredder
+```
 ## HELP:
-
-    $ Usage:
-    $   shredder shred [:options+] <shreds=FILENAME>+
-    $   shredder sew [:options+] <shreds=FILENAME>+
-    $ Options:
-    $   --n=INTEGER 	Number of shreds
-    $   --passphrase	Relay passphrase from stding to stdout
-    $ Types:
-    $   FILENAME   /^[[:print:]]+$/
-    $   INTEGER    /^[2-9]d*$/
-    $ # Examples:
-    $ #   shredder shred file.1 file.2 < file.txt
-    $ #   shredder shred --n=2 file < file.txt
-    $ #   shredder sew file.1 file.2 > file.txt
-    $ #   shredder shred --n=2 file > file.txt
-
-## SYNOPSIS
-
-### Library:
-
-    require 'shredder'
-
+```console
+$ shredder --help
+Usage:
+  shredder shred [:options+] <shreds=FILENAME>+
+  shredder sew [:options+] <shreds=FILENAME>+
+Options:
+  --n=INTEGER 	 Number of shreds
+Types:
+  FILENAME   /^[[:print:]]+$/
+  INTEGER    /^[2-9]\d*$/
+# Examples:
+#   shredder shred file.1 file.2 < file.txt
+#   shredder shred --n=2 file < file.txt
+#   shredder sew file.1 file.2 > file.txt
+#   shredder shred --n=2 file > file.txt
+```
+## SYNOPSIS:
+
+### Library
+```ruby
+require 'shredder'
+```
 #### Shredder::Streams
+```ruby
+require 'stringio'
 
-    require 'stringio'
-
-    sewn = StringIO.new("This is a test String: 1, 2, 3.")
-    sewn.string.length #=> 31
-    shreds = [StringIO.new, StringIO.new]
+sewn = StringIO.new("This is a test String: 1, 2, 3.")
+sewn.string.length #=> 31
+shreds = [StringIO.new, StringIO.new]
 
-    shredder = Shredder::Streams.new(sewn, shreds)
-    shredder.shred #=> 31
+shredder = Shredder::Streams.new(sewn, shreds)
+shredder.shred #=> 31
 
-    shreds[0].string
-    #=> "T\u0001S\u001AAT\u0016T'\e\t\u001A\u001D\u0012\f\u001D"
-    shreds[0].string.length #=> 16
+shreds[0].string
+#=> "T\u0001S\u001AAT\u0016T'\e\t\u001A\u001D\u0012\f\u001D"
+shreds[0].string.length #=> 16
 
-    shreds[1].string
-    #=> "<\u001AISA\u0011\as\u0006\a]\u0011\f\u001E\u0013"
-    shreds[1].string.length #=> 15
+shreds[1].string
+#=> "<\u001AISA\u0011\as\u0006\a]\u0011\f\u001E\u0013"
+shreds[1].string.length #=> 15
 
-    restored = StringIO.new
-    shreds.each{|_|_.rewind}
+restored = StringIO.new
+shreds.each{|_|_.rewind}
 
-    shredder = Shredder::Streams.new(restored, shreds)
-    shredder.sew #=> 31
-
-    restored.string #=> "This is a test String: 1, 2, 3."
+shredder = Shredder::Streams.new(restored, shreds)
+shredder.sew #=> 31
 
+restored.string #=> "This is a test String: 1, 2, 3."
+```
 #### Shredder::Files
-
-    sewn = './tmp/sewn.txt'
-    shreds = './tmp/shreds'
-    restored  = './tmp/restored.txt'
-
-    File.read(sewn).chomp #=> "This is a test file: 1, 2, 3."
-    File.size(sewn) #=> 30
-
-    shredder = Shredder::Files.new(sewn, shreds, 3)
-    shredder.shreds
-    #=> ["./tmp/shreds.1", "./tmp/shreds.2", "./tmp/shreds.3"]
-    shredder.shred #=> 30
-
-    File.read(shreds+'.1') #=> "T\u001A\u001AA\u0016F\t\u0011\u0012\u0013"
-    File.read(shreds+'.2') #=> "<SST\a\u000F_\u001D\u001E\u001D"
-    File.read(shreds+'.3') #=> "\u0001IA\u0011T\u0005\u001A\f\f$"
-    File.size(shreds+'.3') #=> 10
-
-    shredder = Shredder::Files.new(restored, shreds, 3)
-    shredder.sewn #=> "./tmp/restored.txt"
-    shredder.sew #=> 30
-    File.read(restored).chomp #=> "This is a test file: 1, 2, 3."
-
-## INSTALL:
-
-    $ gem install shredder
-
+```ruby
+sewn = './test/sewn.txt'
+shreds = './tmp/shreds'
+restored  = './tmp/restored.txt'
+
+File.read(sewn).chomp #=> "This is a test file: 1, 2, 3."
+File.size(sewn) #=> 30
+
+shredder = Shredder::Files.new(sewn, shreds, 3)
+shredder.shreds
+#=> ["./tmp/shreds.1", "./tmp/shreds.2", "./tmp/shreds.3"]
+shredder.shred #=> 30
+
+File.read(shreds+'.1') #=> "T\u001A\u001AA\u0016F\t\u0011\u0012\u0013"
+File.read(shreds+'.2') #=> "<SST\a\u000F_\u001D\u001E\u001D"
+File.read(shreds+'.3') #=> "\u0001IA\u0011T\u0005\u001A\f\f$"
+File.size(shreds+'.3') #=> 10
+
+shredder = Shredder::Files.new(restored, shreds, 3)
+shredder.sewn #=> "./tmp/restored.txt"
+shredder.sew #=> 30
+File.read(restored).chomp #=> "This is a test file: 1, 2, 3."
+```
 ## LICENSE:
 
 (The MIT License)
 
-Copyright (c) 2020 CarlosJHR64
+Copyright (c) 2022 CarlosJHR64
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the
@@ -110,4 +110,3 @@ 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/bin/shredder

@@ -1,16 +1,16 @@
 #!/usr/bin/env ruby
 require 'help_parser'
+require 'shredder'
 
-OPTIONS = HelpParser['2.0.200126', <<HELP]
+OPTIONS = HelpParser[Shredder::VERSION, <<HELP]
 Usage:
   shredder shred [:options+] <shreds=FILENAME>+
   shredder sew [:options+] <shreds=FILENAME>+
 Options:
-  --n=INTEGER \tNumber of shreds
-  --passphrase\tRelay passphrase from stding to stdout
+  --n=INTEGER \t Number of shreds
 Types:
   FILENAME   /^[[:print:]]+$/
-  INTEGER    /^[2-9]\d*$/
+  INTEGER    /^[2-9]\\d*$/
 # Examples:
 #   shredder shred file.1 file.2 < file.txt
 #   shredder shred --n=2 file < file.txt
@@ -35,10 +35,6 @@ unless count > 1
   exit 64
 end
 
-require 'shredder/shredder'
-require 'shredder/streams'
-require 'shredder/stdio'
-
 shredder = Shredder::StdIO.new(shreds, count)
 case OPTIONS[1]
 when 'shred'

data/lib/shredder/files.rb

@@ -12,11 +12,11 @@ module Shredder
       reader = writers = count = nil
       begin
         reader  = File.open(@sewn, 'r')
-        writers = @shreds.map{|shred| File.open(shred, 'wb')}
+        writers = @shreds.map{File.open _1, 'wb'}
         count   = Streams.new(reader, writers).shred(limit: limit)
       ensure
-        writers.each{|writer| writer.close}  if writers
-        reader.close                         if reader
+        writers.each{_1.close}  if writers
+        reader.close            if reader
       end
       return count
     end
@@ -25,11 +25,11 @@ module Shredder
       writer = readers = count = nil
       begin
         writer  = File.open(@sewn, 'wb')
-        readers = @shreds.map{|shred| File.open(shred, 'r')}
+        readers = @shreds.map{File.open(_1, 'r')}
         count   = Streams.new(writer, readers).sew(limit: limit)
       ensure
-        writer.close                          if writer
-        readers.each{|reader| reader.close}   if readers
+        writer.close            if writer
+        readers.each{_1.close}  if readers
       end
       return count
     end

data/lib/shredder/shredder.rb

@@ -3,11 +3,11 @@ module Shredder
 
   # note that these are streams
   def shred(sewn=(@sewn or $stdin), shreds=@shreds,
-            writers: shreds, reader: sewn, limit: 0)
-    shreds,xor,count = writers.length,0,0
+            writers: shreds, reader: sewn, limit: 0, xor: 0)
+    shreds,count = writers.length,0
     while byte = reader.getbyte do
       writers[count%shreds].putc(xor^(xor=byte))
-      count += 1 # not that 0 is skipped
+      count += 1 # note that 0 is skipped
       break if count == limit
     end
     return count
@@ -15,8 +15,8 @@ module Shredder
 
   # note that these are streams
   def sew(shreds=@shreds, sewn=(@sewn or $stdout),
-          readers: shreds, writer: sewn, limit: 0)
-    shreds,xor,count = readers.length,0,0
+          readers: shreds, writer: sewn, limit: 0, xor: 0)
+    shreds,count = readers.length,0
     while byte = readers[count%shreds].getbyte do
       writer.putc(xor=(byte^xor))
       count += 1 # note that 0 is skipped
@@ -25,7 +25,7 @@ module Shredder
     return count
   end
 
-  def shred_files(b, m=2, basename: b, n: m)
+  def shred_files(b=nil, m=2, basename: b, n: m)
     case basename
     when Array
       basename

data/lib/shredder/stdio.rb

@@ -2,17 +2,17 @@ module Shredder
   class StdIO
     include Shredder
     # this one takes shred filenames and uses $stdin or $stdout appropriately.
-    def initialize(*args)
-      @shreds = shred_files(*args)
+    def initialize(...)
+      @shreds = shred_files(...)
     end
 
     def shred(limit=0)
       writers = count = nil
       begin
-        writers = @shreds.map{|shred| File.open(shred, 'wb')}
+        writers = @shreds.map{File.open _1, 'wb'}
         count   = Streams.new($stdin, writers).shred(limit: limit)
       ensure
-        writers.each{|writer| writer.close}  if writers
+        writers.each{_1.close}  if writers
       end
       return count
     end
@@ -20,10 +20,10 @@ module Shredder
     def sew(limit=0)
       readers = count = nil
       begin
-        readers = @shreds.map{|shred| File.open(shred, 'r')}
+        readers = @shreds.map{File.open _1, 'r'}
         count   = Streams.new($stdout, readers).sew(limit: limit)
       ensure
-        readers.each{|reader| reader.close}  if readers
+        readers.each{_1.close}  if readers
       end
       return count
     end

data/lib/shredder.rb

@@ -1,9 +1,9 @@
 module Shredder
-  VERSION = '2.0.200126'
+  VERSION = '3.1.221230'
+  require 'shredder/shredder'
+  autoload :Streams, 'shredder/streams'
+  autoload :StdIO,   'shredder/stdio'
+  autoload :Files,   'shredder/files'
 end
-require 'shredder/shredder'
-require 'shredder/streams'
-require 'shredder/stdio'
-require 'shredder/files'
 # Requires:
 #`ruby`

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: shredder
 version: !ruby/object:Gem::Version
-  version: 2.0.200126
+  version: 3.1.221230
 platform: ruby
 authors:
-- carlosjhr64
+- CarlosJHR64
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-01-26 00:00:00.000000000 Z
+date: 2022-12-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: help_parser
@@ -16,20 +16,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.5'
+        version: '8.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 6.5.0
+        version: 8.1.221206
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.5'
+        version: '8.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 6.5.0
+        version: 8.1.221206
 description: 'Shred a file into file fragments, and join fragments back into a restored
   file.
 
@@ -66,8 +66,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements:
-- 'ruby: ruby 2.7.0p0 (2019-12-25 revision 647ee6f091) [x86_64-linux]'
-rubygems_version: 3.1.2
+- 'ruby: ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [aarch64-linux]'
+rubygems_version: 3.3.7
 signing_key: 
 specification_version: 4
 summary: Shred a file into file fragments, and join fragments back into a restored