chrad 1.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: b2496ecbaa44e120f9be12f8850bafcbc91cb6be85fde1d89afe392260829fd7
+  data.tar.gz: b86d3009434f1ac3007fbda668d3c671d56e98227896ee66a3c4576b896b9367
+SHA512:
+  metadata.gz: 74a95665031363af6adb52cd4daf79f1564864164479055b60906e01d60474eac2ca9c50803447cb34b71ea62b4c2bb3409363b8ae5c22ff0d3a422c8533c62a
+  data.tar.gz: d7c89246f637683d07b8166d5f681688323514105d8adc7b0db69864e3288a05b8489492254cd33ab5434c25a5c45f44232432f1160f5024a0688491367d0407

data/Gemfile

@@ -0,0 +1,9 @@
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in chrad.gemspec
+gemspec
+
+gem "rake", "~> 12.0"
+gem "minitest", "~> 5.0"
+
+gem "byebug", "~> 11.1", :groups => [:development, :test]

data/Gemfile.lock

@@ -0,0 +1,23 @@
+PATH
+  remote: .
+  specs:
+    chrad (1.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    byebug (11.1.3)
+    minitest (5.16.2)
+    rake (12.3.3)
+
+PLATFORMS
+  x86_64-linux
+
+DEPENDENCIES
+  byebug (~> 11.1)
+  chrad!
+  minitest (~> 5.0)
+  rake (~> 12.0)
+
+BUNDLED WITH
+   2.3.9

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2022 Brent Sanders
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+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 OR COPYRIGHT HOLDERS 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.

data/README.md

@@ -0,0 +1,188 @@
+# ChRad
+
+Change Radix. A command line utility to convert integer bases.
+
+Arbitrarily large numbers are supported thanks to ruby's built-in
+support for bignums. Conversion to or from any positive integer fixed
+base system is supported.
+
+Mixed-radix systems are not supported. For converting numbers in the factoradic
+(factorial base) system, use my [factoradic gem][fact_gem] or [faster c utility][c_util].
+
+[fact_gem]: https://github.com/pdkl95/factoradic
+
+[c_util]: https://github.com/pdkl95/factoradic_c_utils
+
+
+## Installation
+
+Run:
+
+    gem install chrad
+
+
+## Usage
+
+### The command line utility
+
+#### Options
+
+```
+Usage: chrad [options] -i <input_base> -o <output_base> <number> [...]
+
+REQUIRED OPTIONS
+
+  -i, --input=BASE         Interpret input strings integers in base <BASE>
+  -o, --output=BASE        Print converted numbers as integers in base <BASE>
+
+INPUT/OUTPUT FORMAT
+
+      --input-list         Input values as delimiter separated lists
+      --output-list        Output values as delimiter separated lists
+  -l, --list               Both input and output values as delimiter separated lists
+                           (Shorthand for using both --input-list and --output-list)
+      --input-sep=CHAR     Use <CHAR> as the delimiter between places
+                           in input vales when using --input-list mode
+      --output-sep=CHAR    Use <CHAR> as the delimiter between places
+                           in output vales when using --output-list mode
+  -s, --separator=CHAR     Use <CHAR> as the delimiter between places in both
+                           input and output list modes. (shorthand for using
+                           both --input-separator=CHAR and --output-separator=CHAR)
+
+DIGIT ALPHABET
+
+      --input-digits=STR   Use the given <STR> as the set of chars to use
+                           when interpreting input integers.
+                           (Ignored when using--input-list mode.)
+      --output-digits=STR  Use the given <STR> as the set of chars to use
+                           when printing number in the output base.
+                           (Ignored when using--input-list mode.)
+  -d, --digits=STR         Use the given <STR> as the set of chars to use
+                           for both input and output. (shorthand for using
+                           both --input-digits=STR and --output-digits=STR)
+
+      --list-named-digits  List the built-in named digit sets. These names
+                           can be passed to any of --digits, --input-digits,
+                           or --output-digits using the \"name:\" prefix.
+                           (example: \"--digits=base64\")
+  -h, --help               Show this help message
+      --version            Show version
+```
+
+
+#### Examples
+
+```
+$ chrad -i 10 -o 16 255
+ff
+
+$ chrad -i 16 -o 2 c9
+11001001
+
+$ chrad -i 10 -o 64 --output-digits=name:base64 129633344153503
+deadbeef
+
+$ chrad -i 10 -o 64 --output-list 129633344153503
+29,30,26,29,27,30,30,31
+
+$ chrad -i 64 -o 64 --input-list --output-digits=name:base64 29,30,26,29,27,30,30,31
+deadbeef
+
+$ chrad -i 10 -o 4 --output-digits='♠♡♢♣' 4321
+♡♠♠♣♢♠♡
+
+$ print3nums() { echo 255 ; echo 65535 ; echo 16777215 ; }
+$ print3nums | chrad -i 10 -o 16 --stdin
+ff
+ffff
+ffffff
+```
+
+
+### Input/Output
+
+To represent a number in a given base, a set of digits must be available
+that is at least as large as that base. To support this, chrad allows
+you to provide a string of characters to use for input, output, or
+both (with `--input-digits`, `--output-digits`, and `--digits`
+respectively).
+
+```
+$ chrad -i 16 -o 3 --output-digits .-/ 5717063
+/.-../---/...-/./
+```
+
+
+#### Built-in Digit Sets
+
+Several commonly used sets of digits are built-in. To use a built-in
+set, use the name of the wet with the `--digits` options and a `name:`
+prefix.
+
+```
+$ chrad -i 16 -o 64 --output-digits=name:base64 dea
+```
+
+The built-in digit sets are:
+```
+$ chrad --list-named-digits
+name:base62     ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789
+name:base64     ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/
+name:base64url  ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_
+name:base32rfc  ABCDEFGHIJKLMNOPQRSTUVWXYZ234567
+name:base32     0123456789abcdefghijklmnopqrstuv
+name:base16     0123456789abcdef
+```
+
+The sets `base16` and `base32` are the common hexadecimal-style
+extension of the base 10 digits. The sets `base64`, `base64url`, and
+`base32rfc` are from [RFC 3548][rfc3548].
+
+[rfc3548]: https://datatracker.ietf.org/doc/html/rfc3548
+
+
+#### List Mode
+
+When converting numbers in very large bases, finding appropriate
+characters to use becomes difficult. To avoid this problem, use list
+mode. List mode can also make integration easier because it is a
+base-independent representation.
+
+List mode can be enabled for input, output, or both with
+`--input-list`, `--output-list`, and `-l/--list` respectively. When
+list mode is enabled, numbers are represented as a comma (`","`)
+separated list of base 10 integers.
+
+```
+$ chrad -i 10 -o 64 --output-list  16772988
+63,62,61,60
+
+$ chrad -i 64 -o 16 --input-list 3,30,43,27,59,47
+deadbeef
+
+$ chrad -i 8 -o 16 --list 5,4,3,2,1
+5,8,13,1
+```
+
+The comma separator can be changed to any character with the
+`--input-sep`, `--output-sep`, and `-s/--separator` options.
+
+```
+$ chrad -i 10 -o 64 --output-list --output-sep=: 16772988
+63:62:61:60
+```
+
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/pdkl95/chrad.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.warning = false
+  t.test_globs = ["test/**/*_test.rb"]
+end
+
+task default: :test

data/certs/pdkl95.pem

@@ -0,0 +1,25 @@
+-----BEGIN CERTIFICATE-----
+MIIEMDCCApigAwIBAgIBATANBgkqhkiG9w0BAQsFADAhMR8wHQYDVQQDDBZwZGts
+OTUvREM9Z21haWwvREM9Y29tMB4XDTIyMDIwMTIxNDQxMFoXDTIzMDIwMTIxNDQx
+MFowITEfMB0GA1UEAwwWcGRrbDk1L0RDPWdtYWlsL0RDPWNvbTCCAaIwDQYJKoZI
+hvcNAQEBBQADggGPADCCAYoCggGBAJrJqYa1q3ckmQ6L0v5r2KpJLFrks7L9cmpO
+qdo3QdUZqnBbIIuhkUOy+rzUM//lCvZeT2Rym8zysJWslATnjhqoKdC6HhAnM7u8
+puI1Xgr0vy84YCc4Ec0iRyrUQkwRB0flQ1XzmH4CJzMD9HafjF0JbCakoawxYsWu
+A8DJ4mZn8sdz0BjGF5nHaLtt/cTx4FQpHLcU6AJSep0BP+fn87HGsrvhLEcITx5v
+8KYnWAdCEiSVCprmANn0rEeD/vCONotRdUBGSmx6aYV/ijujS+ND7a0hk8d3lhkk
+yvW9L4GM6i3lDsM/wlNBG/HwJuuI06Nve/FC53XYUbh6oyszHiwf8F3jpd9LVHiz
+hO05+X59sJfbC26k8HdsI8/hodDJfgJ4VM5sOqqg3yKV8h6kySiGFSr1XeWddblg
+Zz5jRp85cQsLQWUKWBfxGG3Jnqe8h+aflTaUqnU1EWkEyS0BsotZAFD5t5yX55WD
+dlaJPfF7IyJABxsY+L9LvmWUPFx4RwIDAQABo3MwcTAJBgNVHRMEAjAAMAsGA1Ud
+DwQEAwIEsDAdBgNVHQ4EFgQUsdOGedmK14HgEtn36tJY4fFiPyUwGwYDVR0RBBQw
+EoEQcGRrbDk1QGdtYWlsLmNvbTAbBgNVHRIEFDASgRBwZGtsOTVAZ21haWwuY29t
+MA0GCSqGSIb3DQEBCwUAA4IBgQA481LIo+nYP69SRZgo6Okpii2kO3URi+aR5TLC
+8BZI/z5/NuYZivMuaMenL90NmeF3LYjmKrOhQD0JmW48YmWQB19b2kIbExBqmu3V
+JomVhCTLZ+oU3NhzQ5fL70DUhOz7CUCKpLV5lsUyUEGjebDFN21j4GjyeDFqkphj
+/d2Qe2I5NLzga3tB1AOBqH0EAf3GSWDp1KkWDSUpUCbhjI+CAu4tpUj74HuCBG4g
+QSTyCS7bp79NUcLmDGJ/43ZgPpJwo6wdV5uo3BQMq8AzRDnTXW1EeGlBOTaDCCvp
+N7ImUU63/qmLKyPskr53EKYR6bzvF4V+w5+Lq/JxWIbaB5UxY1kCxGrOubzQLvwE
+tf/k74CEmUNN71A4MXGVuydmgrlok/LBZO8Lqa9Dt+95nBdqKz5vIcO6szPGZIid
+NMwK52EhsO4bDuwRB7r1zYTj42O24s0o0yJQPzqhfQEGssdLDNkEr147K0symobj
+l35DiP6VyFMH/Y0JWgs65E5bGzk=
+-----END CERTIFICATE-----

data/chrad.gemspec

@@ -0,0 +1,32 @@
+require_relative "lib/chrad/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "chrad"
+  spec.version = ChRad::VERSION
+  spec.authors = ["Brent Sanders"]
+  spec.email = ["git@gmail.com"]
+
+  spec.summary = %q{Command line util to convert integer base}
+  spec.description = %q{A commsnd line utility to convert integers into arbitrary bases.}
+
+  spec.homepage = "https://github.com/pdkl95/chrad"
+  spec.license = "MIT"
+  spec.required_ruby_version = Gem::Requirement.new(">= 2.3.0")
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+
+  spec.cert_chain = ['certs/pdkl95.pem']
+  spec.signing_key = File.expand_path("~/.ssh/gem-private_key.pem") if $0 =~ /gem\z/
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+end

data/exe/chrad

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'chrad/cli'
+
+ChRad::CLI.new(ARGV).run!

data/lib/chrad/algorithms.rb

@@ -0,0 +1,18 @@
+module ChRad
+  module Algorithms
+    def self.number_to_base(number, base)
+      if number == 0
+        return [0]
+      end
+
+      digits = []
+      while number > 0
+        div, mod = number.divmod(base)
+        digits.push(mod)
+        number = div
+      end
+
+      digits      
+    end
+  end
+end

data/lib/chrad/alphabet.rb

@@ -0,0 +1,95 @@
+module ChRad
+  class Alphabet
+    B62 = (
+      ('A'..'Z').to_a +
+      ('a'..'z').to_a +
+      (0..9).to_a.map(&:to_s)
+    )
+
+    B32rfc = (
+      ('A'..'Z').to_a +
+      ('2'..'7').to_a
+    )
+
+    B32 = (
+      ('0'..'9').to_a +
+      ('a'..'v').to_a
+    )
+
+    B16 = (
+      ('0'..'9').to_a +
+      ('a'..'f').to_a
+    )
+
+    def self.all
+      @all ||= Hash.new
+    end
+
+    def self.add(name, digits)
+      all[name.to_s] = digits
+    end
+
+    def self.find(name)
+      all[name.to_s]
+    end
+
+    def self.[](name)
+      find(name)
+    end
+
+    def self.names
+      all.keys
+    end
+
+    add :base62,    B62
+    add :base64,    B62 + %w(+ /)
+    add :base64url, B62 + %w(- _)
+    add :base32rfc, B32rfc
+    add :base32,    B32
+    add :base16,    B16
+
+
+    attr_reader :name, :digits
+
+    def initialize(name, digit_chars)
+      @name = name
+               
+      self.digits = digit_chars
+    end
+
+    def digits=(value)
+      new_digits = []
+      case value
+      when String
+        self.digits = value.each_char.to_a
+      
+      when Array
+        value.each do |ch|
+          if new_digits.include?(ch)
+            raise InvalidInputError,
+                  "Cannot add duplicate characters (\"#{ch}\")"
+          else
+            new_digits.push ch.to_s
+          end
+        end
+
+        @digits = new_digits
+        
+      else
+        raise Error, "Cannot set digits from a \"${value}\". Expected a list of digits as a String or Array"
+      end
+    end
+
+    def [](*args)
+      digits[*args]
+    end
+
+    def length
+      digits.length
+    end
+
+    def to_s
+      digits.join('')
+    end
+  end
+end

data/lib/chrad/cli.rb

@@ -0,0 +1,183 @@
+require 'chrad'
+require 'optparse'
+
+module ChRad
+  class CLI
+    attr_reader :argv
+
+    def initialize(argv = ARGV)
+      @argv = argv.map do |x|
+        x.to_s
+      end
+    end
+
+    def input
+      @input ||= ChRad::InputManager.new
+    end
+
+    def output
+      @output ||= ChRad::OutputManager.new
+    end
+
+    def optparse
+      @optparse ||= OptionParser.new do |opts|
+        opts.banner = "Converts integers into a different base (radix)."
+        opts.define_head "Usage: #{$0} [options] -i <input_base> -o <output_base> <number> [...]"
+        opts.summary_width = 24
+        opts.summary_indent = '  '
+
+        opts.separator ''
+        opts.separator 'REQUIRED OPTIONS'
+        opts.separator ''
+
+        opts.on('-iBASE', '--input=BASE',
+                'Interpret input strings integers in base <BASE>'
+               ) do |base|
+          input.base = base
+        end
+
+        opts.on('-oBASE', '--output=BASE',
+                'Print converted numbers as integers in base <BASE>'
+               ) do |base|
+          output.base = base
+        end
+
+
+        opts.separator ''
+        opts.separator 'INPUT/OUTPUT FORMAT'
+        opts.separator ''
+
+        opts.on('--input-list',
+                'Input values as delimiter separated lists'
+               ) do
+          input.mode = :list
+        end
+
+        opts.on('--output-list',
+                'Output values as delimiter separated lists'
+               ) do
+          output.mode = :list
+        end
+
+        opts.on('-l', '--list',
+                'Both input and output values as delimiter separated lists',
+                '(Shorthand for using both --input-list and --output-list)'
+               ) do
+          input.mode = :list
+          output.mode = :list
+        end
+
+        opts.on('--input-sep=CHAR',
+                'Use <CHAR> as the delimiter between places',
+                'in input vales when using --input-list mode'
+               ) do |sep|
+          input.separator = sep
+        end
+
+        opts.on('--output-sep=CHAR',
+                'Use <CHAR> as the delimiter between places',
+                'in output vales when using --output-list mode'
+               ) do |sep|
+          output.separator = sep
+        end
+
+        opts.on('-s', '--separator=CHAR',
+                'Use <CHAR> as the delimiter between places in both',
+                'input and output list modes. (shothand for using',
+                'both --input-separator=CHAR and --output-separator=CHAR)'
+               ) do |sep|
+          input.separator = sep
+          output.separator = sep
+        end
+
+        opts.separator ''
+        opts.separator 'DIGIT ALPHABET'
+        opts.separator ''
+
+        opts.on('--input-digits=STR',
+                'Use the given <STR> as the set of chars to use',
+                'when interpreting input integers.',
+                '(Ignored when using--input-list mode.)'
+               ) do |str|
+          input.alphabet = str
+        end
+
+        opts.on('--output-digits=STR',
+                'Use the given <STR> as the set of chars to use',
+                'when printing number in the output base.',
+                '(Ignored when using--input-list mode.)'
+               ) do |str|
+          output.alphabet = str
+        end
+
+        opts.on('-d', '--digits=STR',
+                'Use the given <STR> as the set of chars to use',
+                'for both input and output. (shorthand for using',
+                'both --input-digits=STR and --output-digits=STR)'
+               ) do |str|
+          input.alphabet = str
+          output.alphabet = str
+        end
+
+
+        opts.separator ''
+
+        opts.on('--stdin',
+                'Read one number per line from STDIN instead',
+                'of ARGV. Equivalent to using the single',
+                'character "-" as the first arg.'
+               ) do
+          input.force_stdin = true 
+        end
+
+        opts.on('--list-named-digits',
+                'List the built-in named digit sets. These names',
+                'can be passed to any of --digits, --input-digits,',
+                'or --output-digits using the \"name:\" prefix.',
+                '(example: \"--digits=base64\")'
+               ) do
+          Alphabet.all.each_pair do |name, digits|
+            puts "name:#{name}\t#{digits.join('')}"
+          end
+          exit
+        end
+
+        opts.on('-h', '--help', 'Show this help message') do
+          puts opts
+          exit
+        end
+
+        opts.on('--version', 'Show version') do
+          puts ChRad::VERSION
+          exit
+        end
+      end
+    end
+
+    def run!
+      optparse.parse!(argv)
+
+      if argv.length > 0
+        unless argv.first == '-'
+          unless input.force_stdin
+            input.stream = argv            
+          end
+        end
+      else
+        unless input.force_stdin
+          puts optparse
+          exit 1
+        end
+      end
+
+      input.setup_base_digits!
+      output.setup_base_digits!
+
+      input.stream.each do |arg|
+        arg = arg.chomp
+        number = input.parse(arg)
+        output.stream_puts(number)
+      end
+    end
+  end
+end

data/lib/chrad/io_manager.rb

@@ -0,0 +1,136 @@
+require_relative 'algorithms'
+
+module ChRad
+  class IOManager
+    attr_accessor :stream, :base
+    attr_writer :mode, :separator
+    attr_reader :digits
+
+    def mode
+      @mode ||= DEFAULT_MODE
+    end
+
+    def base=(value)
+      case value
+      when Integer
+        @base = value
+      when /\A[0-9]+\Z/
+        @base = value.to_i
+      else
+        raise Error, "Trying to set #{name} base to #{value.inspect} (expected an Integer or a string matching /[0-9]+/"
+      end
+    end
+
+    def separator
+      @separator ||= DEFAULT_SEPARATOR
+    end
+
+    def alphabet
+      @alphabet ||= DEFAULT_ALPHABET
+    end
+
+    def alphabet=(str)
+      @alphabet = automagic_find_alphabet(str)
+    end
+
+    def automagic_find_alphabet(str)
+      case str
+      when /\Aname:(\w+)\Z/
+        Alphabet.find($1) or raise Error, "No digit alphabet named \"#{$1}\""
+      else
+        Alphabet.new("custom_#{name}", str)
+      end
+    end
+
+    def setup_base_digits!
+      case mode
+      when :alphabet
+        if base > alphabet.length
+          raise Error, "Trying to use base #{base}, but the input alphabet only has #{alphabet.length} characters."
+        end
+
+        @digits = alphabet[0, base]
+
+      when :list
+        # not needed in :list mode
+
+      else
+        raise Error, "Invalid mode #{mode.inspect}"
+      end
+    end
+
+    def value_to_digit(value)
+      raise Error, '@digits == nil' if @digits.nil?
+      @digits[value]
+    end
+  end
+
+  class InputManager < IOManager
+    attr_accessor :force_stdin
+
+    def initialize
+      @base = DEFAULT_INPUT_BASE
+      @stream = $stdin
+      @force_stdin = false
+    end
+
+    def name
+      'input'
+    end
+
+    def parse(str)
+      case mode
+      when :alphabet
+        str.reverse.each_char.map.with_index do |c, idx|
+          value = digits.index(c)
+          if value.nil?
+            raise Error, "Input digit #{c.inspect} is not a valid input digit (expected: #{digits.join('')})"
+          end
+          value * (base ** idx)
+        end.reduce(&:+)
+
+      when :list
+        digits = str.split(separator).reverse
+        digits.map.with_index do |x,idx|
+          x.to_i * (base ** idx)
+        end.reduce(&:+)
+
+      else
+        raise Error, "Invalid mode #{mode.inspect}"
+      end
+    end
+  end
+
+  class OutputManager < IOManager
+    def initialize
+      @base = DEFAULT_OUTPUT_BASE
+      @stream = $stdout
+    end
+
+    def name
+      'output'
+    end
+
+    def number_to_string(number)
+      list = Algorithms.number_to_base(number, base)
+      list.reverse!
+
+      case mode
+      when :alphabet
+        list.map do |value|
+          value_to_digit(value)
+        end.join('')
+
+      when :list
+        list.join(separator)
+
+      else
+        raise Error, "Invalid mode #{mode.inspect}"
+      end
+    end
+
+    def stream_puts(number)
+      stream.puts number_to_string(number)
+    end
+  end
+end

data/lib/chrad/version.rb

@@ -0,0 +1,3 @@
+module ChRad
+  VERSION = "1.1.0"
+end

data/lib/chrad.rb

@@ -0,0 +1,20 @@
+require_relative "chrad/version"
+
+module ChRad
+  class Error < StandardError; end
+  class InvalidInputError < Error; end
+
+  DEFAULT_BASE = 10
+  DEFAULT_INPUT_BASE  = DEFAULT_BASE
+  DEFAULT_OUTPUT_BASE = DEFAULT_BASE
+
+  DEFAULT_MODE = :alphabet
+  DEFAULT_SEPARATOR = ','
+end
+
+require_relative 'chrad/alphabet'
+require_relative 'chrad/io_manager'
+
+module ChRad
+  DEFAULT_ALPHABET = Alphabet[:base16]
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification
+name: chrad
+version: !ruby/object:Gem::Version
+  version: 1.1.0
+platform: ruby
+authors:
+- Brent Sanders
+autorequire: 
+bindir: exe
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIEMDCCApigAwIBAgIBATANBgkqhkiG9w0BAQsFADAhMR8wHQYDVQQDDBZwZGts
+  OTUvREM9Z21haWwvREM9Y29tMB4XDTIyMDIwMTIxNDQxMFoXDTIzMDIwMTIxNDQx
+  MFowITEfMB0GA1UEAwwWcGRrbDk1L0RDPWdtYWlsL0RDPWNvbTCCAaIwDQYJKoZI
+  hvcNAQEBBQADggGPADCCAYoCggGBAJrJqYa1q3ckmQ6L0v5r2KpJLFrks7L9cmpO
+  qdo3QdUZqnBbIIuhkUOy+rzUM//lCvZeT2Rym8zysJWslATnjhqoKdC6HhAnM7u8
+  puI1Xgr0vy84YCc4Ec0iRyrUQkwRB0flQ1XzmH4CJzMD9HafjF0JbCakoawxYsWu
+  A8DJ4mZn8sdz0BjGF5nHaLtt/cTx4FQpHLcU6AJSep0BP+fn87HGsrvhLEcITx5v
+  8KYnWAdCEiSVCprmANn0rEeD/vCONotRdUBGSmx6aYV/ijujS+ND7a0hk8d3lhkk
+  yvW9L4GM6i3lDsM/wlNBG/HwJuuI06Nve/FC53XYUbh6oyszHiwf8F3jpd9LVHiz
+  hO05+X59sJfbC26k8HdsI8/hodDJfgJ4VM5sOqqg3yKV8h6kySiGFSr1XeWddblg
+  Zz5jRp85cQsLQWUKWBfxGG3Jnqe8h+aflTaUqnU1EWkEyS0BsotZAFD5t5yX55WD
+  dlaJPfF7IyJABxsY+L9LvmWUPFx4RwIDAQABo3MwcTAJBgNVHRMEAjAAMAsGA1Ud
+  DwQEAwIEsDAdBgNVHQ4EFgQUsdOGedmK14HgEtn36tJY4fFiPyUwGwYDVR0RBBQw
+  EoEQcGRrbDk1QGdtYWlsLmNvbTAbBgNVHRIEFDASgRBwZGtsOTVAZ21haWwuY29t
+  MA0GCSqGSIb3DQEBCwUAA4IBgQA481LIo+nYP69SRZgo6Okpii2kO3URi+aR5TLC
+  8BZI/z5/NuYZivMuaMenL90NmeF3LYjmKrOhQD0JmW48YmWQB19b2kIbExBqmu3V
+  JomVhCTLZ+oU3NhzQ5fL70DUhOz7CUCKpLV5lsUyUEGjebDFN21j4GjyeDFqkphj
+  /d2Qe2I5NLzga3tB1AOBqH0EAf3GSWDp1KkWDSUpUCbhjI+CAu4tpUj74HuCBG4g
+  QSTyCS7bp79NUcLmDGJ/43ZgPpJwo6wdV5uo3BQMq8AzRDnTXW1EeGlBOTaDCCvp
+  N7ImUU63/qmLKyPskr53EKYR6bzvF4V+w5+Lq/JxWIbaB5UxY1kCxGrOubzQLvwE
+  tf/k74CEmUNN71A4MXGVuydmgrlok/LBZO8Lqa9Dt+95nBdqKz5vIcO6szPGZIid
+  NMwK52EhsO4bDuwRB7r1zYTj42O24s0o0yJQPzqhfQEGssdLDNkEr147K0symobj
+  l35DiP6VyFMH/Y0JWgs65E5bGzk=
+  -----END CERTIFICATE-----
+date: 2022-07-12 00:00:00.000000000 Z
+dependencies: []
+description: A commsnd line utility to convert integers into arbitrary bases.
+email:
+- git@gmail.com
+executables:
+- chrad
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- certs/pdkl95.pem
+- chrad.gemspec
+- exe/chrad
+- lib/chrad.rb
+- lib/chrad/algorithms.rb
+- lib/chrad/alphabet.rb
+- lib/chrad/cli.rb
+- lib/chrad/io_manager.rb
+- lib/chrad/version.rb
+homepage: https://github.com/pdkl95/chrad
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/pdkl95/chrad
+  source_code_uri: https://github.com/pdkl95/chrad
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.4
+signing_key: 
+specification_version: 4
+summary: Command line util to convert integer base
+test_files: []