nsisam 0.2.6 → 0.2.7

data/lib/nsisam/client.rb

@@ -20,24 +20,45 @@ module NSISam
     #
     # @param [String] data the desired data to store
     # @return [Hash] response with the data key and checksum
+    #   * "key" [String] the key to access the stored data
+    #   * "checksum" [String] the sha1 checksum of the stored data 
     def store(data)
       request_data = {:value => data}.to_json
       request = prepare_request :PUT, request_data
       execute_request(request)
     end
 
+    # Delete data at a given SAM key
+    #
+    # @param [Sring] key of the value to delete
+    # @return [Hash] response
+    #   * "deleted" [Boolean] true if the key was sucefully deleted 
     def delete(key)
       request_data = {:key => key}.to_json
       request = prepare_request :DELETE, request_data
       execute_request(request)
     end
 
+    # Recover data stored at a given SAM key
+    #
+    # @param [String] key of the value to acess
+    # @return [Hash] response
+    #   * "from_user" [String] the user who stored the value
+    #   * "date" [String] the date when the value was stored
+    #   * "data" [String, Hash, Array] the data stored at that key
     def get(key)
       request_data = {:key => key}.to_json
       request = prepare_request :GET, request_data
       execute_request(request)
     end
 
+    # Update data stored at a given SAM key
+    #
+    # @param [String] key of the data to update
+    # @param [String, Hash, Array] data to be stored at the key
+    # return [Hash] response
+    #   * "key" [String] just to value key again
+    #   * "checksum" [String] the new sha1 checksum of the key's data
     def update(key, value)
       request_data = {:key => key, :value => value}.to_json
       request = prepare_request :POST, request_data

data/lib/nsisam/fake_server.rb

@@ -44,16 +44,23 @@ module NSISam
   end
 
   class FakeServerManager
-    def start_server
+
+    # Start the SAM fake server
+    #
+    # @param [Fixnum] port the port where the fake server will listen
+    #   * make sure there's not anything else listenning on this port
+    def start_server(port=8888)
       @thread = Thread.new do
-        Server.run! :port => 8888
+        Server.run! :port => port
       end
       sleep(1)
       self
     end
 
+    # Stop the SAM fake server
     def stop_server
       @thread.kill
+      self
     end
   end
 end

data/nsisam.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = "nsisam"
-  s.version = "0.2.6"
+  s.version = "0.2.7"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Douglas Camata"]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: nsisam
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.2.7
   prerelease: 
 platform: ruby
 authors:
@@ -13,7 +13,7 @@ date: 2012-03-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
-  requirement: &70192467376140 !ruby/object:Gem::Requirement
+  requirement: &17065580 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70192467376140
+  version_requirements: *17065580
 - !ruby/object:Gem::Dependency
   name: sinatra
-  requirement: &70192467375140 !ruby/object:Gem::Requirement
+  requirement: &17064960 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70192467375140
+  version_requirements: *17064960
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70192467367560 !ruby/object:Gem::Requirement
+  requirement: &17064220 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70192467367560
+  version_requirements: *17064220
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &70192467366800 !ruby/object:Gem::Requirement
+  requirement: &17063600 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +54,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *70192467366800
+  version_requirements: *17063600
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70192467365900 !ruby/object:Gem::Requirement
+  requirement: &17063020 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -65,10 +65,10 @@ dependencies:
         version: 2.8.0
   type: :development
   prerelease: false
-  version_requirements: *70192467365900
+  version_requirements: *17063020
 - !ruby/object:Gem::Dependency
   name: bundler
-  requirement: &70192467365220 !ruby/object:Gem::Requirement
+  requirement: &17062340 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -76,10 +76,10 @@ dependencies:
         version: 1.0.0
   type: :development
   prerelease: false
-  version_requirements: *70192467365220
+  version_requirements: *17062340
 - !ruby/object:Gem::Dependency
   name: jeweler
-  requirement: &70192467364480 !ruby/object:Gem::Requirement
+  requirement: &17061800 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -87,7 +87,7 @@ dependencies:
         version: 1.8.3
   type: :development
   prerelease: false
-  version_requirements: *70192467364480
+  version_requirements: *17061800
 description: ! "A simple gem to access a SAM node. For more info about SAM\n                       visit
   www.github.com/nsi-iff/sam_buildout."
 email: d.camata@gmail.com
@@ -126,7 +126,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -3040513687883505412
+      hash: -2979948941930370823
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: