ctf-party 1.2.0 → 1.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc518fdaca11359e723f1a25e93f159a791efb951098c6ddaf0dde1af2226476
-  data.tar.gz: b18d37b97167e931c5e5a82303fda9ece61d8c3e460b57c8b280d80f1007be8d
+  metadata.gz: f5b53f3731ce007357cb7033f6758bbb8136bd7f66deddc1d519aa246f9aee6c
+  data.tar.gz: 5c17753bd1e9bbf34e82f639531c9fe496ca8dffc68a83b30d32cc05b5c0cc5d
 SHA512:
-  metadata.gz: 9faca804bb4b67d01553d11516ba50eecfceff4d2ffad6c2a38c1db072b31e90b7740226637f45fca2b431d342be21457a4bc4ffd5f25fea9d015ff93ed89625
-  data.tar.gz: fd5d70b588e54e6c863532ea2b11955d551242331b0e8c68f611ff6287bbb1259e6ebaf824b73310026c3ff93e4234c606abe0e118f3dba2d774d4d9a66a3d1a
+  metadata.gz: 2788b1c3b60d2f5ed5a3d05c1971e013f3c02317219368a408b0f375ce9bc3e92d9d67090ca92a39f4dfc908d8c6775d90e4a8cee91736474fd8f3b0ea9e0870
+  data.tar.gz: eae30b24bf35a6f6a8caab27bf13f496cc262abefd3d348f7c5e58835141c0a36261162045a17d86236277a0576b64ed9670d66812e82d3536d066fad4b59807

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,6 @@ 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'

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/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/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
@@ -132,6 +148,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

data/lib/ctf_party/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ctf-party
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.3
 platform: ruby
 authors:
 - Alexandre ZANNI
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-02-03 00:00:00.000000000 Z
+date: 2021-02-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -100,14 +100,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,22 +135,25 @@ 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/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,15 +161,15 @@ 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:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.1.4
+signing_key:
 specification_version: 4
 summary: A library to enhance and speed up script/exploit writing for CTF players
 test_files: []