Helpema

require 'helpema'
include Helpema

# These will raise RuntimeError unless version matches:
Piper.validate_command('ruby', '^ruby 3.2.0', '--version')
Piper.validate_command('ssss-split', 'Version: 0\.[567]$', '-v')
# Piper.run_command(cmd, options={}, script:nil, usage=nil, synonyms:nil,
#                   mode:'r', exception:nil, forward_pass:nil **popt, &blk)
# Too many features to fully cover in a synopsis...
Piper.run_command('date',{d: 'Dec 31, 2020',I: true}) #=> "2020-12-31\n"
Piper.run_command('bash',script:'echo "Hello"',mode:'w+') #=> "Hello\n"
Piper.run_command('fish',script:'false',mode:'w',exception:false) #=> false
begin
  Piper.run_command('fish',script:'false',mode:'w',exception:'Ooops!')
rescue
  msg = $!.message
end
msg #=> "Ooops!"

using Piper::Refinements
{d: 'Dec 31, 2020',I: true}.to_args        #=> ["-d", "Dec 31, 2020", "-I"]
{'date=': '2022-12-10', wut: true}.to_args #=> ["--date=2022-12-10", "--wut"]

### define_command ###
# Create a method out of a system command.
module System
  extend Helpema::Piper
  define_command(:date, cmd: 'date', usage: {d: nil, I: true}, synonyms: {string: :d})
  extend self
end
System.date(string: 'Dec 31, 2020') #=> "2020-12-31\n"

# Predefined Rubish:
Rubish.bash 'echo "Hello!"' #=> "Hello!\n"
Rubish.bash? 'which ruby' #=> true
Rubish.fish? 'false'      #=> false
# Define you own Rubish shell call:
Rubish.shell('ruby', default:'puts RUBY_VERSION')
Rubish.ruby #=> "3.2.0\n"
Rubish.ruby('puts "Hello!"') #=> "Hello!\n"
# And define you own Rubish command call:
Rubish.command('which', usage:{arg0:nil})
def which(cmd) = Rubish.which(arg0:cmd)
which 'echo' # "/usr/bin/echo\n"

### 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.

#### SSSS.combine ###
# Pregenerated splits combine to reproduce the secret.
SSSS.combine(secrets: ["3-055562917c41e68c6ab2c8", "1-27bf3cbfe8d2c25c7e8928"],
             threshold: 2)
#=> "Top Secret!"

### YouTubeDL.json ###
list = []
url = 'https://www.youtube.com/watch?v=u4oK3ZSccZI'
Helpema::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.screen ###
# Reads qrcodes on screen.
string_or_nil = Helpema::ZBar.screen

### ZBar.cam ###
# Reads qrcodes from camera.
# You may want to wrap this one in a Timeout block.
#     string = ZBar.cam

### GPG Symmetric ###
## String to String
encrypted = Helpema::GPG.encrypt(passphrase: '<Secret>', string: '<Plain Text>')
decrypted = Helpema::GPG.decrypt(passphrase: '<Secret>', string: encrypted)
#=> "<Plain Text>"
## File to File
# Got a text file...
`md5sum tmp/text.txt` #~> ^d27b3111fdeb72f2862909c216214bc1
# gpg wont overwrite, so need to remove existing...
File.exist?(_='tmp/text.enc') and File.unlink(_)
File.exist?(_='tmp/text.dec') and File.unlink(_)
# Encrypt text file...
Helpema::GPG.encrypt(passphrase: '<Secret>', input: 'tmp/text.txt', output: 'tmp/text.enc') #=> ""
# Decrypt encrypted file...
Helpema::GPG.decrypt(passphrase: '<Secret>', input: 'tmp/text.enc', output: 'tmp/text.dec') #=> ""
# Decrypted file should match...
`md5sum tmp/text.dec` #~> ^d27b3111fdeb72f2862909c216214bc1
## IO to IO
require 'stringio'
pio = StringIO.new '<Plain>'
eio = StringIO.new ''
dio = StringIO.new ''
Helpema::GPG.encrypt(passphrase: '<Secret>', ioin: pio, ioout: eio)
eio.rewind
Helpema::GPG.decrypt(passphrase: '<Secret>', ioin: eio, ioout: dio)
dio.string #=> "<Plain>"