RubyGems - ctf-party - Versions diffs - 1.0.0 - Mend

ctf-party 1.0.0

Files changed (55) hide show

checksums.yaml +7 -0
data/.rubocop.yml +29 -0
data/.yardopts +4 -0
data/.yardopts-dev +6 -0
data/Gemfile +6 -0
data/Gemfile.lock +52 -0
data/LICENSE.txt +21 -0
data/README.md +57 -0
data/Rakefile +11 -0
data/bin/ctf_party_console +7 -0
data/bin/ctf_party_setup +6 -0
data/docs/.nojekyll +0 -0
data/docs/About.md +5 -0
data/docs/CHANGELOG.md +5 -0
data/docs/README.md +52 -0
data/docs/_coverpage.md +10 -0
data/docs/_media/logo.png +0 -0
data/docs/_navbar.md +3 -0
data/docs/_sidebar.md +13 -0
data/docs/index.html +31 -0
data/docs/pages/documentation.md +30 -0
data/docs/pages/install.md +84 -0
data/docs/pages/publishing.md +39 -0
data/docs/pages/quick-start.md +23 -0
data/docs/pages/usage.md +61 -0
data/docs/vendor/docsify.js +1 -0
data/docs/vendor/plugins/emoji.min.js +1 -0
data/docs/vendor/plugins/search.min.js +1 -0
data/docs/vendor/prismjs/components/prism-ruby.min.js +1 -0
data/docs/vendor/themes/vue.css +1 -0
data/docs/yard/String.html +2909 -0
data/docs/yard/Version.html +121 -0
data/docs/yard/_index.html +123 -0
data/docs/yard/class_list.html +51 -0
data/docs/yard/css/common.css +1 -0
data/docs/yard/css/full_list.css +58 -0
data/docs/yard/css/style.css +496 -0
data/docs/yard/file.LICENSE.html +70 -0
data/docs/yard/file.README.html +124 -0
data/docs/yard/file_list.html +61 -0
data/docs/yard/frames.html +17 -0
data/docs/yard/index.html +124 -0
data/docs/yard/js/app.js +303 -0
data/docs/yard/js/full_list.js +216 -0
data/docs/yard/js/jquery.js +4 -0
data/docs/yard/method_list.html +275 -0
data/docs/yard/top-level-namespace.html +112 -0
data/lib/ctf_party.rb +7 -0
data/lib/ctf_party/base64.rb +99 -0
data/lib/ctf_party/digest.rb +115 -0
data/lib/ctf_party/flag.rb +94 -0
data/lib/ctf_party/rot.rb +47 -0
data/lib/ctf_party/version.rb +5 -0
data/test/test_string.rb +134 -0
metadata +218 -0

data/docs/yard/top-level-namespace.html ADDED

@@ -0,0 +1,112 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>
+  Top Level Namespace
+    &mdash; Documentation by YARD 0.9.20
+</title>
+  <link rel="stylesheet" href="css/style.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="css/common.css" type="text/css" charset="utf-8" />
+<script type="text/javascript" charset="utf-8">
+  pathId = "";
+  relpath = '';
+</script>
+  <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
+  <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
+  </head>
+  <body>
+    <div class="nav_wrap">
+      <iframe id="nav" src="class_list.html?1"></iframe>
+      <div id="resizer"></div>
+    </div>
+    <div id="main" tabindex="-1">
+      <div id="header">
+        <div id="menu">
+    <a href="_index.html">Index</a> &raquo;
+    <span class="title">Top Level Namespace</span>
+</div>
+        <div id="search">
+    <a class="full_list_link" id="class_list_link"
+        href="class_list.html">
+        <svg width="24" height="24">
+          <rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
+        </svg>
+    </a>
+</div>
+        <div class="clear"></div>
+      </div>
+      <div id="content"><h1>Top Level Namespace
+</h1>
+<div class="box_info">
+</div>
+<h2>Defined Under Namespace</h2>
+<p class="children">
+      <strong class="modules">Modules:</strong> <span class='object_link'><a href="Version.html" title="Version (module)">Version</a></span>
+      <strong class="classes">Classes:</strong> <span class='object_link'><a href="String.html" title="String (class)">String</a></span>
+</p>
+</div>
+      <div id="footer">
+  Generated on Wed Nov 20 19:33:26 2019 by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.20 (ruby-2.6.2).
+</div>
+    </div>
+  </body>
+</html>

data/lib/ctf_party.rb ADDED

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+# Project internal
+require 'ctf_party/base64'
+require 'ctf_party/rot'
+require 'ctf_party/digest'
+require 'ctf_party/flag'

data/lib/ctf_party/base64.rb ADDED

@@ -0,0 +1,99 @@
+# frozen_string_literal: true
+# Ruby standard library
+require 'base64'
+class String
+  # Encode the string into base64
+  # @param opts [Hash] optional parameters
+  # @option opts [Symbol] :mode Default value: +:strict+.
+  #   Other values are +:strict+ (+:rfc4648+) or +:urlsafe+.
+  # @see https://ruby-doc.org/stdlib-2.6.5/libdoc/base64/rdoc/Base64.html
+  # @return [String] the Base64 encoded string
+  # @example
+  #   'Super lib!'.to_b64 # => "U3VwZXIgbGliIQ=="
+  def to_b64(opts = {})
+    opts[:mode] ||= :strict
+    return Base64.strict_encode64(self) if opts[:mode] == :strict ||
+                                           opts[:mode] == :rfc4648
+    return Base64.encode64(self) if opts[:mode] == :rfc2045
+    return Base64.urlsafe_encode64(self) if opts[:mode] == :urlsafe
+  end
+  # Encode the string into base64 in place as described for {String#to_b64}.
+  # @return [nil]
+  # @example
+  #   myStr = 'Ruby' # => "Ruby"
+  #   myStr.to_b64! # => nil
+  #   myStr # => "UnVieQ=="
+  def to_b64!(opts = {})
+    opts[:mode] ||= :strict
+    replace(to_b64) if opts[:mode] == :strict ||
+                       opts[:mode] == :rfc4648
+    replace(to_b64(mode: :rfc2045)) if opts[:mode] == :rfc2045
+    replace(to_b64(mode: :urlsafe)) if opts[:mode] == :urlsafe
+  end
+  # Decode the string from base64
+  # @param opts [Hash] optional parameters
+  # @option opts [Symbol] :mode Default value: +:strict+.
+  #   Other values are +:strict+ (+:rfc4648+) or +:urlsafe+.
+  # @see https://ruby-doc.org/stdlib-2.6.5/libdoc/base64/rdoc/Base64.html
+  # @return [String] the Base64 decoded string
+  # @example
+  #   'UnVieQ=='.from_b64 # => "Ruby"
+  def from_b64(opts = {})
+    opts[:mode] ||= :strict
+    return Base64.strict_decode64(self) if opts[:mode] == :strict ||
+                                           opts[:mode] == :rfc4648
+    return Base64.decode64(self) if opts[:mode] == :rfc2045
+    return Base64.urlsafe_decode64(self) if opts[:mode] == :urlsafe
+  end
+  # Decode the string from base64 in place as described for {String#from_b64}.
+  # @return [nil]
+  # @example
+  #   a = 'SGVsbG8gd29ybGQh' # => "SGVsbG8gd29ybGQh"
+  #   a.from_b64! # => nil
+  #   a # => "Hello world!"
+  def from_b64!(opts = {})
+    opts[:mode] ||= :strict
+    replace(from_b64) if opts[:mode] == :strict ||
+                         opts[:mode] == :rfc4648
+    replace(from_b64(mode: :rfc2045)) if opts[:mode] == :rfc2045
+    replace(from_b64(mode: :urlsafe)) if opts[:mode] == :urlsafe
+  end
+  # Is the string encoded in base64?
+  # @param opts [Hash] optional parameters
+  # @option opts [Symbol] :mode Default value: +:strict+.
+  #   Other values are +:strict+ (+:rfc4648+) or +:urlsafe+.
+  # @see https://ruby-doc.org/stdlib-2.6.5/libdoc/base64/rdoc/Base64.html
+  # @return [Boolean] +true+ if the string is a valid base64 string, +false+
+  #   else.
+  # @example
+  #   'SGVsbG8gd29ybGQh'.b64? # => true
+  #   'SGVsbG8g@@d29ybGQh'.b64? # => false
+  def b64?(opts = {})
+    opts[:mode] ||= :strict
+    b64 = false
+    # https://www.rexegg.com/regex-ruby.html
+    reg1 = %r{\A(?:[a-zA-Z0-9+/]{4})*(?:|(?:[a-zA-Z0-9+/]{3}=)|
+              (?:[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
+      b64 = true if reg1.match?(self)
+    elsif opts[:mode] == :rfc2045
+      b64 = true
+      split("\n").each do |s|
+        b64 = false unless reg1.match?(s)
+      end
+    elsif opts[:mode] == :urlsafe
+      b64 = true if reg3.match?(self)
+    else
+      raise ArgumentError 'Wrong mode'
+    end
+    return b64
+  end
+end

data/lib/ctf_party/digest.rb ADDED

@@ -0,0 +1,115 @@
+# frozen_string_literal: true
+# Ruby standard library
+require 'digest'
+class String
+  # Calculate the md5 hash of the string.
+  # @see https://ruby-doc.org/stdlib-2.6.1/libdoc/digest/rdoc/Digest/MD5.html
+  # @return [String] md5 hash
+  # @example
+  #   'noraj'.md5 # => "556cc23863fef20fab5c456db166bc6e"
+  def md5
+    Digest::MD5.hexdigest self
+  end
+  # Calculate the md5 hash of the string in place as described for {#md5}.
+  # @example
+  #   a = '\o/' # => "\\o/"
+  #   a.md5! # => "881419964e480e66162da521ccc25ebf"
+  #   a # => "881419964e480e66162da521ccc25ebf"
+  def md5!
+    replace(md5)
+  end
+  # Calculate the sha1 hash of the string.
+  # @see https://ruby-doc.org/stdlib-2.6.1/libdoc/digest/rdoc/Digest/SHA1.html
+  # @return [String] sha1 hash
+  # @example
+  #   'ctf-party'.sha1 # => "5a64f3bc491d0977e1e3578a48c65a89a16a5fe8"
+  def sha1
+    Digest::SHA1.hexdigest self
+  end
+  # Calculate the sha1 hash of the string in place as described for {#sha1}.
+  # @example
+  #   bob = 'alice' # => "alice"
+  #   bob.sha1! # => "522b276a356bdf39013dfabea2cd43e141ecc9e8"
+  #   bob # => "522b276a356bdf39013dfabea2cd43e141ecc9e8"
+  def sha1!
+    replace(sha1)
+  end
+  # Calculate the sha2 hash of the string.
+  # @param opts [Hash] optional parameters
+  # @option opts [Integer] :bitlen Defines the bit lenght of the digest.
+  #   Default value: 256 (SHA2-256). other valid vales are 384 (SHA2-384)
+  #   and 512 (SHA2-512).
+  # @see https://ruby-doc.org/stdlib-2.6.1/libdoc/digest/rdoc/Digest/SHA2.html
+  # @return [String] sha hash
+  # @example
+  #   'try harder'.sha2 # => "5321ff2d4b1389b3a350dfe8ca77e3889dc6259bb233ad..."
+  #   'try harder'.sha2(bitlen: 512) # => "a7b73a98c095b22e25407b15c4dec128c..."
+  def sha2(opts = {})
+    opts[:bitlen] ||= 256
+    Digest::SHA2.new(opts[:bitlen]).hexdigest self
+  end
+  # Calculate the sha2 hash of the string in place as described for {#sha2}.
+  # @example
+  #   th = 'try harder' # => "try harder"
+  #   th.sha2!(bitlen: 384) # => "bb7f60b9562a19c3a83c23791440af11591c42ede9..."
+  #   th # => "bb7f60b9562a19c3a83c23791440af11591c42ede9988334cdfd7efa4261a..."
+  def sha2!(opts = {})
+    replace(sha2(opts))
+  end
+  # Alias for {#sha2} with default value ( +sha2(bitlen: 256)+ ).
+  def sha2_256
+    sha2
+  end
+  # Alias for {#sha2!} with default value ( +sha2!(bitlen: 256)+ ).
+  def sha2_256!
+    replace(sha2)
+  end
+  # Alias for {#sha2} with default value ( +sha2(bitlen: 384)+ ).
+  def sha2_384
+    sha2(bitlen: 384)
+  end
+  # Alias for {#sha2!} with default value ( +sha2!(bitlen: 384)+ ).
+  def sha2_384!
+    replace(sha2(bitlen: 384))
+  end
+  # Alias for {#sha2} with default value ( +sha2(bitlen: 512)+ ).
+  def sha2_512
+    sha2(bitlen: 512)
+  end
+  # Alias for {#sha2!} with default value ( +sha2!(bitlen: 512)+ ).
+  def sha2_512!
+    replace(sha2(bitlen: 512))
+  end
+  # Calculate the RIPEMD-160 hash of the string.
+  # @see https://ruby-doc.org/stdlib-2.6.1/libdoc/digest/rdoc/Digest/RMD160.html
+  # @return [String] RIPEMD-160 hash
+  # @example
+  #   'payload'.rmd160 # => "3c6255c112d409dafdb84d5b0edba98dfd27b44f"
+  def rmd160
+    Digest::RMD160.hexdigest self
+  end
+  # Calculate the RIPEMD-160 hash of the string in place as described for
+  # {#rmd160}.
+  # @example
+  #   pl = 'payload' # => "payload"
+  #   pl.rmd160! # => "3c6255c112d409dafdb84d5b0edba98dfd27b44f"
+  #   pl # => "3c6255c112d409dafdb84d5b0edba98dfd27b44f"
+  def rmd160!
+    replace(rmd160)
+  end
+end

data/lib/ctf_party/flag.rb ADDED

@@ -0,0 +1,94 @@
+# frozen_string_literal: true
+require 'ctf_party/digest'
+class String
+  # The flag configuration hash. See {.flag=}.
+  @@flag = {
+    prefix: '',
+    suffix: '',
+    enclosing: ['{', '}'],
+    digest: nil
+  }
+  # Show the actual flag configuration. See {.flag=}.
+  def self.flag
+    @@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.
+  # @option hash [String] :suffix suffix of the flag. Default: none.
+  # @option hash [Array<String>] :enclosing the characters used to surround
+  #   the flag. Default are curly braces: +{+, +}+. The array must contain
+  #   exactly 2 elements.
+  # @option hash [String] :digest the hash algorithm to apply on the flag.
+  #   Default: none. Allowed values: md5, sha1, sha2_256, sha2_384, sha2_512,
+  #   rmd160.
+  # @return [Hash] hash of the updated options.
+  # @note You can provide the full hash or only the key to update.
+  # @example
+  #   String.flag # => {:prefix=>"", :suffix=>"", :enclosing=>["{", "}"], :digest=>nil}
+  #   String.flag = {prefix: 'sigsegv', digest: 'md5'}
+  #   String.flag # => {:prefix=>"sigsegv", :suffix=>"", :enclosing=>["{", "}"], :digest=>"md5"}
+  #   'this_1s_a_fl4g'.flag # => "sigsegv{a5bec9e2a86b6b70d288451eb38dfec8}"
+  def self.flag=(hash)
+    hash.select! { |k, _v| @@flag.key?(k) }
+    @@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.
+  def flag
+    flag = ''
+    flag += @@flag[:prefix]
+    flag += @@flag[:enclosing][0]
+    if @@flag[:digest].nil?
+      flag += self
+    else
+      case @@flag[:digest]
+      when 'md5'
+        flag += md5
+      when 'sha1'
+        flag += sha1
+      when 'sha2_256'
+        flag += sha2_256
+      when 'sha2_384'
+        flag += sha2_384
+      when 'sha2_512'
+        flag += sha2_512
+      when 'rmd160'
+        flag += rmd160
+      end
+    end
+    flag += @@flag[:enclosing][1]
+    flag + @@flag[:suffix]
+  end
+  # Format the current string into the configured flag format in place as
+  # described for {#flag}.
+  def flag!
+    replace(flag)
+  end
+  # Check if the string respect the defined flag format.
+  # @return [Boolean] true if it respects the configured flag format. but it
+  #   does not check digest used.
+  # @example
+  #   String.flag = {prefix: 'flag'}
+  #   flag = 'Brav0!'
+  #   flag.flag! # => "flag{Brav0!}"
+  #   flag.flag? # => true
+  #   flag = 'ctf{Brav0!}'
+  #   flag.flag? # => false
+  def flag?
+    /#{@@flag[:prefix]}#{@@flag[:enclosing][0]}[[:print:]]+
+      #{@@flag[:enclosing][1]}#{@@flag[:suffix]}/ox.match?(self)
+  end
+end

data/lib/ctf_party/rot.rb ADDED

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+class String
+  # "Encrypt / Decrypt" the string with Caesar cipher. This will shift the
+  # alphabet letters by +n+, where +n+ is the integer key. The same function
+  # is used for encryption / decryption.
+  # @param opts [Hash] optional parameters
+  # @option opts [Integer] :shift The shift key. Default value: 13.
+  # @see https://en.wikipedia.org/wiki/Caesar_cipher
+  # @return [String] the (de)ciphered string
+  # @example
+  #   'Hello world!'.rot # => "Uryyb jbeyq!"
+  #   'Hello world!'.rot(shift: 11) # => "Spwwz hzcwo!"
+  #   'Uryyb jbeyq!'.rot # => "Hello world!"
+  #   'Spwwz hzcwo!'.rot(shift: 26-11) # => "Hello world!"
+  def rot(opts = {})
+    opts[:shift] ||= 13
+    alphabet = Array('a'..'z')
+    lowercase = Hash[alphabet.zip(alphabet.rotate(opts[:shift]))]
+    alphabet = Array('A'..'Z')
+    uppercasecase = Hash[alphabet.zip(alphabet.rotate(opts[:shift]))]
+    encrypter = lowercase.merge(uppercasecase)
+    chars.map { |c| encrypter.fetch(c, c) }.join
+  end
+  # "Encrypt / Decrypt" the string with Caesar cipher in place as described for
+  # {String#rot}.
+  # @return [String] the (de)ciphered string as well as changing changing the
+  #   object in place.
+  # @example
+  #   a = 'Bonjour le monde !' # => "Bonjour le monde !"
+  #   a.rot! # => "Obawbhe yr zbaqr !"
+  #   a # => "Obawbhe yr zbaqr !"
+  def rot!(opts = {})
+    replace(rot(opts))
+  end
+  # Alias for {#rot} with default value ( +rot(shift: 13)+ ).
+  def rot13
+    rot
+  end
+  # Alias for {#rot!} with default value ( +rot!(shift: 13)+ ).
+  def rot13!
+    rot!
+  end
+end