ctf-party 1.1.0 → 1.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa3a85e4dd2db7d636cd1e6f66ca0b32fb34567886901b1102eae35fcb1fbb1c
-  data.tar.gz: aa6c2db8fb07651887d5711d0bfb6b544d422c4f091aaf1893cc6d345e467cc6
+  metadata.gz: 43e5c5fba11ab29415687644876bc3185a7b220adcc0da51bf36bac65b970600
+  data.tar.gz: 6dc55b3100a380a0ff2c11e61eda9f67fd7a7a1ae5fc9effae3bae870cf701df
 SHA512:
-  metadata.gz: b1eebe8e48be92a2f4ce8141f6c41a8f4023a3db5d4091358b41a41f5f3b4d123552e382c323d80e29db256818934b2ca8f036e23af10f56a4c1a04861a4f9d9
-  data.tar.gz: 067e1e47c7bad059917fa3774c9d5f37eb9ba37dcd0d8df0320a01bffeccae90a1958d8de8d41d6308040f5cc21e07025a5a34f4b6ef9ce8165ebb7246349134
+  metadata.gz: 36b8f7a716e66fcfb1aed39b71f586d5ad73e9c099a11651c7dfd29093e09f60b15e278036f7e4e7d74150ceca1c374308864634f8f58b8e4078ca261f60a389
+  data.tar.gz: 17618c1a863ed02b9f838bae87e2135e108d50350658c639494d9d9d2a7751319720a022f801a10a79a0bf0a03417d5262d043c137313d7a004dd08a81b5ab61

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

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

data/lib/ctf_party/base64.rb

@@ -74,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/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/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.

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
@@ -78,9 +78,10 @@ class String
     opts[:nibble] ||= :high
     # convert
     out = ''
-    if opts[:nibble] == :high
+    case opts[:nibble]
+    when :high
       out = unpack1('H*')
-    elsif opts[:nibble] == :low
+    when :low
       out = unpack1('h*')
     end
     # char case management
@@ -89,6 +90,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
@@ -99,6 +105,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
@@ -122,6 +133,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
@@ -131,4 +147,66 @@ class String
   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/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ctf-party
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.3.2
 platform: ruby
 authors:
 - Alexandre ZANNI
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-02-03 00:00:00.000000000 Z
+date: 2020-07-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -135,22 +135,24 @@ files:
 - bin/ctf_party_console
 - lib/ctf_party.rb
 - lib/ctf_party/base64.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/rot.rb
 - lib/ctf_party/version.rb
-homepage: https://orange-cyberdefense.github.io/ctf-party/
+homepage: https://noraj.github.io/ctf-party/
 licenses:
 - MIT
 metadata:
   yard.run: yard
-  bug_tracker_uri: https://github.com/Orange-Cyberdefense/ctf-party/issues
-  changelog_uri: https://github.com/Orange-Cyberdefense/ctf-party/blob/master/docs/CHANGELOG.md
-  documentation_uri: https://orange-cyberdefense.github.io/ctf-party/
-  homepage_uri: https://orange-cyberdefense.github.io/ctf-party/
-  source_code_uri: https://github.com/Orange-Cyberdefense/ctf-party/
-post_install_message: 
+  bug_tracker_uri: https://github.com/noraj/ctf-party/issues
+  changelog_uri: https://github.com/noraj/ctf-party/blob/master/docs/CHANGELOG.md
+  documentation_uri: https://noraj.github.io/ctf-party/
+  homepage_uri: https://noraj.github.io/ctf-party/
+  source_code_uri: https://github.com/noraj/ctf-party/
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -158,7 +160,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - "~>"
     - !ruby/object:Gem::Version
-      version: '2.4'
+      version: '2.7'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -166,7 +168,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubygems_version: 3.1.2
-signing_key: 
+signing_key:
 specification_version: 4
 summary: A library to enhance and speed up script/exploit writing for CTF players
 test_files: []