mystiko 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5796e4e1fa52ab52ff132e77d247b9adffd3ebb6
+  data.tar.gz: 3e3c02ae21aa3d35e35b1651fd9eeff95e055031
+SHA512:
+  metadata.gz: a565faf5873e606e5e2bdca07f6efc9f9263e3c37405a588fd8ba7b110eef6ad705ee5985e2e25ea29d2097f4bf385f66175e63c288cb6bbbe407fbae88d1b3d
+  data.tar.gz: 417b4ea310cca0b2959089fdb014cc9b978e8d2ec884e98303dad60883b64308b367c70ae5a76af00c4770e250bb28a11bb4841f8c14415d8efbb9fea6507a85

data/.gitignore

@@ -0,0 +1,10 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/rdoc/
+/pkg/
+/spec/reports/
+/tmp/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in mystiko.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Peter Camilleri
+
+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,60 @@
+# Mystikó
+
+The word mystikó is from the Greek language and means secret. Keeping
+secrets safe from unauthorized eyes is the very core purpose of encryption.
+
+Over the next few months, this code repo will grow to contain an introduction
+to encryption aimed at those who are curious about how it works.
+
+This will be done in a number of parts:
+
+ - A look at the basic machinery common to all encryption systems.
+ - A look at some famous (and infamous) encryption systems used through history.
+   In addition to seeing how they work, we'll also take a look at how they
+   failed and/or went obsolete.
+ - The mystiko gem, written in ruby, that serves as a simple demonstration of
+   the principles of data encryption.
+ - A challenge. For as long as secret codes have existed, secret code breakers
+   have tried to defeat them. Coming soon, see if you can decode a secret
+   message created by the above ruby code. Prizes, if any, to be determined!
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'mystiko'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install mystiko
+
+The mystiko gem itself will soon be found at: ( https://rubygems.org/gems/mystiko )
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+Creating a good introduction to encryption is quite an undertaking. For
+this reason, any input is most welcomed. There are two basic plans by which
+this can be accomplished.
+
+#### Plan A
+
+1. Fork it ( https://github.com/PeterCamilleri/mystiko/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+#### Plan B
+
+Go to the GitHub repository and raise an issue calling attention to some
+aspect that could use some TLC or a suggestion or an idea.

data/crypto_101/part_01/README.md

@@ -0,0 +1,40 @@
+# Welcome to Cyrpto 101
+
+This series of lessons is a basic level primer on encryption. The target
+audience is programmers curious about how encryption works but not in love
+with pages of confusing mathematical scribblings. It is not really solid
+enough to use as a basis for those wishing to delve deeply into the field
+but may still serve as a starting point for such a path.
+
+The examination of encryption will look at a number of sources.
+
+- The theory behind how encryption works.
+- An examination of actual encryption systems that are deployed in the field.
+- A look at some examples of epic failures through the years.
+- We will build up a simple example encryption system in the ruby language.
+
+Keep in my that this primer will keep things on a basic level. As a result
+we will avoid digging into the leading edge of security apparatus. The NSA
+most certainly has nothing to fear here.
+
+Finally, it is a goal to keep the tone light and informal. Furthermore, since
+I am not particularly learned, this will _not_ be a learned dissertation.
+
+## Encryption Basics
+
+There are many occasions that require moving and/or storing information in a
+secure manner. Some of these include:
+
+- Protecting personal information for customers or citizens.
+- Protecting financial information during business transactions.
+- Protecting the secrecy during military operations.
+- Protecting intellectual property from industrial espionage.
+- Protecting the operation of banking systems or power grids.
+- Protecting... well you get it. There's a lot that needs protecting.
+
+So, just what does protecting mean in this context? In each case above, there
+is information. That information is plainly visible to the originator of the
+information. It needs to be made plainly visible to the intended recipient of
+that information. It needs to be kept out of the hands who are not authorized
+to possess or use that information.
+

data/lib/mystiko.rb

@@ -0,0 +1,8 @@
+# coding: utf-8
+
+require_relative "mystiko/version"
+
+# The Mystiko module is where all the data encryption classes reside.
+module Mystiko
+  # Your code goes here...
+end

data/lib/mystiko/version.rb

@@ -0,0 +1,6 @@
+# coding: utf-8
+
+module Mystiko
+  #The version of this encryption library.
+  VERSION = "0.0.1"
+end

data/mystiko.gemspec

@@ -0,0 +1,33 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'mystiko/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "mystiko"
+  spec.version       = Mystiko::VERSION
+  spec.authors       = ["Peter Camilleri"]
+  spec.email         = ["peter.c.camilleri@gmail.com"]
+
+#  spec.summary       = "A introduction to the world of encryption."
+#  spec.description   = "A brief primer on the fundamentals of encryption."
+
+  spec.summary       = "A temp place holder."
+  spec.description   = "A temp place holder. Work in progress."
+
+  spec.homepage      = "http://teuthida-technologies.com/"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(tests)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.platform      = Gem::Platform::RUBY
+  spec.required_ruby_version = '>=1.9.3'
+
+  spec.add_development_dependency "bundler", "~> 1.11"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency 'minitest_visible', ">= 0.1.0"
+  spec.add_development_dependency 'mini_readline', ">= 0.4.8"
+end

data/rakefile.rb

@@ -0,0 +1,41 @@
+#!/usr/bin/env rake
+# coding: utf-8
+
+require 'rake/testtask'
+require 'rdoc/task'
+require "bundler/gem_tasks"
+
+#Generate internal documentation with rdoc.
+RDoc::Task.new do |rdoc|
+  rdoc.rdoc_dir = "rdoc"
+
+  #List out all the files to be documented.
+  rdoc.rdoc_files.include("lib/**/*.rb", "license.txt", "README.md")
+
+  #Make all access levels visible.
+  rdoc.options << '--visibility' << 'private'
+  #rdoc.options << '--verbose'
+  #rdoc.options << '--coverage-report'
+
+  #Set a title.
+  rdoc.options << '--title' << 'Mystiko Internals'
+end
+
+#Run the mystiko unit test suite.
+Rake::TestTask.new do |t|
+  #List out all the unit test files.
+  t.test_files = FileList['tests/**/*.rb']
+  t.verbose = false
+  t.warning = true
+end
+
+desc "Run a scan for smelly code!"
+task :reek do |t|
+  `reek --no-color lib > reek.txt`
+end
+
+desc "What version of mystiko is this?"
+task :vers do |t|
+  puts
+  puts "Mystiko version = #{Mystiko::VERSION}"
+end

data/reek.txt

@@ -0,0 +1 @@
+0 total warnings

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification
+name: mystiko
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Peter Camilleri
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-05-29 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: minitest_visible
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+- !ruby/object:Gem::Dependency
+  name: mini_readline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.8
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.4.8
+description: A temp place holder. Work in progress.
+email:
+- peter.c.camilleri@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- crypto_101/part_01/README.md
+- lib/mystiko.rb
+- lib/mystiko/version.rb
+- mystiko.gemspec
+- rakefile.rb
+- reek.txt
+homepage: http://teuthida-technologies.com/
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: A temp place holder.
+test_files: []
+has_rdoc: