trumpet-trumpet 0.0.1

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Michael Taras
+
+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.rdoc

@@ -0,0 +1,7 @@
+= trumpet
+
+Description goes here.
+
+== Copyright
+
+Copyright (c) 2009 Michael Taras. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,50 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "trumpet"
+    gem.summary = "The official trumpet gem"
+    gem.email = "wtf@trumpet.io"
+    gem.homepage = "http://github.com/trumpet/trumpet"
+    gem.authors = ["Michael Taras"]
+    gem.add_dependency 'resourceful'
+    gem.add_dependency 'json'
+
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+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 :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION.yml')
+    config = YAML.load(File.read('VERSION.yml'))
+    version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "trumpet #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+

data/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:patch: 1
+:major: 0
+:minor: 0

data/lib/core_extensions.rb

@@ -0,0 +1,153 @@
+require 'time'
+
+# Copyright (c) 2008 Sam Smoot.
+# 
+# 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.
+
+class Object #:nodoc:
+  # @return <TrueClass, FalseClass>
+  #
+  # @example [].blank?         #=>  true
+  # @example [1].blank?        #=>  false
+  # @example [nil].blank?      #=>  false
+  # 
+  # Returns true if the object is nil or empty (if applicable)
+  def blank?
+    nil? || (respond_to?(:empty?) && empty?)
+  end unless method_defined?(:blank?)
+end # class Object
+
+class Numeric #:nodoc:
+  # @return <TrueClass, FalseClass>
+  # 
+  # Numerics can't be blank
+  def blank?
+    false
+  end unless method_defined?(:blank?)
+end # class Numeric
+
+class NilClass #:nodoc:
+  # @return <TrueClass, FalseClass>
+  # 
+  # Nils are always blank
+  def blank?
+    true
+  end unless method_defined?(:blank?)
+end # class NilClass
+
+class TrueClass #:nodoc:
+  # @return <TrueClass, FalseClass>
+  # 
+  # True is not blank.  
+  def blank?
+    false
+  end unless method_defined?(:blank?)
+end # class TrueClass
+
+class FalseClass #:nodoc:
+  # False is always blank.
+  def blank?
+    true
+  end unless method_defined?(:blank?)
+end # class FalseClass
+
+class String #:nodoc:
+  # @example "".blank?         #=>  true
+  # @example "     ".blank?    #=>  true
+  # @example " hey ho ".blank? #=>  false
+  # 
+  # @return <TrueClass, FalseClass>
+  # 
+  # Strips out whitespace then tests if the string is empty.
+  def blank?
+    strip.empty?
+  end unless method_defined?(:blank?)
+  
+  def snake_case
+    return self.downcase if self =~ /^[A-Z]+$/
+    self.gsub(/([A-Z]+)(?=[A-Z][a-z]?)|\B[A-Z]/, '_\&') =~ /_*(.*)/
+    return $+.downcase
+  end unless method_defined?(:snake_case)
+end # class String
+
+class Hash #:nodoc:
+  # @return <String> This hash as a query string
+  #
+  # @example
+  #   { :name => "Bob",
+  #     :address => {
+  #       :street => '111 Ruby Ave.',
+  #       :city => 'Ruby Central',
+  #       :phones => ['111-111-1111', '222-222-2222']
+  #     }
+  #   }.to_params
+  #     #=> "name=Bob&address[city]=Ruby Central&address[phones][]=111-111-1111&address[phones][]=222-222-2222&address[street]=111 Ruby Ave."
+  def to_params
+    params = self.map { |k,v| normalize_param(k,v) }.join
+    params.chop! # trailing &
+    params
+  end
+
+  # @param key<Object> The key for the param.
+  # @param value<Object> The value for the param.
+  #
+  # @return <String> This key value pair as a param
+  #
+  # @example normalize_param(:name, "Bob Jones") #=> "name=Bob%20Jones&"
+  def normalize_param(key, value)
+    param = ''
+    stack = []
+
+    if value.is_a?(Array)
+      param << value.map { |element| normalize_param("#{key}[]", element) }.join
+    elsif value.is_a?(Hash)
+      stack << [key,value]
+    else
+      param << "#{key}=#{URI.encode(value.to_s, Regexp.new("[^#{URI::PATTERN::UNRESERVED}]"))}&"
+    end
+
+    stack.each do |parent, hash|
+      hash.each do |key, value|
+        if value.is_a?(Hash)
+          stack << ["#{parent}[#{key}]", value]
+        else
+          param << normalize_param("#{parent}[#{key}]", value)
+        end
+      end
+    end
+
+    param
+  end
+  
+  # @return <String> The hash as attributes for an XML tag.
+  #
+  # @example
+  #   { :one => 1, "two"=>"TWO" }.to_xml_attributes
+  #     #=> 'one="1" two="TWO"'
+  def to_xml_attributes
+    map do |k,v|
+      %{#{k.to_s.snake_case.sub(/^(.{1,1})/) { |m| m.downcase }}="#{v}"}
+    end.join(' ')
+  end
+end
+
+class BlankSlate #:nodoc:
+  instance_methods.each { |m| undef_method m unless m =~ /^__/ }
+end

data/lib/http.rb

@@ -0,0 +1,68 @@
+module HTTP
+  @@http = Resourceful::HttpAccessor.new
+  @@uri = 'http://api.trumpet.io:3000'
+  
+  def self.get(path, options={})
+    do_request(:get, path, options)
+  end
+
+  def self.post(path, options={})
+    do_request(:post, path, options)
+  end
+
+  def self.put(path, options={})
+    do_request(:put, path, options)
+  end
+
+  def self.delete(path, options={})
+    do_request(:delete, path, options) 
+  end
+
+  private
+  
+    def self.do_request(method, path, options)
+      resource = @@http.resource("#{@@uri}#{URI.encode(path)}")
+      begin
+        response = if method == :post
+          resource.send(method, options[:parameters].to_params, :content_type => "application/x-www-form-urlencoded")
+        else
+          options[:parameters] ? resource.send(method, options[:parameters].to_params) : resource.send(method)
+        end
+      rescue Resourceful::UnsuccessfulHttpRequestError => e
+        response = e.http_response
+        error_string = JSON.parse(response.body).to_s
+        
+        case response.code
+        when 400
+          raise Trumpet::BadRequest, error_string
+        when 403
+          raise Trumpet::Forbidden, error_string
+        when 404
+          raise Trumpet::NotFound, error_string
+        when 405
+          raise Trumpet::MethodNotAllowed, error_string
+        when 500
+          raise Trumpet::InternalServerError, error_string
+        when 501
+          raise Trumpet::NotImplemented, error_string
+        end
+      rescue IOError # Coudln't connect to server
+        raise Trumpet::ServerConnectionError, 'Could not connect to server'
+      end
+      
+      (options[:parse_response] == false) ? response : JSON.parse(response.body)
+    end
+
+    def self.handle_response(response, parse_response)
+      case response.code
+      when 400
+        # TODO: what to do here?
+      when 404
+        raise Trumpet::ResourceNotFound JSON.parse(response.body)
+      when 500
+        # TODO: what to do here?
+      end
+      
+      parse_response ? JSON.parse(response.body) : response
+    end
+end

data/lib/trumpet/channel.rb

@@ -0,0 +1,40 @@
+module Trumpet
+  class Channel
+    @@attributes = [
+      :name,
+      :created_at,
+      :updated_at
+    ]
+    
+    attr_reader *@@attributes
+    
+    def self.create(options)
+      Channel.new(HTTP.post('/channels', :parameters => options))
+    end
+    
+    def self.find(name)
+      Channel.new(HTTP.post("/channels/#{name}"))
+    end
+    
+    def self.all
+      HTTP::get('/channels').map { |attributes| Channel.new(attributes) }
+    end
+        
+    def broadcast(message)
+      Message.new(HTTP.post("/channels/#{@name}/messages", :parameters => message.to_h))
+    end
+    
+    def messages
+      messages = HTTP.get("/channels/#{@name}/messages")
+      messages.map { |attributes| Message.new(attributes) }
+    end
+
+    protected
+    
+      def initialize(attributes)
+        @@attributes.each do |attr|
+          self.instance_variable_set(:"@#{attr.to_s}", attributes[attr.to_s]) if attributes[attr.to_s]
+        end
+      end
+  end
+end

data/lib/trumpet/exceptions.rb

@@ -0,0 +1,29 @@
+# TODO: Add more exceptions here
+
+module Trumpet
+  
+  # Exception raised when the connection to the server fails
+  class ServerConnectionError < StandardError; end
+  
+  # A generic exception to use until we have more specific exceptions
+  # for everything
+  class TrumpetError < StandardError; end
+  
+  # HTTP 400 Error
+  class BadRequest < StandardError; end
+  
+  # HTTP 403 Error
+  class Forbidden < StandardError; end
+  
+  # HTTP 404 Error
+  class NotFound  < StandardError; end
+  
+  # HTTP 405 Error
+  class MethodNotAllowed  < StandardError; end
+  
+  # HTTP 500 Error
+  class InternalServerError  < StandardError; end
+  
+  # HTTP 501 Error
+  class NotImplemented  < StandardError; end
+end

data/lib/trumpet/listener.rb

@@ -0,0 +1,37 @@
+module Trumpet
+  class Listener
+    @@attributes = [
+      :receiver_id,
+      :uri,
+      :start,
+      :end,
+      :days,
+      :created_at,
+      :updated_at,
+    ]
+    
+    attr_reader *@@attributes
+    
+    
+    def self.create(options)
+      Listener.new(HTTP.post('/listeners', :parameters => options))
+    end
+    
+    def self.find(id)
+      Listener.new(HTTP.get("/listeners/#{id}"))
+    end
+    
+    def self.delete
+      HTTP.delete("/listeners/#{@id}")
+    end
+    
+    
+    protected
+    
+      def initialize(attributes)
+        @@attributes.each do |attr|
+          self.instance_variable_set(:"@#{attr.to_s}", attributes[attr.to_s]) if attributes[attr.to_s]
+        end
+      end
+  end
+end

data/lib/trumpet/message.rb

@@ -0,0 +1,34 @@
+module Trumpet
+  class Message
+    @@attributes = [
+      :url        , :creator_id,
+      :author     , :author_name,
+      :avatar_url , :authored_at,
+      :title      , :description,
+      :tags       , :location_string,
+      :lat        , :lng,
+      :radius     , :channel,
+      :public     , :authorized_receiver_owners,
+      :content    , :created_at,
+      :updated_at , :id
+    ]
+    
+    #TODO: created_at and updated_at maybe not writable
+    
+
+    attr_accessor *@@attributes
+
+    def initialize(attributes)
+      
+
+      
+      @@attributes.each do |attr|
+        self.send "#{attr.to_s}=".to_sym, (attributes[attr] || attributes[attr.to_s])
+      end
+    end
+    
+    def to_h
+      @@attributes.inject({}) { |hash, attribute| hash[attribute] = self.send(attribute); hash }
+    end
+  end
+end

data/lib/trumpet/receiver.rb

@@ -0,0 +1,51 @@
+module Trumpet
+  class Receiver
+    include TrumpetResource
+    
+    @@attributes = [
+      :id         , :url,
+      :source_url , :creator_id       ,
+      :author     , :author_name      ,
+      :avatar_url , :authored_at      ,
+      :title      , :description      ,
+      :tags       , :location_string  ,
+      :lat        , :lng              ,
+      :radius     , :channels         ,
+      :keywords   , :name             ,  
+      :created_at , :updated_at       ,
+      :errors
+    ]
+    attr_reader *@@attributes
+    
+    
+    def self.create(options={})
+      Receiver.new(HTTP.post("/receivers", :parameters => options))
+    end
+    
+    def self.find(id)
+      Receiver.new(HTTP.get("/receivers/#{id}"))
+    end
+
+    def delete
+      HTTP.delete("/receivers/#{@id}")
+    end
+    
+    def messages
+      messages = HTTP.get("/receivers/#{@id}/messages")
+      messages.map { |attributes| Message.new(attributes) }
+    end
+    
+    def listen
+      #TODO: impliment this
+    end
+    
+    
+    protected
+    
+      def initialize(attributes)
+        @@attributes.each do |attr|
+          self.instance_variable_set(:"@#{attr.to_s}", attributes[attr.to_s]) if attributes[attr.to_s]
+        end
+      end
+  end
+end

data/lib/trumpet/sieve.rb

@@ -0,0 +1,102 @@
+module Trumpet
+  class Sieve
+    include HTTParty
+    base_uri 'devour.cc:3000'
+    
+    @@options_attributes = [
+      :keywords     , :location ,
+      :via          , :to       ,
+      :days         , :start    ,
+      :end          , :expires  ,
+      :foreign_id
+    ]
+    
+    attr_accessor :id, :foreign_id, :name, :type, :created_at, :options
+    
+    @@options_attributes.each do |attribute|
+      define_method "#{attribute}=" do |value|
+        @options[attribute] = value
+      end
+      define_method attribute do
+        @options[attribute]
+      end
+    end
+    
+    
+    def initialize(options={})
+      options.reject! { |key, value| value.nil? || (value.is_a?(String) && value.strip.empty?) }
+      
+      @options = {}
+      @@options_attributes.each do |attribute|
+        value = options[attribute] || options[attribute.to_s]
+        @options[attribute] = value if value
+      end
+    end
+        
+    def pull
+      add_to_server
+
+      self.class.get("/sieves/#{id}").inject([]) do |memo, attributes|
+        memo << Nugget.new(attributes)
+      end
+    end
+
+    def subscribe
+      wait_time ||= 2 # seconds
+
+      while true
+        results = pull
+        results.each { |nugget| yield nugget }
+        wait_time = results.nil? ? wait_time*2 : [wait_time/2, 2].max
+        sleep(wait_time)
+      end
+    end
+    
+    def delete
+      self.class.delete("/sieves/#{@id}")
+    end
+        
+    def add_to_server
+      unless @id
+        attributes = self.class.post("/sieves", :query => options)
+        @id   = attributes['id']
+        @type = attributes['type']
+        @name = attributes['name']
+      end
+    end
+    
+    def self.index
+      get("/sieves")
+    end
+    
+    def self.find(id)
+      attributes = get("/sieves/?id=#{id}").first
+      instantiate(attributes)
+    end
+    
+    def self.find_by_foreign_id(foreign_id)
+      sieve_attributes = get("/sieves/?foreign_id=#{foreign_id}")
+      sieve_attributes.collect { |attributes| instantiate(attributes) }
+    end
+    
+    def self.create(options={})
+      sieve = new(options)
+      sieve.add_to_server
+      sieve
+    end
+
+    
+    private
+    
+      def self.instantiate(attributes)
+        sieve = allocate
+        
+        sieve.id = attributes['id']
+        sieve.options = attributes['options']
+        sieve.type = attributes['type']
+        sieve.name = attributes['name']
+        
+        sieve
+      end
+  end
+end

data/lib/trumpet/transmitter.rb

@@ -0,0 +1,43 @@
+module Trumpet
+  class Transmitter
+    @@attributes = [
+      :transmitter_id,
+      :source_url,
+      :tags,
+      :location_string,
+      :channel,
+      :lat,
+      :lng,
+      :radius,
+      :public,
+      :created_at,
+      :updated_at,
+    ]
+    
+    attr_reader *@@attributes
+    
+    def self.create(options)
+      attributes = HTTP::post('transmitters', :query => options)
+      Transmitter.new(attributes)
+    end
+    
+    def self.find(id)
+      attributes = get("/transmitters/#{id}")
+      Transmitter.new(attributes)
+    end
+    
+    def delete
+      self.class.delete('/')
+    end
+    
+    def listeners
+      listeners = self.class.get("/transmitters/#{id}/listeners")
+      listeners.map { |attributes| Listener.new(attributes) }
+    end
+    
+    def broadcast(message)
+      self.class.post("/transmitters/#{@transmitter_id}/messages", :query => message.to_h)
+    end
+
+  end
+end

data/lib/trumpet/trumpet_resource.rb

@@ -0,0 +1,7 @@
+module Trumpet
+  module TrumpetResource
+    def to_h
+      @@attributes.inject({}) { |hash, attribute| hash[attribute] = self.send(attribute); hash }
+    end
+  end
+end

data/lib/trumpet/user.rb

@@ -0,0 +1,20 @@
+module Trumpet
+  class User
+    @@attributes = [:name]
+    attr_reader *@@attributes
+    
+    def self.create(options)
+      attributes = post('/users', options)
+      User.new(attributes)
+    end
+    
+    def self.find(name)
+      attributes = get("/users/#{name}")
+      User.new(attributes) if attributes["name"]
+    end
+    
+    def delete
+      self.class.delete("/users/#{@name}")
+    end
+  end
+end

data/lib/trumpet.rb

@@ -0,0 +1,29 @@
+$:.unshift(File.dirname(__FILE__))
+
+require 'rubygems'
+require 'resourceful'
+require 'json'
+
+require 'core_extensions'
+require 'http'
+
+
+module Trumpet
+  include HTTP
+  
+  def authenticate(name, token)
+    
+  end
+  
+  def authenticated?
+    
+  end
+end
+
+require 'trumpet/trumpet_resource'
+require 'trumpet/exceptions'
+require 'trumpet/message'
+require 'trumpet/receiver'
+require 'trumpet/listener'
+require 'trumpet/transmitter'
+require 'trumpet/channel'

data/spec/channel_spec.rb

@@ -0,0 +1,5 @@
+require 'spec_helper'
+
+describe "Channel" do
+  
+end

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+require 'rubygems'
+require 'fakeweb'
+require 'spec'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'trumpet'
+
+Spec::Runner.configure do |config|
+  
+end

metadata

@@ -0,0 +1,91 @@
+--- !ruby/object:Gem::Specification 
+name: trumpet-trumpet
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Michael Taras
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-04-30 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: resourceful
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: json
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: 
+email: wtf@trumpet.io
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- LICENSE
+- README.rdoc
+- Rakefile
+- VERSION.yml
+- lib/core_extensions.rb
+- lib/http.rb
+- lib/trumpet.rb
+- lib/trumpet/channel.rb
+- lib/trumpet/exceptions.rb
+- lib/trumpet/listener.rb
+- lib/trumpet/message.rb
+- lib/trumpet/receiver.rb
+- lib/trumpet/sieve.rb
+- lib/trumpet/transmitter.rb
+- lib/trumpet/trumpet_resource.rb
+- lib/trumpet/user.rb
+- spec/channel_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/trumpet/trumpet
+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.2.0
+signing_key: 
+specification_version: 2
+summary: The official trumpet gem
+test_files: 
+- spec/channel_spec.rb
+- spec/spec_helper.rb