Refactor ronin/support/encoding/base64 to not use the Base64 library

.rubocop.yml

@@ -126,10 +126,12 @@ Style/MapIntoArray:
 Style/CaseEquality:
   Exclude:
     - 'lib/ronin/support/network/ip_range.rb'
+    - 'lib/ronin/support/network/wildcard.rb'
     - 'spec/network/ip_range_spec.rb'
     - 'spec/network/ip_range/cidr_spec.rb'
     - 'spec/network/ip_range/glob_spec.rb'
     - 'spec/network/ip_range/range_spec.rb'
+    - 'spec/network/wildcard_spec.rb'
 
 Style/ConditionalAssignment:
   Exclude:

README.md

@@ -46,10 +46,14 @@ research and development.
     * [Hex][docs-encoding-hex]
     * [HTML][docs-encoding-html]
     * [HTTP][docs-encoding-http]
+    * [Java][docs-encoding-java]
     * [JavaScript][docs-encoding-js]
+    * [Node.js][docs-encoding-node-js]
     * [PowerShell][docs-encoding-powershell]
     * [Punycode][docs-encoding-punycode]
     * [Quoted-printable][docs-encoding-quoted-printable]
+    * [Perl strings][docs-encoding-perl]
+    * [PHP strings][docs-encoding-php]
     * [Ruby strings][docs-encoding-ruby]
     * [Shell][docs-encoding-shell]
     * [SQL][docs-encoding-sql]
@@ -90,10 +94,14 @@ research and development.
     * [Public Suffix List][docs-network-public_suffix]
     * [Host names][docs-network-host]
     * [Domain names][docs-network-domain]
+    * [Defangin / Refanging][docs-network-defang]
   * Working with text:
     * [Generating typos][docs-text-typo].
     * [Generating homoglyphs][docs-text-homoglyp].
     * [Regexs for matching/extracting common types of data][docs-text-patterns].
+  * Working with software versions:
+    * [Parsing versions][docs-software-version].
+    * [Version ranges][docs-software-version_range].
 * Adds additional methods to many of [Ruby's core classes][docs-core-exts].
 * Small memory footprint (~46Kb).
 * Has 96% documentation coverage.
@@ -205,10 +213,14 @@ along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 [docs-encoding-hex]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Encoding/Hex.html
 [docs-encoding-html]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Encoding/HTML.html
 [docs-encoding-http]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Encoding/HTTP.html
+[docs-encoding-java]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Encoding/Java.html
 [docs-encoding-js]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Encoding/JS.html
+[docs-encoding-node-js]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Encoding/NodeJS.html
 [docs-encoding-powershell]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Encoding/PowerShell.html
 [docs-encoding-punycode]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Encoding/Punycode.html
 [docs-encoding-quoted-printable]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Encoding/QuotedPrintable.html
+[docs-encoding-perl]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Encoding/Perl.html
+[docs-encoding-php]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Encoding/PHP.html
 [docs-encoding-ruby]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Encoding/Ruby.html
 [docs-encoding-shell]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Encoding/Shell.html
 [docs-encoding-sql]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Encoding/SQL.html
@@ -250,7 +262,10 @@ along with ronin-support.  If not, see <https://www.gnu.org/licenses/>.
 [docs-network-public_suffix]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Network/PublicSuffix.html
 [docs-network-host]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Network/Host.html
 [docs-network-domain]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Network/Domain.html
+[docs-network-defang]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Network/Defang.html
 [docs-text-typo]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Text/Typo.html
 [docs-text-homoglyp]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Text/Homoglyph.html
 [docs-text-patterns]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Text/Patterns.html
+[docs-software-version]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Software/Version.html
+[docs-software-version_range]: https://ronin-rb.dev/docs/ronin-support/Ronin/Support/Software/VersionRange.html
 [docs-core-exts]: https://ronin-rb.dev/docs/ronin-support/top-level-namespace.html

lib/ronin/support.rb

@@ -25,6 +25,7 @@
 require 'ronin/support/network'
 require 'ronin/support/path'
 require 'ronin/support/text'
+require 'ronin/support/software'
 require 'ronin/support/version'
 
 module Ronin

lib/ronin/support/binary/ctypes.rb

@@ -24,7 +24,7 @@
 require 'ronin/support/binary/ctypes/os'
 
 require 'ronin/support/binary/ctypes/array_type'
-require 'ronin/support/binary/ctypes/unbounded_array_type'
+require 'ronin/support/binary/ctypes/flexible_array_type'
 require 'ronin/support/binary/ctypes/struct_type'
 
 require 'ronin/support/binary/ctypes/array_object_type'
@@ -65,7 +65,7 @@ module Binary
       #       `1.79769313486231570E+308`)
       # * Aggregate Types:
       #   * {CTypes::ArrayType Array} (ex: `{1,2,3}`)
-      #   * {CTypes::UnboundedArrayType unbounded Array} (ex: `char c[] = {...}`)
+      #   * {CTypes::FlexibleArrayType unbounded Array} (ex: `char c[] = {...}`)
       #   * {CTypes::StructType struct} (ex: `struct s = {1, 'c', ...}`)
       #   * {CTypes::UnionType union} (ex: `union u = {1234}`)
       # * Object Types:

lib/ronin/support/binary/ctypes/array_type.rb

@@ -17,7 +17,7 @@
 #
 
 require 'ronin/support/binary/ctypes/aggregate_type'
-require 'ronin/support/binary/ctypes/unbounded_array_type'
+require 'ronin/support/binary/ctypes/flexible_array_type'
 
 module Ronin
   module Support
@@ -60,8 +60,8 @@ class ArrayType < AggregateType
           #   Custom type alignment to override the type's alignment.
           #
           def initialize(type,length, alignment: nil)
-            if type.kind_of?(UnboundedArrayType)
-              raise(ArgumentError,"cannot initialize an #{self.class} of #{UnboundedArrayType}")
+            if type.kind_of?(FlexibleArrayType)
+              raise(ArgumentError,"cannot initialize an #{self.class} of #{FlexibleArrayType}")
             end
 
             @type   = type

lib/ronin/support/binary/ctypes/unbounded_array_type.rb → lib/ronin/support/binary/ctypes/flexible_array_type.rb

@@ -28,9 +28,9 @@ module CTypes
         #
         # @api private
         #
-        # @since 1.0.0
+        # @since 1.2.0
         #
-        class UnboundedArrayType < AggregateType
+        class FlexibleArrayType < AggregateType
 
           # The type of each element in the unbounded array type.
           #
@@ -44,11 +44,11 @@ class UnboundedArrayType < AggregateType
           #   The type of each element in the unbounded array type.
           #
           # @raise [ArgumentError]
-          #   Cannot initialize a nested {UnboundedArrayType}.
+          #   Cannot initialize a nested {FlexibleArrayType}.
           #
           def initialize(type, alignment: nil)
-            if type.kind_of?(UnboundedArrayType)
-              raise(ArgumentError,"cannot initialize a nested #{UnboundedArrayType}")
+            if type.kind_of?(FlexibleArrayType)
+              raise(ArgumentError,"cannot initialize a nested #{FlexibleArrayType}")
             end
 
             @type      = type

lib/ronin/support/binary/ctypes/type.rb

@@ -53,13 +53,13 @@ def initialize(pack_string: )
           # @param [Integer, nil] length
           #   The length of the Array.
           #
-          # @return [ArrayType, UnboundedArrayType]
+          # @return [ArrayType, FlexibleArrayType]
           #   The new Array type or an unbounded Array type if `length` was not
           #   given.
           #
           def [](length=nil)
             if length then ArrayType.new(self,length)
-            else           UnboundedArrayType.new(self)
+            else           FlexibleArrayType.new(self)
             end
           end
 

lib/ronin/support/binary/ctypes/type_resolver.rb

@@ -142,7 +142,7 @@ def resolve_array(type_signature)
           #
           # @param [Range] type_signature
           #
-          # @return [UnboundedArrayType]
+          # @return [FlexibleArrayType]
           #
           def resolve_range(type_signature)
             range = type_signature

lib/ronin/support/binary/struct.rb

@@ -126,7 +126,7 @@ module Binary
       #     struct.pack
       #     # => "\x00\x00\x00\x00\x01\x02\x03\x04\x00\x00\x00\x00\x00\x00"
       #
-      # ### Unbounded Array Fields
+      # ### Flexible Array Fields
       #
       #     class MyStruct < Ronin::Support::Binary::Struct
       #
@@ -517,7 +517,7 @@ def self.read_from(io)
         def [](name)
           if (member = @type.members[name])
             case member.type
-            when CTypes::UnboundedArrayType
+            when CTypes::FlexibleArrayType
               # XXX: but how do we handle an unbounded array of structs?
               @cache[name] ||= begin
                                  offset = member.offset

lib/ronin/support/binary/union.rb

@@ -121,7 +121,7 @@ module Binary
       #     union.pack
       #     # => "\x01\x02\x03\x04\x00\x00\x00\x00\x00\x00"
       #
-      # ### Unbounded Array Fields
+      # ### Flexible Array Fields
       #
       #     class MyUnion < Ronin::Support::Binary::Union
       #

lib/ronin/support/crypto.rb

@@ -19,6 +19,7 @@
 require 'ronin/support/crypto/openssl'
 require 'ronin/support/crypto/hmac'
 require 'ronin/support/crypto/cipher'
+require 'ronin/support/crypto/cipher/des3'
 require 'ronin/support/crypto/cipher/aes'
 require 'ronin/support/crypto/cipher/aes128'
 require 'ronin/support/crypto/cipher/aes256'
@@ -289,6 +290,105 @@ def self.decrypt(data, cipher: ,**kwargs)
         self.cipher(cipher, direction: :decrypt, **kwargs).decrypt(data)
       end
 
+      #
+      # Creates a new DES3 cipher.
+      #
+      # @param [Hash{Symbol => Object}] kwargs
+      #   Additional keyword arguments for {Cipher::DES3#initialize}.
+      #
+      # @option kwargs [:wrap, Symbol, nil] :mode
+      #   The desired DES3 cipher mode.
+      #
+      # @option kwargs [String] :key
+      #   The secret key to use.
+      #
+      # @option kwargs [String] :iv
+      #   The optional Initial Vector (IV).
+      #
+      # @option kwargs [Integer] :padding
+      #   Sets the padding for the cipher.
+      #
+      # @return [Cipher::DES3]
+      #   The new DES3 cipher.
+      #
+      # @example
+      #   Crypto.des3_cipher(direction: :encrypt, key: 'A' * 24)
+      #   # => #<Ronin::Support::Crypto::Cipher::DES3:0x00007f54c3752b90 @mode=nil>
+      #
+      # @see Cipher::DES3
+      #
+      # @since 1.2.0
+      #
+      def self.des3_cipher(**kwargs)
+        Cipher::DES3.new(**kwargs)
+      end
+
+      #
+      # Encrypts data using DES3.
+      #
+      # @param [#to_s] data
+      #   The data to encrypt.
+      #
+      # @param [Hash{Symbol => Object}] kwargs
+      #   Additional keyword arguments for {Cipher::DES3#initialize}.
+      #
+      # @option kwargs [:wrap, Symbol, nil] :mode
+      #   The desired DES3 cipher mode.
+      #
+      # @option kwargs [String] :key
+      #   The secret key to use.
+      #
+      # @option kwargs [String] :iv
+      #   The optional Initial Vector (IV).
+      #
+      # @option kwargs [Integer] :padding
+      #   Sets the padding for the cipher.
+      #
+      # @return [String]
+      #   The encrypted data.
+      #
+      # @raise [ArgumentError]
+      #   The `key:` keyword argument must be given.
+      #
+      # @since 1.2.0
+      #
+      def self.des3_encrypt(data,**kwargs)
+        self.des3_cipher(direction: :encrypt, **kwargs).encrypt(data)
+      end
+
+      #
+      # Decrypts data using DES3.
+      #
+      # @param [#to_s] data
+      #   The data to decrypt.
+      #
+      # @param [Hash{Symbol => Object}] kwargs
+      #   Additional keyword arguments for {Cipher::DES3#initialize}.
+      #
+      # @option kwargs [:wrap, Symbol, nil] :mode
+      #   The desired DES3 cipher mode.
+      #
+      # @option kwargs [String] :key
+      #   The secret key to use.
+      #
+      # @option kwargs [String] :iv
+      #   The optional Initial Vector (IV).
+      #
+      # @option kwargs [Integer] :padding
+      #   Sets the padding for the cipher.
+      #
+      # @return [String]
+      #   The encrypted data.
+      #
+      # @raise [ArgumentError]
+      #   The `key:` keyword argument must be given.
+      #
+      # @since 1.2.0
+      #
+      def self.des3_decrypt(data,**kwargs)
+        self.des3_cipher(direction: :decrypt, **kwargs).decrypt(data)
+      end
+
       #
       # Creates a new AES cipher.
       #

lib/ronin/support/crypto/cipher/des3.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+#
+# Copyright (c) 2006-2024 Hal Brodigan (postmodern.mod3 at gmail.com)
+#
+# Ronin Support is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# Ronin Support is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with Ronin Support.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+require 'ronin/support/crypto/cipher'
+
+module Ronin
+  module Support
+    module Crypto
+      class Cipher < OpenSSL::Cipher
+        #
+        # The DES3 cipher.
+        #
+        # @since 1.2.0
+        #
+        class DES3 < Cipher
+
+          # The DES3 cipher mode.
+          #
+          # @return [:wrap, Symbol, nil]
+          attr_reader :mode
+
+          #
+          # Initializes the DES3 cipher.
+          #
+          # @param [:wrap, Symbol, nil] mode
+          #   The desired DES3 cipher mode.
+          #
+          # @param [Hash{Symbol => Object}] kwargs
+          #   Additional keyword arguments for {Cipher#initialize}.
+          #
+          def initialize(mode: nil, **kwargs)
+            name = if mode then "des3-#{mode}"
+                   else         "des3"
+                   end
+
+            super(name, **kwargs)
+
+            @mode = mode
+          end
+
+          #
+          # The list of supported DES3 ciphers.
+          #
+          # @return [Array<String>]
+          #   The list of supported DES3 cipher names.
+          #
+          def self.supported
+            super().grep(/^des3/)
+          end
+
+        end
+      end
+    end
+  end
+end