helpema 1.0.1 → 2.0.200124

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 58cbb6726a88d792e7e22a6a7795829531cf0137
-  data.tar.gz: '00592e63eb485bac3a87ba7e8d2fd3facdc0aa68'
+SHA256:
+  metadata.gz: 99e52f3d2144ddf05fe8d83ef1a3929a62c43bd68fb8c7db11d360dd2288fe5a
+  data.tar.gz: 636874ab3c6c109751825ec67fd08ae8aff7a18e7adf37b134f4c9ede3c6cc5f
 SHA512:
-  metadata.gz: 6da8d0dd4ac4b78c533b88c2bb21b2ea058a222a4698721abbff4e8f17ce1f2a61c73a4c2f90b80a42d50453ae0e7208b9a7136a384d824eeedc50feefdbad5c
-  data.tar.gz: 10758511542e2cf75e828160b14df8a1ebb9d3a5e63edd14f20835ec36610eee0daad663b10eca7d1f581d1f629974145d6a4d0b5da33c9fe2c59fd18d770c1a
+  metadata.gz: 2a22a1de5d55755b4b8481f73d9710cf8472c1e8ad5bcd73418147014432641b8d632085efeaf52d9758e536dce79b2d3b295f686ac172c525ea1fca59c3c9c1
+  data.tar.gz: a5e908afbed85d4812f2b9284d3535334c07ccdaf4c78799a0d32c103bac33ec99edb4b36e2f72321aa9c9bd7f37725b4b88a23b051051b88419c54304c49d83

data/README.md

@@ -0,0 +1,80 @@
+# helpema
+
+* [VERSION 2.0.200124](https://github.com/carlosjhr64/helpema/releases)
+* [github](https://github/carlosjhr64/helpema)
+* [rubygems](https://rubygems/gems/helpema)
+
+## DESCRIPTION:
+
+Meant to be an eclectic collection of useful single functions and wrappers.
+Wrappers: ssss-split, ssss-combine, zbarcam, youtube-dl -j.
+Funtions: requires("gemname version",...).
+
+More later.
+
+## SYNOPSIS:
+
+    require 'helpema'
+    include HELPEMA
+
+    Helpema.requires <<-GEMS
+      awesome_print ~>1.8
+      base_convert ~>4.0
+      entropia ~>0.1
+    GEMS
+    #=> ["awesome_print", "base_convert", "entropia"]
+    # Returns the list of loaded gems.
+    # For those quick little scripts one writes in one's bin
+    # that annoyingly keep falling out of maintainance... right?
+
+    SSSS.split("Top Secret!", threshold: 2, shares: 3)
+    #~> ^\["1-\h+", "2-\h+", "3-\h+"\]$
+    # Note that the split has random outputs on the same inputs.
+
+    SSSS.combine("3-055562917c41e68c6ab2c8", "1-27bf3cbfe8d2c25c7e8928")
+    #=> Top Secret!
+    # Pregenerated splits combine to reproduce the secret.
+
+    list = []
+    url = 'https://www.youtube.com/watch?v=u4oK3ZSccZI'
+    YouTubeDL.json(url){|json| list.push json}
+    # The url was for just one video
+    list.length #=> 1
+    json = list[0]
+    json['title'] #=> "Fortnite Easy Last Ten"
+
+    ZBar.cam( timeout=3 ) # Reads qrcodes on camera.
+    ZBar.screen # Reads qrcodes on screen.
+
+## INSTALL:
+
+    $ sudo gem install helpema
+
+## FEATURES:
+
+* Autoloaded: no need to pick and choose which library component to require.
+
+## LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2020 carlosjhr64
+
+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/lib/helpema/helpema.rb

@@ -0,0 +1,16 @@
+module HELPEMA
+module Helpema
+  def requires(*list)
+    loaded = []
+    list.each do |gems|
+      gems.lines.each do |gemname_version|
+        gemname, *version = gemname_version.split
+        gem gemname, *version  unless version.empty?
+        require gemname and loaded.push gemname
+      end
+    end
+    loaded
+  end
+  extend self
+end
+end

data/lib/helpema/ssss.rb

@@ -1,27 +1,34 @@
 require 'open3'
 
-module Helpema
+module HELPEMA
 module SSSS
-
-  def self.split(pwd, t, n)
+  # Note how the function mirrors the command line options.
+  def self.split(secret, t0=2, n0=3,
+                 t: t0, n: n0,
+                 threshold: t, shares: n,
+                 w: nil, s: nil, x: false,
+                 token: w, level: s, hexmode: x)
     pwds = nil
-    Open3.popen3("ssss-split -Q -t #{t} -n #{n}") do |stdin, stdout, stderr|
-      stdin.puts pwd
+    command = "ssss-split -Q -t #{threshold} -n #{shares}"
+    command << " -w #{token}"  if token
+    command << " -s #{level}"  if level
+    command << " -x"           if hexmode
+    Open3.popen3(command) do |stdin, stdout, stderr|
+      stdin.puts secret
       stdin.close
-      pwds = stdout.read.strip.split
+      pwds = stdout.read.split("\n")
     end
     return pwds
   end
 
   def self.combine(*pwds)
     pwd = ''
-    Open3.popen3("ssss-combine -Q -t #{pwds.length}") do |stdin, stdout, stderr|
+    Open3.popen3("ssss-combine -q -t #{pwds.length}") do |stdin, stdout, stderr|
       pwds.each{|p| stdin.puts p}
       stdin.close
-      pwd = stderr.read.strip.split.last
+      pwd = stderr.read.split("\n").last
     end
     return pwd
   end
-
 end
 end

data/lib/helpema/youtubedl.rb

@@ -1,9 +1,8 @@
 require 'json'
 require 'open3'
 
-module Helpema
+module HELPEMA
 module YouTubeDL
-
   def self.json(url, pwd=nil)
     Open3.popen2e("youtube-dl -j '#{url}'") do |i, o|
       i.puts pwd if pwd
@@ -17,6 +16,5 @@ module YouTubeDL
       end
     end
   end
-
 end
 end

data/lib/helpema/zbar.rb

@@ -1,9 +1,8 @@
 require 'timeout'
 require 'tmpdir'
 
-module Helpema
+module HELPEMA
 module ZBar
-
   def self.cam(timeout=3)
     raw = ''
     IO.popen('zbarcam --nodisplay --raw --prescale=800x800', 'r') do |io|
@@ -35,6 +34,5 @@ module ZBar
     end
     raw
   end
-
 end
 end

data/lib/helpema.rb

@@ -1,12 +1,11 @@
-module Helpema
-  VERSION = '1.0.1'
-end
-
-# This Gem
-require 'helpema/ssss.rb'
-require 'helpema/zbar.rb'
-require 'helpema/youtubedl.rb'
+module HELPEMA
+  VERSION = '2.0.200124'
 
+  autoload :Helpema,   'helpema/helpema.rb'
+  autoload :SSSS,      'helpema/ssss.rb'
+  autoload :YouTubeDL, 'helpema/youtubedl.rb'
+  autoload :ZBar,      'helpema/zbar.rb'
+end
 # Requires:
 #`ruby`
 #`ssss-split`

metadata

@@ -1,27 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: helpema
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 2.0.200124
 platform: ruby
 authors:
 - carlosjhr64
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-11-22 00:00:00.000000000 Z
+date: 2020-01-24 00:00:00.000000000 Z
 dependencies: []
 description: |
-  Some wrappers on the following linux commands: ssss-split, ssss-combine, zbarcam, youtube-dl -j.
+  Meant to be an eclectic collection of useful single functions and wrappers.
+  Wrappers: ssss-split, ssss-combine, zbarcam, youtube-dl -j.
+  Funtions: requires("gemname version",...).
 
   More later.
 email: carlosjhr64@gmail.com
 executables: []
 extensions: []
-extra_rdoc_files:
-- README.rdoc
+extra_rdoc_files: []
 files:
-- README.rdoc
+- README.md
 - lib/helpema.rb
+- lib/helpema/helpema.rb
 - lib/helpema/ssss.rb
 - lib/helpema/youtubedl.rb
 - lib/helpema/zbar.rb
@@ -30,9 +32,7 @@ licenses:
 - MIT
 metadata: {}
 post_install_message: 
-rdoc_options:
-- "--main"
-- README.rdoc
+rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
@@ -46,15 +46,15 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements:
-- 'ruby: ruby 2.4.2p198 (2017-09-14 revision 59899) [x86_64-linux]'
+- 'ruby: ruby 2.7.0p0 (2019-12-25 revision 647ee6f091) [x86_64-linux]'
 - 'ssss-split: 0.5'
 - 'ssss-combine: 0.5'
-- 'zbarcam: 0.20'
-- 'gnome-screenshot: gnome-screenshot 3.22.0'
-rubyforge_project: 
-rubygems_version: 2.6.13
+- 'zbarcam: 0.23'
+- 'gnome-screenshot: gnome-screenshot 3.34.0'
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
-summary: 'Some wrappers on the following linux commands: ssss-split, ssss-combine,
-  zbarcam, youtube-dl -j.'
+summary: 'Meant to be an eclectic collection of useful single functions and wrappers.
+  Wrappers: ssss-split, ssss-combine, zbarcam, youtube-dl -j. Funtions: requires("gemname
+  version",...).'
 test_files: []

data/README.rdoc

@@ -1,54 +0,0 @@
-= helpema
-
-{<img src="https://badge.fury.io/rb/helpema.svg" alt="Gem Version" />}[http://badge.fury.io/rb/helpema]
-
-== DESCRIPTION:
-
-Some wrappers on the following linux commands: ssss-split, ssss-combine, zbarcam, youtube-dl -j.
-
-More later.
-
-== SYNOPSIS:
-
-=== Helpema::SSSS.split( secret, threshold, shares)
-
-=== Helpema::SSSS.combine( *shared_secrets )
-
-=== Helpema::ZBar.cam( timeout=3 )
-
-Reads qrcodes on camera.
-
-=== Helpema::ZBar.screen
-
-Reads qrcodes on screen.
-
-=== Helpema::YouTubeDL.json( url ){|obj| ... }
-
-== INSTALL:
-
-  $ sudo gem install helpema
-
-== LICENSE:
-
-(The MIT License)
-
-Copyright (c) 2017 carlosjhr64
-
-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.