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

ctf-party 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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