rubish-gem 0.0.1

data/lib/rubish/data/completion_data.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Rubish
+  module Builtins
+    # Git commands for completion
+    GIT_COMMANDS = %w[
+      add am annotate archive bisect blame branch bundle cat-file
+      check-attr check-ignore check-mailmap checkout checkout-index
+      cherry cherry-pick citool clean clone column commit config count-objects
+      credential daemon describe diff diff-files diff-index diff-tree
+      difftool fast-export fast-import fetch fetch-pack filter-branch
+      fmt-merge-msg for-each-ref format-patch fsck gc get-tar-commit-id
+      grep gui hash-object help imap-send index-pack init init-db instaweb
+      interpret-trailers log ls-files ls-remote ls-tree mailinfo mailsplit
+      maintenance merge merge-base merge-file merge-index merge-octopus
+      merge-one-file merge-ours merge-recursive merge-resolve merge-subtree
+      merge-tree mergetool mktag mktree mv name-rev notes pack-objects
+      pack-redundant pack-refs patch-id prune prune-packed pull push
+      quiltimport range-diff read-tree rebase reflog remote repack replace
+      request-pull rerere reset restore rev-list rev-parse revert rm
+      send-email send-pack shortlog show show-branch show-index show-ref
+      sparse-checkout stash status stripspace submodule switch symbolic-ref
+      tag unpack-file unpack-objects update-index update-ref update-server-info
+      upload-archive upload-pack var verify-commit verify-pack verify-tag
+      whatchanged worktree write-tree
+    ].freeze
+
+    # Common git options that apply to most commands
+    GIT_COMMON_OPTIONS = %w[
+      --version --help -C --git-dir --work-tree --bare --no-replace-objects
+      --literal-pathspecs --glob-pathspecs --noglob-pathspecs --icase-pathspecs
+      --no-optional-locks -c --exec-path --html-path --man-path --info-path
+      --paginate --no-pager --config-env
+    ].freeze
+
+    # Action flags mapping for complete/compgen builtins
+    # Maps single-letter flags to their action symbols
+    COMPLETION_ACTION_FLAGS = {
+      'a' => :alias,
+      'b' => :builtin,
+      'c' => :command,
+      'd' => :directory,
+      'e' => :export,
+      'f' => :file,
+      'g' => :group,
+      'j' => :job,
+      'k' => :keyword,
+      's' => :service,
+      'u' => :user,
+      'v' => :variable
+    }.freeze
+  end
+end

data/lib/rubish/data/readline_config.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Rubish
+  module Builtins
+    # Readline function names for -l option
+    READLINE_FUNCTIONS = %w[
+      abort accept-line backward-char backward-delete-char backward-kill-line
+      backward-kill-word backward-word beginning-of-history beginning-of-line
+      call-last-kbd-macro capitalize-word character-search character-search-backward
+      clear-screen complete delete-char delete-horizontal-space digit-argument
+      do-lowercase-version downcase-word dump-functions dump-macros dump-variables
+      emacs-editing-mode end-of-history end-of-line exchange-point-and-mark
+      forward-backward-delete-char forward-char forward-search-history forward-word
+      history-search-backward history-search-forward insert-comment insert-completions
+      kill-line kill-region kill-whole-line kill-word menu-complete menu-complete-backward
+      next-history non-incremental-forward-search-history non-incremental-reverse-search-history
+      overwrite-mode possible-completions previous-history quoted-insert
+      re-read-init-file redraw-current-line reverse-search-history revert-line
+      self-insert set-mark shell-backward-kill-word shell-backward-word shell-expand-line
+      shell-forward-word shell-kill-word start-kbd-macro tilde-expand transpose-chars
+      transpose-words undo universal-argument unix-filename-rubout unix-line-discard
+      unix-word-rubout upcase-word vi-append-eol vi-append-mode vi-arg-digit
+      vi-bWord vi-back-to-indent vi-bword vi-change-case vi-change-char vi-change-to
+      vi-char-search vi-column vi-complete vi-delete vi-delete-to vi-eWord vi-editing-mode
+      vi-end-word vi-eof-maybe vi-eword vi-fWord vi-fetch-history vi-first-print
+      vi-fword vi-goto-mark vi-insert-beg vi-insertion-mode vi-match vi-movement-mode
+      vi-next-word vi-overstrike vi-overstrike-delete vi-prev-word vi-put vi-redo
+      vi-replace vi-rubout vi-search vi-search-again vi-set-mark vi-subst vi-tilde-expand
+      vi-undo vi-yank-arg vi-yank-to yank yank-last-arg yank-nth-arg yank-pop
+    ].freeze
+
+    # Readline variable names for -v/-V options
+    READLINE_VARIABLES_LIST = %w[
+      bell-style bind-tty-special-chars blink-matching-paren colored-completion-prefix
+      colored-stats comment-begin completion-display-width completion-ignore-case
+      completion-map-case completion-prefix-display-length completion-query-items
+      convert-meta disable-completion echo-control-characters editing-mode
+      emacs-mode-string enable-bracketed-paste enable-keypad expand-tilde
+      history-preserve-point history-size horizontal-scroll-mode input-meta
+      isearch-terminators keymap keyseq-timeout mark-directories mark-modified-lines
+      mark-symlinked-directories match-hidden-files menu-complete-display-prefix
+      output-meta page-completions print-completions-horizontally revert-all-at-newline
+      show-all-if-ambiguous show-all-if-unmodified show-mode-in-prompt skip-completed-text
+      vi-cmd-mode-string vi-ins-mode-string visible-stats
+    ].freeze
+  end
+end

data/lib/rubish/data/shell_options.rb

@@ -0,0 +1,251 @@
+# frozen_string_literal: true
+
+module Rubish
+  module Builtins
+    # Valid shell options with their default values and descriptions
+    SHELL_OPTIONS = {
+      'array_expand_once' => [false, 'only expand array subscripts once (bash 5.2+)'],
+      'assoc_expand_once' => [false, 'only expand associative array subscripts once (deprecated, use array_expand_once)'],
+      'autocd' => [false, 'cd to a directory when typed as command'],
+      'bash_source_fullpath' => [false, 'store full pathnames in BASH_SOURCE array'],
+      'cdable_vars' => [false, 'cd argument can be a variable containing a directory name'],
+      'cdspell' => [false, 'correct minor spelling errors in cd'],
+      'checkhash' => [false, 'check hash table before executing'],
+      'checkjobs' => [false, 'check for running jobs before exit'],
+      'checkwinsize' => [false, 'check window size after each command and update LINES and COLUMNS'],
+      'cmdhist' => [true, 'save multi-line commands as single history entry'],
+      'compat10' => [false, 'compatibility mode for rubish 1.0'],
+      'compat31' => [false, 'compatibility mode for bash 3.1'],
+      'compat32' => [false, 'compatibility mode for bash 3.2'],
+      'compat40' => [false, 'compatibility mode for bash 4.0'],
+      'compat41' => [false, 'compatibility mode for bash 4.1'],
+      'compat42' => [false, 'compatibility mode for bash 4.2'],
+      'compat43' => [false, 'compatibility mode for bash 4.3'],
+      'compat44' => [false, 'compatibility mode for bash 4.4'],
+      'compat50' => [false, 'compatibility mode for bash 5.0'],
+      'compat51' => [false, 'compatibility mode for bash 5.1'],
+      'compat52' => [false, 'compatibility mode for bash 5.2'],
+      'compat53' => [false, 'compatibility mode for bash 5.3'],
+      'compat54' => [false, 'compatibility mode for bash 5.4'],
+      'compat55' => [false, 'compatibility mode for bash 5.5'],
+      'complete_fullquote' => [true, 'quote all metacharacters in filename completion'],
+      'direxpand' => [false, 'expand directory names during word completion'],
+      'dirspell' => [false, 'correct minor spelling errors in directory names during completion'],
+      'dotglob' => [false, 'include dotfiles in pathname expansion'],
+      'execfail' => [false, 'do not exit non-interactive shell if exec fails'],
+      'expand_aliases' => [true, 'expand aliases'],
+      'extdebug' => [false, 'enable extended debugging mode'],
+      'extglob' => [false, 'enable extended pattern matching'],
+      'extquote' => [true, 'enable $\'...\' and $"..." quoting within ${...}'],
+      'failglob' => [false, 'patterns which fail to match produce an error'],
+      'force_fignore' => [true, 'apply FIGNORE to word completion'],
+      'globasciiranges' => [true, 'use ASCII ordering for range expressions in bracket patterns'],
+      'globskipdots' => [false, 'skip . and .. in pathname expansion'],
+      'globstar' => [false, 'enable ** for recursive globbing'],
+      'gnu_errfmt' => [false, 'print error messages in GNU format'],
+      'histappend' => [false, 'append to history file'],
+      'histreedit' => [false, 'allow re-editing of failed history substitution'],
+      'histverify' => [false, 'verify history substitution before executing'],
+      'hostcomplete' => [true, 'attempt hostname completion'],
+      'huponexit' => [false, 'send SIGHUP to all jobs when an interactive login shell exits'],
+      'inherit_errexit' => [false, 'command substitution inherits the errexit option'],
+      'interactive_comments' => [true, 'allow comments in interactive shell'],
+      'lastpipe' => [false, 'run last command of pipeline in current shell'],
+      'lithist' => [false, 'preserve newlines in multi-line history'],
+      'localvar_inherit' => [false, 'local variables inherit value from previous scope'],
+      'localvar_unset' => [false, 'calling unset on local variable removes it from scope'],
+      'localvar_warning' => [false, 'warn when local variable shadows variable from outer scope'],
+      'login_shell' => [false, 'shell is a login shell (read-only)'],
+      'mailwarn' => [false, 'warn if mail file has been accessed since last check'],
+      'no_empty_cmd_completion' => [false, 'do not complete on empty command line'],
+      'nocaseglob' => [false, 'case-insensitive pathname expansion'],
+      'nocasematch' => [false, 'case-insensitive pattern matching'],
+      'noexpand_translation' => [false, 'do not expand $"..." strings for translation'],
+      'nullglob' => [false, 'patterns matching nothing expand to null'],
+      'patsub_replacement' => [true, 'enable & replacement in pattern substitution'],
+      'progcomp' => [true, 'enable programmable completion'],
+      'progcomp_alias' => [true, 'allow programmable completion for aliases'],
+      'promptvars' => [true, 'expand variables in prompt strings'],
+      'restricted_shell' => [false, 'shell is restricted (read-only)'],
+      'shift_verbose' => [false, 'print error if shift count exceeds positional parameters'],
+      'sourcepath' => [true, 'use PATH to find sourced files'],
+      'syslog_history' => [false, 'send history to syslog'],
+      'varredir_close' => [false, 'close file descriptors opened by {varname} redirection'],
+      'xpg_echo' => [false, 'echo expands backslash-escape sequences']
+    }.freeze
+
+    # Compatibility level options (like bash's compat31, compat32, etc.)
+    COMPAT_OPTIONS = %w[compat10 compat31 compat32 compat40 compat41 compat42 compat43 compat44 compat50 compat51 compat52 compat53 compat54 compat55].freeze
+
+    # Mapping from zsh option names to bash shopt equivalents
+    # These options exist in both shells (possibly with different names)
+    ZSH_TO_BASH_OPTIONS = {
+      'autocd' => 'autocd',
+      'auto_cd' => 'autocd',
+      'cdablevars' => 'cdable_vars',
+      'cdable_vars' => 'cdable_vars',
+      'globdots' => 'dotglob',
+      'glob_dots' => 'dotglob',
+      'extendedglob' => 'extglob',
+      'extended_glob' => 'extglob',
+      'nullglob' => 'nullglob',
+      'null_glob' => 'nullglob',
+      'globstar' => 'globstar',
+      'glob_star' => 'globstar',
+      'nocaseglob' => 'nocaseglob',
+      'nocase_glob' => 'nocaseglob',
+      'histappend' => 'histappend',
+      'hist_append' => 'histappend',
+      'appendhistory' => 'histappend',
+      'append_history' => 'histappend',
+      'interactivecomments' => 'interactive_comments',
+      'interactive_comments' => 'interactive_comments',
+      'checkjobs' => 'checkjobs',
+      'check_jobs' => 'checkjobs',
+      'pipefail' => 'pipefail',
+      'pipe_fail' => 'pipefail'
+    }.freeze
+
+    # Zsh-specific options (not in bash)
+    # Format: option_name => [default_value, description]
+    ZSH_OPTIONS = {
+      # Changing Directories
+      'auto_pushd' => [false, 'make cd push the old directory onto the directory stack'],
+      'chase_dots' => [false, 'resolve .. in cd to physical directory'],
+      'chase_links' => [false, 'resolve symbolic links in cd to physical directory'],
+      'pushd_ignore_dups' => [false, 'do not push duplicate directories'],
+      'pushd_minus' => [false, 'exchange +/- meanings in pushd'],
+      'pushd_silent' => [false, 'do not print directory stack after pushd/popd'],
+      'pushd_to_home' => [false, 'pushd with no args goes to home'],
+
+      # Completion
+      'always_to_end' => [false, 'move cursor to end after completion'],
+      'auto_list' => [true, 'automatically list choices on ambiguous completion'],
+      'auto_menu' => [true, 'show completion menu on successive tab'],
+      'auto_param_slash' => [true, 'add trailing slash for completed directories'],
+      'auto_remove_slash' => [true, 'remove trailing slash when next char is word delimiter'],
+      'complete_in_word' => [false, 'complete from both ends of cursor'],
+      'glob_complete' => [false, 'generate matches from glob pattern'],
+      'list_ambiguous' => [true, 'list completions when ambiguous'],
+      'list_packed' => [false, 'variable width completion list'],
+      'list_rows_first' => [false, 'list completions in rows instead of columns'],
+      'list_types' => [true, 'show file type indicator in completion list'],
+      'menu_complete' => [false, 'insert first match immediately on ambiguous completion'],
+      'rec_exact' => [false, 'recognize exact matches even if ambiguous'],
+
+      # Expansion and Globbing
+      'bad_pattern' => [true, 'print error on bad glob pattern'],
+      'bare_glob_qual' => [true, 'allow glob qualifiers without parentheses'],
+      'brace_ccl' => [false, 'expand {a-z} to a b c ... z'],
+      'case_glob' => [true, 'case-sensitive globbing'],
+      'case_match' => [true, 'case-sensitive pattern matching'],
+      'equals' => [true, 'expand =cmd to path of cmd'],
+      'extended_glob' => [false, 'enable extended glob operators'],
+      'glob' => [true, 'enable globbing'],
+      'glob_subst' => [false, 'treat characters from parameter expansion as glob'],
+      'mark_dirs' => [false, 'append / to directories from globbing'],
+      'multibyte' => [true, 'respect multibyte characters'],
+      'nomatch' => [true, 'print error if glob has no matches'],
+      'numeric_glob_sort' => [false, 'sort numerically when globbing'],
+      'rc_expand_param' => [false, 'array expansion like rc shell'],
+      'rematch_pcre' => [false, 'use PCRE for =~ operator'],
+      'sh_glob' => [false, 'disable special glob characters'],
+      'unset' => [false, 'treat unset variables as empty instead of error'],
+      'warn_create_global' => [false, 'warn when creating global in function'],
+
+      # History
+      'bang_hist' => [true, 'enable ! history expansion'],
+      'extended_history' => [false, 'save timestamp in history'],
+      'hist_expire_dups_first' => [false, 'expire duplicate entries first'],
+      'hist_find_no_dups' => [false, 'skip duplicates when searching history'],
+      'hist_ignore_all_dups' => [false, 'remove older duplicate entries'],
+      'hist_ignore_dups' => [false, 'do not record consecutive duplicates'],
+      'hist_ignore_space' => [false, 'do not record entries starting with space'],
+      'hist_no_functions' => [false, 'do not record function definitions'],
+      'hist_no_store' => [false, 'do not record history command'],
+      'hist_reduce_blanks' => [false, 'remove superfluous blanks'],
+      'hist_save_no_dups' => [false, 'do not save duplicates to history file'],
+      'hist_verify' => [false, 'show history expansion before executing'],
+      'inc_append_history' => [false, 'append incrementally to history file'],
+      'share_history' => [false, 'share history between sessions'],
+
+      # Input/Output
+      'aliases' => [true, 'enable aliases'],
+      'clobber' => [true, 'allow > to overwrite existing files'],
+      'correct' => [false, 'try to correct spelling of commands'],
+      'correct_all' => [false, 'try to correct spelling of all arguments'],
+      'flow_control' => [true, 'enable ^S/^Q flow control'],
+      'ignore_eof' => [false, 'do not exit on end-of-file'],
+      'hash_cmds' => [true, 'hash command locations'],
+      'hash_dirs' => [true, 'hash directories containing commands'],
+      'mail_warning' => [false, 'warn if mail file has been accessed'],
+      'path_dirs' => [false, 'search path for / commands'],
+      'print_exit_value' => [false, 'print non-zero exit values'],
+      'rc_quotes' => [false, "allow '' to escape ' in single quotes"],
+      'rm_star_silent' => [false, 'do not warn on rm *'],
+      'rm_star_wait' => [false, 'wait before executing rm *'],
+      'short_loops' => [true, 'allow short loop forms'],
+
+      # Job Control
+      'auto_continue' => [false, 'automatically send SIGCONT to disowned jobs'],
+      'auto_resume' => [false, 'treat single word as resume of existing job'],
+      'bg_nice' => [true, 'run background jobs at lower priority'],
+      'check_running_jobs' => [false, 'check for running jobs on exit'],
+      'hup' => [true, 'send SIGHUP to jobs when shell exits'],
+      'long_list_jobs' => [false, 'list jobs in long format'],
+      'monitor' => [true, 'enable job control'],
+      'notify' => [false, 'report job status immediately'],
+
+      # Prompting
+      'prompt_bang' => [false, 'enable ! substitution in prompts'],
+      'prompt_cr' => [true, 'print CR before prompt'],
+      'prompt_percent' => [true, 'enable % substitution in prompts'],
+      'prompt_sp' => [true, 'preserve partial line'],
+      'prompt_subst' => [false, 'enable parameter expansion in prompts'],
+      'transient_rprompt' => [false, 'remove right prompt after command'],
+
+      # Scripts and Functions
+      'c_bases' => [false, 'output hex/octal in C format'],
+      'err_exit' => [false, 'exit on non-zero status (like set -e)'],
+      'err_return' => [false, 'return from function on error'],
+      'exec' => [true, 'execute commands'],
+      'function_argzero' => [true, 'set $0 to function name'],
+      'local_loops' => [false, 'break/continue affect only local loops'],
+      'local_options' => [false, 'restore options on function return'],
+      'local_traps' => [false, 'restore traps on function return'],
+      'multios' => [true, 'enable multiple redirections'],
+      'octal_zeroes' => [false, 'interpret leading 0 as octal'],
+      'source_trace' => [false, 'print source file names'],
+      'typeset_silent' => [false, 'do not print variable values in typeset'],
+      'verbose' => [false, 'print shell input lines'],
+      'xtrace' => [false, 'print commands before execution'],
+
+      # Shell Emulation
+      'bsd_echo' => [false, 'make echo BSD compatible'],
+      'csh_junkie_loops' => [false, 'allow csh-style loop syntax'],
+      'csh_nullcmd' => [false, 'do not use NULLCMD/READNULLCMD'],
+      'ksh_arrays' => [false, 'array index starts at 0'],
+      'ksh_autoload' => [false, 'ksh-style autoloading'],
+      'ksh_option_print' => [false, 'print options ksh-style'],
+      'ksh_typeset' => [false, 'ksh-style typeset behavior'],
+      'posix_aliases' => [false, 'POSIX alias expansion'],
+      'posix_builtins' => [false, 'POSIX builtin behavior'],
+      'posix_identifiers' => [false, 'POSIX identifier rules'],
+      'posix_strings' => [false, 'POSIX string behavior'],
+      'posix_traps' => [false, 'POSIX trap behavior'],
+      'sh_file_expansion' => [false, 'sh-style filename expansion'],
+      'sh_nullcmd' => [false, 'do not use NULLCMD for empty redirections'],
+      'sh_word_split' => [false, 'split unquoted parameter expansions'],
+      'traps_async' => [false, 'run traps asynchronously'],
+
+      # Zle (Zsh Line Editor)
+      'beep' => [true, 'beep on errors'],
+      'combining_chars' => [false, 'handle combining characters'],
+      'emacs' => [false, 'use emacs keybindings'],
+      'overstrike' => [false, 'start in overstrike mode'],
+      'single_line_zle' => [false, 'use single line editing'],
+      'vi' => [false, 'use vi keybindings'],
+      'zle' => [true, 'use zsh line editor']
+    }.freeze
+  end
+end

data/lib/rubish/data_define.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+# Polyfill Data.define for Ruby < 3.2
+data_has_define = Data.respond_to?(:define)
+
+unless data_has_define
+  class Data
+    def self.define(*keys, &block)
+      # Use a module for initialize so that custom initialize can call super
+      init_module = Module.new do
+        define_method(:initialize) do |*args, **kwargs|
+          # Ruby 2.6 has quirky keyword argument handling where a trailing Hash
+          # may be interpreted as kwargs instead of a positional argument
+          has_expected_kwargs = keys.any? { |k| kwargs.key?(k) }
+
+          if has_expected_kwargs
+            keys.each do |key|
+              instance_variable_set("@#{key}", kwargs.fetch(key) { raise ArgumentError, "missing keyword: #{key}" })
+            end
+          elsif args.empty? && kwargs.empty?
+            # Called from super with implicit kwargs (Ruby 2.x behavior)
+            # Do nothing - instance variables already set by caller
+          elsif args.size == 1 && args.first.is_a?(Hash)
+            # Ruby 2.6 may pass keyword args as a positional hash
+            hash = args.first
+            keys.each do |key|
+              instance_variable_set("@#{key}", hash.fetch(key) { raise ArgumentError, "missing keyword: #{key}" })
+            end
+          elsif kwargs.any? && args.size + 1 == keys.size
+            # Ruby 2.6: trailing Hash was converted to kwargs, treat it as last positional arg
+            all_args = args + [kwargs.to_h]
+            keys.zip(all_args).each { |key, val| instance_variable_set("@#{key}", val) }
+          elsif args.size == keys.size
+            keys.zip(args).each { |key, val| instance_variable_set("@#{key}", val) }
+          else
+            raise ArgumentError, "wrong number of arguments (given #{args.size}, expected #{keys.size})"
+          end
+          freeze
+        end
+      end
+
+      Class.new do
+        include init_module
+
+        keys.each do |key|
+          define_method(key) { instance_variable_get("@#{key}") }
+        end
+
+        define_method(:deconstruct) { keys.map { |k| send(k) } }
+        define_method(:deconstruct_keys) { |_| keys.to_h { |k| [k, send(k)] } }
+        define_method(:to_h) { keys.to_h { |k| [k, send(k)] } }
+        define_method(:members) { keys }
+
+        define_method(:==) do |other|
+          other.class == self.class && keys.all? { |k| send(k) == other.send(k) }
+        end
+        alias eql? ==
+
+        define_method(:hash) { [self.class, *keys.map { |k| send(k) }].hash }
+
+        class_exec(&block) if block
+      end
+    end
+  end
+end