bblib 1.0.2 → 2.0.0

data/lib/bblib.rb

@@ -1,28 +1 @@
-require_relative 'bblib/version'
-require_relative 'opal/bbopal'
-require_relative 'object/bbobject'
-require_relative 'hash/bbhash'
-require_relative 'mixins/bbmixins'
-require_relative 'class/effortless'
-require_relative 'hash_path/hash_path'
-require_relative 'string/bbstring'
-require_relative 'file/bbfile'
-require_relative 'time/bbtime'
-require_relative 'number/bbnumber'
-require_relative 'array/bbarray'
-require_relative 'system/bbsystem'
-require_relative 'logging/bblogging'
-require_relative 'error/abstract'
-require_relative 'html/bbhtml'
-
-non_opal = ['os/bbos']
-
-non_opal.each { |i| require_relative i } unless BBLib.in_opal?
-
-require 'fileutils'
-require 'time'
-# require 'logger'
-
-module BBLib
-  CONFIGS_PATH = 'config/'.freeze
-end
+require_relative 'bblib/core'

data/lib/bblib/all.rb

@@ -0,0 +1,5 @@
+require_relative 'core'
+require_relative 'cli'
+require_relative 'system'
+require_relative 'html'
+require_relative 'cron'

data/lib/bblib/cli.rb

@@ -0,0 +1,3 @@
+require_relative 'core'
+require_relative 'cli/opts_parser'
+require_relative 'cli/color'

data/lib/bblib/cli/color.rb

@@ -0,0 +1,51 @@
+module BBLib
+  module Console
+
+    COLOR_CODES = {
+      black:   30,
+      red:     31,
+      green:   32,
+      orange:  33,
+      yellow:  33,
+      blue:    34,
+      purple:  35,
+      cyan:    36,
+      gray:    37,
+      grey:    37,
+      white:   37,
+      none:    0,
+      default: 39
+    }.freeze
+
+    SEVERITY_COLORS = {
+      debug:   :light_purple,
+      info:    :light_blue,
+      warn:    :yellow,
+      error:   :light_red,
+      fatal:   :red,
+      success: :green,
+      ok:      :green,
+      fail:    :red
+    }
+
+    def self.colorize(text, color = :none, background: false, light: false)
+      color = SEVERITY_COLORS[color.to_s.downcase.to_sym] if SEVERITY_COLORS.include?(color.to_s.downcase.to_sym)
+      if color.to_s.start_with?('light_')
+        color = color.to_s.split('_', 2).last.to_sym
+        light = true
+      end
+      light = true if color == :grey || color == :gray
+      color = COLOR_CODES[color] if COLOR_CODES.include?(color)
+      color = COLOR_CODES[:default] unless color.is_a?(Integer)
+      color += 10 if background
+      "\e[#{light ? 1 : 0};#{color}m#{text}\e[0m"
+    end
+
+  end
+end
+
+class String
+  def to_color(color_code, opts = {})
+    BBLib::Console.colorize(self, color_code, **opts)
+  end
+end

data/lib/bblib/cli/exceptions/invalid_argument.rb

@@ -0,0 +1,5 @@
+module BBLib
+  class InvalidArgumentException < OptsParserException
+
+  end
+end

data/lib/bblib/cli/exceptions/missing_argument.rb

@@ -0,0 +1,5 @@
+module BBLib
+  class MissingArgumentException < OptsParserException
+
+  end
+end

data/lib/bblib/cli/exceptions/missing_required_argument.rb

@@ -0,0 +1,5 @@
+module BBLib
+  class MissingRequiredArgumentException < MissingArgumentException
+
+  end
+end

data/lib/bblib/cli/exceptions/opts_parser.rb

@@ -0,0 +1,9 @@
+module BBLib
+  class OptsParserException < Exception
+    # Nothing...
+  end
+end
+
+require_relative 'invalid_argument'
+require_relative 'missing_argument'
+require_relative 'missing_required_argument'

data/lib/bblib/cli/option.rb

@@ -0,0 +1,116 @@
+module BBLib
+  class OptsParser
+    class Option
+      include BBLib::Effortless
+      include BBLib::TypeInit
+
+      attr_sym :name, default_proc: :determine_name
+      attr_str :description, aliases: :desc
+      attr_of Object, :default, allow_nil: true, default: nil
+      attr_str :placeholder, default_proc: proc { |x| x.name.upcase }
+      attr_ary_of String, :flags, arg_at: 1
+      attr_of [String, Regexp], :delimiter, default: nil, allow_nil: true
+      attr_str :argument_delimiter, default: ' '
+      attr_bool :raise_errors, default: true
+      attr_bool :required, default: false
+      attr_of Proc, :processor, arg_at: :block, default: nil, allow_nil: true
+      attr_ary_of Proc, :validators
+      attr_bool :singular, default: true
+      attr_of [Integer, Range], :position, default: nil, allow_nil: true
+      attr_hash :sub_commands, keys: String, values: OptsParser, aliases: [:sub_cmds, :subcommands], default: nil, allow_nil: true, pre_proc: proc { |hash| hash.is_a?(Hash) ? hash.keys_to_s : hash }
+
+
+      def to_s
+        (flags.sort_by(&:size).join(', ') + " #{placeholder}").strip.ljust(40, ' ') + "\t#{description}"
+      end
+
+      def self.types
+        descendants.map(&:type)
+      end
+
+      def retrieve(args, parsed)
+        result = singular? ? nil : []
+        index = 0
+        until index >= args.size
+          begin
+            unless flag_match?(args[index], index)
+              index += 1
+              next
+            end
+            values = split(extract(index, args))
+            values.each do |value|
+              valid!(value)
+              if singular?
+                result = value
+                index = args.size
+              else
+                result << value
+              end
+            end
+          rescue OptsParserException => e
+            raise e if raise_errors?
+          end
+        end
+        raise MissingArgumentException, "A required argument is missing: #{name}" if required? && result.nil?
+        result = processor.call(result) if !result.nil? && processor
+        process_result(result.nil? ? default : result, args, parsed)
+      end
+
+      def singular?
+        singular && !delimiter
+      end
+
+      def flag_match?(str, index = 0)
+        text_match = if flags.empty? && position
+          true
+        elsif argument_delimiter == ' '
+          if str =~ /^\-[^\-]/
+            flags.any? do |flag|
+              flag =~ /^\-[\w\d]/ && str.include?(flag[1])
+            end
+          else
+            flags.include?(str)
+          end
+        else
+          flags.any? do |flag|
+            flag.start_with?("#{str}#{argument_delimiter}")
+          end
+        end
+        return text_match unless text_match && position
+        position === index
+      end
+
+      def valid?(value)
+        return true if validators.empty?
+        validators.all? do |validator|
+          validator.call(value)
+        end
+      end
+
+      def valid!(value)
+        raise InvalidArgumentException, "Invalid argument for #{name}" unless valid?(value)
+      end
+
+      def split(value)
+        return [value] unless delimiter
+        value.msplit(delimiter)
+      end
+
+      protected
+
+      def determine_name
+        flag = flags.find { |f| f.start_with?('--') }
+        flag = flags.first unless flag
+        flag.to_s.sub(/^-{1,2}/, '').snake_case
+      end
+
+      def process_result(result, args, parsed)
+        parsed.deep_merge!(name => result)
+        if sub_commands && sub_commands[result]
+          parsed.deep_merge!(sub_commands[result].parse!(args))
+        end
+      end
+
+    end
+  end
+end

data/lib/bblib/cli/options/basic_option.rb

@@ -0,0 +1,19 @@
+module BBLib
+  class OptsParser
+    class BasicOption < Option
+
+      def extract(index, args)
+        args.delete_at(index)
+        raise MissingArgumentException, "No argument was provided for #{name}" if args[index].nil?
+        format_value(args.delete_at(index))
+      end
+
+      protected
+
+      def format_value(value)
+        raise AbstractError
+      end
+
+    end
+  end
+end

data/lib/bblib/cli/options/bool.rb

@@ -0,0 +1,19 @@
+module BBLib
+  class OptsParser
+    class Bool < BasicOption
+
+      TRUE_STATEMENTS = %w{true yes y t 1}
+      FALSE_STATEMENTS = %w{false no n f 0}
+
+      protected
+
+      def format_value(value)
+        tru = TRUE_STATEMENTS.any? { |ts| ts == value.downcase }
+        fal = FALSE_STATEMENTS.any? { |fs| fs == value.downcase }
+        raise InvalidArgumentException, "#{name} is a boolean argument but got a non-boolean value" unless tru || fal
+        tru && !fal
+      end
+
+    end
+  end
+end

data/lib/bblib/cli/options/command.rb

@@ -0,0 +1,11 @@
+module BBLib
+  class OptsParser
+    class Command < Option
+
+      def extract(index, args)
+        args.delete_at(index)
+      end
+
+    end
+  end
+end

data/lib/bblib/cli/options/date.rb

@@ -0,0 +1,14 @@
+module BBLib
+  class OptsParser
+    class Date < BasicOption
+
+      protected
+
+      # TODO Support custom formats
+      def format_value(value)
+        ::Date.parse(value)
+      end
+
+    end
+  end
+end

data/lib/bblib/cli/options/float.rb

@@ -0,0 +1,14 @@
+module BBLib
+  class OptsParser
+    class Float < BasicOption
+
+      protected
+
+      def format_value(value)
+        raise InvalidArgumentException, "Argument provided for #{name} should be an float but was '#{args[index]}'" unless value =~ /^\d+(\.\d+)?$/
+        value.to_f
+      end
+
+    end
+  end
+end

data/lib/bblib/cli/options/integer.rb

@@ -0,0 +1,14 @@
+module BBLib
+  class OptsParser
+    class Integer < BasicOption
+
+      protected
+
+      def format_value(value)
+        raise InvalidArgumentException, "Argument provided for #{name} should be an integer but was '#{args[index]}'" unless value =~ /^\d+$/
+        value.to_i
+      end
+
+    end
+  end
+end

data/lib/bblib/cli/options/json.rb

@@ -0,0 +1,16 @@
+module BBLib
+  class OptsParser
+    class JSON < BasicOption
+
+      protected
+
+      def format_value(value)
+        require 'json' unless defined?(::JSON)
+        ::JSON.parse(value)
+      rescue ::JSON::ParserError => e
+        raise InvalidArgumentException, "Invalid JSON. #{e.to_s}"
+      end
+
+    end
+  end
+end

data/lib/bblib/cli/options/regexp.rb

@@ -0,0 +1,17 @@
+module BBLib
+  class OptsParser
+    class Regexp < BasicOption
+
+      protected
+
+      def format_value(value)
+        if value =~ /^\/.*\/\w*$/
+          value.to_regex
+        else
+          /#{value}/
+        end
+      end
+
+    end
+  end
+end

data/lib/bblib/cli/options/string.rb

@@ -0,0 +1,13 @@
+module BBLib
+  class OptsParser
+    class String < BasicOption
+
+      protected
+
+      def format_value(value)
+        value.to_s
+      end
+
+    end
+  end
+end

data/lib/bblib/cli/options/symbol.rb

@@ -0,0 +1,13 @@
+module BBLib
+  class OptsParser
+    class Symbol < BasicOption
+
+      protected
+
+      def format_value(value)
+        value.to_sym
+      end
+
+    end
+  end
+end

data/lib/bblib/cli/options/time.rb

@@ -0,0 +1,14 @@
+module BBLib
+  class OptsParser
+    class Time < BasicOption
+
+      protected
+
+      # TODO Support custom formats
+      def format_value(value)
+        ::Time.parse(value)
+      end
+
+    end
+  end
+end

data/lib/bblib/cli/options/toggle.rb

@@ -0,0 +1,27 @@
+module BBLib
+  class OptsParser
+    class Toggle < Option
+
+      def extract(index, args)
+        value = args[index]
+        if value =~ /^\-[\w\d]$/ || flags.include?(value)
+          args.delete_at(index)
+        else
+          flag = flags.find do |flag|
+            next unless flag =~ /^\-[\w\d]$/
+            value.include?(flag[1])
+          end
+          value.sub!(flag[1], '')
+        end
+        true
+      end
+
+      protected
+
+      def simple_setup
+        self.default = false
+      end
+
+    end
+  end
+end