astdb 0.0.1

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in astdb.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2012 TODO: Write your name
+
+MIT License
+
+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/README.md

@@ -0,0 +1,53 @@
+# AstDB
+
+Interact with an Asterisk Database (AstDB) instance via ssh.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'astdb'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install astdb
+
+## Usage
+
+```ruby
+require 'astdb'
+
+db = AstDB::Database.new host:        'ssh.server.com',
+                         username:    'not-root',
+                         password:    'Secret!',        # Omit this line if using key-based auth.
+                         auto_reload: true              # Optionally disable the automatic initial load
+                                                        # and updating of '.hash', instead opting to run
+                                                        # reload_database' manually. Useful in high 
+                                                        # latency or low bandwidth scenarios. 
+                                                        # Default: true 
+
+# view a hash of the database
+p db.hash
+
+# add/update some entries
+errors = db.set({'MyFamily/MyKey' => 'MyValue', 'this/is/a/longer/key' => 'another value'})
+
+if errors
+	errors.each { |key, error_message| p "The following error occurred when trying to set #{key}: #{error}"
+end
+
+# see the updated database
+p db.hash
+```
+
+## Contributing
+
+1. Fork it
+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`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/astdb.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'astdb/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "astdb"
+  gem.version       = Astdb::VERSION
+  gem.authors       = ["Taylor Boyko"]
+  gem.email         = ["taylor@wrprojects.com"]
+  gem.description   = %q{Interact with an Asterisk Database (AstDB) instance via ssh.}
+  gem.summary       = %q{}
+  gem.homepage      = "https://github.com/tboyko/astdb"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+  
+  gem.add_dependency 'net-ssh'
+end

data/lib/astdb.rb

@@ -0,0 +1,4 @@
+require 'astdb/models/connection'
+require 'astdb/models/database'
+require 'astdb/models/entry'
+require 'astdb/version'

data/lib/astdb/models/connection.rb

@@ -0,0 +1,63 @@
+module AstDB
+  class Connection
+    require 'net/ssh'
+    
+    attr_accessor :host, :username, :password
+        
+    def initialize(opts = {})
+      @host     = opts[:host]
+      @username = opts[:username]
+      @password = opts[:password]
+    end
+        
+    def fetch_database
+      
+      # fetch database dump from asterisk server
+      
+      output = nil
+      
+      Net::SSH.start(@host, @username, password: @password) do |ssh|
+        output = ssh.exec!("asterisk -rx 'database show'")
+      end
+
+      # parse dump to hash
+      
+      database = {}
+      
+      lines = output.split("\n").collect { |l| l.rstrip }
+      lines.each do |line|
+        m = line.match /^\/(?<key>[^:]+):(?<value>.+)$/    
+        next if m.nil?
+        key   = m[:key].rstrip
+        value = m[:value].lstrip
+        
+        database[key] = value
+      end
+
+      database
+    end
+    
+    def set_database_values(value_hash)
+      
+      # prepare command
+      
+      commands = value_hash.collect { |k, v| Entry.new(k,v).put_command }
+
+      # send to server
+      
+      errors = {}
+      
+      Net::SSH.start(@host, @username, password: @password) do |ssh|
+        value_hash.each do |key, value|
+          command = Entry.new(key,value).put_command
+          
+          response = ssh.exec!("asterisk -rx '#{command}'")
+          errors[key] = response unless response.match /Updated database successfully/
+        end
+      end
+       
+      return errors.count > 0 ? errors : nil
+    end
+    
+  end
+end

data/lib/astdb/models/database.rb

@@ -0,0 +1,29 @@
+module AstDB
+  class Database
+    
+    attr_reader :connection, :hash
+    
+    def initialize(opts = {})
+      @connection  = Connection.new host:     opts[:host],
+                                    username: opts[:username],
+                                    password: opts[:password]
+                                    
+      @auto_reload  = opts[:auto_reload].nil? ? true : opts[:auto_reload]
+      @database     = {}
+    
+      reload_database if @auto_reload
+    end
+    
+    def set(value_hash)
+      errors = @connection.set_database_values(value_hash)
+      reload_database if @auto_reload
+      
+      errors
+    end
+        
+    def reload_database
+      @hash = @connection.fetch_database
+    end
+    
+  end
+end

data/lib/astdb/models/entry.rb

@@ -0,0 +1,20 @@
+module AstDB
+  class Entry
+    
+    attr_accessor :family, :key, :value
+    
+    def initialize(key, value)
+      m = key.match /^(?<family>.+)\/(?<key>[^\/]+)$/
+      raise ArgumentError, 'key must at least have a single "/" delimiting the asterisk family and key values' if m.nil?
+      
+      @family = m[:family]
+      @key    = m[:key]
+      @value  = value
+    end
+    
+    def put_command
+      "database put #{family} #{key} #{value}"
+    end
+    
+  end
+end

data/lib/astdb/version.rb

@@ -0,0 +1,3 @@
+module Astdb
+  VERSION = "0.0.1"
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification
+name: astdb
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Taylor Boyko
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-11-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: net-ssh
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Interact with an Asterisk Database (AstDB) instance via ssh.
+email:
+- taylor@wrprojects.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .DS_Store
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- astdb.gemspec
+- lib/astdb.rb
+- lib/astdb/models/connection.rb
+- lib/astdb/models/database.rb
+- lib/astdb/models/entry.rb
+- lib/astdb/version.rb
+homepage: https://github.com/tboyko/astdb
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: ''
+test_files: []
+has_rdoc: