ctf-party 1.2.1 → 1.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3320dd66b3b305ed07cce2d8e9059f83f5c6c65b763401223af57d157bcbffb4
-  data.tar.gz: 4ae59e35eb39beb3641cfa9e5d22609f93e18b9540884876d3982ab4ab7cc97e
+  metadata.gz: 588a5007de92c7e4c3fe7654f755eb9d1f9c81a738739455b3f9b89eb87ea9fa
+  data.tar.gz: 85bad8baf276cfa5315dc59f1804b4b21e21f46c8061d1d1bb2e5068e82167ad
 SHA512:
-  metadata.gz: 72c0b492360e7a52af7e3abe000c275accc183f28ea3ca9753fdc92e43258abc45967cb0aa79448ebdcbd118d65aba33435c37354ba0595a0f3459d591b4d37b
-  data.tar.gz: '0907211c7da78180930cfb8243169ae4bb3f63515fa3fd1538b576fa11f34e3278796c757dd494b6f206bca0b6dd09bda2e0308b7e3f42713cf40410e279e3b2'
+  metadata.gz: b0894030c2104ef8cd1421c8ec579e36760af961ad8782ff9ae9cab279a2ebd62dab7e19560d68b69bfabb616f5f84020735546d1470716cea0cf1e6ba6417ff
+  data.tar.gz: 923114873849d37ef0a3b1f5bd4a087e1a385c95e28dcd87761ecc247f51eda936ee058a977c6b25d7c35592133e40a602e89097cea68f8f36cdd61f2759d42d

data/lib/ctf_party.rb

@@ -6,3 +6,7 @@ require 'ctf_party/rot'
 require 'ctf_party/digest'
 require 'ctf_party/flag'
 require 'ctf_party/hex'
+require 'ctf_party/case'
+require 'ctf_party/cgi'
+require 'ctf_party/binary'
+require 'ctf_party/leet'

data/lib/ctf_party/binary.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+class String
+  # Encode a string into binary
+  # @param opts [Hash] optional parameters
+  # @option opts [Symbol] :bitnumbering Display output with most significant bit
+  #   first (+:MSB+ default) or least significant bit first (+:LSB+).
+  # @return [String] the binary encoded string
+  # @example
+  #   'binary'.to_bin # => "011000100110100101101110011000010111001001111001"
+  #   'binary'.to_bin(bitnumbering: :LSB) # => "010001101001011001110110100001100100111010011110"
+  def to_bin(opts = {})
+    opts[:bitnumbering] ||= :MSB
+    # convert
+    return unpack1('B*') if opts[:bitnumbering] == :MSB
+    return unpack1('b*') if opts[:bitnumbering] == :LSB
+
+    raise ArgumentError ':bitnumbering expects :MSB or :LSB'
+  end
+
+  # Alias for {String#to_bin}.
+  def str2bin(opts = {})
+    to_bin(opts)
+  end
+
+  # Encode a string into binary in place as described
+  # for {String#to_bin}.
+  # @example
+  #   a = 'binary'
+  #   a.to_bin!
+  #   a # => "011000100110100101101110011000010111001001111001"
+  def to_bin!(opts = {})
+    replace(to_bin(opts))
+  end
+
+  # Alias for {String#to_bin!}.
+  def str2bin!(opts = {})
+    to_bin!(opts)
+  end
+
+  # Decode a binary string
+  # @param opts [Hash] optional parameters
+  # @option opts [Symbol] :bitnumbering Display input with most significant bit
+  #   first (+:MSB+ default) or least significant bit first (+:LSB+).
+  # @return [String] the binary decoded string
+  # @example
+  #   '011000100110100101101110011000010111001001111001'.from_bin # => "binary"
+  #   '010001101001011001110110100001100100111010011110'.from_bin(bitnumbering: :LSB) # => "binary"
+  def from_bin(opts = {})
+    opts[:bitnumbering] ||= :MSB
+    # convert
+    return Array(self).pack('B*') if opts[:bitnumbering] == :MSB
+    return Array(self).pack('b*') if opts[:bitnumbering] == :LSB
+
+    raise ArgumentError ':bitnumbering expects :MSB or :LSB'
+  end
+
+  # Alias for {String#from_bin}.
+  def bin2str(opts = {})
+    from_bin(opts)
+  end
+
+  # Decode a binary string in place as described
+  # for {String#from_bin}.
+  # @example
+  #   a = "011000100110100101101110011000010111001001111001"
+  #   a.from_bin!
+  #   a # => "binary"
+  def from_bin!(opts = {})
+    replace(from_bin(opts))
+  end
+
+  # Alias for {String#from_bin!}.
+  def bin2str!(opts = {})
+    from_bin!(opts)
+  end
+end

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/cgi.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+# Ruby standard library
+require 'cgi'
+
+class String
+  # URL-encode the string
+  # @return [String] the URL-encoded string
+  # @example
+  #   "'Stop!' said Fred".urlencode # => "%27Stop%21%27+said+Fred"
+  def urlencode
+    CGI.escape self
+  end
+
+  # URL-encode the string in place as described for {String#urlencode}.
+  def urlencode!
+    replace(urlencode)
+  end
+
+  # URL-decode the string
+  # @return [String] the URL-decoded string
+  # @example
+  #   "%27Stop%21%27+said+Fred".urldecode # => "'Stop!' said Fred"
+  def urldecode
+    CGI.unescape self
+  end
+
+  # URL-decode the string in place as described for {String#urldecode}.
+  def urldecode!
+    replace(urldecode)
+  end
+
+  # HTML escape the string
+  # @return [String] the HTML escaped string
+  # @example
+  #   'Usage: foo "bar" <baz>'.htmlescape # => "Usage: foo &quot;bar&quot; &lt;baz&gt;"
+  def htmlescape
+    CGI.escapeHTML self
+  end
+
+  # HTML escape the string in place as described for {String#htmlescape}.
+  def htmlescape!
+    replace(htmlescape)
+  end
+
+  # HTML unescape the string
+  # @return [String] the HTML unescaped string
+  # @example
+  #   "Usage: foo &quot;bar&quot; &lt;baz&gt;".htmlunescape # => "Usage: foo \"bar\" <baz>"
+  def htmlunescape
+    CGI.unescapeHTML self
+  end
+
+  # HTML unescape the string in place as described for {String#htmlunescape}.
+  def htmlunescape!
+    replace(htmlunescape)
+  end
+end

data/lib/ctf_party/hex.rb

@@ -22,7 +22,7 @@ class String
   # @example
   #   a = 'ff'
   #   a.hex2dec!
-  #   a # => => "255"
+  #   a # => "255"
   def hex2dec!(opts = {})
     replace(hex2dec(opts))
   end
@@ -33,6 +33,8 @@ class String
   #   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] :padding Minimum size of the hexadecimal display
+  #   (number of characters). Eg. 10 -> 0xA or 0x0A
   # @return [String] the hexadecimal encoded string
   # @example
   #   '255'.dec2hex # => "ff"
@@ -40,8 +42,11 @@ class String
   def dec2hex(opts = {})
     opts[:prefix] ||= ''
     opts[:case] ||= :lower
+    opts[:padding] ||= 1
     # convert
     out = to_i.to_s(16)
+    # padding
+    out = ('0' * (opts[:padding] - 1)) + out if out.size < opts[:padding]
     # char case management
     out = out.upcase if opts[:case] == :upper
     # adding prefix must be done after case change
@@ -90,6 +95,11 @@ class String
     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
@@ -100,6 +110,11 @@ class String
     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
@@ -123,6 +138,11 @@ class String
     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
@@ -133,6 +153,11 @@ class String
     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
@@ -189,4 +214,63 @@ class String
   def bin2hex!(opts = {})
     replace(bin2hex(opts))
   end
+
+  # Decode a hexadecimal IP string into a dotted decimal one
+  # @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+, used on Unix +/proc/net/tcp+).
+  # @return [String] the dotted decimal IP
+  # @example
+  #   '0100007F'.from_hexip(nibble: :low) # => "127.0.0.1"
+  #   '0x7f000001'.from_hexip(prefix: '0x') # => "127.0.0.1"
+  def from_hexip(opts = {})
+    opts[:prefix] ||= ''
+    opts[:nibble] ||= :high
+    # remove prefix
+    out = sub(opts[:prefix], '')
+    # convert
+    out = out.scan(/.{2}/).map(&:hex2dec)
+    out = out.reverse if opts[:nibble] == :low
+    out.join('.')
+  end
+
+  # Decode a hexadecimal IP string into a dotted decimal one in place as described
+  # for {String#from_hexip}.
+  def from_hexip!(opts = {})
+    replace(from_hexip(opts))
+  end
+
+  # Encode a dotted decimal IP into a hexadecimal one
+  # @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+, used on Unix +/proc/net/tcp+).
+  # @return [String] the hexadecimal encoded IP
+  # @example
+  #   '127.0.0.1'.to_hexip # => "7f000001"
+  #   '127.0.0.1'.to_hexip(nibble: :low) # => "0100007f"
+  def to_hexip(opts = {})
+    opts[:prefix] ||= ''
+    opts[:case] ||= :lower
+    opts[:nibble] ||= :high
+    # convert
+    out = split('.').map { |x| x.dec2hex(padding: 2) }
+    out = out.reverse if opts[:nibble] == :low
+    out = out.join
+    # char case management
+    out = out.upcase if opts[:case] == :upper
+    # adding prefix must be done after case change
+    return opts[:prefix] + out
+  end
+
+  # Encode a dotted decimal IP into a hexadecimal one in place as described
+  # for {String#to_hexip}.
+  def to_hexip!(opts = {})
+    replace(to_hexip(opts))
+  end
 end

data/lib/ctf_party/leet.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+class String
+  # Transform into leet speak (l337 5p34k)
+  # @example
+  #   'The quick brown fox jumps over the lazy dog'.leet # => "7h3 qu1ck 8r0wn f0x jump5 0v3r 7h3 14zy d06"
+  #   'leet speak'.leet # => "1337 5p34k"
+  def leet
+    tr = {
+      'T' => '7',
+      'E' => '3',
+      'I' => '1',
+      'L' => '1',
+      'O' => '0',
+      'S' => '5',
+      'A' => '4',
+      'G' => '6',
+      'B' => '8'
+    }
+    tr.merge! tr.transform_keys(&:downcase)
+    gsub(/[#{tr.keys.join}]/i, **tr)
+  end
+
+  # Transform into leet speak (l337 5p34k) in place as described
+  # for {String#leet}.
+  def leet!
+    replace(leet)
+  end
+end

data/lib/ctf_party/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ctf-party
 version: !ruby/object:Gem::Version
-  version: 1.2.1
+  version: 1.3.4
 platform: ruby
 authors:
 - Alexandre ZANNI
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-07-13 00:00:00.000000000 Z
+date: 2021-03-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -66,6 +66,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '5'
+- !ruby/object:Gem::Dependency
+  name: minitest-skip
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -100,14 +114,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.80'
+        version: '1.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.80'
+        version: '1.8'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement
@@ -135,9 +149,13 @@ files:
 - bin/ctf_party_console
 - lib/ctf_party.rb
 - lib/ctf_party/base64.rb
+- lib/ctf_party/binary.rb
+- lib/ctf_party/case.rb
+- lib/ctf_party/cgi.rb
 - lib/ctf_party/digest.rb
 - lib/ctf_party/flag.rb
 - lib/ctf_party/hex.rb
+- lib/ctf_party/leet.rb
 - lib/ctf_party/rot.rb
 - lib/ctf_party/version.rb
 homepage: https://noraj.github.io/ctf-party/
@@ -165,7 +183,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.1.4
 signing_key:
 specification_version: 4
 summary: A library to enhance and speed up script/exploit writing for CTF players