cassandra_lock 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2642cc2249fff7aa6fe90ad11623eec933578cb8
-  data.tar.gz: 37600867bbcaa92229336fed9cde9ab8591ee406
+  metadata.gz: e9931caf03a8350866ebfc36e5a8ab3d73a5a764
+  data.tar.gz: a2f6da68a06576fe8df2759e7285abc5484ee14e
 SHA512:
-  metadata.gz: 8293c26b5672dce2eab1af349e438ede799466f78fdd7d11a5e9508be79e0af5985ff1e13d97becf9d31a9730d2d03c81f06a9126d1affe5b27950560f616b6d
-  data.tar.gz: 5199215ed36264f509fed20a54be9c999b9610fcb1b9ac54f2192061c140d4822d0f499de1536dcb8a4f1b6ba23b765401859d2f0e2a8f6d05fe1cafa731574a
+  metadata.gz: ad1b0637052225d18e2e1b1bf20ca9f1ada8cb9796da4680d99f18a1d255342758692e436990ba7e9e4d234d74b3b561d64490929376d79b1aa143a1b352bd22
+  data.tar.gz: aa7d9eb2bd32f6abdbad0bee4f1a816494c94c006f0f4997ccd45d0cc6ca04ee889644edc3de41011c2d917ff7b918c892a7a33951918ccf0962eeab437b366d

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/Gemfile.lock

@@ -0,0 +1,35 @@
+PATH
+  remote: .
+  specs:
+    cassandra_lock (0.0.2)
+      cassandra-driver
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    cassandra-driver (1.1.1)
+      ione (~> 1.2)
+    diff-lcs (1.2.5)
+    ione (1.2.0)
+    rake (10.4.2)
+    rspec (3.1.0)
+      rspec-core (~> 3.1.0)
+      rspec-expectations (~> 3.1.0)
+      rspec-mocks (~> 3.1.0)
+    rspec-core (3.1.7)
+      rspec-support (~> 3.1.0)
+    rspec-expectations (3.1.2)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.1.0)
+    rspec-mocks (3.1.3)
+      rspec-support (~> 3.1.0)
+    rspec-support (3.1.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.7)
+  cassandra_lock!
+  rake (~> 10.0)
+  rspec (~> 3.1)

data/README.md

@@ -12,19 +12,56 @@ gem 'cassandra_lock'
 
 And then execute:
 
-    $ bundle
+```$ bundle```
 
 Or install it yourself as:
 
-    $ gem install cassandra_lock
+```$ gem install cassandra_lock```
 
 ## Usage
 
-TODO: Write usage instructions here
+Create the keyspace, see the example bellow.
+
+```SQL
+CREATE KEYSPACE test_lock WITH REPLICATION = { 'class' : 'NetworkTopologyStrategy', 'datacenter1' : 1 };
+```
+
+Create the table, see the example bellow.
+
+```SQL
+CREATE TABLE test_lock.leases (
+      name text PRIMARY KEY,
+      owner text,
+      value text
+ ) with default_time_to_live = 5
+```
+
+And finally to use in your code:
+
+```ruby
+#to create
+contact_points = ["127.0.0.1"]
+keyspace = "test_lock"
+client = CassandraLock::Client.new(contact_points, keyspace)
+
+#to lock
+if client.lock("my_resource")
+  puts "I acquired the lock"
+else
+  puts "Someone took the lock"
+end
+
+#to unlock
+client.unlock("my_resource")
+
+#to keep_alive
+client.keep_alive("my_resource")
+
+```
 
 ## Contributing
 
-1. Fork it ( https://github.com/[my-github-username]/cassandra_lock/fork )
+1. Fork it ( https://github.com/leandromoreira/cassandra_lock/fork )
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)

data/cassandra_lock.gemspec

@@ -17,6 +17,9 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ["lib"]
 
+  spec.add_dependency "cassandra-driver"
+
   spec.add_development_dependency "bundler", "~> 1.7"
   spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.1"
 end

data/lib/cassandra_lock.rb

@@ -1,5 +1,5 @@
 require "cassandra_lock/version"
 
 module CassandraLock
-  # Your code goes here...
+  autoload :Client, 'cassandra_lock/client'
 end

data/lib/cassandra_lock/client.rb

@@ -0,0 +1,30 @@
+require 'cassandra'
+require 'securerandom'
+
+module CassandraLock
+  class Client
+    attr_reader :id
+
+    def initialize(contact_points, keyspace, id=nil)
+      cluster = Cassandra.cluster hosts: contact_points
+      @cassandra = cluster.connect keyspace
+      @id = id || SecureRandom.uuid
+      @LOCK = @cassandra.prepare "INSERT INTO leases (name, owner) VALUES (?,?) IF NOT EXISTS"
+      @KEEPALIVE = @cassandra.prepare "UPDATE leases set owner = ? where name = ? IF owner = ?"
+      @UNLOCK = @cassandra.prepare "DELETE FROM leases where name = ? IF owner = ?"
+    end
+
+    def lock(resource)
+      result = @cassandra.execute(@LOCK, resource, @id)
+      result.first["[applied]"]
+    end
+
+    def keep_alive(resource)
+      @cassandra.execute(@KEEPALIVE, @id, resource, @id)
+    end
+
+    def unlock(resource)
+      @cassandra.execute(@UNLOCK, resource, @id)
+    end
+  end
+end

data/lib/cassandra_lock/version.rb

@@ -1,3 +1,3 @@
 module CassandraLock
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/spec/client_spec.rb

@@ -0,0 +1,55 @@
+require 'spec_helper'
+
+RSpec.describe CassandraLock::Client do
+  let(:contact_points) {["127.0.0.1"]}
+  let(:keyspace) { "test_lock" }
+  let(:resource_key) { "foo" }
+  let(:ttl) { 1000 }
+
+  it 'locks' do
+    first_client = CassandraLock::Client.new(contact_points, keyspace)
+    second_client = CassandraLock::Client.new(contact_points, keyspace)
+
+    first_try_lock_info = first_client.lock(resource_key)
+    second_try_lock_info = second_client.lock(resource_key)
+
+    expect(first_try_lock_info).to be_truthy
+    expect(second_try_lock_info).to be_falsy
+
+    first_client.unlock(resource_key)
+  end
+
+  it 'unlocks' do
+    first_client = CassandraLock::Client.new(contact_points, keyspace)
+    second_client = CassandraLock::Client.new(contact_points, keyspace)
+
+    first_try_lock_info = first_client.lock(resource_key)
+    first_client.unlock(resource_key)
+
+    second_try_lock_info = second_client.lock(resource_key)
+
+    expect(second_try_lock_info).to be_truthy
+  end
+
+  it 'expires' do
+    first_client = CassandraLock::Client.new(contact_points, keyspace)
+    first_try_lock_info = first_client.lock(resource_key)
+
+    sleep 6
+
+    expect(first_try_lock_info).to be_falsy
+  end
+
+  it 'keeps alive' do
+    first_client = CassandraLock::Client.new(contact_points, keyspace)
+    first_try_lock_info = first_client.lock(resource_key)
+
+    sleep 3
+
+    first_client.keep_alive(resource_key)
+
+    sleep 3
+
+    expect(first_try_lock_info).to be_truthy
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'cassandra_lock'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cassandra_lock
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Leandro Moreira
@@ -10,6 +10,20 @@ bindir: bin
 cert_chain: []
 date: 2015-01-03 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: cassandra-driver
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -38,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.1'
 description: 
 email:
 - leandro.ribeiro.moreira@gmail.com
@@ -46,13 +74,18 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".rspec"
 - Gemfile
+- Gemfile.lock
 - LICENSE
 - README.md
 - Rakefile
 - cassandra_lock.gemspec
 - lib/cassandra_lock.rb
+- lib/cassandra_lock/client.rb
 - lib/cassandra_lock/version.rb
+- spec/client_spec.rb
+- spec/spec_helper.rb
 homepage: https://github.com/leandromoreira/cassandra-lock
 licenses:
 - MIT
@@ -77,4 +110,6 @@ rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
 summary: A ruby lib to achieve consensus with Cassandra
-test_files: []
+test_files:
+- spec/client_spec.rb
+- spec/spec_helper.rb