base45_lite 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1910b7a1ffbeac3439e25a8a31272cf52ef1e9036c6429ea7e789f522018c417
+  data.tar.gz: 31dcc6f11dfc98a4e2b327d06f9f35dc63c72ba1e1f0cbed01d84c80735726bb
+SHA512:
+  metadata.gz: 207781b24d294bd4805826a029e39e498efeee3d7ebb2e9c0a72bb62469ed525fe8b00a3b276b43b020d09c3b845f280585a3e8da174a25da2e3ead078cbc8dd
+  data.tar.gz: 9803f051edb2daad7491c008bda25e0c6361909e347719d70f4d43a6e3a5ac1f02126bc07456f5975ed7740eb678e7c03dfb48629b3051d8cbeffa8a3433f4f4

data/lib/base45_lite.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+# Copyright (c) 2022 Weihang Jian <https://tonytonyjan.net>
+#
+# 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.
+
+# An implementation of draft-faltstrom-base45-10, see
+# https://datatracker.ietf.org/doc/draft-faltstrom-base45/
+module Base45Lite
+  class Error < ::StandardError; end
+  class OverflowError < Error; end
+  class InvalidCharacterError < Error; end
+  class ForbiddenLengthError < Error; end
+
+  MAX_UINT18 = 2**16 - 1
+  SQUARED_45 = 45**2
+  MAPPING = [
+    *'0'..'9',
+    *'A'..'Z',
+    ' ', '$', '%', '*', '+', '-', '.', '/', ':'
+  ].map!.with_index { |x, i| [i, x] }.to_h.freeze
+  REVERSE_MAPPING = MAPPING.invert.freeze
+
+  def self.encode(input)
+    sequence = []
+    input.unpack('n*').map! do |uint16|
+      i, c = uint16.divmod(45)
+      i, d = i.divmod(45)
+      _, e = i.divmod(45)
+      sequence.push(c, d, e)
+    end
+    if input.bytesize.odd?
+      i, c = input.getbyte(-1).divmod(45)
+      _, d = i.divmod(45)
+      sequence.push(c, d)
+    end
+    sequence.map!{ MAPPING[_1] }.join
+  end
+
+  def self.decode(input)
+    input
+      .chars.map! { REVERSE_MAPPING[_1] || raise(InvalidCharacterError) }
+      .each_slice(3).map do |slice|
+        c, d, e = slice
+        raise ForbiddenLengthError if d.nil?
+
+        sum = c + d * 45
+        sum += e * SQUARED_45 if e
+        raise OverflowError if sum > MAX_UINT18
+
+        sum
+      end
+      .pack((input.length % 3).zero? ? 'n*' : "n#{input.length / 3}C")
+  end
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification
+name: base45_lite
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Weihang Jian
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2022-04-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: base45_lite is a Ruby implementation of Base45 data encoding
+email:
+- tonytonyjan@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/base45_lite.rb
+homepage: https://github.com/tonytonyjan/base45_lite
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: Base45 encoder/decoder
+test_files: []