ctf-party 1.3.0 → 1.3.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9053993b73413771118a0bbf7b12f5ff9c60d13a97edabdd0f473c74964cd17d
-  data.tar.gz: f16cad2236f81606d50398a9496eeb8e261085ad2350708217e8a85d075a6b07
+  metadata.gz: f09406956f91fdbe561c73f343efc68e28ad20c774370053e88472ebb1bb5098
+  data.tar.gz: 8bf8dfddfdbb4780578216b022d4815778f6f79d489506a2dba9fa0355bc8f90
 SHA512:
-  metadata.gz: f9079a453c9fc080e3a43784270f156ede8cfc2607f8080578251865d64ae76ec2625c9a7540582e61c5223b3392bba39d185088b5a73c279a37e0c504bd270a
-  data.tar.gz: 44032d4ed1df0fbd6eef5becba5da99033c3bb9a7f3c07cc3cc69cdace61474f5b76824a58339e55423c5e592639b6bd1254031f4a87976ddb8efbbd52141eca
+  metadata.gz: 40adf3307a9e8b99ccda9af3d1ab063413433998455cf92c292eb9b6e8d3deb754280673e796d7d980e22c87c222b7eb07c1fd7a6434d4597c186857ea973937
+  data.tar.gz: e3d1bbf14cf1dd05112833a7fa8096acaf0ee6065a266990fa56a71c30415f504a83255c8ae835188dfbd25593e37b983d06b7c137ed5e3d0598ebd3dcc83edd

data/lib/ctf_party.rb

@@ -7,3 +7,7 @@ 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'
+require 'ctf_party/dec'

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

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+class String
+  # Encode a string into decimal (string to hexadecimal then hexadecimal to decimal)
+  # @return [String] the decimal encoded string
+  # @example
+  #   'noraj'.to_dec # => "474316169578"
+  def to_dec
+    str2hex.hex2dec
+  end
+
+  # Encode a string into decimal in place as described for {String#to_dec}.
+  def to_dec!
+    replace(to_dec)
+  end
+
+  # Decode a decimal string (decimal to hexadecimal then hexadecimal to string)
+  # @return [String] the decimal decoded string
+  # @example
+  #   '1834615104613964215417'.from_dec # => "ctf-party"
+  def from_dec
+    dec2hex.hex2str
+  end
+
+  # Decode a decimal string in place as described for {String#from_dec}.
+  def from_dec!
+    replace(from_dec)
+  end
+
+  # Alias for {String#to_dec}.
+  def str2dec
+    to_dec
+  end
+
+  # Alias for {String#to_dec!}.
+  def str2dec!
+    replace(str2dec)
+  end
+
+  # Alias for {String#from_dec}.
+  def dec2str
+    from_dec
+  end
+
+  # Alias for {String#from_dec!}.
+  def dec2str!
+    replace(dec2str)
+  end
+end

data/lib/ctf_party/hex.rb

@@ -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.3.0'
+  VERSION = '1.3.5'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ctf-party
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.3.5
 platform: ruby
 authors:
 - Alexandre ZANNI
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-07-13 00:00:00.000000000 Z
+date: 2021-04-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -44,14 +44,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '4.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -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,10 +149,14 @@ 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/dec.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/
@@ -166,7 +184,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