ctf-party 1.0.0 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1c9bbfee898723defee53d242711a127753c3bef4f6828477d4f686e4487713e
-  data.tar.gz: 69f0e9e1e7bb5fd27dcbd37b2c86d8ce6514307f3eb413d196e89822ad8e6e6e
+  metadata.gz: a1bc032bfe7236e135eccd26e75a67d6b178b2486b1610741017d61e6cd78c16
+  data.tar.gz: 40ec92a25213dc22154190cf2e726ad87ce693e9f2e283c7b544c1e378634869
 SHA512:
-  metadata.gz: 58b042d0a45a771eb5889438497c15c8126039016b70362d0dcffd58b41a35442735351a14d099744603a778a3dc9684e76a1f72334adca4b2124552205e0b2f
-  data.tar.gz: 35c6e42f0c33448bba0acfd9ac126221ac557cfd47f4042edf844aed7bccf0272aaba52e38ee184959dbe0c56630f10c08575b6f0be25e9eeb3bd2a21ac02537
+  metadata.gz: 6d2fb3942843aafde1c157ec4ee598cdfdb9970a178f66fb291964d3f5e867838c94683068ab4a8e6bc02318e3e56336f3832315f7e0a8e01581649354cd7840
+  data.tar.gz: 91709a253527bec78f79cb45c5bf0611f09262dc0c25beacb0a153c534f4f4042e18977a3c020f961c7786551017a056b423114f72ee2ba7a794c09d8f5378ed

data/LICENSE.txt

@@ -1,6 +1,7 @@
 The MIT License (MIT)
 
-Copyright (c) 2019 Alexandre ZANNI
+Copyright (c) 2020-2020 Alexandre ZANNI
+Copyright (c) 2019-2020 Alexandre ZANNI at Orange Cyberdefense
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/lib/ctf_party.rb

@@ -5,3 +5,5 @@ require 'ctf_party/base64'
 require 'ctf_party/rot'
 require 'ctf_party/digest'
 require 'ctf_party/flag'
+require 'ctf_party/hex'
+require 'ctf_party/case'

data/lib/ctf_party/base64.rb

@@ -27,11 +27,7 @@ class String
   #   myStr.to_b64! # => nil
   #   myStr # => "UnVieQ=="
   def to_b64!(opts = {})
-    opts[:mode] ||= :strict
-    replace(to_b64) if opts[:mode] == :strict ||
-                       opts[:mode] == :rfc4648
-    replace(to_b64(mode: :rfc2045)) if opts[:mode] == :rfc2045
-    replace(to_b64(mode: :urlsafe)) if opts[:mode] == :urlsafe
+    replace(to_b64(opts))
   end
 
   # Decode the string from base64
@@ -57,11 +53,7 @@ class String
   #   a.from_b64! # => nil
   #   a # => "Hello world!"
   def from_b64!(opts = {})
-    opts[:mode] ||= :strict
-    replace(from_b64) if opts[:mode] == :strict ||
-                         opts[:mode] == :rfc4648
-    replace(from_b64(mode: :rfc2045)) if opts[:mode] == :rfc2045
-    replace(from_b64(mode: :urlsafe)) if opts[:mode] == :urlsafe
+    replace(from_b64(opts))
   end
 
   # Is the string encoded in base64?
@@ -82,14 +74,15 @@ class String
               (?:[a-zA-Z0-9+/]{2}==)|(?:[a-zA-Z0-9+/]{1}===))\Z}xn
     reg3 = /\A(?:[a-zA-Z0-9\-_]{4})*(?:|(?:[a-zA-Z0-9\-_]{3}=)|
             (?:[a-zA-Z0-9\-_]{2}==)|(?:[a-zA-Z0-9\-_]{1}===))\Z/xn
-    if opts[:mode] == :strict || opts[:mode] == :rfc4648
+    case opts[:mode]
+    when :strict, :rfc4648
       b64 = true if reg1.match?(self)
-    elsif opts[:mode] == :rfc2045
+    when :rfc2045
       b64 = true
       split("\n").each do |s|
         b64 = false unless reg1.match?(s)
       end
-    elsif opts[:mode] == :urlsafe
+    when :urlsafe
       b64 = true if reg3.match?(self)
     else
       raise ArgumentError 'Wrong mode'

data/lib/ctf_party/case.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+class String
+  # Change the case of characters randomly
+  # @return [String] the case modified string
+  # @example
+  #   'SELECT * FROM'.randomcase # => "SElECt * frOm"
+  #   'SELECT * FROM'.randomcase # => "selECT * FROm"
+  def randomcase
+    chars.map { |c| rand(0..1).zero? ? c.downcase : c.upcase }.join
+  end
+
+  # Change the case of characters randomly in place as described for
+  # {String#randomcase}.
+  def randomcase!
+    replace(randomcase)
+  end
+
+  # Change one characte on two upcase and the other downcase
+  # @param shift [Integer] 0: 1st character will be downcase, 1: 1st character
+  #   will be upcase
+  # @return [String] the case modified string
+  # @example
+  #   'SELECT * FROM'.alternatecase # => "sElEcT * FrOm"
+  #   'SELECT * FROM'.alternatecase(1) # => "SeLeCt * fRoM"
+  def alternatecase(shift = 0)
+    chars.each_with_index.map { |c, i| (i + shift).even? ? c.downcase : c.upcase }.join
+  end
+
+  # Change one characte on two upcase and the other downcase in place as
+  # described for {String#alternatecase}.
+  def alternatecase!(shift = 0)
+    replace(alternatecase(shift))
+  end
+end

data/lib/ctf_party/digest.rb

@@ -13,7 +13,7 @@ class String
     Digest::MD5.hexdigest self
   end
 
-  # Calculate the md5 hash of the string in place as described for {#md5}.
+  # Calculate the md5 hash of the string in place as described for {String#md5}.
   # @example
   #   a = '\o/' # => "\\o/"
   #   a.md5! # => "881419964e480e66162da521ccc25ebf"
@@ -31,7 +31,8 @@ class String
     Digest::SHA1.hexdigest self
   end
 
-  # Calculate the sha1 hash of the string in place as described for {#sha1}.
+  # Calculate the sha1 hash of the string in place as described for
+  #   {String#sha1}.
   # @example
   #   bob = 'alice' # => "alice"
   #   bob.sha1! # => "522b276a356bdf39013dfabea2cd43e141ecc9e8"
@@ -55,7 +56,8 @@ class String
     Digest::SHA2.new(opts[:bitlen]).hexdigest self
   end
 
-  # Calculate the sha2 hash of the string in place as described for {#sha2}.
+  # Calculate the sha2 hash of the string in place as described for
+  #   {String#sha2}.
   # @example
   #   th = 'try harder' # => "try harder"
   #   th.sha2!(bitlen: 384) # => "bb7f60b9562a19c3a83c23791440af11591c42ede9..."
@@ -64,32 +66,32 @@ class String
     replace(sha2(opts))
   end
 
-  # Alias for {#sha2} with default value ( +sha2(bitlen: 256)+ ).
+  # Alias for {String#sha2} with default value ( +sha2(bitlen: 256)+ ).
   def sha2_256
     sha2
   end
 
-  # Alias for {#sha2!} with default value ( +sha2!(bitlen: 256)+ ).
+  # Alias for {String#sha2!} with default value ( +sha2!(bitlen: 256)+ ).
   def sha2_256!
     replace(sha2)
   end
 
-  # Alias for {#sha2} with default value ( +sha2(bitlen: 384)+ ).
+  # Alias for {String#sha2} with default value ( +sha2(bitlen: 384)+ ).
   def sha2_384
     sha2(bitlen: 384)
   end
 
-  # Alias for {#sha2!} with default value ( +sha2!(bitlen: 384)+ ).
+  # Alias for {String#sha2!} with default value ( +sha2!(bitlen: 384)+ ).
   def sha2_384!
     replace(sha2(bitlen: 384))
   end
 
-  # Alias for {#sha2} with default value ( +sha2(bitlen: 512)+ ).
+  # Alias for {String#sha2} with default value ( +sha2(bitlen: 512)+ ).
   def sha2_512
     sha2(bitlen: 512)
   end
 
-  # Alias for {#sha2!} with default value ( +sha2!(bitlen: 512)+ ).
+  # Alias for {String#sha2!} with default value ( +sha2!(bitlen: 512)+ ).
   def sha2_512!
     replace(sha2(bitlen: 512))
   end
@@ -104,7 +106,7 @@ class String
   end
 
   # Calculate the RIPEMD-160 hash of the string in place as described for
-  # {#rmd160}.
+  # {String#rmd160}.
   # @example
   #   pl = 'payload' # => "payload"
   #   pl.rmd160! # => "3c6255c112d409dafdb84d5b0edba98dfd27b44f"

data/lib/ctf_party/flag.rb

@@ -16,8 +16,6 @@ class String
     @@flag
   end
 
-  # rubocop:disable Metrics/LineLength
-
   # Update the flag configuration.
   # @param hash [Hash] flag configuration
   # @option hash [String] :prefix prefix of the flag. Default: none.
@@ -40,8 +38,6 @@ class String
     @@flag.merge!(hash)
   end
 
-  # rubocop:enable Metrics/LineLength
-
   # Format the current string into the configured flag format. See {.flag=}
   # example.
   # @return [String] the format flag.
@@ -72,7 +68,7 @@ class String
   end
 
   # Format the current string into the configured flag format in place as
-  # described for {#flag}.
+  # described for {String#flag}.
   def flag!
     replace(flag)
   end

data/lib/ctf_party/hex.rb

@@ -0,0 +1,212 @@
+# frozen_string_literal: true
+
+class String
+  # Encode an hexadecimal string to a decimal string
+  # @param opts [Hash] optional parameters
+  # @option opts [String] :prefix Prefix of the input. Default value is a void
+  #   string. Example of values: +0x+, +\x+.
+  # @return [String] the decimal encoded string
+  # @example
+  #   'ff'.hex2dec # => "255"
+  #   '\xf3'.hex2dec(prefix: '\x') # => "243"
+  def hex2dec(opts = {})
+    opts[:prefix] ||= ''
+    # remove prefix
+    out = sub(opts[:prefix], '')
+    # convert
+    return out.hex.to_s
+  end
+
+  # Encode an hexadecimal string to a decimal string in place as described
+  # for {String#hex2dec}.
+  # @example
+  #   a = 'ff'
+  #   a.hex2dec!
+  #   a # => "255"
+  def hex2dec!(opts = {})
+    replace(hex2dec(opts))
+  end
+
+  # Encode an decimal string to a hexadecimal string
+  # @param opts [Hash] optional parameters
+  # @option opts [String] :prefix Prefix of the output. Default value is a void
+  #   string. Example of values: +0x+, +\x+.
+  # @option opts [Symbol] :case Char case of the ouput. Default value +:lower+.
+  #   Other valid value +:upper+.
+  # @return [String] the hexadecimal encoded string
+  # @example
+  #   '255'.dec2hex # => "ff"
+  #   '255'.dec2hex({prefix: '0x', case: :upper}) # => "0xFF"
+  def dec2hex(opts = {})
+    opts[:prefix] ||= ''
+    opts[:case] ||= :lower
+    # convert
+    out = to_i.to_s(16)
+    # char case management
+    out = out.upcase if opts[:case] == :upper
+    # adding prefix must be done after case change
+    return opts[:prefix] + out
+  end
+
+  # Encode an decimal string to a hexadecimal string in place as described
+  # for {String#dec2hex}.
+  # @example
+  #   a = '255'
+  #   a.dec2hex!
+  #   a # => "ff"
+  def dec2hex!(opts = {})
+    replace(dec2hex(opts))
+  end
+
+  # Encode a string into hexadecimal
+  # @param opts [Hash] optional parameters
+  # @option opts [String] :prefix Prefix of the output. Default value is a void
+  #   string. Example of values: +0x+, +\x+.
+  # @option opts [Symbol] :case Char case of the ouput. Default value +:lower+.
+  #   Other valid value +:upper+.
+  # @option opts [Symbol] :nibble Display output with high nibble first
+  #   (+:high+ default) or low nibble first (+:low+).
+  # @return [String] the hexadecimal encoded string
+  # @example
+  #   'noraj'.to_hex # => "6e6f72616a"
+  #   'noraj'.to_hex(prefix: '0x') # => "0x6e6f72616a"
+  #   'noraj'.to_hex(case: :upper) # => "6E6F72616A"
+  #   'noraj'.to_hex(nibble: :low) # => "e6f62716a6"
+  def to_hex(opts = {})
+    opts[:prefix] ||= ''
+    opts[:case] ||= :lower
+    opts[:nibble] ||= :high
+    # convert
+    out = ''
+    case opts[:nibble]
+    when :high
+      out = unpack1('H*')
+    when :low
+      out = unpack1('h*')
+    end
+    # char case management
+    out = out.upcase if opts[:case] == :upper
+    # adding prefix must be done after case change
+    return opts[:prefix] + out
+  end
+
+  # Alias for {String#to_hex}.
+  def str2hex(opts = {})
+    to_hex(opts)
+  end
+
+  # Encode a string into hexadecimal in place as described
+  # for {String#to_hex}.
+  # @example
+  #   a = 'noraj'
+  #   a.to_hex!
+  #   a # => "6e6f72616a"
+  def to_hex!(opts = {})
+    replace(to_hex(opts))
+  end
+
+  # Alias for {String#to_hex!}.
+  def str2hex!(opts = {})
+    to_hex!(opts)
+  end
+
+  # Decode a hexadecimal string
+  # @param opts [Hash] optional parameters
+  # @option opts [String] :prefix Prefix of the input. Default value is a void
+  #   string. Example of values: +0x+, +\x+.
+  # @option opts [Symbol] :nibble Display input with high nibble first
+  #   (+:high+ default) or low nibble first (+:low+).
+  # @return [String] the hexadecimal decoded string
+  # @example
+  #   "6e6f72616a".from_hex # => "noraj"
+  #   "0x6e6f72616a".from_hex(prefix: '0x') # => "noraj"
+  #   "e6f62716a6".from_hex(nibble: :low) # => "noraj"
+  def from_hex(opts = {})
+    opts[:prefix] ||= ''
+    opts[:nibble] ||= :high
+    # remove prefix
+    out = sub(opts[:prefix], '')
+    # convert
+    return Array(out).pack('H*') if opts[:nibble] == :high
+    return Array(out).pack('h*') if opts[:nibble] == :low
+
+    raise ArgumentError ':nibble expects :high or :low'
+  end
+
+  # Alias for {String#from_hex}.
+  def hex2str(opts = {})
+    from_hex(opts)
+  end
+
+  # Decode a hexadecimal string in place as described
+  # for {String#from_hex}.
+  # @example
+  #   a = "6e6f72616a"
+  #   a.from_hex!
+  #   a # => "noraj"
+  def from_hex!(opts = {})
+    replace(from_hex(opts))
+  end
+
+  # Alias for {String#from_hex!}.
+  def hex2str!(opts = {})
+    from_hex!(opts)
+  end
+
+  # Encode an hexadecimal string to a binary string
+  # @param opts [Hash] optional parameters
+  # @option opts [String] :prefix Prefix of the input. Default value is a void
+  #   string. Example of values: +0x+, +\x+.
+  # @return [String] the binary encoded string
+  # @example
+  #   'ab'.hex2bin # => "10101011"
+  #   '\xf3'.hex2bin(prefix: '\x') # => "11110011"
+  def hex2bin(opts = {})
+    opts[:prefix] ||= ''
+    # remove prefix
+    out = sub(opts[:prefix], '')
+    # convert
+    return out.to_i(16).to_s(2)
+  end
+
+  # Encode an hexadecimal string to a binary string in place as described
+  # for {String#hex2bin}.
+  # @example
+  #   a = 'ff'
+  #   a.hex2bin!
+  #   a # => => "11111111"
+  def hex2bin!(opts = {})
+    replace(hex2bin(opts))
+  end
+
+  # Encode an binary string to a hexadecimal string
+  # @param opts [Hash] optional parameters
+  # @option opts [String] :prefix Prefix of the output. Default value is a void
+  #   string. Example of values: +0x+, +\x+.
+  # @option opts [Symbol] :case Char case of the ouput. Default value +:lower+.
+  #   Other valid value +:upper+.
+  # @return [String] the hexadecimal encoded string
+  # @example
+  #   '11110011'.bin2hex # => "f3"
+  #   '11110011'.bin2hex({prefix: '0x', case: :upper}) # => "0xF3"
+  def bin2hex(opts = {})
+    opts[:prefix] ||= ''
+    opts[:case] ||= :lower
+    # convert
+    out = to_i(2).to_s(16)
+    # char case management
+    out = out.upcase if opts[:case] == :upper
+    # adding prefix must be done after case change
+    return opts[:prefix] + out
+  end
+
+  # Encode an binary string to a hexadecimal string in place as described
+  # for {String#bin2hex}.
+  # @example
+  #   a = '11110011'
+  #   a.bin2hex!
+  #   a # => "f3"
+  def bin2hex!(opts = {})
+    replace(bin2hex(opts))
+  end
+end

data/lib/ctf_party/rot.rb

@@ -35,12 +35,12 @@ class String
     replace(rot(opts))
   end
 
-  # Alias for {#rot} with default value ( +rot(shift: 13)+ ).
+  # Alias for {String#rot} with default value ( +rot(shift: 13)+ ).
   def rot13
     rot
   end
 
-  # Alias for {#rot!} with default value ( +rot!(shift: 13)+ ).
+  # Alias for {String#rot!} with default value ( +rot!(shift: 13)+ ).
   def rot13!
     rot!
   end

data/lib/ctf_party/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Version
-  VERSION = '1.0.0'
+  VERSION = '1.3.1'
 end