dbum 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ad519cdebdace7e30281919c5e11996a57cb2d7b
-  data.tar.gz: 95f488b44c47ae91b69e9b97bc7620123177cbcf
+  metadata.gz: 6440dbbd65d0459b357f33f43bbb0f949f453602
+  data.tar.gz: ef8eb85055d70699bc8fd9b17fd23aff4d7ef450
 SHA512:
-  metadata.gz: 5f480562d08b7aa7999ae05c63ce7229f88ee55348afaa0c793a54da3d2e930a5ab39874dc90e713160ec3f47ce5c601351663dafd056f345090f3b796f097ec
-  data.tar.gz: f59ed81129c080a20e0e25381e96a9b760641f752bd78b1276527a23adbe23226e5c70d90e57e9891a106d271d12d14616444823528407b2bf51195c38da9305
+  metadata.gz: 69bfb0964579921af41122ce9ccbb044a9aebcf08a25c2d69a5fddadbea2e80b1b71880f8164928736e6ca304f5225e379723076c782587f5860101091dabe27
+  data.tar.gz: 3238eac53926240c8bc3dbf9af5bdf8110462c9a8b52d3fa4884fe3a69003815d694b0e2982df66793d754a32414a51a1a314e3c7e3b674e0ac3edd9392b93b3

data/Readme.md

@@ -1,3 +1,65 @@
 # DBum
 
-A no-nonsense, JSON-based key-value store
+A no-nonsense, JSON-based key-value store backed by [Daybreak](http://propublica.github.io/daybreak/)
+
+## Usage
+
+DBum has few commands:
+
+    $ dbum help
+    Commands:
+      dbum art             # View the application art
+      dbum help [COMMAND]  # Describe available commands or one specific command
+      dbum server          # Start the application Web server
+      dbum version         # Echo the application version
+
+You're probably most interested in the `server` command:
+
+    $ dbum help server
+    Usage:
+      dbum server
+    
+    Options:
+      -p, [--port=N]                   # Set Sinatra port
+                                       # Default: 4567
+      -e, [--environment=ENVIRONMENT]  # Set Sinatra environment
+                                       # Default: development
+      -b, [--bind=BIND]                # Set Sinatra interface
+                                       # Default: 0.0.0.0
+      -t, [--database=DATABASE]        # Location of application database
+                                       # Default: um.db
+      -d, [--debug], [--no-debug]      # Enable debugging output
+    
+    Start the application Web server
+
+## API
+
+The Web server has only a few endpoints:
+
+### List keys `GET /`
+
+Return the current list of keys.
+
+### Lookup key `GET /:key`
+
+Return the value associated with the given key. Returns `404` if the key does
+not exist.
+
+### Create key `POST /:key`
+
+Associate the given key with the value contained in the request body, which must
+be a valid JSON hash. Returns `404` if the key already exists.
+
+### Replace key `PUT /:key`
+
+Associate the given key with the value contained in the request body, which must
+be a valid JSON hash. Returns `404` if the key does not exist.
+
+### Update key `PATCH /:key`
+
+Merge the value associated the given key with the contents of the request body,
+which must be a valid JSON hash. Returns `404` if the key does not exist.
+
+### Delete key `DELETE /:key`
+
+Delete the key and its associated value.

data/VERSION

@@ -1 +1 @@
-0.0.1
+0.0.2

data/dbum.gemspec

@@ -17,6 +17,7 @@ Gem::Specification.new do |s|
   s.add_runtime_dependency 'slog', '~> 1.1'
   s.add_runtime_dependency 'sinatra', '~> 1.4'
   s.add_runtime_dependency 'daybreak', '~> 0.3'
+  s.add_runtime_dependency 'deep_merge', '~> 1'
 
   s.files         = `git ls-files`.split("\n")
   s.test_files    = `git ls-files -- test/*`.split("\n")

data/lib/dbum/app.rb

@@ -1,7 +1,11 @@
 require 'pathname'
+require 'logger'
 require 'thread'
 require 'json'
 
+require 'slog'
+require 'daybreak'
+require 'deep_merge'
 require 'sinatra/base'
 
 require_relative 'helpers'
@@ -14,9 +18,105 @@ module DBum
   class App < Sinatra::Application
     include DBum::Helpers
 
+    def self.config! options
+      @@logger = Slog::Logger.new
+      @@db = Daybreak::DB.new options.database
+
+      self.set :environment, options.environment
+      self.set :port, options.port
+      self.set :bind, options.bind
+      self.set :raise_errors, options.debug?
+      self.set :dump_errors, options.debug?
+      self.set :show_exceptions, options.debug?
+      self.set :logging, ::Logger::DEBUG if options.debug?
+    end
+
+    def self.close!
+      @@db.close
+    end
+
+
     get '/' do
-      content_type :text
-      VERSION
+      pretty_json map.keys
+    end
+
+    get '/:key' do
+      key = params[:key]
+      val = lookup key
+      return status(404) if val.nil?
+      pretty_json val
+    end
+
+    post '/:key' do
+      key = params[:key]
+      val = lookup key
+      return status(404) unless val.nil?
+      data = request_body
+      update key, data
+      pretty_json data
+    end
+
+    put '/:key' do
+      key = params[:key]
+      val = lookup key
+      return status(404) if val.nil?
+      data = request_body
+      update key, data
+      pretty_json data
+    end
+
+    patch '/:key' do
+      key = params[:key]
+      val = lookup key
+      return status(404) if val.nil?
+      val.deep_merge! request_body
+      update key, val
+      pretty_json val
+    end
+
+    delete '/:key' do
+      key = params[:key]
+      val = lookup key
+      return status(404) if val.nil?
+      remove key
+      pretty_json val
+    end
+
+
+  private
+
+    def request_body
+      request.body.rewind
+      JSON.parse request.body.read
+    end
+
+    def pretty_json o
+      content_type :json
+      JSON.pretty_generate o
+    end
+
+    def map
+      @@db.lock do
+        @@db.keys.reduce({}) { |h, k| h[k] = @@db[k] ; h }
+      end
+    end
+
+    def lookup key
+      map[key]
+    end
+
+    def update key, val
+      @@db.lock do
+        @@db[key] = val
+      end
+      @@db.flush
+    end
+
+    def remove key
+      @@db.lock do
+        @@db.delete key
+      end
+      @@db.flush
     end
 
   end

data/lib/dbum/main.rb

@@ -29,9 +29,38 @@ module DBum
     end
 
 
-    desc 'app', 'Start the application and server'
-    def app
+    desc 'server', 'Start the application Web server'
+    option :port, \
+      type: :numeric,
+      aliases: %w[ -p ],
+      desc: 'Set Sinatra port',
+      default: 4567
+    option :environment, \
+      type: :string,
+      aliases: %w[ -e ],
+      desc: 'Set Sinatra environment',
+      default: 'development'
+    option :bind, \
+      type: :string,
+      aliases: %w[ -b ],
+      desc: 'Set Sinatra interface',
+      default: '0.0.0.0'
+    option :database, \
+      type: :string,
+      aliases: %w[ -t ],
+      desc: 'Location of application database',
+      default: 'um.db'
+    option :debug, \
+      type: :boolean,
+      aliases: %w[ -d ],
+      desc: 'Enable debugging output',
+      default: false
+    def server
+      App.config! options
       App.run!
+      at_exit do
+        App.close!
+      end
     end
 
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dbum
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Sean Clemmer
@@ -66,6 +66,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.3'
+- !ruby/object:Gem::Dependency
+  name: deep_merge
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1'
 description: A no-nonsense, JSON-based key-value store.
 email: sczizzo@gmail.com
 executables: