kvs 0.3.1

data/.gitignore

@@ -0,0 +1 @@
+pkg

data/ChangeLog

@@ -0,0 +1,3 @@
+== 0.1.0 2009-09-15
+
+* first release!

data/README.markdown

@@ -0,0 +1,53 @@
+KVS
+========
+
+[http://github.com/jugyo/kvs](http://github.com/jugyo/kvs)
+
+Description
+--------
+
+KVS is a simple key value store.
+
+Install
+--------
+
+    sudo gem install jugyo-kvs --source http://gems.github.com
+
+Usage
+--------
+
+    KVS.dir = '/tmp/kvs'
+
+    KVS['foo'] = 'bar'
+    puts KVS['foo'] #=> bar
+
+    key = KVS << 'jugyo'
+    puts KVS[key] #=> jugyo
+
+    KVS.delete('foo')
+
+License
+--------
+
+(The MIT License)
+
+Copyright (c) 2008-2009 jugyo
+
+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/Rakefile

@@ -0,0 +1,43 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "kvs"
+    gem.summary = %Q{Key Value Store.}
+    gem.description = %Q{KVS is a simple key value store.}
+    gem.email = "jugyo.org@gmail.com"
+    gem.homepage = "http://github.com/jugyo/kvs"
+    gem.authors = ["jugyo"]
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "kvs #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.3.1

data/kvs.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{kvs}
+  s.version = "0.3.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["jugyo"]
+  s.date = %q{2009-09-16}
+  s.description = %q{KVS is a simple key value store.}
+  s.email = %q{jugyo.org@gmail.com}
+  s.files = ["Rakefile", "README.markdown", "ChangeLog", "lib/kvs.rb", "spec/kvs_spec.rb"]
+  s.homepage = %q{http://github.com/jugyo/kvs}
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{kvs}
+  s.rubygems_version = %q{1.3.4}
+  s.summary = %q{simple key value store.}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

data/lib/kvs.rb

@@ -0,0 +1,41 @@
+require 'digest/sha1'
+require 'yaml'
+
+module KVS
+  class <<self
+    attr_accessor :dir
+
+    def <<(value)
+      key = key_gen(value)
+      self[key] = value
+      key
+    end
+
+    def [](key)
+      path = file_of(key)
+      return nil unless File.exists?(path)
+      YAML.load(File.read(path))
+    end
+
+    def []=(key, value)
+      File.open(file_of(key), 'wb') { |f| f << value.to_yaml }
+    end
+
+    def delete(key)
+      path = file_of(key)
+      File.delete(path) if File.exists?(path)
+      nil
+    end
+
+    def file_of(key)
+      key = key.to_s
+      raise ArgumentError, 'invalid key' unless key =~ /^[\w]+$/
+      raise "dir is not specified" unless dir
+      File.join(dir, key)
+    end
+
+    def key_gen(value)
+      Digest::SHA1.hexdigest(value.to_s)
+    end
+  end
+end

data/spec/kvs_spec.rb

@@ -0,0 +1,85 @@
+$:.unshift File.dirname(__FILE__) + '/../lib'
+require 'kvs'
+require 'tmpdir'
+require 'fileutils'
+
+describe KVS do
+  before do
+    @tmpdir = Dir.tmpdir + '/kvs_test'
+    FileUtils.rm_rf(@tmpdir)
+    FileUtils.mkdir_p(@tmpdir)
+    KVS.dir = @tmpdir
+  end
+
+  it 'should generate file path' do
+    KVS.file_of('foo').should == @tmpdir + '/foo'
+  end
+
+  it 'should store data' do
+    KVS['foo'] = {:a => 'b', :c => 'd'}
+    KVS['foo'].should == {:a => 'b', :c => 'd'}
+    File.exists?(KVS.file_of('foo')).should be_true
+  end
+
+  it 'should store data with "<<"' do
+    key = KVS << {:a => 'b', :c => 'd'}
+    KVS[key].should == {:a => 'b', :c => 'd'}
+    File.exists?(KVS.file_of(key)).should be_true
+  end
+
+  it 'can also use Symbol as key' do
+    KVS[:foo] = 'test'
+    KVS['foo'].should == 'test'
+    KVS['bar'] = 'test test'
+    KVS[:bar].should == 'test test'
+  end
+
+  describe 'no value exists' do
+    it 'should return nil' do
+      KVS['x'].should be_nil
+    end
+  end
+
+  describe 'delete value' do
+    it 'should delete value' do
+      KVS['foo'] = 'bar'
+      KVS['foo'].should == 'bar'
+      KVS.delete('foo')
+      KVS['foo'].should be_nil
+      File.exists?(KVS.file_of('foo')).should be_false
+    end
+
+    it 'should return nil' do
+      KVS['foo'] = 'bar'
+      KVS.delete('foo').should be_nil
+      KVS.delete('foo').should be_nil
+    end
+  end
+
+  describe 'should always return nil' do
+    it 'should not raise ArgumentError' do
+      lambda { KVS['foo'] }.should_not raise_error(ArgumentError)
+      lambda { KVS['_'] }.should_not raise_error(ArgumentError)
+      lambda { KVS['1'] }.should_not raise_error(ArgumentError)
+    end
+  end
+
+  describe 'use invalid key' do
+    it 'should raise ArgumentError' do
+      lambda { KVS['.'] }.should raise_error(ArgumentError)
+      lambda { KVS['../'] }.should raise_error(ArgumentError)
+      lambda { KVS['/'] }.should raise_error(ArgumentError)
+    end
+  end
+
+  describe 'dir is nil' do
+    before do
+      KVS.dir = nil
+    end
+
+    it 'should raise ArgumentError' do
+      lambda { KVS['foo'] = {:a => 'b'} }.should raise_error(RuntimeError)
+      lambda { KVS['foo'] }.should raise_error(RuntimeError)
+    end
+  end
+end

metadata

@@ -0,0 +1,72 @@
+--- !ruby/object:Gem::Specification 
+name: kvs
+version: !ruby/object:Gem::Version 
+  version: 0.3.1
+platform: ruby
+authors: 
+- jugyo
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-01-03 00:00:00 +09:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.9
+    version: 
+description: KVS is a simple key value store.
+email: jugyo.org@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- ChangeLog
+- README.markdown
+files: 
+- .gitignore
+- ChangeLog
+- README.markdown
+- Rakefile
+- VERSION
+- kvs.gemspec
+- lib/kvs.rb
+- spec/kvs_spec.rb
+has_rdoc: true
+homepage: http://github.com/jugyo/kvs
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Key Value Store.
+test_files: 
+- spec/kvs_spec.rb