gibberish 0.0.1

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+gemspec
+gem 'rspec'

data/Gemfile.lock

@@ -0,0 +1,24 @@
+PATH
+  remote: .
+  specs:
+    gibberish (0.0.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.2)
+    rspec (2.5.0)
+      rspec-core (~> 2.5.0)
+      rspec-expectations (~> 2.5.0)
+      rspec-mocks (~> 2.5.0)
+    rspec-core (2.5.1)
+    rspec-expectations (2.5.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.5.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  gibberish!
+  rspec

data/README.markdown

@@ -0,0 +1,42 @@
+# Gibberish - Stop looking up encryption code snippets!
+
+Gibberish is an opinionated cryptography library for Ruby. Its objective is easy to use
+encryption in Ruby while remaining secure.
+
+## Digests
+
+    Gibberish::MD5("somedata")
+    #=> aefaf7502d52994c3b01957636a3cdd2
+
+    Gibberish::SHA1("somedata")
+    #=> efaa311ae448a7374c122061bfed952d940e9e37
+
+    Gibberish::SHA256("somedata")
+    #=> 87d149cb424c0387656f211d2589fb5b1e16229921309e98588419ccca8a7362
+
+## AES
+
+Defaults to 256 bit CBC encryption
+
+    cipher = Gibberish::AES.new("p4ssw0rd")
+    cipher.enc("Some top secret data")
+    #=> U2FsdGVkX187oKRbgDkUcMKaFfB5RsXQj/X4mc8X3lsUVgwb4+S55LQo6f6N\nIDMX
+
+    cipher.dec("U2FsdGVkX187oKRbgDkUcMKaFfB5RsXQj/X4mc8X3lsUVgwb4+S55LQo6f6N\nIDMX")
+    #=> "Some top secret data"
+
+Gibberish AES is fully compatible with default OpenSSL on the command line
+
+    echo "U2FsdGVkX187oKRbgDkUcMKaFfB5RsXQj/X4mc8X3lsUVgwb4+S55LQo6f6N\nIDMX\n" | \
+    openssl enc -d -aes-256-cbc -a -k p4ssw0rd
+
+## HMAC
+
+Defaults to 256 bit digest
+
+    Gibberish::HMAC("key", "some data")
+    #=> 521677c580722c5c52fa15d978e8656341c4f3c5
+
+## PKI
+
+Coming soon

data/gibberish.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "gibberish/version"
+
+Gem::Specification.new do |s|
+  s.name        = "gibberish"
+  s.version     = Gibberish::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Mark Percival"]
+  s.email       = ["mark@markpercival.us"]
+  s.homepage    = "http://github.com/mdp/gibberish"
+  s.summary     = %q{An opinionated ruby encryption library}
+  s.description = %q{Supports OpenSSL compatible AES, HMAC, and RSA encryption}
+
+  s.rubyforge_project = "gibberish"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/gibberish.rb

@@ -0,0 +1,5 @@
+require 'openssl'
+require 'base64'
+require 'gibberish/aes'
+require 'gibberish/digest'
+require 'gibberish/hmac'

data/lib/gibberish/aes.rb

@@ -0,0 +1,48 @@
+module Gibberish
+  class AES
+
+    attr_reader :password, :size, :cipher
+    def initialize(password, size=256)
+      @password = password
+      @size = size
+      @cipher = OpenSSL::Cipher::Cipher.new("aes-#{size}-cbc")
+    end
+
+    def encrypt(data, opts={})
+      salt = generate_salt
+      setup_cipher(:encrypt, salt)
+      e = cipher.update(data) + cipher.final
+      e = "Salted__#{salt}#{e}" #OpenSSL compatible
+      if opts[:binary]
+        e
+      else
+        Base64.encode64(e)
+      end
+    end
+    alias :enc :encrypt
+    alias :e :encrypt
+
+    def decrypt(data, opts={})
+      data = Base64.decode64(data)
+      salt = data[8..15]
+      data = data[16..-1]
+      setup_cipher(:decrypt, salt)
+      cipher.update(data) + cipher.final
+    end
+    alias :dec :decrypt
+    alias :d :decrypt
+
+    private
+
+    def generate_salt
+      s = ''
+      8.times {s << rand(255).chr}
+      s
+    end
+
+    def setup_cipher(method, salt)
+      cipher.send(method)
+      cipher.pkcs5_keyivgen(password, salt, 1)
+    end
+  end
+end

data/lib/gibberish/digest.rb

@@ -0,0 +1,41 @@
+module Gibberish
+  class Digest
+
+    def self.sha1(val, opts={})
+      if opts[:binary]
+        OpenSSL::Digest::SHA1.digest(val)
+      else
+        OpenSSL::Digest::SHA1.hexdigest(val)
+      end
+    end
+
+    def self.sha256(val, opts={})
+      if opts[:binary]
+        OpenSSL::Digest::SHA256.digest(val)
+      else
+        OpenSSL::Digest::SHA256.hexdigest(val)
+      end
+    end
+
+    def self.md5(val, opts={})
+      if opts[:binary]
+        OpenSSL::Digest::MD5.digest(val)
+      else
+        OpenSSL::Digest::MD5.hexdigest(val)
+      end
+    end
+  end
+
+  def self.SHA1(val, opts={})
+    Digest.sha1(val,opts)
+  end
+
+  def self.SHA256(val, opts={})
+    Digest.sha256(val,opts)
+  end
+
+  def self.MD5(val, opts={})
+    Digest.md5(val,opts)
+  end
+
+end

data/lib/gibberish/hmac.rb

@@ -0,0 +1,21 @@
+module Gibberish
+  class HMAC
+    DIGEST = {
+      :sha1 => OpenSSL::Digest::Digest.new('sha1'),
+      :sha256 => OpenSSL::Digest::Digest.new('sha256')
+    }
+
+    def self.digest(key, data, opts={})
+      digest_type = opts[:digest] || :sha1
+      if opts[:binary]
+        OpenSSL::HMAC.digest(DIGEST[digest_type], key, data)
+      else
+        OpenSSL::HMAC.hexdigest(DIGEST[digest_type], key, data)
+      end
+    end
+  end
+
+  def self.HMAC(key, data, opts={})
+    Gibberish::HMAC.digest(key, data, opts)
+  end
+end

data/lib/gibberish/version.rb

@@ -0,0 +1,3 @@
+module Gibberish
+  VERSION = "0.0.1"
+end

data/spec/aes_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+
+describe "the aes cipher" do
+
+  before do
+    @cipher = Gibberish::AES.new("password")
+  end
+
+  it "should encrypt text and be compatible with OpenSSL CLI" do
+    secret_text = "Made with Gibberish"
+    encrypted = @cipher.e(secret_text)
+    from_openssl = `echo "#{encrypted}" | openssl enc -d -aes-256-cbc -a -k password`
+    from_openssl.should eql(secret_text)
+  end
+
+  it "should decrypt base64 encoded data from the OpenSSL CLI" do
+    secret_text = "Made with Gibberish"
+    from_openssl = `echo #{secret_text} | openssl enc -aes-256-cbc -a -k password`
+    decrypted_text = @cipher.d(from_openssl).chomp
+    decrypted_text.should eql(secret_text)
+  end
+
+end

data/spec/digest_spec.rb

@@ -0,0 +1,17 @@
+require 'spec_helper'
+
+describe "A variety of digest methods" do
+
+  it "should work with MD5" do
+    Gibberish::MD5("password").should eql("5f4dcc3b5aa765d61d8327deb882cf99")
+  end
+
+  it "should work with SHA1" do
+    Gibberish::SHA1("password").should eql("5baa61e4c9b93f3f0682250b6cf8331b7ee68fd8")
+  end
+
+  it "should work with SHA256" do
+    Gibberish::SHA256("password").should eql("5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8")
+  end
+
+end

data/spec/hmac_spec.rb

@@ -0,0 +1,9 @@
+require 'spec_helper'
+
+describe "HMAC" do
+
+  it "should hopefully work" do
+    Gibberish::HMAC("password", "data").should eql("08d13c72bed7ace5efadc09df109a78a5d713097")
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+require 'rubygems'
+require 'bundler/setup'
+
+require 'gibberish'
+
+RSpec.configure do |config|
+  # some (optional) config here
+end

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification 
+name: gibberish
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Mark Percival
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-28 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Supports OpenSSL compatible AES, HMAC, and RSA encryption
+email: 
+- mark@markpercival.us
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- Gemfile
+- Gemfile.lock
+- README.markdown
+- gibberish.gemspec
+- lib/gibberish.rb
+- lib/gibberish/aes.rb
+- lib/gibberish/digest.rb
+- lib/gibberish/hmac.rb
+- lib/gibberish/version.rb
+- spec/aes_spec.rb
+- spec/digest_spec.rb
+- spec/hmac_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/mdp/gibberish
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: gibberish
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: An opinionated ruby encryption library
+test_files: 
+- spec/aes_spec.rb
+- spec/digest_spec.rb
+- spec/hmac_spec.rb
+- spec/spec_helper.rb