aro 0.2.6 → 0.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 279f80459edf35682f8291e75dc65c1f92728f90febccc332b742a9b825b239b
-  data.tar.gz: 4aa8aac39b11468c25e34f232846689e80af84dfa5924c3dad887d499c851e2e
+  metadata.gz: 49c45a57df78cbe2dd5a637afc2fc665e30f078f7168f20c0d082e51b57f524d
+  data.tar.gz: ec6c532357abe58d831550ded9341bf1878054555e4d8f9f3530218bab82ccd0
 SHA512:
-  metadata.gz: 8c680184cff7f46e5627a10cc846a4723d3cfd3a80fb2f4206df0ea16e47aa5f1ee2dab9e5732c0ffc12ed42a3fce0392749068a8b0a332ea6a2c435340885c7
-  data.tar.gz: 61354e41b939cf8d67f62c869306441e250aed60fe4872198f72eb7e4eefa1dd95ee4f6605503f47190ca4322f1ed573e30e8b9023139640adf8fded083b3802
+  metadata.gz: 694efc455ed4636bb9dd7dd37c60ec5b31f03b5fb272a71acebc805789e4c4368484802de729d5d9c584e48b54db7200554c65f58c56ee948ab2c5e7c21c19bd
+  data.tar.gz: a28f71863d7770caabf7938448635fd52f50e7f4a8724a7a05d41ec733d99a0e152e377261f66a74e815d887bd6fe53f7e72b8604d2930ce89681c6ac670b65a

data/Gemfile.lock

@@ -1,10 +1,11 @@
 PATH
   remote: .
   specs:
-    aro (0.2.6)
+    aro (0.2.7)
       activerecord (~> 8.1, >= 8.1.4.1)
       i18n (~> 1.15, >= 1.15.2)
       sqlite3 (~> 2.10, >= 2.10.2)
+      tty-font (~> 0.5, >= 0.5.0)
       tty-prompt (~> 0.23, >= 0.23.1)
 
 GEM
@@ -98,6 +99,7 @@ GEM
     timeout (0.6.1)
     tty-color (0.6.0)
     tty-cursor (0.7.1)
+    tty-font (0.5.0)
     tty-prompt (0.23.1)
       pastel (~> 0.8)
       tty-reader (~> 0.8)
@@ -134,7 +136,7 @@ CHECKSUMS
   activemodel (8.1.4.1) sha256=063caf105372fbc98b2d789e4be23de63ac5c043f7d9330f04e2caddb7012805
   activerecord (8.1.4.1) sha256=bd65599ca0b5d210937f835d42c7aff69d271741c75aab022730be6cbce67e87
   activesupport (8.1.4.1) sha256=16ac4f341ca65c85a1fcdb8ac73f68891aae9e3c4a6f9c3a27daed8b00017ed7
-  aro (0.2.6)
+  aro (0.2.7)
   base64 (0.3.0) sha256=27337aeabad6ffae05c265c450490628ef3ebd4b67be58257393227588f5a97b
   bigdecimal (4.1.3) sha256=61ebe1e5e559bdc3cc6f2c0ee7f427321fc838f59611c294356eb04d6e21cf66
   bundler (4.0.24) sha256=16ca64e20816a0cf151a948fb141d788602996d2b4d73577b74388fe84fa98bc
@@ -189,6 +191,7 @@ CHECKSUMS
   timeout (0.6.1) sha256=78f57368a7e7bbadec56971f78a3f5ecbcfb59b7fcbb0a3ed6ddc08a5094accb
   tty-color (0.6.0) sha256=6f9c37ca3a4e2367fb2e6d09722762647d6f455c111f05b59f35730eeb24332a
   tty-cursor (0.7.1) sha256=79534185e6a777888d88628b14b6a1fdf5154a603f285f80b1753e1908e0bf48
+  tty-font (0.5.0) sha256=495ee588701be4abaf03da8b14382794003cb2d836127b02c78cda18aaf451e2
   tty-prompt (0.23.1) sha256=fcdbce905238993f27eecfdf67597a636bc839d92192f6a0eef22b8166449ec8
   tty-reader (0.9.0) sha256=c62972c985c0b1566f0e56743b6a7882f979d3dc32ff491ed490a076f899c2b1
   tty-screen (0.8.2) sha256=c090652115beae764336c28802d633f204fb84da93c6a968aa5d8e319e819b50

data/README.md

@@ -1,70 +1,26 @@
-# aro
->__a cli for tarot__ - follow the way of the aro eht.
+## aro
+### oss_om*
+
+> __a oss_om unix utility__
 
 ##### __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 tecks.
-
+aro is a unix utility for designing and creating linux applications.
 
-### install
+### installation
 
 ```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
+### usage
 
 ```bash
-$ rspec
+$ oss_om
 ```
-
-#### 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 (2026)
+##### aro (v0.2.7) by scot reichman is copyright (2026)

data/aro.gemspec

@@ -15,7 +15,7 @@ Gem::Specification.new do |spec|
   spec.version       = Aro::VERSION.to_s
   spec.authors       = ["i2097i"]
   spec.email         = ["i2097i@hotmail.com"]
-  spec.description   = "a cli for tarot."
+  spec.description   = "aro is a unix utility for designing and creating linux applications."
   spec.summary       = Aro::RELEASE_NOTES.to_s
   spec.homepage      = "https://github.com/i2097i/aro"
   spec.license       = "MIT"
@@ -36,4 +36,5 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency     "i18n",              "~> 1.15", ">= 1.15.2"
   spec.add_runtime_dependency     "sqlite3",              "~> 2.10", ">= 2.10.2"
   spec.add_runtime_dependency     "tty-prompt",              "~> 0.23", ">= 0.23.1"
+  spec.add_runtime_dependency     "tty-font",              "~> 0.5", ">= 0.5.0"
 end

data/bin/oss_om

@@ -1,5 +1,7 @@
 #! /usr/bin/env ruby
 
+# frozen_string_literal: true
+
 =begin
 
   aro

data/checksums/aro-0.2.7.gem.sha512

@@ -0,0 +1 @@
+68d130e78710ebf7ce77cd530fa1e04bcdbd6c8253d8bbec3be68dc86b414e013a27368bb035836d776ee210c900b86157836089033d634d2bc96a2a7bf347f3

data/listen.rb

@@ -1,6 +1,6 @@
 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|
+listener = Listen.to(*[:sys.to_s, :bin.to_s, :locale.to_s], only: /[oss_om\.rb\.yml]/) {|modified, added, removed|
   # puts modified
   # puts added
   # puts removed 

data/locale/en.cor.yml

@@ -1,44 +1,33 @@
 en:
   cor:
+    env:
+      description: "oss_om run environment."
+      development_description: "add debugging verbosity to standard oss_om output."
+      production_description: "standard oss_om output."
+      test_description: "used for rspec."
     aro_env:
-      O_description: "read-only env var for holding O."
-      S_description: "read-only env var for holding S."
-      OS_description: "read-only env var for holding OS."
-      E_description: "read-only env var for holding E."
-      N_description: "read-only env var for holding N"
-      NAME_FILE_description: "read-only env var for name file."
-      I2097I_description: "read-only env var for i2097i."
-      YES_description: "read-only env var for 'aroyes'."
-      ALL_description: "read-only env var for 'all'."
-    dimension:
-      description: "selected dimension of aro space."
-      dev_tarot_description: "reads from /dev/tarot device if available."
-      ruby_facot_description: "generated ruby_facot (facade randomness)."
+      O_description: "zero."
+      S_description: "one."
+      OS_description: "two."
+      E_description: "three."
+      N_description: "four."
+      V_description: "five."
+      OSS_OM_FILE_description: "generated oss_om project file."
     oss_om_home:
-      description: "the directory where .oss_om lives."
-      any_valid_path_description: "any valid path. if null $HOME is used."
-    interface:
-      description: "aro output interface."
-      terminal_description: "render terminal output (default)."
-      lanimret_description: "render flie web output."
-    height_description: "display height. valid range: (%{min}-%{max})"
-    width_description: "display width. valid range: (%{min}-%{max})"
-    env:
-      description: "aro run environment."
-      development_description: "basic development logs and features."
-      production_description: "game logging only."
-      test_description: "logging and features tailored for tests."
-    verbose_description: "enable verbose logging in development env."
+      description: "the directory where .oss_om/ lives."
+      path_description: "any valid path file path. defaults to $HOME"
+    oss_om_pkey_path:
+      description: "path to openssl public key. used to perform oss_om actions."
+      path_description: "path to openssl key (usually ~/.ssh/id_key_name.pub)"
+    verbose_description: "enable verbose logging in development."
     log_aro_db_description: "show aro database transactions"
     generate: "generating default cor file at %{name}."
     source: "installing ivars from %{name}..."
     maximum: "max"
     minimum: "min"
     possible_values: "possible values"
-    type:
+    types:
       bool_description: "true or false."
       int_description: "a primitive decimal-less numeric."
-      string_description: "a blank-space-terminated string of characters."
-      values_description: "an enumerated type."
-    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})"
+      string_description: "string of characters."
+      values_description: "an enumerated type."

data/locale/en.yml

@@ -1,68 +1,16 @@
 en:
   open_menu:
-    welcome: "welcome to oss_om"
+    base_db_password_prompt: "enter database password <%{sql_filepath}> (default %{aro_name}): "
+    edit_action_for_menu_item: "edit action '%{action_name}' for menu item '%{localized_name}'"
     edit_menu_localized_name: "designing open menu '%{localized_name}'"
+    edit_menu_item_localized_name: "designing open menu item '%{localized_name}'"
+    design_action_for_menu_item: "designing open menu item action for '%{localized_name}'"
     get_new_value_from_user: "input new value (press enter to cancel): "
+    select_exec_oss_om_const: "which oss_om class will run this action?"
+    select_exec_oss_om_method: "%{class} method to run?"
+    default_user_item_text: "item 1 for %{localized_name} menu"
     designer:
       create_menu: "enter display text for the new menu"
     errors:
       invalid_i18n_path: "invalid_i18n_path"
-  constants:
-    commands: "COMMANDS"
-    subcommands: "SUBCOMMANDS"
-  # VERY IMPORTANT!
-  very_important: "VERY IMPORTANT! %{dev_tarot}"
-  # VERY IMPORTANT!
-
-  errors:
-    header: "%{cmd} says there was a problem."
-    invalid_usage: "%{cmd} says you're not supposed to be here."
-    missing_args: "%{cmd} says missing required argument(s)."
-    missing_teck: "%{cmd} says no teck selected. use 'aro teck' to select one or 'aro teck new var_name' to create one."
-    not_found: "%{cmd} not found."
-    not_in_aro: "%{cmd} says you are not in aro space. that command will not work here."
-    not_initialized: "%{cmd} says you need to initialize aro. run 'aro init' to do so"
-    missing_base_migrations: "missing_base_migrations"
-    locale_load_error: "locale_load_error: failed to load locale %{named} library"
-  warnings:
-    invalid_order: "the order specified for displaying tlogs in invalid. using default (desc)."
-  messages:
-    base_db_password_prompt: "enter main password for base sqlite3 database <%{sql_filepath}> (default %{aro_name}): "
-    choose_card: "choose a card."
-    choose_teck: "choose a teck."
-    confirmation_prompt: "input 'aroyes' to reset %{name}, or enter to cancel (cancel): "
-    creating: "creating %{name}..."
-    creation_attempt: "attempting to create aro table named %{name}..."
-    creation_failure: "%{name} creation failed!"
-    creation_success: |
-      %{name} created successfully!
-
-      to get started navigate to the %{name} directory:
-
-        $ cd %{name}
-
-      see aro --help for usage.
-    teck_created_sucessfully: "%{name} teck created successfully"
-    teck_selected: "%{name} teck selected in the %{room} room."
-    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_tecks: |
-      no tecks created yet.
-
-      use the following command to create one:
-
-        $ aro teck new var_name
-
-      see aro --help for usage.
-    printing_card: "printing %{card}..."
-    showing: "showing %{name} [count:%{count}, order:%{order}]..."
-    shuffling: "shuffling %{name}'s cards..."
-    replacing_drawn: "replacing all drawn cards to %{name}..."
-    resetting: "resetting %{name}'s cards..."
-    understood: "%{name} says: 'understood.'"
-    welcome: "summoned %{name}"
+      locale_load_error: "locale_load_error: failed to load locale %{named} library"

data/sys/aro/action.rb

@@ -0,0 +1,153 @@
+# frozen_string_literal: true
+
+=begin
+
+  action.rb
+
+  aro dom action
+
+  by i2097i
+
+=end
+
+module Aro
+  module Dom
+    class Action
+
+      TYPES = {
+        OSS_OM: {
+          key: :exec_oss_om,
+          params: {
+            aro_class_name: {
+              default_value: Aro::Dom::Action.name,
+              required: true
+            },
+            aro_class_method: {
+              default_value: :inspect,
+              required: false
+            },
+            oss_om_ssh_key: {
+              default_value: nil,
+              required: true,
+              unique: true
+            }
+          }
+        },
+        SYSTEM: {
+          key: :exec_system,
+          params: {
+            command_string: {
+              default_value: nil,
+              required: true
+            },
+            oss_om_ssh_key: {
+              default_value: nil,
+              required: true,
+              unique: true
+            }
+          }
+        },
+        CREATE_DATA_BASE: {
+          key: :exec_data_base,
+          params: {
+            data_base_name: {
+              default_value: nil,
+              required: true,
+              unique: true
+            },
+            oss_om_ssh_key: {
+              default_value: nil,
+              required: true,
+              unique: true
+            }
+          },
+        }
+      }
+
+      def self.valid_param_values!(action_key, params)
+        params.keys.each{|k|
+          v = params[k]
+          params_action_def = Aro::Dom::Action::TYPES[action_key][:params][k.to_sym]
+          v = params_action_def[:default_value] if v.nil?
+          required = false
+          required = params_action_def[:required] unless params_action_def[:required].nil?
+
+          raise "required value missing! params[#{k}] = '#{v}'" if required && (v.nil? || v.empty?)
+        }
+      end
+
+      def self.valid_param_keys!(action_key, params)
+        (
+          Aro::Dom::Action::TYPES[action_key][:params].keys & # assert one ampersand(&) here!
+          params.keys.map{|k|
+            k.to_s&.strip.to_sym
+          }
+        ).count == params.keys.count
+      end
+
+      def self.validate_params!(action_key, params)
+        Aro::P.say("validating #{action_key} action")
+        Aro::V.say("params: #{JSON.pretty_generate(params)}")
+
+        raise "invalid params! (#{params})" unless params.kind_of?(Hash) &&
+          valid_param_keys!(action_key, params) && valid_param_values!(action_key, params)
+      end
+
+      def self.validate_action_key!(action_key)
+        action_key = action_key&.upcase.to_sym
+        raise "invalid action! (#{action_key})" unless Aro::Dom::Action::TYPES.keys.include?(action_key)
+        return action_key
+      end
+
+      def self.create(action_key, menu_item)
+        Aro::P.say(__method__)
+        action_key = validate_action_key!(action_key)
+
+        aro_action_type_def = Aro::Dom::Action::TYPES[action_key]
+        case aro_action_type_def[:key]
+        when :exec_oss_om
+          Aro::Dom::Oss_OpenMenu.create_exec_oss_om_entry_for(menu_item)
+        when :exec_system
+          Aro::Dom::Oss_OpenMenu.create_exec_system_entry_for(menu_item)
+        when :exec_data_base
+          Aro::Dom::Oss_OpenMenu.create_exec_data_base_entry_for(menu_item)
+        end
+      end
+
+      def self.perform(action_key, params = {})
+        Aro::P.say(__method__)
+        action_key = validate_action_key!(action_key)
+        validate_params!(action_key, params)
+
+        params = params.symbolize_keys
+        aro_action_type_def = Aro::Dom::Action::TYPES[action_key]
+        case aro_action_type_def[:key]
+        when :exec_oss_om
+          Aro::P.say("#{params[:aro_class_name]}.#{params[:aro_class_method]}")
+          begin
+            params[:aro_class_name].constantize.send(params[:aro_class_method])
+          rescue NoMethodError => e
+            Aro::P.say("exec_oss_om error! #{e}")
+          end
+        when :exec_system
+          Aro::P.say("todo: implement!")
+          Aro::P.say("when :exec_system")
+          Aro::Dom::Ma_ain.i2097i_bookmark
+          command_string = params[:command_string]
+          if command_string.nil?
+            raise "invalid command_string! #{command_string}"
+          end
+          Aro::P.say("#{self.name} performing #{action_key} action: [system(#{command_string})]")
+          result = system("#{command_string}")
+          Aro::P.say("=> #{result}")
+          Aro::P.say("\n")
+        when :exec_data_base
+          Aro::P.say("todo: implement!")
+          Aro::P.say("when :exec_data_base")
+          Aro::Dom::Ma_ain.i2097i_bookmark
+        end
+      end
+
+    end
+  end
+end

data/sys/aro/d.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 =begin
   
   d.rb
@@ -21,7 +23,7 @@ module Aro
 
     def self.should_print?
       return false unless Aro::Cor.ivar(:ENV).present?
-      Aro::Cor::DBG_MODES.include?(Aro::Cor.ivar(:ENV)&.to_sym)
+      Aro::Cor::DEBUG_MODES.include?(Aro::Cor.ivar(:ENV)&.to_sym)
     end
   end
 end

data/sys/aro/db/migrate/1793913747_create_data_bases.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class CreateDataBases < ActiveRecord::Migration[8.1]
   def change
     create_table :data_bases do |t|

data/sys/aro/db/migrate/1793913777_create_data_base_directories.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class CreateDataBaseDirectories < ActiveRecord::Migration[8.1]
   def change
     create_table :data_base_directories do |t|

data/sys/aro/db/migrate/1793913796_create_data_base_files.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class CreateDataBaseFiles < ActiveRecord::Migration[8.1]
   def change
     create_table :data_base_files do |t|

data/sys/aro/db/migrate/1793913841_create_menus.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class CreateMenus < ActiveRecord::Migration[8.1]
   def change
     create_table :menus do |t|

data/sys/aro/db/migrate/1793913861_create_menu_items.rb

@@ -1,14 +1,15 @@
+# frozen_string_literal: true
+
 class CreateMenuItems < ActiveRecord::Migration[8.1]
   def change
     create_table :menu_items do |t|
       t.belongs_to :menu, null: false, foreign_key: true
       t.string :uuid, null: false
-      t.string :tty_name
+      t.integer :type_flag, default: 1
 
       t.timestamps
     end
 
     add_index :menu_items, :uuid, unique: true
-    add_index :menu_items, [:menu_id, :tty_name], unique: true
   end
 end

data/sys/aro/db.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 =begin
   
   db.rb
@@ -20,11 +22,8 @@ module Aro
 
     def self.ensure_connected!
       return if self.instance.connected?
-
       Aro::Db.configure_logger
-      if Aro::Mancy.in_aro?
-        self.instance.setup_local_aro
-      end
+      self.instance.setup_local_aro if Aro::Mancy.in_aro?
     end
 
     def connected?
@@ -41,13 +40,7 @@ module Aro
     end
 
     def self.base_db_dir
-      db_dir = File.join(Aro::Mancy.root_dir, :db.to_s)
-      return "#{db_dir}_#{Aro::Cor::ENVS[:TEST]}" if Aro::Cor.is_test?
-      db_dir
-    end
-
-    def self.migrate_dir
-      File.join(Aro::Db.base_db_dir, :migrate.to_s)
+      File.join(Aro::Mancy.root_dir, :db.to_s)
     end
 
     def self.sql_filepath
@@ -70,7 +63,15 @@ module Aro
       end
 
       unless File.exist?(db_config_filepath)
-        pw = Aro::P.p.ask(I18n.t("messages.base_db_password_prompt", aro_name: aro_name, sql_filepath: self.class.sql_filepath))
+        pw = Aro::P.p.ask(
+          I18n.t(
+            "open_menu.base_db_password_prompt",
+            sql_filepath: self.class.sql_filepath.gsub(
+              Aro::Mancy.root_dir, Aro::Mancy::ARO_DIRECTORY.to_s
+            ),
+            aro_name: aro_name
+          )
+        )
         pw = aro_name unless pw.present?
         # create database config yaml file
         c = {
@@ -98,36 +99,21 @@ module Aro
       Aro::D.say("#{self}#{__method__}#{self.active_record_connection_instance.inspect}")
     end
 
-    def self.migrations_filepaths
-      File.join(Aro::Db.migrate_dir, "*.rb")
+    def self.gem_migrations_filepaths
+      File.join(gem_migration_dir, "*.rb")
     end
 
-    def self.gem_migrations_filepaths
-      File.join(Reiquire.gem_migrations_path, :migrate.to_s, "*.rb")
+    def self.gem_migration_dir
+      File.join(Reiquire.gem_migrations_path, :migrate.to_s)
     end
 
     def migrate
-      puts __method__
-      migration_file_names = Dir[self.class.migrations_filepaths].map{|fp| File.basename(fp)}
-      puts "migration_file_names: #{migration_file_names}"
       gem_migration_file_names = Dir[self.class.gem_migrations_filepaths].map{|fp| File.basename(fp)}
-      puts "gem_migration_file_names: #{gem_migration_file_names}"
-      mfs_all = gem_migration_file_names.all?{|gmf|
-        migration_file_names.include?(gmf)
-      }
-      puts "mfs_all: #{mfs_all}"
-
-      unless Dir.exist?(Aro::Db.migrate_dir) && mfs_all
-        puts "Reiquire.copy_db_migrations_from_gem!"
-        puts "ls #{Aro::Db.migrate_dir}"
-        puts migration_file_names
-        Reiquire.copy_db_migrations_from_gem! 
-      end
 
-      migration_version = migration_file_names.map{|n|
+      migration_version = gem_migration_file_names.map{|n|
         n.to_s.split("_")[0].to_i
       }.max
-      ActiveRecord::MigrationContext.new(Aro::Db.migrate_dir).migrate(migration_version)
+      ActiveRecord::MigrationContext.new(Aro::Db.gem_migration_dir).migrate(migration_version)
       dump_schema!
     end