aro 0.1.6 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2d38dfc3076510642fc060178b2de03eb366c527ac6e88c2bfeb746f85b0e6b9
-  data.tar.gz: c58bdbb118b84d1bd05709cf19942cf7ac69c1ab66cbdb91b916fe42fb7b0ab0
+  metadata.gz: 526b2b77c9a4a0315c096cf27028a45a3294113ea198d36771a690d34efbcb25
+  data.tar.gz: a3f5c221245676bf831498b1517fcb654deeec2c5ecd6ad1aa5b7ba3b4bf3c67
 SHA512:
-  metadata.gz: 4cf670b3a0bfefd708c9a6286218a4474394eb10b9669e359f3eec157052e0f6762a88e9f93ee31299bea09f9d0a41e51dbbf5019e42f1870ece83093dad00fe
-  data.tar.gz: 9ca02e7c6b8f772ae6ff92b4f392c32c4d8fa830611af35d8ddd3b1b455536d2b1af37e4ea4ed2a1e3ab1f0ec49d930b30a3e2c0c1f1498e841feb05ead09549
+  metadata.gz: 311cb1b3d8df2da508f73b954c3169c92cb3fb5a0532b08ba60b96e31f6cf0a0681ee70d166ee68fcedeae8064a07b05498b491585c5a4f7aca3d1f8da3b25bd
+  data.tar.gz: 2ec454c0546e13d18ea541b40cf29308aa443e986559ced667918cc63bac3dcaa1406f02a2a93ed0383a7f9c7d7b378bb945897e850b8f0f123f579a8fb34fc2

data/.gitignore

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

data/.ruby-version

@@ -1 +1 @@
-ruby-3.4.7
+3.4.7

data/Gemfile.lock

@@ -1,9 +1,10 @@
 PATH
   remote: .
   specs:
-    aro (0.1.3)
+    aro (0.1.7)
       activerecord (~> 8.1, >= 8.1.1)
       i18n (~> 1.14, >= 1.14.7)
+      listen (~> 3.9, >= 3.9.0)
       sqlite3 (~> 2.8, >= 2.8.0)
       tty-prompt (~> 0.23.1, >= 0.23.1)
 
@@ -32,17 +33,33 @@ GEM
     base64 (0.3.0)
     bigdecimal (3.3.1)
     concurrent-ruby (1.3.5)
-    connection_pool (2.5.4)
+    connection_pool (3.0.2)
     diff-lcs (1.6.2)
     drb (2.2.3)
+    ffi (1.17.2-aarch64-linux-gnu)
+    ffi (1.17.2-aarch64-linux-musl)
+    ffi (1.17.2-arm-linux-gnu)
+    ffi (1.17.2-arm-linux-musl)
+    ffi (1.17.2-arm64-darwin)
+    ffi (1.17.2-x86-linux-gnu)
+    ffi (1.17.2-x86-linux-musl)
+    ffi (1.17.2-x86_64-darwin)
+    ffi (1.17.2-x86_64-linux-gnu)
+    ffi (1.17.2-x86_64-linux-musl)
     i18n (1.14.7)
       concurrent-ruby (~> 1.0)
-    json (2.16.0)
+    json (2.17.1)
+    listen (3.9.0)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
     logger (1.7.0)
-    minitest (5.26.1)
+    minitest (5.26.2)
     pastel (0.8.0)
       tty-color (~> 0.5)
     rake (13.3.1)
+    rb-fsevent (0.11.2)
+    rb-inotify (0.11.1)
+      ffi (~> 1.0)
     rspec (3.13.2)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
@@ -57,16 +74,16 @@ GEM
       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)
+    sqlite3 (2.8.1-aarch64-linux-gnu)
+    sqlite3 (2.8.1-aarch64-linux-musl)
+    sqlite3 (2.8.1-arm-linux-gnu)
+    sqlite3 (2.8.1-arm-linux-musl)
+    sqlite3 (2.8.1-arm64-darwin)
+    sqlite3 (2.8.1-x86-linux-gnu)
+    sqlite3 (2.8.1-x86-linux-musl)
+    sqlite3 (2.8.1-x86_64-darwin)
+    sqlite3 (2.8.1-x86_64-linux-gnu)
+    sqlite3 (2.8.1-x86_64-linux-musl)
     timeout (0.4.4)
     tty-color (0.6.0)
     tty-cursor (0.7.1)
@@ -92,6 +109,7 @@ PLATFORMS
   x86-linux-gnu
   x86-linux-musl
   x86_64-darwin
+  x86_64-linux
   x86_64-linux-gnu
   x86_64-linux-musl
 

data/aro.gemspec

@@ -1,21 +1,29 @@
-# coding: utf-8
+=begin
+  
+  aro.gemspec
 
-require :aro.to_s
+  aro gem specification.
+
+  by i2097i
+
+=end
+
+require_relative :"sys/shr/version".to_s
 
 Gem::Specification.new do |spec|
   spec.name          = "aro"
-  spec.version       = Aro::VERSION
+  spec.version       = Aro::VERSION.to_s
   spec.authors       = ["i2097i"]
   spec.email         = ["i2097i@hotmail.com"]
   spec.description   = "a cli for tarot."
-  spec.summary       = "follow the way of the aro eht."
+  spec.summary       = Aro::RELEASE_NOTES.to_s
   spec.homepage      = "https://github.com/i2097i/aro"
   spec.license       = "MIT"
-
-  spec.files         = `git ls-files`.split("\n").reject{|f| f.match(%r{^(spec|pkg)/})}
+  spec.files         = `git ls-files`.split("\n").reject{|p| p.match?(/^(spec|.release|.*.gem$)/)}
   spec.bindir        = "bin"
   spec.executables   = ["aro"]
-  spec.require_paths = ["lib", "bin/cli"]
+  spec.require_paths = ["sys"]
+  spec.required_ruby_version = ">= 3.4.7"
 
   # development gems
   spec.add_development_dependency "bundler",      "~> 2.7", ">= 2.7.2"
@@ -27,4 +35,5 @@ Gem::Specification.new do |spec|
   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"
+  spec.add_runtime_dependency     "listen",       "~> 3.9", ">= 3.9.0"
 end

data/bin/aro

@@ -4,41 +4,41 @@
   
   aro
 
-  entry point for the aro cli
+  entry point for the aro cli.
 
   by i2097i
 
 =end
 
-require_relative :cli.to_s
+require :aro.to_s
 
 # todo: add tab completion using abbrev gem
 # https://stackoverflow.com/a/11627931
 
-module CLI
-  if CLI::FLAGS[:VERSION].include?(CLI::ARGV0)
-    Aro::P.say(Aro::VERSION)
-    exit(CLI::EXIT_CODES[:SUCCESS])
-  end
+if CLI::FLAGS[:VERSION].include?(CLI::ARGV0)
+  Aro::P.say(Aro::VERSION)
+  exit(CLI::EXIT_CODES[:SUCCESS])
+end
 
-  # initialize config
-  CLI::Config.instance
-
-  # cli parser
-  case CLI::ARGV0
-  when :create
-    CLI::create
-  when :deck
-    CLI::deck
-  else
-    unless Aro::Mancy.game.nil? || CLI::FLAGS[:HELP].include?(CLI::ARGV0)
-      Aro::P.say(I18n.t("cli.messages.welcome", name: "#{Aro::Mancy.name}.game.show"))
-      Aro::Mancy.game.show
-      exit(CLI::EXIT_CODES[:SUCCESS])
-    end
-
-    CLI::usage
+# cli parser
+case CLI::ARGV0
+when CLI::CMDS[:ARO][:CONFIG]
+  CLI::config
+when CLI::CMDS[:ARO][:CREATE]
+  CLI::create
+when CLI::CMDS[:ARO][:DECK]
+  CLI::deck
+when CLI::CMDS[:ARO][:DOM]
+  CLI::dom
+when CLI::CMDS[:ARO][:INIT]
+  Aro::Mancy.init
+else
+  unless Aro::Mancy.game.nil? || CLI::FLAGS[:HELP].include?(CLI::ARGV0)
+    Aro::P.say(I18n.t("cli.messages.welcome", name: "#{Aro::Mancy.name}.game"))
+    Aro::Mancy.game.show
     exit(CLI::EXIT_CODES[:SUCCESS])
   end
 
+  CLI.usage
+  exit(CLI::EXIT_CODES[:SUCCESS])
 end

data/checksums/aro-0.1.6.gem.sha512

@@ -0,0 +1 @@
+52fd8d90abad947eb27a4dc634f2048128d42349005d1b9f93a52518332cf8e14433b05170d077453b5753b83a6f6b7c9df36fc575e792ca2a5dbf3312e06f59

data/listen.rb

@@ -0,0 +1,10 @@
+require :listen.to_s
+
+listener = Listen.to(*[:sys.to_s, :bin.to_s, :spec.to_s, :locale.to_s], only: /[\.rb\.yml]/) {|modified, added, removed|
+  # puts modified
+  # puts added
+  # puts removed 
+  system("exec rake make")
+}
+listener.start
+sleep

data/locale/en.usage.yml

@@ -1,63 +1,76 @@
 en: 
-  cli:
-    usage: |
+  usage:
+    main: |
       NAME
 
-        aro - a cli for tarot.
+        aro - a cli for tarot games in the arodom.
 
       SYNOPSIS
 
         aro [-v | --version] [-h | --help] <command1> <command2>
 
-        to pick up where you left off, simply enter the following command:
-        
-          $ aro 
-
       COMMANDS
-
-        there are two primary commands in the aro. one is to create and the
-        other is to play.
-
         create
-          create an aro directory named <name>. if directory already exists, abort.
-
-          aro create <name>
-
-          examples:
+          create and init an aro game room named <name>:
 
             $ aro create <name>
 
+        init
+          set up the .aro directory that contains database and config
+          
+          note:
+            this runs by default after create and has no effect if init is complete.
+
         config
-          todo: manage your aro config - not yet implemented
+          config management (ex: update preferences)
+          todo:
 
         deck
-          perform operations on the deck(s) in current aro instance
+          manage decks in the current room
+
+            $ aro deck <commands>
+
+          note:
+
+            deck subcommands do not require typing 'deck'. for example,
 
-          aro deck [-h | --help] <command>
+            $ aro deck show
 
-          running `aro deck` with no arguments prompts user to select a deck.
+            is the same thing as:
 
-            $ aro deck
+            $ aro show
 
-          COMMANDS
+          SUBCOMMANDS
+            draw
+              draw a random card from the current deck.
 
-            create
+            explore
+              allows user to browse each card in the current deck.
 
-              creates a new deck with the specified name.
+            new
+              create a new deck with the specified name.
 
                 example:
 
-                  $ aro deck create <name_of_new_deck>
+                  $ aro deck create <name>
 
-            show
+            replace
+              replaces all drawn cards FIFO and puts them on the bottom of
+              the deck. this will preserve all card orientations.
+            
+            reset
+              completely reset the deck. replace all drawn and reset order.
+              all orientations will be set to upright. you must enter 'aroyes'
+              to continue.
 
+            show
               displays the current deck's log record(s).
 
               the default behavior is to display only the most recent log record.
 
               note: 
               
-                'less' is automatically used to display records if --count > 1
+                'less' is automatically used to view text output log count > 1
 
               OPTIONS
 
@@ -74,26 +87,31 @@ en:
                                   possible values: ['asc', 'desc']
 
             shuffle
-
               shuffles the current deck and generates a log record.
 
-            explore
+        dom
+          create or manage an arodome (ex: list game rooms)
 
-              allows user to browse each card in the current deck.
+          $ aro dom <commands>
 
-            draw
+          SUBCOMMANDS
+            init
+              generate the arodome
 
-              draw a random card from the current deck.
+            map
+              display arodome map
 
-            replace
+                example
+
+                  $ aro dom map
+            new
+              create a new arodome with the specified name.
+
+                example:
+
+                  $ aro dom new <name>
 
-              replaces all drawn cards FIFO and puts them on the bottom of
-              the deck. this will preserve all card orientations.
-            
-            reset
 
-              completely reset the deck. replace all drawn and reset order.
-              all orientations will be set to upright.
 
 
 

data/locale/en.yml

@@ -5,12 +5,24 @@ en:
     # VERY IMPORTANT!
 
     config:
-      format_description: "aro output format. possible values: [${possible values}]"
+      aro_env_O_description: "read-only env var for holding O."
+      aro_env_S_description: "read-only env var for holding S."
+      aro_env_OS_description: "read-only env var for holding OS."
+      aro_env_N_description: "read-only env var for holding N"
+      aro_env_PS1_description: "read-only env var for holding default PS1."
+      aro_env_NAME_FILE_description: "read-only env var for name file."
+      aro_env_I2097I_description: "read-only env var for i2097i."
+      aro_env_YES_description: "read-only env var for 'aroyes'."
+      format_description: "aro output format."
       def_type: "CLI::Config::DEF_TYPES"
-      dimension_description: "chosen dimension of aro space. possible values: [${possible values}]"
+      dimension_description: "selected dimension of aro space."
       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})"
+      display_columns_description: "display width multiplier. valid range: (${min}-${max})"
+      env_description: "aro run environment."
+      env_development_description: "basic development logs and features."
+      env_production_description: "game logging only."
+      env_test_description: "logging and features tailored for tests."
       generating_default_config: "missing config. generating default config file at %{name}."
       json_format_description: "show aro responses in json format."
       maximum: "max"
@@ -18,16 +30,21 @@ en:
       possible_values: "possible values"
       text_format_description: "show aro responses in text format (default)"
       type_int_description: "a primitive decimal-less numeric."
+      type_string_description: "a blank-space-terminated string of characters."
       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)"
-      missing_deck: "no deck selected. use 'aro deck' to select one or 'aro deck create deck_name' to create one."
+      # , cmd: Aro::Mancy::I2097I))
+      header: "$ %{cmd}: !error."
+      invalid_usage: "$ %{cmd}: !says you're not supposed to be here."
+      missing_args: "$ %{cmd}: !says missing required argument(s)."
+      missing_deck: "$ %{cmd}: !no deck selected. use 'aro deck' to select one or 'aro deck create <name>' to create one."
+      not_in_aro: "$ %{cmd}: !you are not in aro space. that command will not work here."
     warnings:
       invalid_order: "the order specified for displaying logs in invalid. using default (desc)."
+      not_initialized: "warning - you need to initialize aro. run 'aro init' to do so"
     messages:
       choose_card: "choose a card."
       confirmation_prompt: "input 'aroyes' to reset %{name}, or enter to cancel (cancel): "

data/sys/aro/d.rb

@@ -0,0 +1,25 @@
+=begin
+  
+  d.rb
+
+  d logger for i2097i.
+
+  by i2097i
+
+=end
+
+require_relative :"../shr/prompt".to_s
+
+module Aro
+  class D < Aro::Prompt
+    def self.say(message)
+      return unless Aro::D.should_print?
+      Aro::P::p.say(">[#{Aro::Mancy::I2097I}]>: #{message}\n")
+    end
+
+    def self.should_print?
+      Aro::Mancy::ARO_ENV_DEBUG_MODES.include?(ENV[:ARO_ENV.to_s]&.to_sym)
+    end
+  end
+end
+

data/sys/aro/db.rb

@@ -0,0 +1,96 @@
+=begin
+  
+  db.rb
+
+  database for aro room.
+
+  by i2097i
+
+=end
+
+module Aro
+  class Db
+    DATABASE_YML = :"database.yml"
+    SQL_FILE = :"database.sql"
+    SCHEMA_FILE = :"schema.rb"
+    MIGRATIONS_DIR = :"db/migrate"
+
+    def initialize
+      unless Aro::Mancy.is_aro_space?
+        Aro::P.say(I18n.t("cli.errors.not_in_aro" , cmd: Aro::Mancy::I2097I))
+        return
+      end
+
+      if Aro::Mancy.is_initialized?
+        setup_local_aro
+      else
+        Aro::P.say(I18n.t("cli.warnings.not_initialized"))
+      end
+    end
+
+    def connect(name)
+      ActiveRecord::Base.establish_connection(config)
+    end
+
+    def config
+      @config ||= YAML.load_file(db_config_filepath)
+    end
+
+    def self.base_aro_dir
+      base_aro_file = Aro::Mancy::ARO_FILE.to_s
+      CLI::Config.is_test? ? "#{base_aro_file}_test" : base_aro_file 
+    end
+
+    def db_config_filepath
+      File.join(Aro::Db.base_aro_dir, Aro::Db::DATABASE_YML.to_s)
+    end
+
+    def self.get_name_from_namefile
+      Aro::Mancy.is_aro_space? ? File.read(Aro::Mancy::NAME_FILE.to_s).strip : nil
+    end
+
+    def setup_local_aro
+      name = Aro::Db.get_name_from_namefile
+      return if name.nil?
+
+      # create local .aro/ directory
+      unless File.exist?(Aro::Db.base_aro_dir)
+        FileUtils.mkdir(Aro::Db.base_aro_dir)
+      end
+
+      unless File.exist?(db_config_filepath)
+        # create database config yaml file
+        c = {
+          adapter: :sqlite3.to_s,
+          database: File.join(Aro::Db.base_aro_dir, Aro::Db::SQL_FILE.to_s),
+          username: name,
+          password: name
+        }.to_yaml
+        File.open(db_config_filepath, "w") do |file|
+          file.write(c)
+        end
+      end
+
+      connect(name)
+      migrate(name)
+    end
+
+    def migrate(name)
+      local_migrate_dir = File.join(Aro::Db.base_aro_dir, Aro::Db::MIGRATIONS_DIR.to_s)
+      unless Dir.exist?(local_migrate_dir)
+        gem_dir = Dir[Gem.loaded_specs[:aro.to_s]&.full_gem_path || '.'].first
+        FileUtils.cp_r(File.join(gem_dir, "db"), Aro::Db::base_aro_dir)
+      end
+
+      migration_version = Dir["#{local_migrate_dir}/*.rb"].map{|n|
+        Pathname.new(n).basename.to_s.split("_")[0].to_i
+      }.max
+      ActiveRecord::MigrationContext.new(local_migrate_dir).migrate(migration_version)
+
+      filename = File.join(Aro::Db.base_aro_dir, Aro::Db::SCHEMA_FILE.to_s)
+      File.open(filename, "w+") do |f|
+        ActiveRecord::SchemaDumper.dump(ActiveRecord::Base.connection_pool, f)
+      end
+    end
+  end
+end

data/sys/aro/mancy.rb

@@ -0,0 +1,117 @@
+=begin
+  
+  aro.rb
+
+  aro and mancy.
+
+  by i2097i
+
+=end
+
+module Aro
+  class Mancy
+    include Singleton
+
+    attr_accessor :game
+
+    O  = 0
+    S  = 1
+    OS = 2
+    N  = 4
+    PS1 = Aro::Mancy.name
+    NAME_FILE = :".name"
+    ARO_FILE = :".aro"
+    I2097I = :i2097i
+    YES = :aroyes
+    ALL = :all
+
+    ARO_ENV_DEBUG_MODES = [:development, :test]
+    DEBUG_VERBOSE = false
+
+    NUMERALS = {
+      O:       0,
+      I:       1,
+      II:      2,
+      III:     3,
+      IV:      4,
+      V:       5,
+      VI:      6,
+      VII:     7,
+      VIII:    8,
+      IX:      9,
+      X:       10,
+      XI:      11,
+      XII:     12,
+      XIII:    13,
+      XIV:     14,
+      XV:      15,
+      XVI:     16,
+      XVII:    17,
+      XVIII:   18,
+      XIX:     19,
+      XX:      20,
+      XXI:     21,
+      XXII:    22,
+      MMXCVII: Aro::Mancy::I2097I[Aro::Mancy::S..Aro::Mancy::N].to_i,
+    }
+
+    def initialize
+      # ENV bindings
+      ENV[:ARO_ENV_O.to_s] = "#{Aro::Mancy::O}"
+      ENV[:ARO_ENV_S.to_s] = "#{Aro::Mancy::S}"
+      ENV[:ARO_ENV_OS.to_s] = "#{Aro::Mancy::OS}"
+      ENV[:ARO_ENV_N.to_s] = "#{Aro::Mancy::N}"
+      ENV[:ARO_ENV_PS1.to_s] = "#{Aro::Mancy::PS1}"
+      ENV[:ARO_ENV_NAME_FILE.to_s] = "#{Aro::Mancy::NAME_FILE}"
+      ENV[:ARO_ENV_I2097I.to_s] = "#{Aro::Mancy::I2097I}"
+      ENV[:ARO_ENV_YES.to_s] = "#{Aro::Mancy::YES}"
+
+      if Aro::Mancy.is_aro_space?
+        Aro::Db.new
+        self.game = Aro::Deck.current_deck
+      end
+    end
+
+    def self.game
+      Aro::Mancy.instance.game
+    end
+
+    def self.create(name)
+      return false if Aro::Mancy.is_aro_space? || name.nil?
+
+      # explicitly only allow String/Symbol types for name
+      return false unless name.kind_of?(String) || name.kind_of?(Symbol)
+      name = name.to_s.strip
+      
+      # create the new aro directory and database
+      if !Dir.exist?(name)
+        Aro::P.say(I18n.t("cli.messages.no_decks"))
+        FileUtils.mkdir(name)
+      else
+        return false
+      end
+
+      # create name file
+      File.open(File.join(name, Aro::Mancy::NAME_FILE.to_s), "w+") do |file|
+        file.write(name)
+      end
+
+      Dir.chdir(name) do
+        Aro::Db.new.setup_local_aro
+      end
+      return true
+    end
+
+    def self.init
+      Aro::Db.new.setup_local_aro
+    end
+
+    def self.is_initialized?
+      Dir.exist?(Aro::Db.base_aro_dir)
+    end
+
+    def self.is_aro_space?
+      File.exist?(Aro::Mancy::NAME_FILE.to_s)
+    end
+  end
+end