king_tokens 1.0.0

data/.document

@@ -0,0 +1,3 @@
+README.rdoc
+lib/**/*.rb
+LICENSE

data/.gitignore

@@ -0,0 +1,20 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+## Netbeans
+nbproject/*
+
+## PROJECT::GENERAL
+rdoc
+pkg

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 [name of plugin creator]
+
+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.rdoc

@@ -0,0 +1,87 @@
+= KingTokens
+
+Tokens are a usefull way to give users access to an application. This can be for a limited time or just once.
+Just think of password resets, changing email, protected rss feed urls, timed out private links, .. KingTokens are your easy way out in such cases 
+
+This plugin consists of two parts:
+
+* an ActiveRecord model class TokenCode, which maps to the token table in the db 
+* a module Tokenizer mixed into ActiveRecord::Base, providing your models with the possibility to define tokens
+
+KingTokens map polymorphic to other objects, through the can_has_tokens :a_tokens_name call
+
+== Install
+
+Get it as gem (hosted on gemcutter.org)
+  gem install king_tokens
+
+Or download it from github and use it as rails plugin
+
+setup your token db like defined in the test schema => test/schema.rb
+
+== Example
+
+Define a token on a model
+  class User
+    can_has_tokens :forgot_password
+  end
+
+Set and get a user by token in a controller
+  class UsersController
+    # form with email so user can send himself a password reset link
+    def lost_password      
+      if request.post?
+          #create users forgot_password_token
+          @user.set_forgot_password_token
+          .....
+      end
+    end
+
+    # Lookup user by lost_pass_code, send him to his password_edit page
+    # params[:code] contains the forgot_passwd token
+    def change_password
+      # identify by forgot_password_token in params[:code]
+      user = User.find_by_valid_token(:forgot_password,  params[:code])
+      #expire token
+      user.get_forgot_password_token.use!
+      ...
+    end
+  end
+
+== Docs
+
+To get a full understanding of the usage also read the tests. For QM you might check the coverage report in coverage/index.html
+
+=== Token definition inside an ActiveRecord object:
+  
+Add a token with the name forgot_pasword to an object.  
+  can_has_tokens :forgot_password 
+A token with the name change email valid for 3 days
+  can_has_tokens :change_email, {:days_valid => 3}
+
+=== Instance methods added to the ActiveRecord object:
+Set a new token and removing any existing one
+  user.set_forgot_password_token
+Get the token string  
+  user.forgot_password_token
+Check if the user has such a token, returns boolean true
+  user.forgot_password_token?
+Get the token object  
+  user.get_forgot_password_token
+Get the token object by name  
+  user.token(:forgot_password)  
+Low level function to create a token with special options, overriding the ones set in the class definition
+  user.create_token(:token_name, :valid => 2.days.from_now)
+
+
+=== Class methods
+
+Find a user by a specific token which must be valid
+  User.find_by_valid_token(:token_name, 'a token string')
+Find a user by specific token, without valid check  
+  User.find_by_token(:forgot_password, 'a token string')
+  
+  User.find_token
+
+
+Copyright (c) 2008-2010 Michael Bumann, Georg Leciejewski released under the MIT license

data/Rakefile

@@ -0,0 +1,40 @@
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "king_tokens"
+    gem.summary = %Q{Access tokens for any active record object}
+    gem.description = %Q{Tokens are a usefull way to give users access to an application. This can be for a limited time or just once. Just think of password resets, changing email, protected rss feed urls, timed out private links}
+    gem.email = "gl@salesking.eu"
+    gem.homepage = "http://github.com/schorsch/king_tokens"
+    gem.authors = ["Georg Leciejewski"]
+    gem.add_development_dependency "thoughtbot-shoulda", ">= 0"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the tokenizer plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the tokenizer plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'KingTokens'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/coverage/index.html

@@ -0,0 +1,112 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html lang='en' xml:lang='en' xmlns='http://www.w3.org/1999/xhtml'>
+  <head>
+    <title>
+      C0 code coverage information
+    </title>
+    <style type='text/css'>
+      body { background-color: rgb(240, 240, 245); }
+    </style>
+    <style type='text/css'>
+      span.cross-ref-title { font-size: 140%; } span.cross-ref a {
+      text-decoration: none; } span.cross-ref { background-color:#f3f7fa;
+      border: 1px dashed #333; margin: 1em; padding: 0.5em; overflow: hidden; }
+      a.crossref-toggle { text-decoration: none; } span.marked0 {
+      background-color: rgb(185, 210, 200); display: block; } span.marked1 {
+      background-color: rgb(190, 215, 205); display: block; } span.inferred0 {
+      background-color: rgb(175, 200, 200); display: block; } span.inferred1 {
+      background-color: rgb(180, 205, 205); display: block; } span.uncovered0 {
+      background-color: rgb(225, 110, 110); display: block; } span.uncovered1 {
+      background-color: rgb(235, 120, 120); display: block; } span.overview {
+      border-bottom: 8px solid black; } div.overview { border-bottom: 8px solid
+      black; } body { font-family: verdana, arial, helvetica; } div.footer {
+      font-size: 68%; margin-top: 1.5em; } h1, h2, h3, h4, h5, h6 {
+      margin-bottom: 0.5em; } h5 { margin-top: 0.5em; } .hidden { display: none;
+      } div.separator { height: 10px; } /* Commented out for better readability,
+      esp. on IE */ /* table tr td, table tr th { font-size: 68%; } td.value
+      table tr td { font-size: 11px; } */ table.percent_graph { height: 12px;
+      border: #808080 1px solid; empty-cells: show; } table.percent_graph
+      td.covered { height: 10px; background: #00f000; } table.percent_graph
+      td.uncovered { height: 10px; background: #e00000; } table.percent_graph
+      td.NA { height: 10px; background: #eaeaea; } table.report {
+      border-collapse: collapse; width: 100%; } table.report td.heading {
+      background: #dcecff; border: #d0d0d0 1px solid; font-weight: bold;
+      text-align: center; } table.report td.heading:hover { background: #c0ffc0;
+      } table.report td.text { border: #d0d0d0 1px solid; } table.report
+      td.value, table.report td.lines_total, table.report td.lines_code {
+      text-align: right; border: #d0d0d0 1px solid; } table.report tr.light {
+      background-color: rgb(240, 240, 245); } table.report tr.dark {
+      background-color: rgb(230, 230, 235); } 
+    </style>
+    <script type='text/javascript'>
+       // <![CDATA[ function toggleCode( id ) { if ( document.getElementById )
+      elem = document.getElementById( id ); else if ( document.all ) elem =
+      eval( "document.all." + id ); else return false; elemStyle = elem.style;
+      if ( elemStyle.display != "block" ) { elemStyle.display = "block" } else {
+      elemStyle.display = "none" } return true; } // Make cross-references
+      hidden by default document.writeln( "<style
+      type=\"text/css\">span.cross-ref { display: none }</style>" ) // ]]> 
+    </script>
+  </head>
+  <body>
+    <h3>
+      C0 code coverage information
+    </h3>
+    <p>
+      Generated on Sun Dec 07 02:06:42 +0100 2008 with 
+      <a href='http://eigenclass.org/hiki/rcov'>
+        rcov 0.8.1.2
+      </a>
+    </p>
+    <hr />
+    <table class='report'> <thead> <tr> <td class='heading'> Name </td> <td
+    class='heading'> Total lines </td> <td class='heading'> Lines of code </td>
+    <td class='heading'> Total coverage </td> <td class='heading'> Code coverage
+    </td> </tr> </thead> <tbody> <tr class='light'> <td> TOTAL </td> <td
+    class='lines_total'> <tt> 201 </tt> </td> <td class='lines_code'> <tt> 109
+    </tt> </td> <td> <table cellspacing='0' align='right' cellpadding='0'> <tr>
+    <td> <tt class='coverage_total'> 100.0% </tt> &nbsp; </td> <td> <table
+    class='percent_graph' cellspacing='0' width='100' cellpadding='0'> <tr> <td
+    class='covered' width='100' /> <td class='uncovered' width='0' /> </tr>
+    </table> </td> </tr> </table> </td> <td> <table cellspacing='0'
+    align='right' cellpadding='0'> <tr> <td> <tt class='coverage_code'> 100.0%
+    </tt> &nbsp; </td> <td> <table class='percent_graph' cellspacing='0'
+    width='100' cellpadding='0'> <tr> <td class='covered' width='100' /> <td
+    class='uncovered' width='0' /> </tr> </table> </td> </tr> </table> </td>
+    </tr> <tr class='dark'> <td> <a href='lib-token_code_rb.html'>
+    lib/token_code.rb </a> </td> <td class='lines_total'> <tt> 80 </tt> </td>
+    <td class='lines_code'> <tt> 46 </tt> </td> <td> <table cellspacing='0'
+    align='right' cellpadding='0'> <tr> <td> <tt class='coverage_total'> 100.0%
+    </tt> &nbsp; </td> <td> <table class='percent_graph' cellspacing='0'
+    width='100' cellpadding='0'> <tr> <td class='covered' width='100' /> <td
+    class='uncovered' width='0' /> </tr> </table> </td> </tr> </table> </td>
+    <td> <table cellspacing='0' align='right' cellpadding='0'> <tr> <td> <tt
+    class='coverage_code'> 100.0% </tt> &nbsp; </td> <td> <table
+    class='percent_graph' cellspacing='0' width='100' cellpadding='0'> <tr> <td
+    class='covered' width='100' /> <td class='uncovered' width='0' /> </tr>
+    </table> </td> </tr> </table> </td> </tr> <tr class='light'> <td> <a
+    href='lib-tokenizer_rb.html'> lib/tokenizer.rb </a> </td> <td
+    class='lines_total'> <tt> 121 </tt> </td> <td class='lines_code'> <tt> 63
+    </tt> </td> <td> <table cellspacing='0' align='right' cellpadding='0'> <tr>
+    <td> <tt class='coverage_total'> 100.0% </tt> &nbsp; </td> <td> <table
+    class='percent_graph' cellspacing='0' width='100' cellpadding='0'> <tr> <td
+    class='covered' width='100' /> <td class='uncovered' width='0' /> </tr>
+    </table> </td> </tr> </table> </td> <td> <table cellspacing='0'
+    align='right' cellpadding='0'> <tr> <td> <tt class='coverage_code'> 100.0%
+    </tt> &nbsp; </td> <td> <table class='percent_graph' cellspacing='0'
+    width='100' cellpadding='0'> <tr> <td class='covered' width='100' /> <td
+    class='uncovered' width='0' /> </tr> </table> </td> </tr> </table> </td>
+    </tr> </tbody> </table>
+    <hr />
+    <p> Generated using the <a href='http://eigenclass.org/hiki.rb?rcov'> rcov
+    code coverage analysis tool for Ruby </a> version 0.8.1.2. </p>
+    <p>
+      <a href='http://validator.w3.org/check/referer'>
+        <img src='http://www.w3.org/Icons/valid-xhtml11' height='31' alt='Valid XHTML 1.1!' width='88' />
+      </a>
+      <a href='http://jigsaw.w3.org/css-validator/check/referer'>
+        <img src='http://jigsaw.w3.org/css-validator/images/vcss' alt='Valid CSS!' style='border:0;width:88px;height:31px' />
+      </a>
+    </p>
+  </body>
+</html>

data/coverage/lib-token_code_rb.html

@@ -0,0 +1,290 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html lang='en' xml:lang='en' xmlns='http://www.w3.org/1999/xhtml'>
+  <head>
+    <title>
+      lib/token_code.rb - C0 code coverage information
+    </title>
+    <style type='text/css'>
+      body { background-color: rgb(240, 240, 245); }
+    </style>
+    <style type='text/css'>
+      span.cross-ref-title { font-size: 140%; } span.cross-ref a {
+      text-decoration: none; } span.cross-ref { background-color:#f3f7fa;
+      border: 1px dashed #333; margin: 1em; padding: 0.5em; overflow: hidden; }
+      a.crossref-toggle { text-decoration: none; } span.marked0 {
+      background-color: rgb(185, 210, 200); display: block; } span.marked1 {
+      background-color: rgb(190, 215, 205); display: block; } span.inferred0 {
+      background-color: rgb(175, 200, 200); display: block; } span.inferred1 {
+      background-color: rgb(180, 205, 205); display: block; } span.uncovered0 {
+      background-color: rgb(225, 110, 110); display: block; } span.uncovered1 {
+      background-color: rgb(235, 120, 120); display: block; } span.overview {
+      border-bottom: 8px solid black; } div.overview { border-bottom: 8px solid
+      black; } body { font-family: verdana, arial, helvetica; } div.footer {
+      font-size: 68%; margin-top: 1.5em; } h1, h2, h3, h4, h5, h6 {
+      margin-bottom: 0.5em; } h5 { margin-top: 0.5em; } .hidden { display: none;
+      } div.separator { height: 10px; } /* Commented out for better readability,
+      esp. on IE */ /* table tr td, table tr th { font-size: 68%; } td.value
+      table tr td { font-size: 11px; } */ table.percent_graph { height: 12px;
+      border: #808080 1px solid; empty-cells: show; } table.percent_graph
+      td.covered { height: 10px; background: #00f000; } table.percent_graph
+      td.uncovered { height: 10px; background: #e00000; } table.percent_graph
+      td.NA { height: 10px; background: #eaeaea; } table.report {
+      border-collapse: collapse; width: 100%; } table.report td.heading {
+      background: #dcecff; border: #d0d0d0 1px solid; font-weight: bold;
+      text-align: center; } table.report td.heading:hover { background: #c0ffc0;
+      } table.report td.text { border: #d0d0d0 1px solid; } table.report
+      td.value, table.report td.lines_total, table.report td.lines_code {
+      text-align: right; border: #d0d0d0 1px solid; } table.report tr.light {
+      background-color: rgb(240, 240, 245); } table.report tr.dark {
+      background-color: rgb(230, 230, 235); } 
+    </style>
+    <script type='text/javascript'>
+       // <![CDATA[ function toggleCode( id ) { if ( document.getElementById )
+      elem = document.getElementById( id ); else if ( document.all ) elem =
+      eval( "document.all." + id ); else return false; elemStyle = elem.style;
+      if ( elemStyle.display != "block" ) { elemStyle.display = "block" } else {
+      elemStyle.display = "none" } return true; } // Make cross-references
+      hidden by default document.writeln( "<style
+      type=\"text/css\">span.cross-ref { display: none }</style>" ) // ]]> 
+    </script>
+    <style type='text/css'>
+      span.run0 { background-color: rgb(178, 204, 255); display: block; }
+      span.run1 { background-color: rgb(178, 206, 255); display: block; }
+      span.run2 { background-color: rgb(178, 209, 255); display: block; }
+      span.run3 { background-color: rgb(178, 211, 255); display: block; }
+      span.run4 { background-color: rgb(178, 214, 255); display: block; }
+      span.run5 { background-color: rgb(178, 218, 255); display: block; }
+      span.run6 { background-color: rgb(178, 220, 255); display: block; }
+      span.run7 { background-color: rgb(178, 223, 255); display: block; }
+      span.run8 { background-color: rgb(178, 225, 255); display: block; }
+      span.run9 { background-color: rgb(178, 228, 255); display: block; }
+      span.run10 { background-color: rgb(178, 232, 255); display: block; }
+      span.run11 { background-color: rgb(178, 234, 255); display: block; }
+      span.run12 { background-color: rgb(178, 237, 255); display: block; }
+      span.run13 { background-color: rgb(178, 239, 255); display: block; }
+      span.run14 { background-color: rgb(178, 242, 255); display: block; }
+      span.run15 { background-color: rgb(178, 246, 255); display: block; }
+      span.run16 { background-color: rgb(178, 248, 255); display: block; }
+      span.run17 { background-color: rgb(178, 251, 255); display: block; }
+      span.run18 { background-color: rgb(178, 253, 255); display: block; }
+      span.run19 { background-color: rgb(178, 255, 253); display: block; }
+      span.run20 { background-color: rgb(178, 255, 249); display: block; }
+      span.run21 { background-color: rgb(178, 255, 247); display: block; }
+      span.run22 { background-color: rgb(178, 255, 244); display: block; }
+      span.run23 { background-color: rgb(178, 255, 242); display: block; }
+      span.run24 { background-color: rgb(178, 255, 239); display: block; }
+      span.run25 { background-color: rgb(178, 255, 235); display: block; }
+      span.run26 { background-color: rgb(178, 255, 233); display: block; }
+      span.run27 { background-color: rgb(178, 255, 230); display: block; }
+      span.run28 { background-color: rgb(178, 255, 228); display: block; }
+      span.run29 { background-color: rgb(178, 255, 225); display: block; }
+      span.run30 { background-color: rgb(178, 255, 221); display: block; }
+      span.run31 { background-color: rgb(178, 255, 219); display: block; }
+      span.run32 { background-color: rgb(178, 255, 216); display: block; }
+      span.run33 { background-color: rgb(178, 255, 214); display: block; }
+      span.run34 { background-color: rgb(178, 255, 211); display: block; }
+      span.run35 { background-color: rgb(178, 255, 207); display: block; }
+      span.run36 { background-color: rgb(178, 255, 205); display: block; }
+      span.run37 { background-color: rgb(178, 255, 202); display: block; }
+      span.run38 { background-color: rgb(178, 255, 200); display: block; }
+      span.run39 { background-color: rgb(178, 255, 197); display: block; }
+      span.run40 { background-color: rgb(178, 255, 193); display: block; }
+      span.run41 { background-color: rgb(178, 255, 191); display: block; }
+      span.run42 { background-color: rgb(178, 255, 188); display: block; }
+      span.run43 { background-color: rgb(178, 255, 186); display: block; }
+      span.run44 { background-color: rgb(178, 255, 183); display: block; }
+      span.run45 { background-color: rgb(178, 255, 179); display: block; }
+      span.run46 { background-color: rgb(179, 255, 178); display: block; }
+      span.run47 { background-color: rgb(182, 255, 178); display: block; }
+      span.run48 { background-color: rgb(184, 255, 178); display: block; }
+      span.run49 { background-color: rgb(187, 255, 178); display: block; }
+      span.run50 { background-color: rgb(191, 255, 178); display: block; }
+      span.run51 { background-color: rgb(193, 255, 178); display: block; }
+      span.run52 { background-color: rgb(196, 255, 178); display: block; }
+      span.run53 { background-color: rgb(198, 255, 178); display: block; }
+      span.run54 { background-color: rgb(201, 255, 178); display: block; }
+      span.run55 { background-color: rgb(205, 255, 178); display: block; }
+      span.run56 { background-color: rgb(207, 255, 178); display: block; }
+      span.run57 { background-color: rgb(210, 255, 178); display: block; }
+      span.run58 { background-color: rgb(212, 255, 178); display: block; }
+      span.run59 { background-color: rgb(215, 255, 178); display: block; }
+      span.run60 { background-color: rgb(219, 255, 178); display: block; }
+      span.run61 { background-color: rgb(221, 255, 178); display: block; }
+      span.run62 { background-color: rgb(224, 255, 178); display: block; }
+      span.run63 { background-color: rgb(226, 255, 178); display: block; }
+      span.run64 { background-color: rgb(229, 255, 178); display: block; }
+      span.run65 { background-color: rgb(233, 255, 178); display: block; }
+      span.run66 { background-color: rgb(235, 255, 178); display: block; }
+      span.run67 { background-color: rgb(238, 255, 178); display: block; }
+      span.run68 { background-color: rgb(240, 255, 178); display: block; }
+      span.run69 { background-color: rgb(243, 255, 178); display: block; }
+      span.run70 { background-color: rgb(247, 255, 178); display: block; }
+      span.run71 { background-color: rgb(249, 255, 178); display: block; }
+      span.run72 { background-color: rgb(252, 255, 178); display: block; }
+      span.run73 { background-color: rgb(255, 255, 178); display: block; }
+      span.run74 { background-color: rgb(255, 252, 178); display: block; }
+      span.run75 { background-color: rgb(255, 248, 178); display: block; }
+      span.run76 { background-color: rgb(255, 246, 178); display: block; }
+      span.run77 { background-color: rgb(255, 243, 178); display: block; }
+      span.run78 { background-color: rgb(255, 240, 178); display: block; }
+      span.run79 { background-color: rgb(255, 238, 178); display: block; }
+      span.run80 { background-color: rgb(255, 234, 178); display: block; }
+      span.run81 { background-color: rgb(255, 232, 178); display: block; }
+      span.run82 { background-color: rgb(255, 229, 178); display: block; }
+      span.run83 { background-color: rgb(255, 226, 178); display: block; }
+      span.run84 { background-color: rgb(255, 224, 178); display: block; }
+      span.run85 { background-color: rgb(255, 220, 178); display: block; }
+      span.run86 { background-color: rgb(255, 218, 178); display: block; }
+      span.run87 { background-color: rgb(255, 215, 178); display: block; }
+      span.run88 { background-color: rgb(255, 212, 178); display: block; }
+      span.run89 { background-color: rgb(255, 210, 178); display: block; }
+      span.run90 { background-color: rgb(255, 206, 178); display: block; }
+      span.run91 { background-color: rgb(255, 204, 178); display: block; }
+      span.run92 { background-color: rgb(255, 201, 178); display: block; }
+      span.run93 { background-color: rgb(255, 198, 178); display: block; }
+      span.run94 { background-color: rgb(255, 196, 178); display: block; }
+      span.run95 { background-color: rgb(255, 192, 178); display: block; }
+      span.run96 { background-color: rgb(255, 189, 178); display: block; }
+      span.run97 { background-color: rgb(255, 187, 178); display: block; }
+      span.run98 { background-color: rgb(255, 184, 178); display: block; }
+      span.run99 { background-color: rgb(255, 182, 178); display: block; }
+      span.run100 { background-color: rgb(255, 178, 178); display: block; } 
+    </style>
+  </head>
+  <body>
+    <h3>
+      C0 code coverage information
+    </h3>
+    <p>
+      Generated on Sun Dec 07 02:06:42 +0100 2008 with 
+      <a href='http://eigenclass.org/hiki/rcov'>
+        rcov 0.8.1.2
+      </a>
+    </p>
+    <hr />
+    <pre><span class='marked0'>Code reported as executed by Ruby looks like
+    this... </span><span class='marked1'>and this: this line is also marked as
+    covered. </span><span class='inferred0'>Lines considered as run by rcov, but
+    not reported by Ruby, look like this, </span><span class='inferred1'>and
+    this: these lines were inferred by rcov (using simple heuristics).
+    </span><span class='uncovered0'>Finally, here&apos;s a line marked as not
+    executed. </span></pre> 
+    <table class='report'> <thead> <tr> <td class='heading'> Name </td> <td
+    class='heading'> Total lines </td> <td class='heading'> Lines of code </td>
+    <td class='heading'> Total coverage </td> <td class='heading'> Code coverage
+    </td> </tr> </thead> <tbody> <tr class='light'> <td> <a
+    href='lib-token_code_rb.html'> lib/token_code.rb </a> </td> <td
+    class='lines_total'> <tt> 80 </tt> </td> <td class='lines_code'> <tt> 46
+    </tt> </td> <td> <table cellspacing='0' align='right' cellpadding='0'> <tr>
+    <td> <tt class='coverage_total'> 100.0% </tt> &nbsp; </td> <td> <table
+    class='percent_graph' cellspacing='0' width='100' cellpadding='0'> <tr> <td
+    class='covered' width='100' /> <td class='uncovered' width='0' /> </tr>
+    </table> </td> </tr> </table> </td> <td> <table cellspacing='0'
+    align='right' cellpadding='0'> <tr> <td> <tt class='coverage_code'> 100.0%
+    </tt> &nbsp; </td> <td> <table class='percent_graph' cellspacing='0'
+    width='100' cellpadding='0'> <tr> <td class='covered' width='100' /> <td
+    class='uncovered' width='0' /> </tr> </table> </td> </tr> </table> </td>
+    </tr> </tbody> </table><pre><span class="marked1"><a name="line1"></a> 1
+    require &quot;digest/sha1&quot; </span><span class="inferred0"><a
+    name="line2"></a> 2 </span><span class="inferred1"><a name="line3"></a> 3 #
+    Class to handle polymorphic tokens </span><span class="marked0"><a
+    name="line4"></a> 4 class TokenCode &lt; ActiveRecord::Base </span><span
+    class="inferred1"><a name="line5"></a> 5 </span><span class="inferred0"><a
+    name="line6"></a> 6 # kick this stament if you dont uses uuids .. or better
+    we make a check?? </span><span class="inferred1"><a name="line7"></a> 7
+    </span><span class="marked0"><a name="line8"></a> 8 usesguid if
+    defined?(usesguid) </span><span class="inferred1"><a name="line9"></a> 9
+    </span><span class="marked0"><a name="line10"></a>10 belongs_to :object,
+    :polymorphic =&gt; true </span><span class="marked1"><a name="line11"></a>11
+    before_create :set_token </span><span class="inferred0"><a
+    name="line12"></a>12 </span><span class="marked1"><a name="line13"></a>13
+    validates_presence_of :name </span><span class="marked0"><a
+    name="line14"></a>14 validates_format_of :name, :with =&gt;
+    /^[a-zA-Z0-9\_\-]+$/ </span><span class="marked1"><a name="line15"></a>15
+    validates_uniqueness_of :name, :scope =&gt; [:object_id, :object_type]
+    #second not really needed if uuid </span><span class="inferred0"><a
+    name="line16"></a>16 </span><span class="marked1"><a name="line17"></a>17
+    def to_s </span><span class="marked0"><a name="line18"></a>18 self.token
+    </span><span class="inferred1"><a name="line19"></a>19 end </span><span
+    class="inferred0"><a name="line20"></a>20 </span><span class="inferred1"><a
+    name="line21"></a>21 # Use a token for an object. </span><span
+    class="inferred0"><a name="line22"></a>22 # Sets the used_at field
+    </span><span class="marked1"><a name="line23"></a>23 def use! </span><span
+    class="marked0"><a name="line24"></a>24 update_attribute(:used_at,Time.now)
+    </span><span class="inferred1"><a name="line25"></a>25 end </span><span
+    class="inferred0"><a name="line26"></a>26 </span><span class="inferred1"><a
+    name="line27"></a>27 # Revoke the usage of a token by emptying its used_at
+    field </span><span class="marked0"><a name="line28"></a>28 def unuse!
+    </span><span class="marked1"><a name="line29"></a>29
+    update_attribute(:used_at,nil) </span><span class="inferred0"><a
+    name="line30"></a>30 end </span><span class="inferred1"><a
+    name="line31"></a>31 </span><span class="marked0"><a name="line32"></a>32
+    def used? </span><span class="marked1"><a name="line33"></a>33 !!
+    read_attribute(:used_at) </span><span class="inferred0"><a
+    name="line34"></a>34 end </span><span class="inferred1"><a
+    name="line35"></a>35 </span><span class="inferred0"><a name="line36"></a>36
+    # Check if the token has expired </span><span class="marked1"><a
+    name="line37"></a>37 def expired? </span><span class="marked0"><a
+    name="line38"></a>38 valid_until &amp;&amp; valid_until &lt; Time.now
+    </span><span class="inferred1"><a name="line39"></a>39 end </span><span
+    class="inferred0"><a name="line40"></a>40 </span><span class="inferred1"><a
+    name="line41"></a>41 # A token is valid to be used if: </span><span
+    class="inferred0"><a name="line42"></a>42 # - its has not been used
+    </span><span class="inferred1"><a name="line43"></a>43 # - its not expired
+    </span><span class="inferred0"><a name="line44"></a>44 # - its valid in
+    terms of AR validation </span><span class="marked1"><a name="line45"></a>45
+    def valid_for_use? </span><span class="marked0"><a name="line46"></a>46
+    valid? &amp;&amp; !used? &amp;&amp; !expired? </span><span
+    class="inferred1"><a name="line47"></a>47 end </span><span
+    class="inferred0"><a name="line48"></a>48 </span><span class="inferred1"><a
+    name="line49"></a>49 </span><span class="marked0"><a name="line50"></a>50
+    def self.delete_used </span><span class="marked1"><a name="line51"></a>51
+    delete_all &quot;used_at IS NOT NULL&quot; </span><span class="inferred0"><a
+    name="line52"></a>52 end </span><span class="inferred1"><a
+    name="line53"></a>53 </span><span class="marked0"><a name="line54"></a>54
+    def self.delete_expired </span><span class="marked1"><a name="line55"></a>55
+    delete_all [&quot;valid_until IS NOT NULL AND valid_until &lt; ? &quot;,
+    Time.now] </span><span class="inferred0"><a name="line56"></a>56 end
+    </span><span class="inferred1"><a name="line57"></a>57 </span><span
+    class="marked0"><a name="line58"></a>58 private </span><span
+    class="inferred1"><a name="line59"></a>59 </span><span class="inferred0"><a
+    name="line60"></a>60 # Generate a token with a default length of 12.
+    </span><span class="inferred1"><a name="line61"></a>61 # Takes a block to
+    validate the token, which should return true/false </span><span
+    class="inferred0"><a name="line62"></a>62 # ==== Parameter </span><span
+    class="inferred1"><a name="line63"></a>63 # size&lt;Integer&gt;:: The length
+    of the token. Defaults to 40 </span><span class="inferred0"><a
+    name="line64"></a>64 # validity&lt;Proc&gt;:: A block to check the validity
+    of the token, see #set_token for usage </span><span class="marked1"><a
+    name="line65"></a>65 def generate_token(size = 40, &amp;validity)
+    </span><span class="inferred0"><a name="line66"></a>66 begin </span><span
+    class="marked1"><a name="line67"></a>67 token = secure_digest(Time.now,
+    &quot;#{self.object_type}#{self.object_id}&quot;, (1..10).map{ rand.to_s
+    }).first(size) </span><span class="marked0"><a name="line68"></a>68 end
+    while !validity.call(token) if block_given? </span><span class="marked1"><a
+    name="line69"></a>69 token </span><span class="inferred0"><a
+    name="line70"></a>70 end </span><span class="inferred1"><a
+    name="line71"></a>71 </span><span class="marked0"><a name="line72"></a>72
+    def secure_digest(*args) </span><span class="marked1"><a
+    name="line73"></a>73 Digest::SHA1.hexdigest(args.flatten.join('--'))
+    </span><span class="inferred0"><a name="line74"></a>74 end </span><span
+    class="inferred1"><a name="line75"></a>75 </span><span class="marked0"><a
+    name="line76"></a>76 def set_token </span><span class="marked1"><a
+    name="line77"></a>77 self.token = generate_token { |token|
+    TokenCode.find_by_token(token).nil? } </span><span class="inferred0"><a
+    name="line78"></a>78 end </span><span class="inferred1"><a
+    name="line79"></a>79 </span><span class="inferred0"><a name="line80"></a>80
+    end </span></pre>
+    <hr />
+    <p> Generated using the <a href='http://eigenclass.org/hiki.rb?rcov'> rcov
+    code coverage analysis tool for Ruby </a> version 0.8.1.2. </p>
+    <p>
+      <a href='http://validator.w3.org/check/referer'>
+        <img src='http://www.w3.org/Icons/valid-xhtml10' height='31' alt='Valid XHTML 1.0!' width='88' />
+      </a>
+      <a href='http://jigsaw.w3.org/css-validator/check/referer'>
+        <img src='http://jigsaw.w3.org/css-validator/images/vcss' alt='Valid CSS!' style='border:0;width:88px;height:31px' />
+      </a>
+    </p>
+  </body>
+</html>