Rafini

require 'rafini'

include Rafini::Empty

s0 #=> ""
a0 #=> []
h0 #=> {}
[s0,a0,h0].all?(&:frozen?) #=> true

using Rafini::Array

# classify(like Set#classify)
[1, 2.0, 'Three', 4.0].classify #=> {Integer=>[1], Float=>[2.0, 4.0], String=>["Three"]}

# is
[:a,:b,:c].is(true) #=> {:a=>true, :b=>true, :c=>true}

# joins
['Y','M','D','h','m','s'].joins('-','-',' '){':'}
#=> "Y-M-D h:m:s"
[1,9,2,8,3,7,4,6,5,5].joins{|a,b|a>b ? '>': a<b ? '<': '='}
#=> "1<9>2<8>3<7>4<6>5=5"

using Rafini::Hash

# to_struc
struct = {a:'A',b:'C',c:'C'}.to_struct{ def ok = "OK" }
struct    #=> #<struct a="A", b="C", c="C">
struct.a  #=> "A"
struct.ok #=> "OK"

# supplement
{a:'A',b:'B'}.supplement({b:'X',c:'C'},{c:'Y',d:'D'}) #=> {:a=>"A", :b=>"B", :c=>"C", :d=>"D"}

# amend
{a:'A',b:'B'}.amend({b:'X',c:'C'},{c:'Y',d:'D'}) #=> {:a=>"A", :b=>"X"}

using Rafini::Integer

# odometer
123.odometer(10,10) #=> [3, 2, 1]
30.odometer(2,3,5)  #=> [0, 0, 0, 1]

using Rafini::Object

''.as{_1.empty? ? :empty : _1.length}    #=> :empty
'123'.as{_1.empty? ? :empty : _1.length} #=> 3

using Rafini::String

# cases
'My name is ruby'.pascal_case #=> MyNameIsRuby
'My name is ruby'.camel_case  #=> myNameIsRuby
'My name is ruby'.snake_case  #=> my_name_is_ruby
'My name is ruby'.kebab_case  #=> my-name-is-ruby

# semantic
'1.2.3'.semantic(0..1) #=> "1.2"

# shellescape(like Shellwords.escape)
'Hello World!'.shellescape #=> "Hello\\ World\\!"

using Rafini::Exception

# $!.puts
# Normally stderr.puts your "Nice" message.
# Additionally puts your "Ugly" message when $VERBOSE.
# Additionally puts backtrace when $DEBUG
# No output when $VERBOSE is nil.
begin
  raise 'Ugly Message'
rescue RuntimeError
  $!.puts 'Nice Message'
end

# Rafini.bang!
error = Rafini.bang!('Nice Message') do
  raise 'Ugly Message'
  # Outputs as $!.puts "Nice Message"
end
error.class #=> RuntimeError
error.to_s  #=> "Ugly Message"

# Rafini.thread_bang!
thread = Rafini.thread_bang!('Nice Message') do
  # this is in a thread
  raise 'Ugly Message' # outputs as $!.puts 'Nice Message'
end
# The returned value joined from the thread
# will not re-raise the error(but gives the error).
thread.value.class #=> RuntimeError

using Rafini::Odometers

# sec2time
12501.sec2time.to_s #=> "3 hours and 28 minutes"

# illion
3_512_325.illion.to_s #=> "3.51M"

using Rafini::Requires

requires'
ruby   ~>3.0
rafini ~>3.2
json   ~>2.0' #=> ["json"]
## You can also say:
#   require 'rafini/requires'
#   Rafini.requires...
## But you wont be able to test for Rafini's VERSION
## unless you've also required 'rafini'.