keytar 0.1.1 → 0.9.0

data/.rvmrc

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+
+ruby_string="ree-1.8.7-2011.03"
+gemset_name="keytar"
+
+if rvm list strings | grep -q "${ruby_string}" ; then
+
+  rvm use "${ruby_string}@${gemset_name}" --create
+
+  # Complain if bundler isn't installed
+  if [[ -z "`gem which bundler 2>&1 | grep -v ERROR`" ]]; then
+    echo "You need bundler:"
+    echo ""
+    echo "    gem install bundler"
+    echo ""
+  fi
+else
+  echo "${ruby_string} was not found, please run 'rvm install ${ruby_string}' and then cd back into the project directory."
+fi

data/Gemfile

@@ -1,13 +1,13 @@
 source 'http://rubygems.org'
 
 group :development do
-  gem 'activerecord' ## not needed if you're just using KeyBuilder
-  gem 'activesupport' ## KeyBuilder relys on several helper methods, can be re-factored to not need this
-  gem 'rake'
-  gem 'jeweler'
+  gem 'activerecord', '~>3.0.4' ## not needed if you're just using KeyBuilder
+  gem 'activesupport', '~>3.0.4' ## KeyBuilder relies on several helper methods, can be re-factored to not need this
+  gem 'rake', '~>0.8.7'
+  gem 'jeweler', '~>1.5.2'
 end
 
 group :test do
-  gem 'sqlite3'
+  gem 'sqlite3', '~> 1.3.3'
   gem 'rspec', '~> 2.5'
 end

data/Gemfile.lock

@@ -36,9 +36,9 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
-  activerecord
-  activesupport
-  jeweler
-  rake
+  activerecord (~> 3.0.4)
+  activesupport (~> 3.0.4)
+  jeweler (~> 1.5.2)
+  rake (~> 0.8.7)
   rspec (~> 2.5)
-  sqlite3
+  sqlite3 (~> 1.3.3)

data/README.md

@@ -2,41 +2,40 @@ Keytar
 ======
 
 **1.** A keyboard that is designed to be played standing up, like a guitar.  
-**2.** A crazy simple ruby-on-rails library for making re-usable keys  
+**2.** A crazy simple ruby-on-rails library for making re-usable keys (the kind you use in key/value stores)
 
 KeyBuilder
 ----------
 
-Keytar is a Ruby on Rails gem for KeyBuilder. Use KeyBuilder to automatically generate keys based on class name instead of cluttering model definitions with tons of redundant key method declarations. 
+Keytar is an amazingly easy way to auto-magically generate keys for all of your NOSQL key needs. Are you using Redis, Memcache, MongoDB, Cassandra, or another hot key-value store? Then use **keytar**! It automatically generates keys based on class name instead of cluttering model definitions with tons of redundant key method declarations. 
 
-quit littering your code with junk like this:
+___quit___ littering your code with junk like this:
 
+    class User
       def some_distributed_no_sql_datastore_key
         "foos:some_distributed_no_sql_datastore:#{self.id}"
       end
-      
-Seriously, quit it
-
+    end
 
+Seriously, ___quit it___!
 
 
 Installation
 ------------
-    gem install keytar
-
-in your Gemfile add
+In your Ruby on Rails Gemfile add
 
     gem 'keytar'
 
-now, you're good to go. See below for examples and config documentation
+then run
 
-Example: 
---------
+    bundle install
 
-Keytar in action
+now, you're good to go. Not using RoR? No worries, just drop `include Keytar` in any Ruby model you want.
 
-    class User < ActiveRecord::Base
-    end
+
+Example: 
+--------
+keytar auto-magically generates keys using method names ending in `"_key"` or simply "key".
 
     User.key #=> "user"
     User.memcache_key #=> "user:memcache"
@@ -49,74 +48,81 @@ Keytar in action
     u.sweet_key #=> "users:sweet:2"
     
 
+
 It's that simple
 
 Config
 ------
 
-There's a ton of configuration options. Call the below methods in your class to configure it's options. 
+These options can be configured by passing in a hash to keyfig:
+
+    class User < ActiveRecord::Base
+      keyfig :key_delimiter => ":", :key_order => [:unique, :suffix], :key_prefix => "before"
+    end
+
+Or by calling class methods
 
     class User < ActiveRecord::Base
       key_delimiter ":"
       key_order [:prefix, :base, :name, :unique, :args, :suffix]
       key_prefix nil
-      key_suffix nil
-      key_pluralize_instances true
-      key_plural nil
-      key_case :downcase
-      key_unique "id"
     end
 
+Config Options Breakdown
+------------------------
 Here is a run down of what each does  
 
+**key_delimeter** sets the separating argument in keys
+
     User.key_delimeter "|"
     user.redis_key #=> "users|redis"
 
-key_delimeter sets the separating argument in keys
+
+**key_order** sets the location of key parts, if a symbol is omitted, it will not show up in the final key
 
     User.key_order [:name, :base]
     user.redis_key #=> "redis:users"
-
-key_order sets the location of key parts, if a symbol is omitted, it will not show up in the final key
     
+**key_unique** sets the unique value of the instance that is used to build the key
+
+By default all instance keys have an identifying unique element included in the key, specifying `key_unique` allows you to change the field that is used to specify a unique key. (defaults to database backed id, but will not use id if object.id == object.object_id)
+
+    user = User.create(:username => "Schneems", :id => 9)
+    user.id #=> 9
+    user.redis_key #=> "users:redis:9"
+
+    User.key_unique("username")
+    user.redis_key #=> "users:redis:schneems"
+
+**key_prefix** sets the a prefix to your key for that class
+
     User.key_prefix "woot"
     user.redis_key #=> "woot:users:redis"
     
-key_prefix sets the a prefix to your key for that class
+**key_suffix** sets the a suffix to your key for that class
 
     User.key_suffix "slave"
     user.redis_key #=> "users:redis:slave"
 
-key_suffix sets the a suffix to your key for that class
+**`key_pluralize_instances`** allows you to toggle pluralizing instance keys (note the 's' in 'users' is not there)
 
     User.key_pluralize_instances false
     user.redis_key #=> "user:redis"
     
-key_pluralize_instances allows you to toggle pluralizing instance keys (note the 's' in 'users' is not there)
+
+**key_plural** allows you to over-ride the default pluralize method with custom spelling
 
     User.key_plural "uzerz"
     user.redis_key #=> "uzerz:redis"
 
-key_plural allows you to over-ride the default pluralize method with custom spelling
+**key_case** allows you to specify the case of your key
 
     User.key_case :upcase
     user.redis_key #=> "USERS:REDIS"
 
-key_case allows you to specify the case of your key
-
-    User.key_unique "username"
-
-`key_unique`: By default all instance keys have an identifying unique element included in the key, specifying `key_unique` allows you to change the field that is used to specify a unique key. (defaults to database backed id, but will not use id if object.id == object.object_id)
-
-    user = User.create(:username => "Schneems", :id => 9)
-    user.id #=> 9
-    user.redis_key #=> "users:redis:9"
-    
-    User.key_unique("username")
-    user.redis_key #=> "users:redis:schneems"
-    
-    
-    
+**`key_cache_methods`** will let you toggle whether or not keytar defines your key methods after being called. If you're calling
+these methods over and over, this can give you a speed boost, however there is overhead associated with defining methods. The default
+is on, however try it both ways on your app run some benchmarks and see what works the best.
 
 
 
@@ -175,5 +181,11 @@ Since this library is sooooo simple, here is a ASCII keytar for you. Thanks for
              ,::::~:,7:::                                                         
 
 
+Contribution
+============
+
+Fork away. If you want to chat about a feature idea, or a question you can find me on the twitters [@schneems](http://twitter.com/schneems).  Put any major changes into feature branches. Make sure all tests stay green, and make sure your changes are covered. 
+
+
 Copyright (c) 2011 Schneems. See LICENSE.txt for
 further details.

data/VERSION

@@ -1 +1 @@
-0.1.1
+0.9.0

data/keytar.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{keytar}
-  s.version = "0.1.1"
+  s.version = "0.9.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Schneems"]
-  s.date = %q{2011-04-20}
+  s.date = %q{2011-05-08}
   s.description = %q{
     Keytar is a Ruby on Rails wrapper for KeyBuilder.
     Use KeyBuilder to automatically generate keys based on class name instead of cluttering model
@@ -21,6 +21,7 @@ Gem::Specification.new do |s|
   ]
   s.files = [
     ".DS_Store",
+    ".rvmrc",
     "Gemfile",
     "Gemfile.lock",
     "README.md",
@@ -36,7 +37,23 @@ Gem::Specification.new do |s|
     "pkg/keytar-0.1.1.gem",
     "spec/keytar/key_builder_spec.rb",
     "spec/keytar/keytar_spec.rb",
-    "spec/keytar/spec_helper.rb"
+    "spec/keytar/spec_helper.rb",
+    "vendor/cache/activemodel-3.0.6.gem",
+    "vendor/cache/activerecord-3.0.6.gem",
+    "vendor/cache/activesupport-3.0.6.gem",
+    "vendor/cache/arel-2.0.9.gem",
+    "vendor/cache/builder-2.1.2.gem",
+    "vendor/cache/diff-lcs-1.1.2.gem",
+    "vendor/cache/git-1.2.5.gem",
+    "vendor/cache/i18n-0.5.0.gem",
+    "vendor/cache/jeweler-1.5.2.gem",
+    "vendor/cache/rake-0.8.7.gem",
+    "vendor/cache/rspec-2.5.0.gem",
+    "vendor/cache/rspec-core-2.5.1.gem",
+    "vendor/cache/rspec-expectations-2.5.0.gem",
+    "vendor/cache/rspec-mocks-2.5.0.gem",
+    "vendor/cache/sqlite3-1.3.3.gem",
+    "vendor/cache/tzinfo-0.3.26.gem"
   ]
   s.homepage = %q{http://github.com/Schnems/keytar}
   s.licenses = ["MIT"]
@@ -53,23 +70,23 @@ Gem::Specification.new do |s|
     s.specification_version = 3
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_development_dependency(%q<activerecord>, [">= 0"])
-      s.add_development_dependency(%q<activesupport>, [">= 0"])
-      s.add_development_dependency(%q<rake>, [">= 0"])
-      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_development_dependency(%q<activerecord>, ["~> 3.0.4"])
+      s.add_development_dependency(%q<activesupport>, ["~> 3.0.4"])
+      s.add_development_dependency(%q<rake>, ["~> 0.8.7"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.5.2"])
       s.add_development_dependency(%q<rspec>, [">= 0"])
     else
-      s.add_dependency(%q<activerecord>, [">= 0"])
-      s.add_dependency(%q<activesupport>, [">= 0"])
-      s.add_dependency(%q<rake>, [">= 0"])
-      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<activerecord>, ["~> 3.0.4"])
+      s.add_dependency(%q<activesupport>, ["~> 3.0.4"])
+      s.add_dependency(%q<rake>, ["~> 0.8.7"])
+      s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
       s.add_dependency(%q<rspec>, [">= 0"])
     end
   else
-    s.add_dependency(%q<activerecord>, [">= 0"])
-    s.add_dependency(%q<activesupport>, [">= 0"])
-    s.add_dependency(%q<rake>, [">= 0"])
-    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<activerecord>, ["~> 3.0.4"])
+    s.add_dependency(%q<activesupport>, ["~> 3.0.4"])
+    s.add_dependency(%q<rake>, ["~> 0.8.7"])
+    s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
     s.add_dependency(%q<rspec>, [">= 0"])
   end
 end

data/lib/keytar.rb

@@ -1,7 +1,10 @@
 require 'rubygems'
-require 'active_record'
+begin; require 'active_record'; rescue; end
 
 module Keytar
   autoload :KeyBuilder, 'keytar/key_builder'
-  ActiveRecord::Base.class_eval %{ include KeyBuilder }
+  ActiveRecord::Base.class_eval { include KeyBuilder } if defined?(ActiveRecord::Base)
+  def self.included(klass)
+    klass.class_eval {include KeyBuilder}
+  end
 end

data/lib/keytar/key_builder.rb

@@ -12,12 +12,13 @@ module KeyBuilder
                 :key_pluralize_instances => true,
                 :key_case => :downcase,
                 :key_plural => nil,
-                :key_unique => "id"
+                :key_unique => "id",
+                :key_cache_methods => true
                 }
 
   def self.included(klass)
     # setup method missing on class
-    klass.class_eval %{
+    klass.class_eval do
       extend KeyBuilder::Ext
       # if method_missing doesn't already exist, aliasing and calling it will create an infinite loop
       @@key_builder_jump_to_superclass = true
@@ -28,6 +29,14 @@ module KeyBuilder
 
       def self.method_missing(method_name, *args, &blk)
         if method_name.to_s =~ /.*key$/
+          ## Performance: define method so we can skip method_missing next time
+          if key_cache_methods
+            (class << self;self ;end).instance_eval do
+              define_method(method_name) do |*args|
+                build_key(:base => self.to_s.downcase, :name => method_name, :args => args)
+              end
+            end
+          end
           self.build_key(:base => self.to_s.downcase, :name => method_name, :args => args)
         else
           if @@key_builder_jump_to_superclass
@@ -37,7 +46,7 @@ module KeyBuilder
           end
         end
       end
-    }
+    end
   end
 
   # class methods to be extended
@@ -53,6 +62,11 @@ module KeyBuilder
       }
     end
 
+    def keyfig(options = {})
+      options.keys.each do |key|
+        eval("@@#{key} = options[key]") if key.to_s =~ /^key_.*/
+      end
+    end
 
     # Call KeyBuilder.build_key or Foo.build_key with options
     # :base => self.to_s.downcase, :name => method_name, :args => args
@@ -102,6 +116,14 @@ module KeyBuilder
 
   def method_missing(method_name, *args, &blk)
     if method_name.to_s =~ /.*key$/
+      ## Performance: define method so we can skip method_missing next time
+      if self.class.key_cache_methods
+        self.class.instance_eval do
+          define_method(method_name) do |*args|
+            build_key(method_name, *args)
+          end
+        end
+      end
       build_key(method_name, *args)
     else
       original_method_missing(method_name, *args, &blk)

data/spec/keytar/key_builder_spec.rb

@@ -1,4 +1,5 @@
-require 'spec_helper'
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
 
 class Foo
   include KeyBuilder
@@ -21,6 +22,15 @@ describe KeyBuilder do
       Foo.awesome_key(number).should == "foo:awesome:#{number}"
     end
 
+    it 'should dynamically define a class method capeable of producing different keys' do
+      key1 = Foo.define_method_time_test_key(1)
+      key2 = Foo.define_method_time_test_key(2)
+      Foo.respond_to?(:define_method_time_test_key).should be_true
+      key2.should_not == key1
+    end
+
+
+
     it 'should call method_missing on a non-existant method' do
       begin
         Foo.thismethoddoesnotexist
@@ -49,6 +59,20 @@ describe KeyBuilder do
       @foo.awesome_key(number).should == "foos:awesome:#{number}"
     end
 
+    it 'should dynamically define an instance method capeable of producing different keys' do
+      key1 = @foo.define_method_time_test_key(1)
+      key2 = @foo.define_method_time_test_key(2)
+      @foo.respond_to?(:define_method_time_test_key).should be_true
+      key2.should_not == key1
+    end
+
+    it 'should dynamically define an instance method capeable of producing different keys' do
+      key1 = @foo.define_method_time_test_key(1)
+      key2 = @foo.define_method_time_test_key(2)
+      @foo.respond_to?(:define_method_time_test_key).should be_true
+      key2.should_not == key1
+    end
+
     it 'should call method_missing on a non-existant method' do
       begin
         @foo.thismethoddoesnotexist
@@ -70,6 +94,7 @@ describe KeyBuilder do
       Foo.key_case KeyBuilder::DEFAULTS[:key_case]
       Foo.key_plural KeyBuilder::DEFAULTS[:key_plural]
       Foo.key_unique KeyBuilder::DEFAULTS[:key_unique]
+      Foo.key_cache_methods KeyBuilder::DEFAULTS[:key_cache_methods]
     end
 
     it 'should change key_delimiter' do
@@ -132,6 +157,47 @@ describe KeyBuilder do
        foo = Foo.new
        foo.awesome_key.should == "foos:awesome:#{foo.timeish}"
      end
+
+     # todo move tests and assertsions to seperate describe and it blocks
+     it 'should allow all configurations to be set using a hash' do
+       # variables
+       key_delimiter = "/"
+       key_order = [:prefix, :base, :suffix]
+       key_prefix = "before"
+       key_suffix = "after"
+       key_pluralize_instances = false
+       key_case = :upcase
+       key_plural = "zoosk"
+       key_unique = "doesn-t_apply_to_instance_methods"
+       key_cache_methods = false
+       # config
+       Foo.keyfig :key_delimiter => key_delimiter,
+                  :key_order => key_order,
+                  :key_prefix => key_prefix,
+                  :key_suffix => key_suffix,
+                  :key_pluralize_instances => key_pluralize_instances,
+                  :key_case => key_case,
+                  :key_plural => key_plural,
+                  :key_unique => key_unique,
+                  :key_cache_methods => key_cache_methods
+      # assertions
+      Foo.key_delimiter.should == key_delimiter
+      Foo.key_order.should == key_order
+      Foo.key_prefix.should == key_prefix
+      Foo.key_suffix.should == key_suffix
+      Foo.key_pluralize_instances.should == key_pluralize_instances
+      Foo.key_case.should == key_case
+      Foo.key_plural.should == key_plural
+      Foo.key_unique.should == key_unique
+      Foo.key_cache_methods == key_cache_methods
+     end
+
+     it 'should change key_cache_methods' do
+       Foo.key_cache_methods false
+       key1 = Foo.config_define_method_time_test_key(1)
+       Foo.respond_to?(:config_define_method_time_test_key).should be_false
+     end
+
   end
 
 end

data/spec/keytar/keytar_spec.rb

@@ -1,31 +1,66 @@
-require 'spec_helper'
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
 ## Gives us ActiveRecord backed model Bar that we can test instances of
 ActiveRecord::Base.establish_connection(
 :adapter => "sqlite3",
 :database => ":memory:",
 :host     => 'localhost')
-ActiveRecord::Migrator.migrate('../../db/migrate', ENV["VERSION"] ? ENV["VERSION"].to_i : nil )
-## Gives us ActiveRecord backed model Bar that we can test instances of
 
+## Gives us ActiveRecord backed model Bar that we can test instances of
+ActiveRecord::Migrator.migrate(
+  File.expand_path(File.dirname(__FILE__) + "../../../db/migrate") ,
+  ENV["VERSION"] ? ENV["VERSION"].to_i : nil )
 
 class Bar < ActiveRecord::Base
 
 end
 
+class BarNonActiveRecord
+
+end
+
 
 describe Keytar do
   describe 'requiring Keytar' do
-    it 'should load keybuilder into ActiveRecord::Base' do
+    it 'should load keybuilder into ActiveRecord::Base if defined' do
       describe Bar.ancestors do
         it {should include( KeyBuilder)}
       end
     end
 
-    it 'should ' do
+    it 'should allow ActiveRecord based objects to use their unique identifiers' do
       name = "notblank"
       b = Bar.create(:name => name)
       b.name.should == name
       b.awesome_key.should == "bars:awesome:#{b.id}"
     end
   end
+
+  describe 'requiring Keytar with ActiveRecord undefined' do
+    before do
+      begin; Object.send(:remove_const, "ActiveRecord"); rescue NameError; end
+    end
+
+    it 'does not automatically add KeyBuilder to the class' do
+      describe BarNonActiveRecord.ancestors do
+        it {should_not include( KeyBuilder)}
+      end
+    end
+
+    describe 'allows non ActiveRecord based classes to use keytar directly' do
+      it 'includes keybuilder when it is included' do
+        BarNonActiveRecord.class_eval do
+          include Keytar
+        end
+        describe BarNonActiveRecord.ancestors do
+          it {should include( KeyBuilder)}
+        end
+      end
+
+      it 'should allow ActiveRecord based objects to use their unique identifiers' do
+        BarNonActiveRecord.awesome_key.should == "barnonactiverecord:awesome"
+      end
+    end
+  end
+
+
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: keytar
 version: !ruby/object:Gem::Version 
-  hash: 25
+  hash: 59
   prerelease: 
   segments: 
   - 0
-  - 1
-  - 1
-  version: 0.1.1
+  - 9
+  - 0
+  version: 0.9.0
 platform: ruby
 authors: 
 - Schneems
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-04-20 00:00:00 -05:00
+date: 2011-05-08 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -23,12 +23,14 @@ dependencies:
   requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
-        hash: 3
+        hash: 15
         segments: 
+        - 3
         - 0
-        version: "0"
+        - 4
+        version: 3.0.4
   name: activerecord
   version_requirements: *id001
   prerelease: false
@@ -37,12 +39,14 @@ dependencies:
   requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
-        hash: 3
+        hash: 15
         segments: 
+        - 3
         - 0
-        version: "0"
+        - 4
+        version: 3.0.4
   name: activesupport
   version_requirements: *id002
   prerelease: false
@@ -51,12 +55,14 @@ dependencies:
   requirement: &id003 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
-        hash: 3
+        hash: 49
         segments: 
         - 0
-        version: "0"
+        - 8
+        - 7
+        version: 0.8.7
   name: rake
   version_requirements: *id003
   prerelease: false
@@ -65,12 +71,14 @@ dependencies:
   requirement: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
-        hash: 3
+        hash: 7
         segments: 
-        - 0
-        version: "0"
+        - 1
+        - 5
+        - 2
+        version: 1.5.2
   name: jeweler
   version_requirements: *id004
   prerelease: false
@@ -98,6 +106,7 @@ extra_rdoc_files:
 - README.md
 files: 
 - .DS_Store
+- .rvmrc
 - Gemfile
 - Gemfile.lock
 - README.md
@@ -114,6 +123,22 @@ files:
 - spec/keytar/key_builder_spec.rb
 - spec/keytar/keytar_spec.rb
 - spec/keytar/spec_helper.rb
+- vendor/cache/activemodel-3.0.6.gem
+- vendor/cache/activerecord-3.0.6.gem
+- vendor/cache/activesupport-3.0.6.gem
+- vendor/cache/arel-2.0.9.gem
+- vendor/cache/builder-2.1.2.gem
+- vendor/cache/diff-lcs-1.1.2.gem
+- vendor/cache/git-1.2.5.gem
+- vendor/cache/i18n-0.5.0.gem
+- vendor/cache/jeweler-1.5.2.gem
+- vendor/cache/rake-0.8.7.gem
+- vendor/cache/rspec-2.5.0.gem
+- vendor/cache/rspec-core-2.5.1.gem
+- vendor/cache/rspec-expectations-2.5.0.gem
+- vendor/cache/rspec-mocks-2.5.0.gem
+- vendor/cache/sqlite3-1.3.3.gem
+- vendor/cache/tzinfo-0.3.26.gem
 has_rdoc: true
 homepage: http://github.com/Schnems/keytar
 licenses: