opp 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 81ad8ada6040b0889e5ecb235ac3c3f6984861a873c6b43ccef2983302d36329
+  data.tar.gz: 7274afc3ef775161202bf0ecd3347d3e960b6a73c09481185d9531819af7445b
+SHA512:
+  metadata.gz: ccac5009a2952880b2da533090bde8734301a8348ecc1b11e5cb86cc5a0a663b5ba12d2edf6ecf7fc927da8058c35a6bb953e611f9b95e4e504aa6b0ba729955
+  data.tar.gz: c2e5a220072aa313e6e92bdf9f92d77a2da513f1a7ce800672e12006f9977bccc0d15736e6797a4c444cfc63254c27973d51859b06683360423c56fd73323a72

data/LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+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 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.
+
+For more information, please refer to <http://unlicense.org/>

data/lib/opp.rb

@@ -0,0 +1,91 @@
+# frozen_string_literal: true
+
+# Inspiration for this came from a feature request by Sampersand: https://bugs.ruby-lang.org/issues/21015
+
+require 'set'
+
+reserved_names = Set[
+  'FILENAME', 'VERBOSE', 'DEBUG', 'stdin', 'stdout', # globals
+  'stderr', 'LOAD_PATH', 'LOADED_FEATURES',
+  'ERROR_INFO', 'ERROR_POSITION', 'FS', 'FIELD_SEPARATOR', # English module
+  'OFS', 'OUTPUT_FIELD_SEPARATOR', 'RS', 'INPUT_RECORD_SEPARATOR',
+  'ORS', 'OUTPUT_RECORD_SEPARATOR', 'INPUT_LINE_NUMBER', 'NR',
+  'LAST_READ_LINE', 'DEFAULT_OUTPUT', 'DEFAULT_INPUT', 'PID', 'PROCESS_ID',
+  'CHILD_STATUS', 'LAST_MATCH_INFO', 'IGNORECASE', 'ARGV', 'MATCH',
+  'PREMATCH', 'POSTMATCH', 'LAST_PAREN_MATCH'
+]
+
+make_valid_name = lambda do |name|
+  name = name.to_s.gsub('-', '_')
+  reserved_names.include?(name) ? "_#{name}" : name
+end
+set_global = lambda do |name, value, mode = :normal|
+  name = name.to_s.strip # strip might not be necessary
+  raise "Illegal parameter name: «#{name}»" unless /\A\$?[a-zA-Z_][a-zA-Z0-9_]*\z/ =~ name
+
+  name = "$#{name}" unless name.start_with?('$')
+  eq_sign = case mode
+            when :normal then '='
+            when :optional then '||='
+            when :adder then '+='
+            else raise 'Illegal operation in `set_global`.'
+            end
+  eval("#{name} #{eq_sign} ObjectSpace._id2ref(#{value.object_id})", binding, __FILE__, __LINE__)
+  value
+end
+global_is_an_integer = lambda do |name|
+  name = name.to_s.strip
+  raise "Illegal parameter name: «#{name}»" unless /\A\$?[a-zA-Z_][a-zA-Z0-9_]*\z/ =~ name
+
+  name = "$#{name}" unless name.start_with?('$')
+  eval(name, binding, __FILE__, __LINE__).is_a?(Integer)
+end
+process_value = lambda do |value|
+  case value # in the feature request, matz was against this
+  when 'true' then true
+  when 'false' then false
+  when 'nil' then nil
+  when /\A[0-9]+\z/ then Integer(value)
+  else value
+  end
+end
+
+while true
+  break if ARGV.empty?
+
+  arg = ARGV.first
+  case arg
+  when '--', '', /\A[^-]/ # this is for breaking early, otherwise the else section would handle these
+    break
+  when /\A--(?<name>[a-zA-Z_][a-zA-Z0-9_-]*)(?<value>=.*)?\z/
+    rem = Regexp.last_match
+    name = make_valid_name[rem['name']]
+    value = if rem['value']
+              process_value[rem['value'][1..]]
+            else
+              true
+            end
+    set_global[name, value]
+  when /\A-(?<flags>[a-zA-Z][a-zA-Z0-9]*)(?<value>=.*)?\z/
+    rem = Regexp.last_match
+    flags = rem['flags'].chars
+    raise "Illegal argument format: «#{arg}»" if /[0-9]/ =~ flags.first ||
+                                                 (rem['value'] && /[a-zA-Z]/ !~ flags.last)
+
+    set_global[make_valid_name[flags.pop], process_value[rem['value'][1..]]] if rem['value']
+
+    flags.slice_before(/[a-zA-Z]/).each do |ary|
+      name = make_valid_name[ary.shift]
+      if ary.empty?
+        set_global[name, 0, :optional]
+        set_global[name, 1, :adder] if global_is_an_integer[name]
+      else
+        set_global[name, Integer(ary.join)]
+      end
+    end
+  else # something starts with three dashes or one or two dashes followed by non-conventional characters
+    break
+  end
+
+  ARGV.shift
+end

metadata

@@ -0,0 +1,46 @@
+--- !ruby/object:Gem::Specification
+name: opp
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Astra
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2025-10-02 00:00:00.000000000 Z
+dependencies: []
+description: Parses options passed on the command-line and assigns them to eponymous
+  global variables, similar in functionality to Ruby interpreter's `-s` flag but with
+  more features.
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- lib/opp.rb
+homepage:
+licenses:
+- UNLICENSE
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.15
+signing_key:
+specification_version: 4
+summary: Automatic CLI options to global variables parser
+test_files: []