h 1.0.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,13 @@
+Copyright (c) 2011, Cyril Wack <cyril@gosu.fr>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

data/README.textile

@@ -0,0 +1,79 @@
+h1. H
+
+h2. Overview
+
+Very small cryptographic tool that generates on-the-fly custom message digests,
+according to some parameters.
+
+h2. Why?
+
+Because I prefer to put makeup on passwords rather than yield them to Manager™.
+
+h2. Installation
+
+<pre>
+  gem install h
+</pre>
+
+h2. Configuration
+
+H reads its configuration from the YAML <tt>~/.h</tt> file at initialization.
+This file, which should be readable by its owner only, has four parameters:
+
+ * Max length: The maximum length of returned message digests.
+ * Radix: The number of unique digits that compose message digests.
+ * Encryption: A cryptographic hash function in Ruby's Digest module.
+ * Static key: Provides salted messages through concatenation.
+
+h2. Examples
+
+Generate a digest from the system:
+
+<pre>
+  $ h secret
+  t3dpe24xie3y74t
+</pre>
+
+Because no configuration has been detected, this default file was created:
+
+<pre>
+  $ cat ~/.h
+  ---
+  max_length: 15
+  radix: 36
+  encryption: SHA1
+  static_key: foobar
+</pre>
+
+Same operation, from Ruby:
+
+<pre>
+  irb(main):001:0> require "h"
+  true
+  irb(main):002:0> H::Generator.new.input "secret"
+  "t3dpe24xie3y74t"
+</pre>
+
+To prevent your log display the message as a string, do not specify it at first.
+
+<pre>
+  $ h
+  Message: ******
+  t3dpe24xie3y74t
+</pre>
+
+Example with the SHA2 cryptographic hash instead of SHA1, and a custom key:
+
+<pre>
+  $ echo "{max_length: 15, radix: 36, encryption: SHA2, static_key: sun}" > ~/.h
+  $ h secret
+  5gumh4smv1iit23
+</pre>
+
+And now a useless test, with conventional parameters. You can Google the result.
+
+<pre>
+  $ echo "{max_length: 40, radix: 16, encryption: SHA1, static_key: ''}" > ~/.h
+  $ h "The quick brown fox jumps over the lazy dog"
+  2fd4e1c67a2d28fced849ee1bb76e7391b93eb12
+</pre>

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/bin/h

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+
+require 'h'
+
+h = H::Generator.new
+
+if ARGV.first.nil?
+  puts h.prompt
+else
+  puts h.input ARGV.first
+end

data/h.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "h/version"
+
+Gem::Specification.new do |s|
+  s.name        = "h"
+  s.version     = H::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Cyril Wack"]
+  s.email       = ["cyril@gosu.fr"]
+  s.homepage    = "http://github.com/cyril/h"
+  s.summary     = %q{Custom hash generator}
+  s.description = %q{Very small cryptographic tool that generates custom message digests according to some parameters.}
+
+  s.rubyforge_project = "h"
+
+  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/h.rb

@@ -0,0 +1,49 @@
+require 'digest'
+require 'highline/import'
+require 'yaml'
+
+module H
+  class Generator
+    CONF_PATH = File.join(File.expand_path('~'), '.h')
+
+    def initialize
+      unless File.exists?(CONF_PATH)
+        File.open(CONF_PATH, 'w') do |f|
+          YAML.dump({ 'encryption' => 'SHA1',
+                      'static_key' => 'foobar',
+                      'max_length' => 15,
+                      'radix'      => 36 }, f)
+        end
+
+        File.chmod(0600, CONF_PATH)
+      end
+
+      @params = YAML::load_file(CONF_PATH)
+      @params.freeze
+    end
+
+    def input(message)
+      m = message + @params['static_key']
+      d = cryptographic_hash(m)
+      truncate codage(d)
+    end
+
+    def prompt
+      input ask('Message: ') {|q| q.echo = '*' }
+    end
+
+    protected
+
+    def codage(hexdigest)
+      hexdigest.to_i(16).to_s(@params['radix'])
+    end
+
+    def cryptographic_hash(message)
+      Digest.class_eval(@params['encryption']).hexdigest(message)
+    end
+
+    def truncate(string)
+      string[0, @params['max_length']]
+    end
+  end
+end

data/lib/h/version.rb

@@ -0,0 +1,3 @@
+module H
+  VERSION = "1.0.0"
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification 
+name: h
+version: !ruby/object:Gem::Version 
+  hash: 23
+  prerelease: 
+  segments: 
+  - 1
+  - 0
+  - 0
+  version: 1.0.0
+platform: ruby
+authors: 
+- Cyril Wack
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-08 00:00:00 +02:00
+default_executable: 
+dependencies: []
+
+description: Very small cryptographic tool that generates custom message digests according to some parameters.
+email: 
+- cyril@gosu.fr
+executables: 
+- h
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- LICENSE
+- README.textile
+- Rakefile
+- bin/h
+- h.gemspec
+- lib/h.rb
+- lib/h/version.rb
+has_rdoc: true
+homepage: http://github.com/cyril/h
+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: h
+rubygems_version: 1.5.0
+signing_key: 
+specification_version: 3
+summary: Custom hash generator
+test_files: []
+