authtools 0.2.0 → 0.3.0

data/CHANGELOG

@@ -1,5 +1,12 @@
 Authtools changelog.
 
+v0.3.0 [4.07.2010]
+* Added specs
+* Added symbolic names for token sizes (:tiny, :short, :medium, :long)
+* Added tiny (128bit) md5-like token
+* Minor improvments
+* TODO empty 
+
 v0.2.0 [4.07.2010]
 * Improvements in implementation
 * Minor bug fixes

data/Rakefile

@@ -16,29 +16,21 @@ rescue LoadError
   puts "Jeweler not available. Install it with: gem install jeweler"
 end
 
-require 'rake/testtask'
-Rake::TestTask.new(:test) do |test|
-  test.libs << 'lib' << 'test'
-  test.pattern = 'test/**/test_*.rb'
-  test.verbose = true
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
 end
 
-begin
-  require 'rcov/rcovtask'
-  Rcov::RcovTask.new do |test|
-    test.libs << 'test'
-    test.pattern = 'test/**/test_*.rb'
-    test.verbose = true
-  end
-rescue LoadError
-  task :rcov do
-    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
-  end
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
 end
 
-task :test => :check_dependencies
+task :spec => :check_dependencies
 
-task :default => :test
+task :default => :spec
 
 require 'rake/rdoctask'
 Rake::RDocTask.new do |rdoc|

data/VERSION

@@ -1 +1 @@
-0.2.0
+0.3.0

data/authtools.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{authtools}
-  s.version = "0.2.0"
+  s.version = "0.3.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Kris Kowalik"]
@@ -15,8 +15,7 @@ h or unique token and check if specified password string is valid for stored has
   s.email = %q{kriss.kowalik@gmail.com}
   s.extra_rdoc_files = [
     "LICENSE",
-     "README.rdoc",
-     "TODO"
+     "README.rdoc"
   ]
   s.files = [
     ".gitignore",
@@ -24,19 +23,25 @@ h or unique token and check if specified password string is valid for stored has
      "LICENSE",
      "README.rdoc",
      "Rakefile",
-     "TODO",
      "VERSION",
      "authtools.gemspec",
      "lib/authtools.rb",
      "lib/authtools/common.rb",
      "lib/authtools/password.rb",
-     "lib/authtools/token.rb"
+     "lib/authtools/token.rb",
+     "spec/authtools_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb"
   ]
   s.homepage = %q{http://github.com/kriss/authtools}
   s.rdoc_options = ["--charset=UTF-8"]
   s.require_paths = ["lib"]
   s.rubygems_version = %q{1.3.6}
   s.summary = %q{Usefull staff for tokens, passwords and authorization}
+  s.test_files = [
+    "spec/spec_helper.rb",
+     "spec/authtools_spec.rb"
+  ]
 
   if s.respond_to? :specification_version then
     current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION

data/lib/authtools/token.rb

@@ -1,4 +1,5 @@
 require 'digest/sha2'
+require 'digest/md5'
 require 'authtools/common'
 
 module Authtools
@@ -6,15 +7,21 @@ module Authtools
     extend Common
     extend self
       
-    SHORT = 256
+    TINY   = 128
+    SHORT  = 256
     MEDIUM = 384
-    LONG = 512
+    LONG   = 512
     
     # Generates new token with specified size.
     #
     def generate(size=SHORT)
-      hash = Digest::SHA2.new(size)
-      hash << self.salt
+      size = const_get(size.to_s.upcase) if [:tiny, :short, :medium, :long].include?(size)
+      if size > 128
+        hash = Digest::SHA2.new(size)
+        hash << self.salt
+      else
+        hash = Digest::MD5.hexdigest(self.salt)
+      end
       hash.to_s
     end
 
@@ -24,22 +31,10 @@ module Authtools
       generate(size)
     end
     
-    # Shortcut for generate 256 bit token.
-    #
-    def short
-      generate(SHORT)
-    end
-    
-    # Shortcut for generate 384 bit token.
-    #
-    def medium
-      generate(MEDIUM)
-    end
-    
-    # Shortcut for generate 512 bit token.
-    #
-    def long
-      generate(LONG)
+    %w{tiny short medium long}.each do |label|
+      module_eval do 
+        define_method(label) { generate(label.to_sym) }
+      end
     end
   end
 end

data/spec/authtools_spec.rb

@@ -0,0 +1,76 @@
+require File.dirname(__FILE__) + '/spec_helper.rb'
+
+describe "Authtools" do 
+  describe "Password" do 
+    it "should be properly extended by Authtools::Common" do 
+      Authtools::Password.should respond_to :salt
+    end 
+    
+    before do 
+      @hash = Authtools::Password.generate('secret')
+    end
+    
+    it "should allow to generate hash based on given string" do 
+      @hash.should_not be_nil
+      @hash.size.should == 192
+    end 
+    
+    it "should allow to retrieve salt from stored hash" do 
+      salt = Authtools::Password.get_salt(@hash)
+      salt.should_not be_nil
+      salt.size.should == 64
+      @hash.match(/#{salt}\Z/).should_not be_nil 
+    end
+    
+    it "should allow to check if given hash was generated from specified password" do 
+      Authtools::Password.check('secret', @hash).should == true
+      Authtools::Password.check('not secret', @hash).should == false
+    end 
+  end
+  
+  describe "Token" do 
+    it "should be properly extended by Authtools::Common" do 
+      Authtools::Token.should respond_to :salt
+    end
+    
+    it "should define shortcuts for each token size" do 
+      Authtools::Token.should respond_to :tiny
+      Authtools::Token.should respond_to :short
+      Authtools::Token.should respond_to :medium
+      Authtools::Token.should respond_to :long
+    end
+    
+    it "should allow to generate 128bit random token" do 
+      Authtools::Token.generate(:tiny).size.should == 32
+      Authtools::Token.tiny.size.should == 32
+    end
+    
+    it "should allow to generate 256bit random token" do 
+      Authtools::Token.generate(:short).size.should == 64
+      Authtools::Token.short.size.should == 64
+    end
+    
+    it "should allow to generate 384bit random token" do 
+      Authtools::Token.generate(:medium).size.should == 96
+      Authtools::Token.medium.size.should == 96
+    end
+    
+    it "should allow to generate 512bit random token" do 
+      Authtools::Token.generate(:long).size.should == 128
+      Authtools::Token.long.size.should == 128
+    end 
+    
+    it "should generate 256bit token by default" do 
+      Authtools::Token.generate.size.should == 64
+    end
+  end
+  
+  describe "Common" do 
+    include Authtools::Common
+    
+    it "should provide method for generating pseudo-random salt" do
+      salt.should_not be_nil
+      salt.size.should == 64
+    end
+  end
+end

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,8 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'authtools'
+require 'spec'
+require 'spec/autorun'
+
+Spec::Runner.configure do |config|
+end

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 2
+  - 3
   - 0
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors: 
 - Kris Kowalik
@@ -29,20 +29,21 @@ extensions: []
 extra_rdoc_files: 
 - LICENSE
 - README.rdoc
-- TODO
 files: 
 - .gitignore
 - CHANGELOG
 - LICENSE
 - README.rdoc
 - Rakefile
-- TODO
 - VERSION
 - authtools.gemspec
 - lib/authtools.rb
 - lib/authtools/common.rb
 - lib/authtools/password.rb
 - lib/authtools/token.rb
+- spec/authtools_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
 has_rdoc: true
 homepage: http://github.com/kriss/authtools
 licenses: []
@@ -73,5 +74,6 @@ rubygems_version: 1.3.6
 signing_key: 
 specification_version: 3
 summary: Usefull staff for tokens, passwords and authorization
-test_files: []
-
+test_files: 
+- spec/spec_helper.rb
+- spec/authtools_spec.rb

data/TODO

@@ -1,3 +0,0 @@
-TODO list:
-
-* Write specs!