enigma_engine 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a7993aac6d914e32caaff615000fe8f2fc58eebd
+  data.tar.gz: d133d5e09085fa866689d6b04d104ad95d34a455
+SHA512:
+  metadata.gz: 912ba2f5bc17c679c7aaf7146726e914352926f5113116e4fcad0f4842a68ed732d574bc4472c75c07e55836ee4745d518aedaab8e9c5ab91a21ffe44b414b15
+  data.tar.gz: 87c75bae1d47ec9fe94907a1e6ffbe9e7ee12f6a1b843a5281ae7a66ce3ca8914f6d491ce3aa0fe72e979da15e1a31a32ffd9577b8c5ca0b76166bcefcef6f88

data/.coveralls.yml

@@ -0,0 +1 @@
+repo_token: iopph6rYYZOwJMACVcCZvPgpiWnPzYgQ1

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+.idea/
+/.idea*/
+/.idea/
+*.xml
+

data/.rubocop.yml

@@ -0,0 +1,9 @@
+# This is the configuration used to check the rubocop source code.
+
+AllCops:
+  Exclude:
+    - 'spec/*'
+    - 'lib/enigma_engine/version.rb'
+    - 'enigma_engine.gemspec'
+  TargetRubyVersion: 2.2
+

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,49 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, and in the interest of
+fostering an open and welcoming community, we pledge to respect all people who
+contribute through reporting issues, posting feature requests, updating
+documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free
+experience for everyone, regardless of level of experience, gender, gender
+identity and expression, sexual orientation, disability, personal appearance,
+body size, race, ethnicity, age, religion, or nationality.
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing other's private information, such as physical or electronic
+  addresses, without explicit permission
+* Other unethical or unprofessional conduct
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+By adopting this Code of Conduct, project maintainers commit themselves to
+fairly and consistently applying these principles to every aspect of managing
+this project. Project maintainers who do not follow or enforce the Code of
+Conduct may be permanently removed from the project team.
+
+This code of conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting a project maintainer at simon.peter@andela.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. Maintainers are
+obligated to maintain confidentiality with regard to the reporter of an
+incident.
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 1.3.0, available at
+[http://contributor-covenant.org/version/1/3/0/][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/3/0/

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Damian Simon Peter
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,108 @@
+# EnigmaEngine [![Coverage Status](https://coveralls.io/repos/github/andela-sdamian/enigma_engine/badge.svg?branch=master)](https://coveralls.io/github/andela-sdamian/enigma_engine?branch=master)    [![Circle CI](https://circleci.com/gh/andela-sdamian/enigma_engine.svg?style=svg)](https://circleci.com/gh/andela-sdamian/enigma_engine)
+
+This is a ruby gem that simulates the Enigma Machine.
+The Enigma Machine is a cipher mechanism created by [Arthur Scherbius](https://en.wikipedia.org/wiki/Arthur_Scherbius) a German Engineer. The machine is capable of transcribing text into coded information as a means of encryption. As of its time during World War II, it was the most sophisticated means of encryption. During the war, both the Allies and the Axis countries were looking for a new way to encrypt messages - a way that would result in complete security this was when the Enigma was born. By the end of World War II [Alan Turing](https://en.wikipedia.org/wiki/Alan_Turing) with the help of is friends where able to crack the enigma which helped Britain and their allies during the war. [More on the Enigma](https://en.wikipedia.org/wiki/Enigma_machine).
+
+<img src="http://static.bbc.co.uk/history/img/ic/640/images/resources/topics/enigma.jpg" />
+
+## How the encryption works
+
+The inner working of an enigma machine has three rotors, each rotors has wrapped around it the 26 letters. When a key is pressed it moves the rotor ahead one alphabet. The other rotors kick off after the first has completed a revolution and so for the third.  When this is done, text in plain english becomes gibberish. Before you start encrypting you and your recipient must agree upon a key which can be set on the machine. Find out more about the enigma machine by watching this video.
+
+<a href="http://www.youtube.com/watch?feature=player_embedded&v=G2_Q9FoD-oQ
+" target="_blank"><img src="http://img.youtube.com/vi/G2_Q9FoD-oQ/0.jpg"
+alt="How the Enigma Machine works" width="600" height="350" border="10" /></a>
+
+Though, my implementation of the Enigma Machine is slightly different from that of World War II but here is the catch
+
+<strong>The rotors: they are denoted by five digit numbers e.g. 97239</strong>
+<ul>
+    <li>The first two digits of the key is the "A" rotation (97)</li>
+    <li>The second and third digits are the "B" rotation (72)</li>
+    <li>The third and fourth digits are the "C" rotation (23)</li>
+    <li>The fourth and firth digits are the "D" rotation (39)</li>
+</ul>
+
+<strong>The offsets: the date of message transmission is also factored into the encryption</strong>
+<ul>
+    <li>Date is in the format DDMMYY e.g. 020315</li>
+    <li>Square the numeric form you get 412699225 pick the last four digits</li>
+    <li>The first digit is the "A" offset (9)</li>
+    <li>The second digit is the "B" offset (2)</li>
+    <li>The third digit is the "C" offset (2)</li>
+    <li>The fourth digit is the "D" offset (5)</li>
+</ul>
+
+<strong>Encrypting a message</strong>
+
+<ul>
+    <li>Four characters are encrypted at a time</li>
+    <li>The first character is rotated forward by the "A" rotation plus the "A offset"</li>
+    <li> The second character is rotated forward by the "B" rotation plus the "B offset"</li>
+    <li>The third character is rotated forward by the "C" rotation plus the "C offset"</li>
+    <li>The fourth character is rotated forward by the "D" rotation plus the "D offset"</li>
+</ul>
+
+<strong>Decrypting a message</strong>
+
+The offsets and keys can be calculated by the same methods above. Then each character is rotated backwards instead of forwards.
+
+<strong>Cracking a message</strong>
+When the key is not known, the offsets can still be calculated from the message date. We believe that each enemy message ends with the characters "..end..". Use that to determine when you’ve correctly guessed the key.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'enigma_engine'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install enigma_engine
+
+## Usage
+
+The tool is used from the command line like so:</p>
+
+<strong>View Help </strong>
+
+`enigma help` To see help file
+
+<strong> Encrypting a message</strong>
+
+`enigma encrypt [message.txt] [encrypted.txt]`
+created encrypted.txt with key 82648 and date 090216
+
+That will take the plaintext file message.txt and create an encrypted file encrypted.txt.
+
+<strong> Decrypting a message</strong>
+Then, if we know the key, we can decrypt like so:
+
+`enigma decrypt [encrypted.txt] [decrypted.txt] [82648] [030415]`
+created ‘decrypted.txt with key 82648 and date 030415
+
+<strong> Cracking a message</strong>
+But if we don’t know the key, we can try to crack it with just the date like so: 
+
+`enigma crack [decrypted.txt] [cracked.txt] [030415]`
+created ‘cracked.txt with key 82648 and date 030415
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/andela-sdamian/EnigmaEngine. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler/gem_tasks'
+task :default => :spec

data/bin/console_helpers.rb

@@ -0,0 +1,45 @@
+def colorize(text, color_code)
+  "\e[#{color_code}m#{text}\e[0m"
+end
+
+def red(text)
+  colorize(text, 31)
+end
+
+def green(text)
+  colorize(text, 32)
+end
+
+def blue(text)
+  colorize(text, 34)
+end
+
+def yellow(text)
+  colorize(text, 33)
+end
+
+def call_error
+  puts red('Arguments error!')
+  puts yellow('Run [enigma help] for more info...')
+  exit
+end
+
+def files_valid?(arr)
+  arr.all? { |i| i[-4, 4] == '.txt' }
+end
+
+def key_valid?(key)
+  key.to_s.length.eql? 5
+end
+
+def date_valid?(date)
+  date.to_s.length.eql? 6
+end
+
+def fields_empty?(arr)
+  if arr.include? ''
+    true
+  elsif arr.nil?
+    true
+  end
+end

data/bin/enigma

@@ -0,0 +1,54 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'enigma_engine'
+require_relative 'console_helpers'
+require 'enigma_engine/crack'
+require_relative 'help'
+
+case ARGV[0]
+when 'help'
+  show_wait_cursor(3)
+  puts @msg_help
+when 'encrypt'
+  message = ARGV[1]
+  new_file = ARGV[2]
+  if fields_empty?([message, new_file])
+    raise call_error
+  end
+
+  if files_valid?([message, new_file])
+    EnigmaEngine::Engine.new.encrypt(message, new_file)
+  else
+    raise call_error
+  end
+when 'decrypt'
+  message = ARGV[1]
+  new_file = ARGV[2]
+  key = ARGV[3]
+  date = ARGV[4]
+  if fields_empty?([message, new_file, key, date])
+    raise call_error
+  end
+
+  if files_valid?([message, new_file]) && key_valid?(key) && date_valid?(date)
+    EnigmaEngine::Engine.new.decrypt(message, new_file, key, date)
+  else
+    raise call_error
+  end
+when 'crack'
+  message = ARGV[1]
+  new_file = ARGV[2]
+  date = ARGV[3]
+  if fields_empty?([message, new_file, date])
+    raise call_error
+  end
+
+  if files_valid?([message, new_file]) && date_valid?(date)
+    EnigmaEngine::Crack.new.crack(message, new_file, date)
+  else
+    raise call_error
+  end
+else
+  raise call_error
+end

data/bin/help.rb

@@ -0,0 +1,56 @@
+require_relative'console_helpers'
+
+def show_wait_cursor(seconds, fps = 10)
+  chars = %w(| / - \\)
+  delay = 1.0 / fps
+  (seconds * fps).round.times do |i|
+    print chars[i % chars.length]
+    sleep delay
+    print "\b"
+  end
+end
+
+show_wait_cursor(3)
+@msg_help = <<HELP
+                                                                 .         .
+8 8888888888   b.             8  8 8888     ,o888888o.          ,8.       ,8.                   .8.
+8 8888         888o.          8  8 8888    8888     `88.       ,888.     ,888.                 .888.
+8 8888         Y88888o.       8  8 8888 ,8 8888       `8.     .`8888.   .`8888.               :88888.
+8 8888         .`Y888888o.    8  8 8888 88 8888              ,8.`8888. ,8.`8888.             . `88888.
+8 888888888888 8o. `Y888888o. 8  8 8888 88 8888             ,8'8.`8888,8^8.`8888.           .8. `88888.
+8 8888         8`Y8o. `Y88888o8  8 8888 88 8888            ,8' `8.`8888' `8.`8888.         .8`8. `88888.
+8 8888         8   `Y8o. `Y8888  8 8888 88 8888   8888888 ,8'   `8.`88'   `8.`8888.       .8' `8. `88888.
+8 8888         8      `Y8o. `Y8  8 8888 `8 8888       .8',8'     `8.`'     `8.`8888.     .8'   `8. `88888.
+8 8888         8         `Y8o.`  8 8888    8888     ,88',8'       `8        `8.`8888.   .888888888. `88888.
+8 888888888888 8            `Yo  8 8888     `8888888P' ,8'         `         `8.`8888. .8'       `8. `88888.
+
+
+Intro
+====================================
+Hello there, welcome to the EnigmaEngine! This program simulates the Enigma Machine used in World War II by the Germans.
+Find out more on "#{yellow('https://github.com/andela-sdamian/enigma_engine')}"
+
+Usage
+====================================
+1. Encrypting a file
+   `enigma encrypt [file_name.txt] [new_file.txt]`
+
+2. Decrypting a file
+   `enigma decrypt [encrypted_file.txt] [new_file.txt] [five_digit_key] [date]`
+
+3. Cracking a file
+  `enigma crack [file_name.txt] [new_file.txt] [date]`
+
+All date should be in the format DDMMYY e.g. 020416
+
+AUTHOR
+=====================================
+Copyright (c) 2016 Damian Simon Peter
+----------------------------------------------------------------------
+|Twitter =>  "#{blue('http://twitter.com/damiansimonpete')}"
+|StackOverflow => "#{yellow('http://goo.gl/3WIAP4')}"
+|GitHub => "#{blue('http://github.com/andela-sdamian')}"
+|Powered by Andela "#{green('http://twitter.com/andela')}"
+----------------------------------------------------------------------
+
+HELP

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/circle.yml

@@ -0,0 +1,6 @@
+machine:
+  ruby:
+    version: 2.2.3
+dependencies:
+  pre:
+    - gem install bundler -v 1.11.2

data/enigma_engine.gemspec

@@ -0,0 +1,32 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'enigma_engine/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'enigma_engine'
+  spec.version       = EnigmaEngine::VERSION
+  spec.authors       = ['Damian Simon Peter']
+  spec.email         = ['simon.peter@andela.com']
+
+  spec.summary       = 'A gem that simulates the Enigma Machine'
+  spec.description   = 'The inner working of an enigma machine has three rotors. Each rotors has wrapped around it the 26 letters. When a key is pressed it moves the rotor ahead one alphabet. The other rotors kick off after the first has completed a revolution and so for the third.When this is done, text in plain english becomes gibberish. Before you start encrypting you and your recipient must agree upon a key which can be set on the machine. Find out more on my GitHub page'
+  spec.homepage      = 'https://github.com/andela-sdamian/enigma_engine'
+  spec.license       = 'MIT'
+
+  if spec.respond_to?(:metadata)
+    spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+  else
+    raise 'RubyGems 2.0 or newer is required to protect against public gem pushes.'
+  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'bin'
+  spec.executables = ['enigma']
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.11'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'coveralls'
+end

data/lib/enigma_engine.rb

@@ -0,0 +1,8 @@
+require_relative 'enigma_engine/version'
+require_relative 'enigma_engine/date_key_helpers'
+require_relative 'enigma_engine/file_helpers'
+require_relative 'enigma_engine/offsets'
+require_relative 'enigma_engine/rotors'
+require_relative 'enigma_engine/engine'
+module EnigmaEngine
+end

data/lib/enigma_engine/crack.rb

@@ -0,0 +1,63 @@
+require_relative 'engine'
+module EnigmaEngine
+  class Crack < EnigmaEngine::Engine
+    def handle_get_target(encrypted_file, res)
+      case encrypted_file.last.length
+      when 4 then res[:target] = encrypted_file.last
+                  res[:weakness] = %w(n d . .)
+      when 3 then res[:weakness] = %w(. . e n)
+      when 2 then res[:weakness] = %w(. e n d)
+      when 1 then res[:weakness] = %w(e n d .)
+      end
+      res
+    end
+
+    def get_target(encrypted_file)
+      res = {}
+      res[:target] = encrypted_file[encrypted_file.length - 2]
+      handle_get_target(encrypted_file, res)
+    end
+
+    def find_key(encrypted_file)
+      encrypted_file = text_to_array(open_file(encrypted_file))
+      char_map_with_index = Hash[characters.zip (0...characters.size)]
+      target_char = get_target(encrypted_file)
+      rotation = {}
+      target_char[:target].each_with_index do |item, index|
+        weakness_pos = char_map_with_index[target_char[:weakness][index]]
+        pos = char_map_with_index[item] - weakness_pos
+        (pos < 0) ? pos += 39 : pos
+        case index
+        when 0 then rotation[:a_rotation] = pos
+        when 1 then rotation[:b_rotation] = pos
+        when 2 then rotation[:c_rotation] = pos
+        when 3 then rotation[:d_rotation] = pos
+        end
+      end
+      rotation
+    end
+
+    def handle_crack_rotation(index, item, res, func)
+      case index
+      when 0 then func.call(item, res[:a_rotation])
+      when 1 then func.call(item, res[:b_rotation])
+      when 2 then func.call(item, res[:c_rotation])
+      when 3 then func.call(item, res[:d_rotation])
+      end
+    end
+
+    def crack(encrypted_file, new_file, date)
+      res = find_key(encrypted_file)
+      key = res.values.map(&:to_s).join('')
+      encrypted_file = text_to_array(open_file(encrypted_file))
+      cracked_chars = []
+      encrypted_file.each do |row|
+        row.each_with_index do |item, index|
+          brk = handle_crack_rotation(index, item, res, method(:decrypt_char))
+          cracked_chars.push(brk)
+        end
+      end
+      create_write_file(cracked_chars.join(''), new_file, key, date)
+    end
+  end
+end

data/lib/enigma_engine/date_key_helpers.rb

@@ -0,0 +1,44 @@
+module EnigmaEngine
+  module DateKeyHelpers
+    def today
+      date = Time.now.strftime('%d, %m, %y').to_s
+      date.gsub!(/\,/, '').split(' ').join('').to_s
+    end
+
+    def colorize(text, color_code)
+      "\e[#{color_code}m#{text}\e[0m"
+    end
+
+    def red(text)
+      colorize(text, 31)
+    end
+
+    def green(text)
+      colorize(text, 32)
+    end
+
+    def blue(text)
+      colorize(text, 34)
+    end
+
+    def yellow(text)
+      colorize(text, 33)
+    end
+
+    def files_valid?(arr)
+      arr.all? { |i| i[-4, 4] == '.txt' }
+    end
+
+    def key_valid?(key)
+      key.to_s.length.eql? 5
+    end
+
+    def date_valid?(date)
+      date.to_s.length.eql? 6
+    end
+
+    def fields_empty?(arr)
+      arr.include? ''
+    end
+  end
+end

data/lib/enigma_engine/engine.rb

@@ -0,0 +1,83 @@
+require_relative 'rotors'
+require_relative 'offsets'
+require_relative 'file_helpers'
+require_relative 'date_key_helpers'
+
+module EnigmaEngine
+  class Engine
+    include Rotors
+    include Offsets
+    include FileHelpers
+    include DateKeyHelpers
+
+    attr_writer :date, :key
+    attr_reader :date
+
+    def date=(date)
+      date.sub!(/^0/, '')
+      date_squared = date.to_i**2
+      last_four = date_squared.to_s.split('')[-4, 4]
+      @date = last_four.map(&:to_i)
+    end
+
+    def characters
+      ('a'..'z').to_a + ('0'..'9').to_a + [32.chr, 46.chr, 44.chr]
+    end
+
+    def encrypt_char(char, pos)
+      char.downcase!
+      char_map_hash = Hash[characters.zip(characters.rotate(pos))]
+      res = char.chars.map { |c| char_map_hash.fetch(c) }
+      res.join('')
+    end
+
+    def decrypt_char(char, pos)
+      char.downcase!
+      pos *= -1
+      char_map_hash = Hash[characters.zip(characters.rotate(pos))]
+      res = char.chars.map { |c| char_map_hash.fetch(c) }
+      res.join('')
+    end
+
+    def handle_rotation(index, item, func)
+      case index
+      when 0 then func.call(item, a_rotation + a_offset)
+      when 1 then func.call(item, b_rotation + b_offset)
+      when 2 then func.call(item, c_rotation + c_offset)
+      when 3 then func.call(item, d_rotation + d_offset)
+      end
+    end
+
+    def rand_key
+      rand(999_99).to_s.center(5, rand(9).to_s)
+    end
+
+    def encrypt(file, new_file)
+      @key = rand_key
+      @date = today
+      message = text_to_array(open_file(file))
+      encrypted_chars = []
+      message.each do |row|
+        row.each_with_index do |item, index|
+          rotated = handle_rotation(index, item, method(:encrypt_char))
+          encrypted_chars.push(rotated)
+        end
+      end
+      create_write_file(encrypted_chars.join(''), new_file, @key, date, true)
+    end
+
+    def decrypt(file, new_file, key, date)
+      @key = key
+      @date = date
+      message = text_to_array(open_file(file))
+      decrypted_chars = []
+      message.each do |row|
+        row.each_with_index do |item, index|
+          reversed = handle_rotation(index, item, method(:decrypt_char))
+          decrypted_chars.push(reversed)
+        end
+      end
+      create_write_file(decrypted_chars.join(''), new_file, key, date)
+    end
+  end
+end

data/lib/enigma_engine/file_helpers.rb

@@ -0,0 +1,36 @@
+module EnigmaEngine
+  module FileHelpers
+    def open_file(file_name)
+      file = File.open(file_name, 'r')
+      if File.exist? file
+        data = file.read
+        data.gsub(/\n/, ' ')
+      end
+    rescue
+      raise <<NOTIFY
+"Cannot find file, Run [enigma help] to see help!"
+NOTIFY
+    end
+
+    def create_write_file(txt, file_name, key, date, type = false)
+      file = File.open(file_name, 'w')
+      file.write(txt)
+      file.close
+      show_msg(file_name, key, date, type)
+    end
+
+    def text_to_array(text)
+      text = text.split('').map(&:downcase)
+      text.each_slice(4).to_a
+    end
+
+    def show_msg(new_file, key, date, type = false)
+      msg = 'Please take note of the key & date in order to decrypt this file'
+      (type) ? msg = yellow(msg) : msg = ''
+      puts <<NOTIFY
+Created: #{green(new_file)}\nKey: #{red(key)}\nDate: #{blue(date)}
+#{msg}
+NOTIFY
+    end
+  end
+end

data/lib/enigma_engine/offsets.rb

@@ -0,0 +1,23 @@
+module EnigmaEngine
+  module Offsets
+    def get_date(index)
+      @date[index].to_i
+    end
+
+    def a_offset
+      get_date(0)
+    end
+
+    def b_offset
+      get_date(1)
+    end
+
+    def c_offset
+      get_date(2)
+    end
+
+    def d_offset
+      get_date(3)
+    end
+  end
+end

data/lib/enigma_engine/rotors.rb

@@ -0,0 +1,27 @@
+module EnigmaEngine
+  module Rotors
+    def key
+      @key
+    end
+
+    def put_key(x, y)
+      key.to_s.split('')[x, y].join('').to_i
+    end
+
+    def a_rotation
+      put_key(0, 2)
+    end
+
+    def b_rotation
+      put_key(1, 2)
+    end
+
+    def c_rotation
+      put_key(2, 2)
+    end
+
+    def d_rotation
+      put_key(3, 2)
+    end
+  end
+end

data/lib/enigma_engine/version.rb

@@ -0,0 +1,3 @@
+module EnigmaEngine
+  VERSION = '0.1.0'
+end

metadata

@@ -0,0 +1,129 @@
+--- !ruby/object:Gem::Specification
+name: enigma_engine
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Damian Simon Peter
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-03-01 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.11'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: The inner working of an enigma machine has three rotors. Each rotors
+  has wrapped around it the 26 letters. When a key is pressed it moves the rotor ahead
+  one alphabet. The other rotors kick off after the first has completed a revolution
+  and so for the third.When this is done, text in plain english becomes gibberish.
+  Before you start encrypting you and your recipient must agree upon a key which can
+  be set on the machine. Find out more on my GitHub page
+email:
+- simon.peter@andela.com
+executables:
+- enigma
+extensions: []
+extra_rdoc_files: []
+files:
+- ".coveralls.yml"
+- ".gitignore"
+- ".rubocop.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console_helpers.rb
+- bin/enigma
+- bin/help.rb
+- bin/setup
+- circle.yml
+- enigma_engine.gemspec
+- lib/enigma_engine.rb
+- lib/enigma_engine/crack.rb
+- lib/enigma_engine/date_key_helpers.rb
+- lib/enigma_engine/engine.rb
+- lib/enigma_engine/file_helpers.rb
+- lib/enigma_engine/offsets.rb
+- lib/enigma_engine/rotors.rb
+- lib/enigma_engine/version.rb
+homepage: https://github.com/andela-sdamian/enigma_engine
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5.1
+signing_key: 
+specification_version: 4
+summary: A gem that simulates the Enigma Machine
+test_files: []