aro 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 112a9db053a27471ff5444243b12bd55426a81491695134c269c5bb4f3513cac
-  data.tar.gz: c6d23c2cb1f9ab42d45711e9f42d91f32aa1f01d0d56896fe73751814eaa8d35
+  metadata.gz: a276927c911f1781041e6d5c274c1611f0a23a948edb9b0fb6bc17518d22eee5
+  data.tar.gz: 415a4ad29297c5c8815127fb4bae7c5dc97f4f8eb12cda4aacf2235997cb895e
 SHA512:
-  metadata.gz: 7b6c85313304ddb52defa7c17b32bbab9bd90fbb79a77235bd065ca67fb88b94a9a5005092599f85d31363cf7a922f5e625c15ced470ac49a1d9aa8b9ea04543
-  data.tar.gz: '06156495bdd7718b9655b1dc56337ba42231d3cd15a6f971a025b3941f2eaa819a2fe65d0e33890669f8b0b302a4b30eead4a50687632230b0ce220df3f49e57'
+  metadata.gz: a91cb814964c27d4aa6c53aea311dc530ecd897d4534f19b3295ad8954c7611268102b8113dc4ecaea52d23fb975dbf890bcfbcfc575727741c497942f3ea36f
+  data.tar.gz: b8270db12a879b8738d014f748929641d234234f61cbba5cc351907319d5616bfef2ae1f58616827930673703258841c2ee6c70d732ab247ae87941cf1bf0073

data/.gitignore

@@ -0,0 +1,6 @@
+.DS_Store
+.aro
+.aro_test
+.name
+*.sql
+*.log

data/.release

@@ -0,0 +1,20 @@
+# helper script for consistency when doing releases
+
+# start on latest develop branch
+
+# 1) update version and release notes (manually)
+# 2) test and build
+#     $ rake make
+# 3) build checksum
+#     $ rake build:checksum 
+# 4) create a commit
+# 5) generate tag
+#     tag message format:
+#       vx.x.x
+#       <release_note_text>
+#     $ gitaga vx.x.x && gush tag vx.x.x
+# 6) push develop
+# 7) pull request develop -> master & merge
+# 8) checkout and pull master
+# 9) publish to rubygems
+#     $ gem push pkg/aro-x.x.x.gem

data/.ruby-version

@@ -0,0 +1 @@
+ruby-3.4.7

data/Gemfile

@@ -0,0 +1,5 @@
+source :"https://rubygems.org".to_s
+gemspec
+
+# do not modify
+# add dependencies to the gemspec

data/Gemfile.lock

@@ -0,0 +1,105 @@
+PATH
+  remote: .
+  specs:
+    aro (0.1.3)
+      activerecord (~> 8.1, >= 8.1.1)
+      i18n (~> 1.14, >= 1.14.7)
+      sqlite3 (~> 2.8, >= 2.8.0)
+      tty-prompt (~> 0.23.1, >= 0.23.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activemodel (8.1.1)
+      activesupport (= 8.1.1)
+    activerecord (8.1.1)
+      activemodel (= 8.1.1)
+      activesupport (= 8.1.1)
+      timeout (>= 0.4.0)
+    activesupport (8.1.1)
+      base64
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      json
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    base64 (0.3.0)
+    bigdecimal (3.3.1)
+    concurrent-ruby (1.3.5)
+    connection_pool (2.5.4)
+    diff-lcs (1.6.2)
+    drb (2.2.3)
+    i18n (1.14.7)
+      concurrent-ruby (~> 1.0)
+    json (2.16.0)
+    logger (1.7.0)
+    minitest (5.26.1)
+    pastel (0.8.0)
+      tty-color (~> 0.5)
+    rake (13.3.1)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.7)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.6)
+    securerandom (0.4.1)
+    sqlite3 (2.8.0-aarch64-linux-gnu)
+    sqlite3 (2.8.0-aarch64-linux-musl)
+    sqlite3 (2.8.0-arm-linux-gnu)
+    sqlite3 (2.8.0-arm-linux-musl)
+    sqlite3 (2.8.0-arm64-darwin)
+    sqlite3 (2.8.0-x86-linux-gnu)
+    sqlite3 (2.8.0-x86-linux-musl)
+    sqlite3 (2.8.0-x86_64-darwin)
+    sqlite3 (2.8.0-x86_64-linux-gnu)
+    sqlite3 (2.8.0-x86_64-linux-musl)
+    timeout (0.4.4)
+    tty-color (0.6.0)
+    tty-cursor (0.7.1)
+    tty-prompt (0.23.1)
+      pastel (~> 0.8)
+      tty-reader (~> 0.8)
+    tty-reader (0.9.0)
+      tty-cursor (~> 0.7)
+      tty-screen (~> 0.8)
+      wisper (~> 2.0)
+    tty-screen (0.8.2)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    uri (1.1.1)
+    wisper (2.0.1)
+
+PLATFORMS
+  aarch64-linux-gnu
+  aarch64-linux-musl
+  arm-linux-gnu
+  arm-linux-musl
+  arm64-darwin
+  x86-linux-gnu
+  x86-linux-musl
+  x86_64-darwin
+  x86_64-linux-gnu
+  x86_64-linux-musl
+
+DEPENDENCIES
+  aro!
+  bundler (~> 2.7, >= 2.7.2)
+  rake (~> 13.3, >= 13.3.1)
+  rspec (~> 3.13, >= 3.13.2)
+
+BUNDLED WITH
+   2.7.2

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (C) 2025 Scot Reichman
+
+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/README.md

@@ -0,0 +1,70 @@
+# aro
+>__a cli for tarot__ - follow the way of the aro eht.
+
+##### __current version:__
+[![Gem Version](https://badge.fury.io/rb/aro.svg)](https://badge.fury.io/rb/aro)
+
+aro is a command line interface that allows you to manage multiple tarot decks.
+
+
+### install
+
+```bash
+$ gem install aro
+```
+
+### use
+
+```bash
+$ aro -h
+```
+
+[usage documentation](https://raw.githubusercontent.com/i2097i/aro/refs/heads/master/locale/en.usage.yml)
+
+
+[card definitions](https://raw.githubusercontent.com/i2097i/aro/refs/heads/master/locale/en.cards.yml)
+
+
+### develop
+
+[rubygems.org guides](https://guides.rubygems.org)
+
+```ruby
+# the Rakefile contains bundler's gem_tasks,
+# which are used for gem development.
+
+# Rakefile
+require "bundler/gem_tasks"
+```
+
+```bash
+# list tasks
+$ rake --tasks
+
+# build gem
+$ rake build
+
+# build and install
+$ rake install
+```
+
+### test
+
+```bash
+$ rspec
+```
+
+#### pre-commit hook:
+```bash
+: cat .git/hooks/pre-commit
+#!/bin/sh
+
+echo "running pre-commit hooks"
+echo "exec rspec -f d -o ./spec/spec.log"
+exec rspec -f d -o ./spec/spec.log
+```
+
+[license](http://opensource.org/licenses/MIT)
+[issues](https://github.com/i2097i/aro/issues)
+
+>aro by i2097i is copyright (2025)

data/Rakefile

@@ -0,0 +1,5 @@
+require "bundler/gem_tasks"
+
+task :default => :rspec
+
+Rake.add_rakelib :"tasks".to_s

data/aro.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+
+require :aro.to_s
+
+Gem::Specification.new do |spec|
+  spec.name          = "aro"
+  spec.version       = Aro::VERSION
+  spec.authors       = ["i2097i"]
+  spec.email         = ["i2097i@hotmail.com"]
+  spec.description   = "a cli for tarot."
+  spec.summary       = "follow the way of the aro eht."
+  spec.homepage      = "https://github.com/i2097i/aro"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split("\n").reject{|f| f.match(%r{^(spec)/})}
+  spec.bindir        = "bin"
+  spec.executables   = ["aro"]
+  spec.require_paths = ["lib", "bin/cli"]
+
+  # development gems
+  spec.add_development_dependency "bundler",      "~> 2.7", ">= 2.7.2"
+  spec.add_development_dependency "rake",         "~> 13.3", ">= 13.3.1"
+  spec.add_development_dependency "rspec",        "~> 3.13", ">= 3.13.2"
+
+  # runtime gems
+  spec.add_runtime_dependency     "i18n",         "~> 1.14", ">= 1.14.7"
+  spec.add_runtime_dependency     "activerecord", "~> 8.1", ">= 8.1.1"
+  spec.add_runtime_dependency     "sqlite3",      "~> 2.8", ">= 2.8.0"
+  spec.add_runtime_dependency     "tty-prompt",   "~> 0.23.1", ">= 0.23.1"
+end

data/bin/aro

@@ -15,11 +15,6 @@ require_relative :cli.to_s
 # todo: add tab completion using abbrev gem
 # https://stackoverflow.com/a/11627931
 
-# todo: response formats 
-# text (default)
-# json
-# 
-
 module CLI
   if CLI::FLAGS[:VERSION].include?(CLI::ARGV0)
     Aro::P.say(Aro::VERSION)

data/bin/cli/config.rb

@@ -7,17 +7,167 @@ module CLI
     CONFIG_FILE = :".config".to_s
     CONFIG_FILE_PATH = "#{Aro::Db.base_aro_dir(Aro::Db.get_name_from_namefile)}/#{CLI::Config::CONFIG_FILE}"
 
-    DEFAULT_CONFIG = {
+    INTS = {
+      O:       0,
+      I:       1,
+      VII:     7,
+      XXII:    22,
+      MMXCVII: Aro::Mancy::I2097I[1..4].to_i,
+    }
+
+    # possible formats
+    # 
+    # example usage:
+    # CLI::Config::FORMATS[:TEXT]
+    FORMATS = {
+      TEXT: :text,
+      JSON: :json,
+    }
+
+    # possible dimensions
+    # 
+    # example usage:
+    # CLI::Config::DMS[:DEV_TAROT]
+    DMS = {
+      DEV_TAROT: :dev_tarot,
+      RUBY_FACOT: :ruby_facot,
+    }
+
+    # types used in definition
+    # 
+    # example usage:
+    # CLI::Config::DEF_TYPES[:INT][:validator].call(unvalid, CLI::Config::DEF[:DIMENSION])
+    DEF_TYPES = {
+      INT: {
+        name: :int,
+        description: I18n.t("cli.config.type_int_description"),
+        validator: Proc.new{|unvalid, deff, key|
+          CLI::Config.def_valid?(deff, key) &&
+          CLI::Config.int_valid?(unvalid)   &&
+          unvalid.to_i <= deff[:min]        &&
+          unvalid.to_i >= deff[:max]
+        }
+      },
+      VALUES: {
+        name: :values,
+        description: I18n.t("cli.config.type_values_description"),
+        validator: Proc.new{|unvalid, deff, key|
+          CLI::Config.def_valid?(deff, key) &&
+          deff[:possible_values].keys.include?(unvalid.to_sym)
+        }
+      },
+    }
+
+    # adapts I18n translations to generate bash environment vars.
+    # 
+    # example usage:
+    # CLI::Config::DEF[:Z_MAX]
+    DEF = {
       FORMAT: {
+        type: :values,
+        description: I18n.t(
+          "cli.config.format_description",
+          possible_values: CLI::Config::FORMATS.values.join(", ")
+        ),
         value: :text,
-        possible_values: [
-          {name: :text, description: I18n.t("cli.config.text_format_description")},
-          {name: :json, description: I18n.t("cli.config.json_format_description")},
-        ]
-      }
+        possible_values: {
+          text: I18n.t("cli.config.text_format_description"),
+          json: I18n.t("cli.config.json_format_description")
+        }
+      },
+      DIMENSION: {
+        type: :values,
+        description: I18n.t(
+          "cli.config.dimension_description",
+          possible_values: CLI::Config::DMS.values.join(", ")
+         ),
+        value: :dev_tarot,
+        possible_values: {
+          dev_tarot: I18n.t("cli.config.dimension_dev_tarot_description"),
+          ruby_facot: I18n.t("cli.config.dimension_ruby_facot_description"),
+        }
+      },
+      # not implemented. replace Aro::Deck::DRAW_COUNT with this
+      # DRAW_COUNT: {
+      #   type: :int,
+      #   description: I18n.t(
+      #     "cli.config.draw_count_description",
+      #     min: CLI::Config::INTS[:I],
+      #     max: CLI::Config::INTS[:XXII],
+      #   ),
+      #   value: CLI::Config::INTS[:VII],
+      #   min: CLI::Config::INTS[:I],
+      #   max: CLI::Config::INTS[:XXII],
+      # },
+      Z: {
+        type: :int,
+        description: I18n.t(
+          "cli.config.z_description",
+          min: CLI::Config::INTS[:I],
+          max: CLI::Config::INTS[:MMXCVII],
+        ),
+        value: CLI::Config::INTS[:I],
+        min: CLI::Config::INTS[:I],
+        max: CLI::Config::INTS[:MMXCVII],
+      },
+      Z_MAX: {
+        type: :int,
+        description: I18n.t(
+          "cli.config.z_max_description",
+          min: CLI::Config::INTS[:I],
+          max: CLI::Config::INTS[:XXII],
+        ),
+        value: CLI::Config::INTS[:VII],
+        min: CLI::Config::INTS[:I],
+        max: CLI::Config::INTS[:XXII],
+      },
+
       # ...
     }
 
+    def generate_config
+      # todo: localize generated config text
+      Aro::P.say(I18n.t("cli.config.generating_default_config", name: CLI::Config::CONFIG_FILE_PATH))
+      File.open(CLI::Config::CONFIG_FILE_PATH, "w+") do |file|
+        file.write("# #{Aro::Mancy::PS1} configuration file.\n")
+        file.write("# this file was auto generated by the aro cli.\n")
+        Aro::Mancy::OS.times do
+          file.write("#\n")
+        end
+        file.write("# CLI::Config::DEF_TYPES\n")
+        file.write("# describes the possible types of variables.\n")
+        CLI::Config::DEF_TYPES.each{|k, v|
+          file.write("# #{k}: #{v[:description]}\n")
+        }
+        Aro::Mancy::OS.times do
+          file.write("#\n")
+        end
+        file.write("# CLI::Config::DEF\n")
+        file.write("# define & expose an aro bash api via ENV variables.\n")
+        file.write("# modifying them in this file will change aro's behavior.\n")
+        Aro::Mancy::OS.times do
+          file.write("#\n")
+        end
+        CLI::Config::DEF.each{|k, v|
+          var_name = CLI::Config.var_key_with_suffix(k)
+          file.write("# [#{var_name}]\n")
+          file.write("#   => #{I18n.t("cli.config.def_type")}: #{v[:type]}\n")
+          case v[:type]
+          when CLI::Config::DEF_TYPES[:INT][:name]
+            file.write("#   => #{I18n.t("cli.config.minimum")}: #{v[:min]}\n")
+            file.write("#   => #{I18n.t("cli.config.maximum")}: #{v[:max]}\n")
+          when CLI::Config::DEF_TYPES[:VALUES][:name]
+            file.write("#   => #{I18n.t("cli.config.possible_values")}:\n")
+            v[:possible_values].each{|name, description|
+              file.write("#   => #{name} - #{description}\n")
+            }
+          end
+          file.write("export #{var_name}=#{v[:value]}\n\n")
+        }
+        file.write("\n")
+      end
+    end
+
     def initialize
       return unless Aro::Mancy.is_aro_dir?
       unless File.exist?(CLI::Config::CONFIG_FILE_PATH)
@@ -27,8 +177,15 @@ module CLI
       source_config
     end
 
-    def self.format
-      CLI::Config.var_value_with_suffix(:FORMAT)
+    def self.def_valid?(deff, key)
+      deff == CLI::Config::DEF[key]
+    end
+
+    def self.int_valid?(unvalid)
+      return !unvalid.nil? && (
+        unvalid.kind_of?(Integer) ||
+        ("0" != unvalid && unvalid.respond_to?(:to_i))
+      )
     end
 
     def self.var_value_with_suffix(suffix)
@@ -39,33 +196,28 @@ module CLI
       "#{CLI::Config::VAR_PREFIX}#{suffix}"
     end
 
-    def generate_config
-      Aro::P.say(I18n.t("cli.config.generating_default_config", name: CLI::Config::CONFIG_FILE_PATH))
-      File.open(CLI::Config::CONFIG_FILE_PATH, "w+") do |file|
-        file.write("# #{Aro::Mancy::PS1} configuration file.\n")
-        file.write("# this file is auto generated by the aro cli.\n")
-        2.times do
-          file.write("#\n")
-        end
-        DEFAULT_CONFIG.each{|k, v|
-          var_name = CLI::Config.var_key_with_suffix(k)
-          file.write("# [#{var_name}]\n")
-          file.write("#   => #{I18n.t("cli.config.possible_values")}:\n")
-          v[:possible_values].each{|pv|
-            file.write("#   => #{pv[:name]} - #{pv[:description]}\n")
-          }
-          file.write("export #{var_name}=#{v[:value]}")
-        }
-        file.write("\n")
-      end
-    end
-
     def source_config
+      invalid_defs = validate_config
       Aro::P.say(I18n.t("cli.config.sourcing_config", name: CLI::Config::CONFIG_FILE_PATH))
       system("source #{CLI::Config::CONFIG_FILE_PATH}")
-      DEFAULT_CONFIG.keys.each{|dfk|
+      CLI::Config::DEF.keys.each{|dfk|
+        next if invalid_defs.include?(dfk)
         Aro::P.say("$#{CLI::Config.var_key_with_suffix(dfk)}=#{CLI::Config.var_value_with_suffix(dfk)}")
       }
+
+      # todo: set all invalid_refs to default in ENV
+    end
+
+    def validate_config
+      invalid_defs = []
+      CLI::Config::DEF.each{|k, v|
+        var_value = CLI::Config.var_value_with_suffix(k)
+        is_valid = CLI::Config::DEF_TYPES[v[:type].to_s.upcase.to_sym][:validator]
+          .call(var_value, v, k)
+        invalid_defs << k unless is_valid
+      }
+      invalid_defs
     end
+
   end
-end
+end

data/bin/cli/create.rb

@@ -10,7 +10,7 @@
 
 module CLI
   def self.create
-    CLI.exit_error_missing_args! if CLI::ARGV1.nil?
+    CLI::Aroface.exit_error_missing_args! if CLI::ARGV1.nil?
     name = CLI::ARGV1&.to_s
     Aro::P.say(I18n.t("cli.messages.creation_attempt", name: name))
     if Aro::Create.new(name).initialized

data/bin/cli/deck.rb

@@ -20,7 +20,7 @@ module CLI
       Aro::Create.new(Aro::Db.get_name_from_namefile)
       Aro::Deck.display_selection_menu
     elsif action == CLI::CREATE_DECK_ACTIONS[:CREATE]
-      CLI.exit_error_missing_args! if CLI::ARGV2.nil?
+      CLI::Aroface.exit_error_missing_args! if CLI::ARGV2.nil?
       deck = Aro::Deck.make(CLI::ARGV2.to_s)
       Aro::P.say(I18n.t("cli.messages.deck_created_sucessfully", name: Aro::Mancy.game.name))
       Aro::Deck.display_selection_menu
@@ -39,7 +39,12 @@ module CLI
         Aro::Mancy.game.shuffle
       when CLI::LOAD_DECK_ACTIONS[:DRAW]
         Aro::P.say(I18n.t("cli.messages.drawing", name: Aro::Mancy.game.name))
-        Aro::Mancy.game.draw
+        Aro::P.p.say(I18n.t("cli.messages.drawing_from_dimension", dimension: "#{CLI::Config.var_value_with_suffix(:DIMENSION)}"))
+        Aro::Mancy.game.draw(
+          is_dt_dimension: CLI::Config.var_value_with_suffix(:DIMENSION).to_sym == CLI::Config::DMS[:DEV_TAROT],
+          z_max: CLI::Config.var_value_with_suffix(:Z_MAX).to_i,
+          z: CLI::Config.var_value_with_suffix(:Z)
+        )
       when CLI::LOAD_DECK_ACTIONS[:REPLACE]
         Aro::P.say(I18n.t("cli.messages.replacing_drawn", name: Aro::Mancy.game.name))
         Aro::Mancy.game.replace

data/bin/cli.rb

@@ -14,7 +14,6 @@ ENV[:ARO_ENV.to_s] = :production.to_s
 # ENV[:ARO_ENV.to_s] = :development.to_s
 
 module CLI
-  
   if CLI::LOAD_DECK_ACTIONS.keys.map{|k| k.downcase.to_sym}.include?(ARGV[0]&.to_sym)
     # enable deck shortcut (skip typing deck while in-game)
     ARGV0 = :deck
@@ -27,10 +26,14 @@ module CLI
     ARGV2 = ARGV[2]&.to_sym
   end
 
-  def self.exit_error_missing_args!
-    Aro::P.say(I18n.t("cli.errors.header"))
-    Aro::P.say(I18n.t("cli.errors.missing_args", cmd: "#{CLI::ARGV0} #{CLI::ARGV1} #{CLI::ARGV2}".strip))
-    exit(CLI::EXIT_CODES[:INVALID_ARG])
+  class Aroface
+
+    def self.exit_error_missing_args!
+      Aro::P.say(I18n.t("cli.errors.header"))
+      Aro::P.say(I18n.t("cli.errors.missing_args", cmd: "#{CLI::ARGV0} #{CLI::ARGV1} #{CLI::ARGV2}".strip))
+      exit(CLI::EXIT_CODES[:INVALID_ARG])
+    end
+
   end
 
 end

data/checksums/aro-0.1.4.gem.sha512

@@ -0,0 +1 @@
+5a6af41ca8e0e2eee62a129aca162bc709d5c3ded0c4ec7b6326fa6768d949313f320bd659cf00d5a0056c1adced4898fdd6d9c91c2a79f7d06018cc9cc61ad7

data/lib/aro/i18n.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 require :i18n.to_s
 
 module Aro

data/lib/aro/prompt.rb

@@ -15,7 +15,7 @@ module Aro
     end
 
     def self.say(message)
-      Aro::P::p.say("[#{Aro::Mancy::PS1}@#{Time.now.to_i}]: #{message}")
+      Aro::P::p.say(">[#{Aro::Mancy::PS1}::#{Time.now.to_i}]>: #{message}")
     end
 
     def self.less(display_text = "")

data/lib/aro/version.rb

@@ -1,4 +1,4 @@
 module Aro
-  VERSION = :"0.1.3"
-  RELEASE_NOTES = :"added deck show options for count and order."
+  VERSION = :"0.1.4"
+  RELEASE_NOTES = :"add multiple config variables, add much improved randomness"
 end

data/lib/aro.rb

@@ -16,8 +16,10 @@ module Aro
 
     attr_accessor :game
 
+    OS = 2
     PS1 = Aro::Mancy.name
-    NAME_FILE = ".name"
+    NAME_FILE = :".name".to_s
+    I2097I = :i2097i
 
     def initialize
       Aro::Create.new(Aro::Db.get_name_from_namefile)

data/lib/models/deck.rb

@@ -76,13 +76,6 @@ class Aro::Deck < ActiveRecord::Base
     end
   end
 
-  def self.read_dev_tarot
-    dt = nil
-    return dt unless File.exist?(Aro::Deck::DEV_TAROT_FILE)
-
-    File.open(Aro::Deck::DEV_TAROT_FILE, "r"){|dtf| dt = dtf.read(4)}
-  end
-
   def self.card_strip(card)
     card.gsub(/[+-]/, "").strip
   end
@@ -198,48 +191,97 @@ class Aro::Deck < ActiveRecord::Base
     update(drawn: "", cards: cards_arr.join(Aro::Deck::CARD_DELIM))
   end
 
-  def draw
-    # draw a random card from the current deck.
+  # read dev_tarot
+  def self.read_dev_tarot
+    dt = nil
+    return dt unless File.exist?(Aro::Deck::DEV_TAROT_FILE)
+
+    File.open(Aro::Deck::DEV_TAROT_FILE, "r"){|dtf| dt = dtf.read(4)}
+    
+    # VERY IMPORTANT!
+    Aro::P.say(I18n.t("cli.very_important", dev_tarot: dt))
+    return dt
+  end
+
+  # summon ruby_facot
+  def summon_ruby_facot(cards_arr)
+    Aro::P.say(I18n.t("cli.messages.ruby_facot_random"))
+    ruby_facot = cards_arr.sample.split("")
+
+    # get orientation
+    ruby_facot_str = ["+","-"].sample
+
+    # get suite
+    ruby_facot_str += ruby_facot[1]
+
+    # calculate the sym
+    symm = ruby_facot.select{|c|
+      # loops through the characters in ruby_facot
+      # return all characters not matching:
+      # => character[0]: orientation
+      # => character[1]: suite 
+
+      # the first two characters in the dev_tarot format designate the
+      !ruby_facot.first(Aro::Mancy::OS).include?(c)
+    }.join("").to_sym
+    ruby_facot_str += Aro::NUMERALS[symm].to_s
+
+    # return ruby_facot_str
+    ruby_facot_str
+  end
+
+  def draw(is_dt_dimension: true, z_max: 7, z: 1)    
+    # the true card
+    abs_dev_tarot = nil
+
+    # oriented card
     dev_tarot = nil
 
+    # get cards
+    cards_arr = cards.split(Aro::Deck::CARD_DELIM) || []
+    # get abs_cards
+    abs_cards_arr = cards_arr.map{|c| Aro::Deck.card_strip(c)}
+    # get drawn
+    drawn_arr = drawn&.split(Aro::Deck::CARD_DELIM) || []
+
+    # use fallback randomness if /dev/tarot unavailable
+    if !is_dt_dimension || !File.exist?(Aro::Deck::DEV_TAROT_FILE)
+      dev_tarot = summon_ruby_facot(cards_arr)
+      abs_dev_tarot = Aro::Deck.card_strip(dev_tarot)
+    end
+
+    sleeps = 0
+    sleeps_max = z_max
+
     # find a card that is not already drawn
-    while dev_tarot.nil? do
+    while sleeps <= sleeps_max && dev_tarot.nil? do
       # preferred randomness
-      dev_tarot = nil # Aro::Deck.read_dev_tarot&.strip&.split("")
-      
-      cards_arr = cards.split(Aro::Deck::CARD_DELIM) || []
-      cards_arr_stripped = cards_arr.map{|c| Aro::Deck.card_strip(c)}
-
-      if dev_tarot.nil?
-        # assume user does not have /dev/tarot device.
-        # generate random facade
-        facade = cards_arr.sample.split("")
-        dev_tarot = (
-          facade.first(2).join("") + 
-          Aro::NUMERALS[
-            facade.select{|c| !facade.first(2).include?(c)}.join("").to_sym
-          ].to_s
-        ).split("")
-      end
-
-      dev_tarot_converted = dev_tarot[1] + Aro::NUMERALS.key(
-        dev_tarot.select{|c| !dev_tarot.first(2).include?(c)}.join("").to_i
-      ).to_s
-      if cards_arr_stripped.include?(dev_tarot_converted)
-        # dev_tarot is valid
-        drawn_arr = drawn&.split(Aro::Deck::CARD_DELIM) || []
-        dev_tarot = dev_tarot[0] + dev_tarot_converted
-        drawn_arr << dev_tarot
-        cards_arr.delete_at(cards_arr_stripped.index(dev_tarot_converted))
-        update(
-          cards: cards_arr.join(Aro::Deck::CARD_DELIM),
-          drawn: drawn_arr.join(Aro::Deck::CARD_DELIM)
-        )
+      dev_tarot = Aro::Deck.read_dev_tarot&.strip&.split("")
+      if dev_tarot.present?
+        abs_dev_tarot = dev_tarot[1] + Aro::NUMERALS.key(
+          dev_tarot.select{|c| !dev_tarot.first(2).include?(c)}.join("").to_i
+        ).to_s
+        if abs_cards_arr.include?(abs_dev_tarot)
+          # dev_tarot is valid
+          dev_tarot = dev_tarot[0] + abs_dev_tarot
+        end
       else
         # dev_tarot is invalid
-        dev_tarot = nil
-        sleep(1)
+        sleeps += 1
+        sleep(z)
       end
     end
+
+    # remove from cards
+    cards_arr.delete(cards_arr.select{|c| c.include?(abs_dev_tarot)}.first)
+
+    # insert dev_tarot to drawn
+    drawn_arr << dev_tarot
+
+    # update database 
+    update(
+      cards: cards_arr.join(Aro::Deck::CARD_DELIM),
+      drawn: drawn_arr.join(Aro::Deck::CARD_DELIM)
+    )
   end
-end
+end

data/locale/en.usage.yml

@@ -27,6 +27,9 @@ en:
 
             $ aro create <name>
 
+        config
+          manage your aro config - not yet implemented
+
         deck
           perform operations on the deck(s) in current aro instance
 

data/locale/en.yml

@@ -1,11 +1,27 @@
 en:
   cli:
+    # VERY IMPORTANT!
+    very_important: "VERY IMPORTANT! %{dev_tarot}"
+    # VERY IMPORTANT!
+
     config:
+      format_description: "aro output format. possible values: [${possible values}]"
+      def_type: "CLI::Config::DEF_TYPES"
+      dimension_description: "chosen dimension of aro space. possible values: [${possible values}]"
+      dimension_dev_tarot_description: "reads from /dev/tarot device if available."
+      dimension_ruby_facot_description: "generated ruby_facot (facade randomness)."
+      draw_count_description: "number of cards in one line of draws. valid range: (${min}-${max})"
       generating_default_config: "missing config. generating default config file at %{name}."
       json_format_description: "show aro responses in json format."
+      maximum: "max"
+      minimum: "min"
       possible_values: "possible values"
       text_format_description: "show aro responses in text format (default)"
+      type_int_description: "a primitive decimal-less numeric."
+      type_values_description: "an enumerated type."
       sourcing_config: "loading configuration from %{name}..."
+      z_description: "sleep time between attempts to read /dev/tarot. valid range (%{min}-%{max})"
+      z_max_description: "max number of z long sleeps before giving up. valid range (%{min}-%{max})"
     errors:
       header: "error! something is out of place."
       missing_args: "the command you entered, '%{cmd}', is missing required argument(s)"
@@ -27,7 +43,12 @@ en:
 
         see aro --help for usage.
       deck_created_sucessfully: "%{name} deck created successfully"
-      drawing: "drawing a card from %{name}..."
+      drawing: "drawing a card from %{name}"
+      drawing_from_dimension: "in the the %{dimension} dimension..."
+      ruby_facot_random: |
+        unable to read from /dev/tarot - using facade randomness instead.
+        for more information visit:
+          https://github.com/arowmancy/dev_tarot
       history_drawn: "drawn cards"
       no_decks: |
         no decks created yet.
@@ -37,7 +58,7 @@ en:
           $ aro deck create <deck_name>
 
         see aro --help for usage.
-      showing: "%{name}: (count: [%{count}], order: [%{order}])..."
+      showing: "showing %{name} [count:%{count}, order:%{order}]..."
       shuffling: "shuffling %{name}'s cards..."
       replacing_drawn: "all drawn cards to %{name}..."
       resetting: "resetting %{name}'s cards..."

data/tasks/console.rake

@@ -0,0 +1,8 @@
+desc "run irb console with aro and autocomplete"
+task :console do
+  require :irb.to_s
+  require :"irb/completion".to_s
+  require :aro.to_s
+  ARGV.clear
+  IRB.start
+end

data/tasks/make.rake

@@ -0,0 +1,4 @@
+desc "rspec && rake install"
+task :make do
+  exec "rspec && rake install"
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aro
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - i2097i
@@ -69,26 +69,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 3.13.2
-- !ruby/object:Gem::Dependency
-  name: x
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.16'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.16.0
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.16'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.16.0
 - !ruby/object:Gem::Dependency
   name: i18n
   requirement: !ruby/object:Gem::Requirement
@@ -177,6 +157,15 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".gitignore"
+- ".release"
+- ".ruby-version"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- aro.gemspec
 - bin/aro
 - bin/cli.rb
 - bin/cli/config.rb
@@ -184,6 +173,7 @@ files:
 - bin/cli/create.rb
 - bin/cli/deck.rb
 - bin/cli/usage.rb
+- checksums/aro-0.1.4.gem.sha512
 - db/migrate/1763374647_create_decks.rb
 - db/migrate/1763432541_create_logs.rb
 - lib/aro.rb
@@ -199,6 +189,13 @@ files:
 - locale/en.cards.yml
 - locale/en.usage.yml
 - locale/en.yml
+- pkg/aro-0.1.0.gem
+- pkg/aro-0.1.1.gem
+- pkg/aro-0.1.2.gem
+- pkg/aro-0.1.3.gem
+- pkg/aro-0.1.4.gem
+- tasks/console.rake
+- tasks/make.rake
 homepage: https://github.com/i2097i/aro
 licenses:
 - MIT
@@ -206,6 +203,7 @@ metadata: {}
 rdoc_options: []
 require_paths:
 - lib
+- bin/cli
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="