ob64 0.4.0 → 0.6.0

data/ext/ob64/pack_uuencode.h

@@ -0,0 +1,18 @@
+#ifndef PACK_UUENCODE_H
+#define PACK_UUENCODE_H
+
+#include <stddef.h>
+
+size_t pack_uuencode_encode(const char *src, size_t srclen, char *out);
+/* Encodes like native pack("u") with line_len (a multiple of 3, 3..63) bytes per line; returns the length */
+size_t pack_uuencode_lines(const char *src, size_t srclen, char *out, size_t line_len);
+size_t pack_uuencode_decode(const char *src, size_t srclen, char *out);
+/* Upper bound of the decoded length of srclen chars: srclen * 3 / 4 without overflow */
+size_t pack_uudecode_cap(size_t srclen);
+/*
+ * Decodes like native unpack("u") and returns the decoded length. out needs
+ * pack_uudecode_cap(srclen) + 3 bytes; NULL computes the length only.
+ */
+size_t pack_uudecode_lines(const char *src, size_t srclen, char *out);
+
+#endif /* PACK_UUENCODE_H */

data/lib/ob64/core_ext.rb

@@ -1,29 +1,6 @@
 # frozen_string_literal: true
 
 require "ob64"
-require "base64"
 
-module Ob64
-  module CoreExt
-    def strict_encode64(bin)
-      Ob64.strictier_encode(bin)
-    end
-
-    def strict_decode64(str)
-      Ob64.strictier_decode(str)
-    end
-
-    def urlsafe_encode64(bin, padding: true)
-      Ob64.urlsafe_encode(bin, padding: padding)
-    end
-
-    def urlsafe_decode64(str)
-      Ob64.urlsafe_decode(str)
-    end
-  end
-
-  ::Base64.prepend(CoreExt)
-  ::Base64.singleton_class.prepend(CoreExt)
-
-  private_constant :CoreExt
-end
+::Array.prepend(Ob64::Ext::Pack)
+::String.prepend(Ob64::Ext::Unpack)

data/lib/ob64/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Ob64
-  VERSION = "0.4.0"
+  VERSION = "0.6.0"
 end

data/lib/ob64.rb

@@ -3,94 +3,173 @@
 require_relative "ob64/version"
 require_relative "ob64_ext"
 
-# Methods for base64-encoding and -decoding strings.
+# Fast base64 and uuencode encoding and decoding: see {Base64} and {UU}.
 module Ob64
-  # The glue between Ruby and libbase64. See +../ext/libbase64/ob64/ob64_ext.c+.
-  module LibBase64; end
+  # The glue between Ruby and the C codecs. See +../ext/ob64/ob64_ext.c+.
+  module Ext; end
 
-  include LibBase64
-  extend LibBase64
+  include Ext
+  extend Ext
 
   module_function
 
-  # Returns the Base64-encoded version of +bin+.
-  # This method complies with RFC 4648.
-  # No line feeds are added.
+  # Returns the codec used by {Base64}, {UU} and, with +ob64/core_ext+,
+  # +pack+ and +unpack+ with +m+ and +u+. Defaults to {best_codec}.
   #
-  # @param bin [String]
-  # @return [String]
-  def encode(bin)
-    __encode(bin)
+  # @return [Symbol] one of {codecs}
+  def codec
+    __codec
   end
 
-  # Returns the Base64-decoded version of +string+.
-  # This method complies with RFC 4648.
-  # ArgumentError is raised if +string+ is incorrectly padded or contains
-  # non-alphabet characters. Note that CR or LF are also rejected.
+  # Forces a codec for the whole process: every thread and Ractor.
   #
-  # @param string [String]
-  # @return [String]
-  # @raise [ArgumentError] if +string+ cannot be decoded
-  def decode(string)
-    __decode(string)
+  # @param codec [Symbol] one of {codecs}
+  # @return [Symbol] +codec+
+  # @raise [ArgumentError] if +codec+ is unknown or this CPU cannot run it
+  def codec=(codec)
+    __set_codec(codec)
   end
 
-  # Returns the Base64-encoded version of +bin+.
-  # This method complies with ``Base 64 Encoding with URL and Filename Safe
-  # Alphabet'' in RFC 4648.
-  # The alphabet uses '-' instead of '+' and '_' instead of '/'.
-  # Note that the result can still contain '='.
-  # You can remove the padding by setting +padding+ as false.
+  # Returns the codecs this CPU runs, best last. +:scalar+ is plain C.
   #
-  # @param bin [String]
-  # @param padding [Boolean] - if the output must be padded
-  # @return [String]
-  def urlsafe_encode(bin, padding: true)
-    string = __encode(bin)
-    string.chomp!("==") || string.chomp!("=") unless padding
-    string.tr!("+/", "-_")
-    string
+  # @return [Array<Symbol>] among +:scalar+, +:avx2+, +:avx512+, +:neon64+
+  def codecs
+    __codecs
   end
 
-  # Returns the Base64-decoded version of +string+.
-  # This method complies with ``Base 64 Encoding with URL and Filename Safe
-  # Alphabet'' in RFC 4648.
-  # The alphabet uses '-' instead of '+' and '_' instead of '/'.
+  # Returns the best codec this CPU runs, the default {codec}.
   #
-  # The padding character is optional.
-  # This method accepts both correctly-padded and unpadded input.
-  # Note that it still rejects incorrectly-padded input.
-  #
-  # @param string [String]
-  # @return [String]
-  # @raise [ArgumentError] if +string+ cannot be decoded
-  def urlsafe_decode(string)
-    if !string.end_with?("=") && string.length % 4 != 0
-      string = string.ljust((string.length + 3) & ~3, "=")
-      string.tr!("-_", "+/")
-    else
-      string = string.tr("-_", "+/")
-    end
-    __decode(string)
+  # @return [Symbol] one of {codecs}
+  def best_codec
+    codecs.last
   end
 
-  # Returns the length of the Base64-encoded version of +bin+.
-  #
-  # @param bin [String]
-  # @param padding [Boolean] - if the Base64-encoded version of +bin+ will be padded
-  # @return [Integer]
-  def encoded_length_of(bin, padding: true)
-    __encoded_length_of(bin, padding)
+  # Methods for base64-encoding and -decoding strings.
+  module Base64
+    include Ext
+    extend Ext
+
+    module_function
+
+    # Returns the Base64-encoded version of +bin+.
+    # This method complies with RFC 4648.
+    # No line feeds are added.
+    #
+    # @param bin [String]
+    # @return [String]
+    def encode(bin)
+      __encode(bin, false, true)
+    end
+
+    # Returns the Base64-decoded version of +string+.
+    # This method complies with RFC 4648.
+    # ArgumentError is raised if +string+ is incorrectly padded or contains
+    # non-alphabet characters. Note that CR or LF are also rejected.
+    #
+    # With +loose+, the padding character is optional: both correctly-padded
+    # and unpadded input are accepted. Incorrectly-padded input is still
+    # rejected.
+    #
+    # @param string [String]
+    # @param loose [Boolean] - if unpadded input is accepted
+    # @return [String]
+    # @raise [ArgumentError] if +string+ cannot be decoded
+    def decode(string, loose: false)
+      __decode(string, false, loose)
+    end
+
+    # Returns the Base64-encoded version of +bin+.
+    # This method complies with ``Base 64 Encoding with URL and Filename Safe
+    # Alphabet'' in RFC 4648.
+    # The alphabet uses '-' instead of '+' and '_' instead of '/'.
+    # Note that the result can still contain '='.
+    # You can remove the padding by setting +padding+ as false.
+    #
+    # @param bin [String]
+    # @param padding [Boolean] - if the output must be padded
+    # @return [String]
+    def urlsafe_encode(bin, padding: true)
+      __encode(bin, true, padding)
+    end
+
+    # Returns the Base64-decoded version of +string+.
+    # This method complies with ``Base 64 Encoding with URL and Filename Safe
+    # Alphabet'' in RFC 4648.
+    # The alphabet uses '-' instead of '+' and '_' instead of '/'.
+    #
+    # The padding character is optional.
+    # This method accepts both correctly-padded and unpadded input.
+    # Note that it still rejects incorrectly-padded input.
+    #
+    # @param string [String]
+    # @return [String]
+    # @raise [ArgumentError] if +string+ cannot be decoded
+    def urlsafe_decode(string)
+      __decode(string, true, true)
+    end
+
+    # Returns the length of the Base64-encoded version of +bin+.
+    #
+    # @param bin [String]
+    # @param padding [Boolean] - if the Base64-encoded version of +bin+ will be padded
+    # @return [Integer]
+    def encoded_length_of(bin, padding: true)
+      __encoded_length_of(bin, padding)
+    end
+
+    # Returns the length of the Base64-decoded version of +string+.
+    #
+    # ArgumentError is raised if +string+ has an invalid length.
+    #
+    # @param string [String]
+    # @return [Integer]
+    # @raise [ArgumentError] if +string+ has an invalid length
+    def decoded_length_of(string)
+      __decoded_length_of(string)
+    end
   end
 
-  # Returns the length of the Base64-decoded version of +string+.
-  #
-  # ArgumentError is raised if +string+ has an invalid length.
-  #
-  # @param string [String]
-  # @return [Integer]
-  # @raise [ArgumentError] if +string+ has an invalid length
-  def decoded_length_of(string)
-    __decoded_length_of(string)
+  # Methods for uuencoding and -decoding strings.
+  module UU
+    include Ext
+    extend Ext
+
+    module_function
+
+    # Returns the uuencoded version of +bin+, like <tt>[bin].pack("u")</tt>:
+    # lines of up to 45 input bytes, each ending in a newline.
+    #
+    # @param bin [String]
+    # @return [String]
+    def encode(bin)
+      __uuencode(bin)
+    end
+
+    # Returns the uudecoded version of +string+, like <tt>string.unpack1("u")</tt>.
+    # Decoding is lenient, as in Ruby: it stops at the first invalid line and
+    # never raises for malformed input.
+    #
+    # @param string [String]
+    # @return [String]
+    def decode(string)
+      __uudecode(string)
+    end
+
+    # Returns the length of the uuencoded version of +bin+.
+    #
+    # @param bin [String]
+    # @return [Integer]
+    def encoded_length_of(bin)
+      __uuencoded_length_of(bin)
+    end
+
+    # Returns the length of the uudecoded version of +string+.
+    # Like {decode}, never raises for malformed input.
+    #
+    # @param string [String]
+    # @return [Integer]
+    def decoded_length_of(string)
+      __uudecoded_length_of(string)
+    end
   end
 end

data/ob64.gemspec

@@ -10,8 +10,8 @@ Gem::Specification.new do |spec|
   spec.email = ["joao.fernandes@ist.utl.pt"]
   spec.homepage = "https://github.com/jcmfernandes/ob64"
   spec.license = "MIT"
-  spec.summary = "A fast Base64 encoder and decoder."
-  spec.description = "A fast Base64 encoder and decoder that makes use of SIMD extensions."
+  spec.summary = "A fast Base64 and uuencode encoder and decoder."
+  spec.description = "A fast Base64 and uuencode encoder and decoder that makes use of SIMD extensions."
 
   # 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.
@@ -28,5 +28,5 @@ Gem::Specification.new do |spec|
     "source_code_uri" => spec.homepage + "/tree/v#{spec.version}"
   }
 
-  spec.required_ruby_version = Gem::Requirement.new(">= 2.5.0")
+  spec.required_ruby_version = Gem::Requirement.new(">= 3.3.0")
 end

metadata

@@ -1,16 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: ob64
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - João Fernandes
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-09-28 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description: A fast Base64 encoder and decoder that makes use of SIMD extensions.
+description: A fast Base64 and uuencode encoder and decoder that makes use of SIMD
+  extensions.
 email:
 - joao.fernandes@ist.utl.pt
 executables: []
@@ -18,9 +18,9 @@ extensions:
 - ext/ob64/extconf.rb
 extra_rdoc_files: []
 files:
+- ".github/dependabot.yml"
 - ".github/workflows/main.yml"
 - ".gitignore"
-- ".gitmodules"
 - ".rspec"
 - ".standard.yml"
 - ".yardopts"
@@ -39,9 +39,15 @@ files:
 - bin/setup
 - bin/standardrb
 - ext/ob64/extconf.rb
-- ext/ob64/libbase64.h
 - ext/ob64/ob64.h
 - ext/ob64/ob64_ext.c
+- ext/ob64/ob64_pack.c
+- ext/ob64/pack_base64.c
+- ext/ob64/pack_base64.h
+- ext/ob64/pack_generic.h
+- ext/ob64/pack_simd.h
+- ext/ob64/pack_uuencode.c
+- ext/ob64/pack_uuencode.h
 - lib/ob64.rb
 - lib/ob64/core_ext.rb
 - lib/ob64/version.rb
@@ -52,9 +58,8 @@ licenses:
 metadata:
   homepage_uri: https://github.com/jcmfernandes/ob64
   changelog_uri: https://github.com/jcmfernandes/ob64/blob/master/CHANGELOG.md
-  documentation_uri: https://www.rubydoc.info/gems/ob64/0.4.0
-  source_code_uri: https://github.com/jcmfernandes/ob64/tree/v0.4.0
-post_install_message: 
+  documentation_uri: https://www.rubydoc.info/gems/ob64/0.6.0
+  source_code_uri: https://github.com/jcmfernandes/ob64/tree/v0.6.0
 rdoc_options: []
 require_paths:
 - lib
@@ -62,15 +67,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.5.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.15
-signing_key: 
+rubygems_version: 3.6.9
 specification_version: 4
-summary: A fast Base64 encoder and decoder.
+summary: A fast Base64 and uuencode encoder and decoder.
 test_files: []

data/.gitmodules

@@ -1,3 +0,0 @@
-[submodule "vendor/libbase64"]
-	path = vendor/libbase64
-	url = https://github.com/jcmfernandes/base64-cmake

data/ext/ob64/libbase64.h

@@ -1 +0,0 @@
-#include "../../vendor/libbase64/include/libbase64.h"