rush-shell 0.0.2

data/lib/rush/umask_mode.rb

@@ -0,0 +1,133 @@
+# typed: true
+# frozen_string_literal: true
+
+module Rush
+  # Parses and formats `umask` modes. Symbolic operands describe the permissions
+  # that remain allowed (the complement of the creation mask), matching dash and
+  # POSIX `umask -S` output.
+  class UmaskMode
+    extend T::Sig
+
+    CLASSES = { 'u' => 6, 'g' => 3, 'o' => 0 }.freeze
+    PERMISSIONS = { 'r' => 4, 'w' => 2, 'x' => 1 }.freeze
+    WHO = (CLASSES.keys + ['a']).freeze
+    OPERATORS = { '+' => :add_allowed, '-' => :remove_allowed, '=' => :assign_allowed }.freeze
+    ALL = 0o777
+
+    sig { params(mask: Integer).returns(String) }
+    def self.format_octal(mask)
+      format('%04o', mask & ALL)
+    end
+
+    sig { params(mask: Integer).returns(String) }
+    def self.format_symbolic(mask)
+      allowed = (~mask) & ALL
+      CLASSES.map { |name, shift| "#{name}=#{letters((allowed >> shift) & 7)}" }.join(',')
+    end
+
+    sig { params(text: String, current: Integer).returns(T.nilable(Integer)) }
+    def self.parse(text, current)
+      return parse_octal(text) if text.match?(/\A[0-7]+\z/)
+
+      new(current).parse_symbolic(text)
+    end
+
+    sig { params(bits: Integer).returns(String) }
+    def self.letters(bits)
+      PERMISSIONS.filter_map { |letter, value| letter if bits.anybits?(value) }.join
+    end
+
+    sig { params(text: String).returns(Integer) }
+    def self.parse_octal(text)
+      text.to_i(8) & ALL
+    end
+
+    sig { params(current: Integer).void }
+    def initialize(current)
+      @allowed = (~current) & ALL
+    end
+
+    sig { params(text: String).returns(T.nilable(Integer)) }
+    def parse_symbolic(text)
+      text.split(',', -1).each { |clause| apply_clause(clause) }
+      (~@allowed) & ALL
+    rescue ArgumentError
+      nil
+    end
+
+    private
+
+    sig { params(clause: String).void }
+    def apply_clause(clause)
+      who, rest = split_who(clause)
+      operator = rest.slice!(0)
+      raise ArgumentError unless operator && OPERATORS.key?(operator)
+
+      apply(operator, target_mask(who), permission_bits(rest, who))
+    end
+
+    # Duplicate who letters (uua+w) need no dedup: every consumer ORs the
+    # per-class bit fields, so repeats are absorbed (mutant-verified).
+    sig { params(clause: String).returns([T::Array[String], String]) }
+    def split_who(clause)
+      who = [] #: Array[String]
+      who.concat(expand_who(T.must(clause.slice!(0)))) while clause.start_with?(*WHO)
+      [who.empty? ? CLASSES.keys : who, clause]
+    end
+
+    sig { params(name: String).returns(T::Array[String]) }
+    def expand_who(name)
+      name == 'a' ? CLASSES.keys : [name]
+    end
+
+    sig { params(operator: String, target: Integer, bits: Integer).void }
+    def apply(operator, target, bits)
+      method(OPERATORS.fetch(operator)).call(target, bits)
+    end
+
+    sig { params(target: Integer, bits: Integer).void }
+    def assign_allowed(target, bits)
+      @allowed = (@allowed & ~target) | bits
+    end
+
+    sig { params(_target: Integer, bits: Integer).void }
+    def add_allowed(_target, bits)
+      @allowed |= bits
+    end
+
+    sig { params(_target: Integer, bits: Integer).void }
+    def remove_allowed(_target, bits)
+      @allowed &= ~bits
+    end
+
+    sig { params(who: T::Array[String]).returns(Integer) }
+    def target_mask(who)
+      who.reduce(0) { |mask, name| mask | (7 << CLASSES.fetch(name)) }
+    end
+
+    sig { params(text: String, who: T::Array[String]).returns(Integer) }
+    def permission_bits(text, who)
+      text.each_char.reduce(0) { |bits, char| bits | bits_for(char, who) }
+    end
+
+    sig { params(char: String, who: T::Array[String]).returns(Integer) }
+    def bits_for(char, who)
+      return permission_value(char, who) if PERMISSIONS.key?(char)
+      return copy_value(char, who) if CLASSES.key?(char)
+
+      raise ArgumentError
+    end
+
+    sig { params(char: String, who: T::Array[String]).returns(Integer) }
+    def permission_value(char, who)
+      value = PERMISSIONS.fetch(char)
+      who.reduce(0) { |bits, name| bits | (value << CLASSES.fetch(name)) }
+    end
+
+    sig { params(char: String, who: T::Array[String]).returns(Integer) }
+    def copy_value(char, who)
+      source = (@allowed >> CLASSES.fetch(char)) & 7
+      who.reduce(0) { |bits, name| bits | (source << CLASSES.fetch(name)) }
+    end
+  end
+end

data/lib/rush/version.rb

@@ -0,0 +1,6 @@
+# typed: true
+# frozen_string_literal: true
+
+module Rush
+  VERSION = '0.0.2'
+end

data/lib/rush.rb

@@ -0,0 +1,190 @@
+# typed: true
+# frozen_string_literal: true
+
+# sorbet-runtime backs the inline `sig {}` annotations (the second, independent
+# type system; see docs/journal.md Charter). Required once here so T::Sig is
+# available as the lib files load.
+require 'sorbet-runtime'
+
+require_relative 'rush/version'
+require_relative 'rush/errors'
+require_relative 'rush/error_policy'
+require_relative 'rush/status'
+require_relative 'rush/bracket_scanner'
+require_relative 'rush/bracket_expression'
+require_relative 'rush/pattern_scanner'
+require_relative 'rush/escaped_bracket'
+require_relative 'rush/posix_pattern'
+require_relative 'rush/shell_pattern'
+require_relative 'rush/system_calls'
+require_relative 'rush/environment'
+require_relative 'rush/function_table'
+require_relative 'rush/alias_table'
+require_relative 'rush/signals'
+require_relative 'rush/signal_report'
+require_relative 'rush/trap_table'
+require_relative 'rush/pending_signals'
+require_relative 'rush/scope'
+require_relative 'rush/shell_variables'
+require_relative 'rush/assignments'
+require_relative 'rush/loop_nesting'
+require_relative 'rush/options'
+require_relative 'rush/option_cluster'
+require_relative 'rush/positional'
+require_relative 'rush/function_frame'
+require_relative 'rush/getopts_state'
+require_relative 'rush/getopts_parser'
+require_relative 'rush/umask_mode'
+require_relative 'rush/shell_parameters'
+require_relative 'rush/shell_state'
+require_relative 'rush/terminal'
+require_relative 'rush/job_table'
+require_relative 'rush/job_table/job'
+require_relative 'rush/job_table/control'
+require_relative 'rush/job_table/interruptible_wait'
+require_relative 'rush/stop_relay'
+require_relative 'rush/job_report'
+require_relative 'rush/job_spec'
+require_relative 'rush/job_control'
+require_relative 'rush/fd_entry'
+require_relative 'rush/io_table'
+require_relative 'rush/here_doc'
+require_relative 'rush/escape_table'
+
+require_relative 'rush/ast/node'
+require_relative 'rush/ast/word_segment'
+require_relative 'rush/ast/word'
+require_relative 'rush/ast/param_ref'
+require_relative 'rush/ast/assignment'
+require_relative 'rush/ast/redirect'
+require_relative 'rush/ast/simple_command'
+require_relative 'rush/ast/pipeline'
+require_relative 'rush/ast/and_or'
+require_relative 'rush/ast/list'
+require_relative 'rush/ast/brace_group'
+require_relative 'rush/ast/subshell'
+require_relative 'rush/ast/redirected'
+require_relative 'rush/ast/if_node'
+require_relative 'rush/ast/condition_loop'
+require_relative 'rush/ast/while_node'
+require_relative 'rush/ast/until_node'
+require_relative 'rush/ast/for_node'
+require_relative 'rush/ast/case_node'
+require_relative 'rush/ast/function_def'
+require_relative 'rush/command_text'
+
+require_relative 'rush/redirection/file_redirect'
+require_relative 'rush/redirection/here_doc_redirect'
+require_relative 'rush/redirection/dup_redirect'
+require_relative 'rush/redirection/registry'
+
+require_relative 'rush/expansion/resolver'
+require_relative 'rush/expansion/parameter_forms'
+require_relative 'rush/expansion/pattern_removal'
+require_relative 'rush/expansion/parameter_expander'
+require_relative 'rush/expansion/command_substitution'
+require_relative 'rush/expansion/tilde_expander'
+require_relative 'rush/expansion/arithmetic/number'
+require_relative 'rush/expansion/arithmetic/nodes'
+require_relative 'rush/expansion/arithmetic/tokenizer'
+require_relative 'rush/expansion/arithmetic/parser'
+require_relative 'rush/expansion/arithmetic/evaluator'
+require_relative 'rush/expansion/arithmetic_expander'
+require_relative 'rush/expansion/ifs'
+require_relative 'rush/expansion/field_part'
+require_relative 'rush/expansion/ifs_scanner'
+require_relative 'rush/expansion/field_splitter'
+require_relative 'rush/expansion/glob_expander'
+require_relative 'rush/expansion/read_char'
+require_relative 'rush/expansion/read_field_scanner'
+require_relative 'rush/expansion/read_splitter'
+require_relative 'rush/expansion/pipeline'
+
+require_relative 'rush/command_assignments'
+
+require_relative 'rush/builtins/base'
+require_relative 'rush/builtins/loop_jump'
+require_relative 'rush/builtins/registry'
+require_relative 'rush/builtins/colon'
+require_relative 'rush/builtins/true_'
+require_relative 'rush/builtins/false_'
+require_relative 'rush/builtins/echo'
+require_relative 'rush/builtins/exit'
+require_relative 'rush/builtins/pwd'
+require_relative 'rush/builtins/cd'
+require_relative 'rush/builtins/break_'
+require_relative 'rush/builtins/continue_'
+require_relative 'rush/builtins/return_'
+require_relative 'rush/builtins/fd_operand'
+require_relative 'rush/builtins/test_operators'
+require_relative 'rush/builtins/test_context'
+require_relative 'rush/builtins/test_tokens'
+require_relative 'rush/builtins/test_grammar'
+require_relative 'rush/builtins/test_expr'
+require_relative 'rush/builtins/test_'
+require_relative 'rush/builtins/set'
+require_relative 'rush/builtins/shift'
+require_relative 'rush/builtins/declare'
+require_relative 'rush/builtins/export'
+require_relative 'rush/builtins/readonly'
+require_relative 'rush/builtins/unset'
+require_relative 'rush/builtins/eval'
+require_relative 'rush/builtins/getopts'
+require_relative 'rush/builtins/read_input'
+require_relative 'rush/builtins/read'
+require_relative 'rush/builtins/printf_formatter'
+require_relative 'rush/builtins/printf'
+require_relative 'rush/builtins/dot'
+require_relative 'rush/builtins/exec'
+require_relative 'rush/builtins/local'
+require_relative 'rush/builtins/type_'
+require_relative 'rush/builtins/command_options'
+require_relative 'rush/builtins/command'
+require_relative 'rush/builtins/trap'
+require_relative 'rush/builtins/kill'
+require_relative 'rush/builtins/alias_'
+require_relative 'rush/builtins/unalias'
+require_relative 'rush/builtins/hash'
+require_relative 'rush/builtins/times'
+require_relative 'rush/builtins/umask'
+require_relative 'rush/builtins/ulimit'
+require_relative 'rush/builtins/wait'
+require_relative 'rush/builtins/jobs'
+require_relative 'rush/builtins/job_resume'
+require_relative 'rush/builtins/defaults'
+
+require_relative 'rush/external'
+require_relative 'rush/command_resolution'
+require_relative 'rush/command_lookup'
+require_relative 'rush/command_runner'
+require_relative 'rush/pipeline_statuses'
+require_relative 'rush/pipeline_runner'
+require_relative 'rush/subshell_runner'
+require_relative 'rush/background_runner'
+require_relative 'rush/loop_control_handling'
+require_relative 'rush/loop_runner'
+require_relative 'rush/for_runner'
+require_relative 'rush/function_runner'
+require_relative 'rush/exit_trap'
+require_relative 'rush/trap_runner'
+require_relative 'rush/errexit_context'
+require_relative 'rush/redirect_scope'
+require_relative 'rush/executor'
+
+require_relative 'rush/lexer'
+require_relative 'rush/parser_support'
+require_relative 'rush/parser'
+require_relative 'rush/source_line_counter'
+require_relative 'rush/program_reader'
+require_relative 'rush/program_session'
+require_relative 'rush/source_runner'
+require_relative 'rush/segment_buffer'
+require_relative 'rush/param_text'
+require_relative 'rush/startup'
+require_relative 'rush/program_input'
+require_relative 'rush/invocation'
+require_relative 'rush/interactive_signals'
+require_relative 'rush/source'
+require_relative 'rush/prompt'
+require_relative 'rush/repl'
+require_relative 'rush/cli'