ctf-party 1.3.2 → 1.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 43e5c5fba11ab29415687644876bc3185a7b220adcc0da51bf36bac65b970600
-  data.tar.gz: 6dc55b3100a380a0ff2c11e61eda9f67fd7a7a1ae5fc9effae3bae870cf701df
+  metadata.gz: e5265fb514b440bf6ddb5f4baef32204784bf36d564e16d1d05164e42be29693
+  data.tar.gz: 9f56032becda314e6da26c5b752f0cafaa95689262cead61f1c0699d237bf271
 SHA512:
-  metadata.gz: 36b8f7a716e66fcfb1aed39b71f586d5ad73e9c099a11651c7dfd29093e09f60b15e278036f7e4e7d74150ceca1c374308864634f8f58b8e4078ca261f60a389
-  data.tar.gz: 17618c1a863ed02b9f838bae87e2135e108d50350658c639494d9d9d2a7751319720a022f801a10a79a0bf0a03417d5262d043c137313d7a004dd08a81b5ab61
+  metadata.gz: 8329dc68bf53cd5bbd5d20060000db3b1bbd35f74fcb8881dabe7ac699b80b9b3ed65644480b48429da076d3a77938b44814295dbeb2b9b368a8f37bb1c79325
+  data.tar.gz: e3663bc5224918b291ff740edb2623604660d41c752e4c9eba7cfc0cd82b7a0987fe24fcbfa425a6c9a691d0088632aec0b50a403cc5deb7c305986135965077

data/bin/ctf-party

@@ -0,0 +1,94 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Ruby internal
+require 'pp'
+# Project internal
+require 'ctf_party'
+require 'ctf_party/version'
+# External
+require 'docopt'
+
+cmd_whitelist = {
+  alternatecase: 'Change one characte on two upcase and the other downcase',
+  bin2hex: 'Encode an binary string to a hexadecimal string',
+  bin2str: 'Alias for from_bin',
+  dec2hex: 'Encode an decimal string to a hexadecimal string',
+  dec2str: 'Alias for from_dec',
+  from_b64: 'Decode the string from base64',
+  from_bin: 'Decode a binary string',
+  from_dec: 'Decode a decimal string (decimal to hexadecimal then hexadecimal to string)',
+  from_hex: 'Decode a hexadecimal string',
+  from_hexip: 'Decode a hexadecimal IP string into a dotted decimal one',
+  hex2bin: 'Encode an hexadecimal string to a binary string',
+  hex2dec: 'Encode an hexadecimal string to a decimal string',
+  hex2str: 'Alias for from_hex',
+  htmlescape: 'HTML escape the string',
+  htmlunescape: 'HTML unescape the string',
+  leet: 'Transform into leet speak (l337 5p34k)',
+  md5: 'Calculate the md5 hash of the string',
+  randomcase: 'Change the case of characters randomly',
+  rmd160: 'Calculate the RIPEMD-160 hash of the string',
+  rot13: 'Encrypt / Decrypt the string with Caesar cipher with a shift of 13',
+  sha1: 'Calculate the sha1 hash of the string',
+  sha2: 'Calculate the sha2 hash of the string',
+  sha2_256: 'Alias for sha2 with bitlen of 256',
+  sha2_384: 'Alias for sha2 with bitlen of 384',
+  sha2_512: 'Alias for sha2 with bitlen of 512',
+  str2bin: 'Alias for to_bin',
+  str2dec: 'Alias for to_dec',
+  str2hex: 'Alias for to_hex',
+  to_b64: 'Encode the string into base64',
+  to_bin: 'Encode a string into binary',
+  to_dec: 'Encode a string into decimal (string to hexadecimal then hexadecimal to decimal)',
+  to_hex: 'Encode a string into hexadecimal',
+  to_hexip: 'Encode a dotted decimal IP into a hexadecimal one',
+  urldecode: 'URL-decode the string',
+  urlencode: 'URL-encode the string'
+}
+
+doc = <<~DOCOPT
+  ctf-party by noraj
+
+  Usage:
+    ctf-party <string> <cmd>... [--debug]
+    ctf-party --list-commands [--debug]
+    ctf-party -h | --help
+    ctf-party --version
+
+  Options:
+    -l, --list-commands   List available commands (see https://noraj.github.io/ctf-party/yard/String.html)
+    --debug               Display arguments
+    -h, --help            Show this screen
+    --version             Show version
+
+  Examples:
+    ctf-party 'security' to_hex
+    ctf-party 'NzQ2Zjc0NmY=' from_b64 hex2str str2bin
+DOCOPT
+
+begin
+  args = Docopt.docopt(doc, version: Version::VERSION)
+  # use case 1, using the tool
+  pp args if args['--debug']
+  if args['<string>']
+    wrong_cmd = args['<cmd>'] - cmd_whitelist.keys.map(&:to_s)
+    if wrong_cmd.empty?
+      output = args['<string>']
+      args['<cmd>'].each do |cmd|
+        output = output.public_send(cmd)
+      end
+      puts output
+    else
+      abort "Those commands don't exist: #{wrong_cmd}"
+    end
+  elsif args['--list-commands']
+    cmd_whitelist.each do |k, v|
+      puts "#{k.to_s.ljust(15)}#{v}"
+    end
+  end
+  # use case 2, help: already handled by docopt
+  # use case 3, version: already handled by docopt
+rescue Docopt::Exit => e
+  puts e.message
+end

data/lib/ctf_party.rb

@@ -8,3 +8,6 @@ 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/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
@@ -209,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/rot.rb

@@ -16,9 +16,9 @@ class String
   def rot(opts = {})
     opts[:shift] ||= 13
     alphabet = Array('a'..'z')
-    lowercase = Hash[alphabet.zip(alphabet.rotate(opts[:shift]))]
+    lowercase = alphabet.zip(alphabet.rotate(opts[:shift])).to_h
     alphabet = Array('A'..'Z')
-    uppercasecase = Hash[alphabet.zip(alphabet.rotate(opts[:shift]))]
+    uppercasecase = alphabet.zip(alphabet.rotate(opts[:shift])).to_h
     encrypter = lowercase.merge(uppercasecase)
     chars.map { |c| encrypter.fetch(c, c) }.join
   end

data/lib/ctf_party/version.rb

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

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: ctf-party
 version: !ruby/object:Gem::Version
-  version: 1.3.2
+  version: 1.4.1
 platform: ruby
 authors:
 - Alexandre ZANNI
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-07-13 00:00:00.000000000 Z
+date: 2021-04-27 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: docopt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -44,14 +58,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 +80,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 +128,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
@@ -122,24 +150,29 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.9'
-description: A library to enhance and speed up script/exploit writingfor CTF players
-  (or security researchers, bug bountyhunters, pentesters but mostly focused on CTF)
-  bypatching the String class to add a short syntax of usual code patterns.
+description: A CLI tool & library to enhance and speed up script/exploitwriting for
+  CTF players (or security researchers, bug bountyhunters, pentesters but mostly focused
+  on CTF) bypatching the String class to add a short syntax of usualcode patterns.
 email: alexandre.zanni@engineer.com
 executables:
+- ctf-party
 - ctf_party_console
 extensions: []
 extra_rdoc_files: []
 files:
 - LICENSE.txt
+- bin/ctf-party
 - 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/
@@ -158,17 +191,21 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - "~>"
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+  - - "<"
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.2.15
 signing_key:
 specification_version: 4
-summary: A library to enhance and speed up script/exploit writing for CTF players
+summary: A CLI tool & library to enhance and speed up script/exploitwriting for CTF
+  players
 test_files: []