helpema 3.1.210909 → 3.2.210924

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06db87416d69a4ed736c20927d8f9d3c379d7654cbd3e85f57e6e44a5571098e
-  data.tar.gz: e0f8202e576a5ba7d7fb30ec1b045bc8da3bf1c696bf98874b30c032820e45a8
+  metadata.gz: 958027b0a2546243bae724c0a543197d7632385c0f9049d8e59ed53349b18f4d
+  data.tar.gz: d57d402890e736b580fc052c66308df90a6e29202d467cd4e26714ad11b64331
 SHA512:
-  metadata.gz: 0e59e80e64f0c88ac0a0948ff773b9238f7334939231d70c70aec105217962cc4e3e68276b29013cb4e22eec57e392031b2f927c690d29d35999ca236860b1ee
-  data.tar.gz: aaddb40d73e6d372d50ff61244232dbc998076806dcc3903fefd1c46647e3f739bfd9b0b0d6d29ab4b56c8bfb0411d2314bee2505ceae11c90ffeb717b2cf781
+  metadata.gz: dd576603c81835d9610eac6d15487d25d82491eec8de717fcfbe6a16c51c865968d8ac259dddc45e02f2148f7653c6fa5b9ed5be55eb05c878b184df3bc5cdec
+  data.tar.gz: 65f36c77c56ded75225ecd35fe6f6f4bb3581aeff1c3ce1de855f423e65de78e3e69d1131a63e7b18760b1224f27eda14a33c0a41e40e55bef67d8c0cb89b488

data/README.md

@@ -1,6 +1,6 @@
 # Helpema
 
-* [VERSION 3.1.210909](https://github.com/carlosjhr64/helpema/releases)
+* [VERSION 3.2.210924](https://github.com/carlosjhr64/helpema/releases)
 * [github](https://github.com/carlosjhr64/helpema)
 * [rubygems](https://rubygems.org/gems/helpema)
 
@@ -18,6 +18,7 @@ $ gem install helpema
 
 ## SYNOPSIS:
 
+### requires
 ```ruby
 require 'helpema'
 include Helpema
@@ -34,23 +35,31 @@ helpema       ~>3.1
 base_convert  ~>4.0
 entropia      ~>0.1'
 #=> ["base_convert", "entropia"]
-
+```
+### String#satisfies?
+```ruby
 ### String#satisfies? ###
 # Uses Gem::Requirement and Gem::Version to check version strings.
 '1.2.3'.satisfies? '~>1.1' #=> true
 '1.2.3'.satisfies? '~>1.3' #=> false
-
+```
+### run_command
+```ruby
 ### run_command ###
 # Automates pipe creation to a system command.
 # See the code for all available features.
 run_command('date',{d: 'Dec 31, 2020'}) #=> "Thu Dec 31 12:00:00 AM PST 2020\n"
-
+```
+### define_command
+```ruby
 ### define_command ###
 # Creates a method out of a system command.
 # See the code for all available features.
 define_command(:date, cmd: 'date', usage: {d: nil}, synonyms: {string: :d})
 date(string: 'Dec 31, 2020') #=> "Thu Dec 31 12:00:00 AM PST 2020\n"
-
+```
+### to_arg
+```ruby
 ### to_arg ###
 # A helper function to do system command calls.
 to_arg :q, true             #=> "-q"
@@ -59,7 +68,9 @@ to_arg :verbose, false      #=> nil
 to_arg :f, '/path-to/file'  #=> ["-f", "/path-to/file"]
 to_arg :geo=, '10x20'       #=> "--geo=10x20"
 to_arg :arg0, 'Hello World' #=> "Hello World"
-
+```
+### Hash#to_args
+```ruby
 ### Hash#to_args ###
 { q:       true,
   quiet:   true,
@@ -68,23 +79,31 @@ to_arg :arg0, 'Hello World' #=> "Hello World"
 	:geo= => '10x20',
   arg0:    'Hello World' }.to_args
 #=> ["-q", "--quiet", "-f", "/path-to/file", "--geo=10x20", "Hello World"]
-
+```
+### Array#classify
+```ruby
 ### Array#classify ###
 # Groups items in Array by class.
 [1, 2.0, :Three, 'Four', /Five/, :Six, 'Seven'].classify
 #=> {Integer=>[1], Float=>[2.0], Symbol=>[:Three, :Six], String=>["Four", "Seven"], Regexp=>[/Five/]}
-
+```
+### SSSS.split
+```ruby
 ### SSSS.split ####
 SSSS.split(secret: "Top Secret!", threshold: 2, shares: 3)
 #~> ^\["1-\h+", "2-\h+", "3-\h+"\]$
 # Note that the split has random outputs on the same inputs.
-
+```
+### SSS.combine
+```ruby
 #### SSSS.combine ###
 # Pregenerated splits combine to reproduce the secret.
 SSSS.combine(secrets: ["3-055562917c41e68c6ab2c8", "1-27bf3cbfe8d2c25c7e8928"],
              threshold: 2)
 #=> "Top Secret!"
-
+```
+### YouTubeDL.json
+```ruby
 ### YouTubeDL.json ###
 list = []
 url = 'https://www.youtube.com/watch?v=u4oK3ZSccZI'
@@ -93,16 +112,24 @@ YouTubeDL.json(url){|json| list.push json}
 list.length #=> 1
 json = list[0]
 json['title'] #=> "Fortnite Easy Last Ten"
-
+```
+### YouTubeDL.mp3(url, output: '%(id)s.%(ext)s')
+### FFMPEG.hash(filename, digest: 'sha160')
+### ZBar.screen
+```ruby
 ### ZBar.screen ###
 # Reads qrcodes on screen.
 string_or_nil = ZBar.screen
-
+```
+### ZBar.cam
+```ruby
 ### ZBar.cam ###
 # Reads qrcodes from camera.
 # You may want to wrap this one in a Timeout block.
 #     string = ZBar.cam
-
+```
+### GPG.encrypt and GPG.decrypt
+```ruby
 ### GPG Symmetric ###
 ## String to String
 encrypted = GPG.encrypt(passphrase: '<Secret>', string: '<Plain Text>')

data/lib/helpema/ffmpeg.rb

@@ -0,0 +1,23 @@
+module Helpema
+  module FFMPEG
+    extend Helpema
+
+    FFMPEG.define_command(:_hash,
+      cmd: 'ffmpeg',
+      usage: {arg0: '-i',
+              arg1: nil,
+              arg2: '-f',
+              arg3: 'hash',
+              arg4: '-hash',
+              arg5: nil,
+              arg6: '-'},
+      synonyms: {filename: :arg1, digest: :arg5},
+      exception: 'ffmpeg failed',
+      err: '/dev/null')
+    def hash(filename, digest:'sha160')
+      FFMPEG._hash(filename:filename, digest:digest).strip.split('=').last
+    end
+
+    extend self
+  end
+end

data/lib/helpema/youtubedl.rb

@@ -21,6 +21,17 @@ module Helpema
     end
     def json(url, &blk) = YouTubeDL._json(url:url, &blk)
 
+    YouTubeDL.define_command(:_mp3,
+      cmd: 'youtube-dl', version: YouTubeDL.version,
+      usage: { output: nil,
+               'extract-audio': true,
+               'audio-format': true,
+               arg0: 'mp3',
+               arg1: nil },
+      synonyms: {url: :arg1},
+      err: '/dev/null')
+    def mp3(url, output:'%(id)s.%(ext)s') = YouTubeDL._mp3(url:url, output:output)
+
     extend self
   end
 end

data/lib/helpema.rb

@@ -1,5 +1,5 @@
 module Helpema
-  VERSION = '3.1.210909'
+  VERSION = '3.2.210924'
 
   require_relative     'helpema/helpema'
 
@@ -7,6 +7,7 @@ module Helpema
   autoload :YouTubeDL, 'helpema/youtubedl.rb'
   autoload :ZBar,      'helpema/zbar.rb'
   autoload :GPG,       'helpema/gpg.rb'
+  autoload :FFMPEG,    'helpema/ffmpeg.rb'
 end
 
 # Requires:

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: helpema
 version: !ruby/object:Gem::Version
-  version: 3.1.210909
+  version: 3.2.210924
 platform: ruby
 authors:
 - CarlosJHR64
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-09-09 00:00:00.000000000 Z
+date: 2021-09-24 00:00:00.000000000 Z
 dependencies: []
 description: |
   Meant to be an eclectic collection of useful single functions and wrappers.
@@ -21,6 +21,7 @@ extra_rdoc_files: []
 files:
 - README.md
 - lib/helpema.rb
+- lib/helpema/ffmpeg.rb
 - lib/helpema/gpg.rb
 - lib/helpema/helpema.rb
 - lib/helpema/ssss.rb