hydna 0.1.0

data/LICENSE

@@ -0,0 +1,24 @@
+Copyright (c) 2012, Hydna AB
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright
+      notice, this list of conditions and the following disclaimer in the
+      documentation and/or other materials provided with the distribution.
+    * Neither the name of the Hydna AB nor the
+      names of its contributors may be used to endorse or promote products
+      derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL Hydna AB BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,29 @@
+# Hydna Ruby Client Library
+
+This first version of our client library for Ruby implements support for the
+Hydna Push API. Future versions will include support for the full set of
+features.
+
+More info: https://www.hydna.com/
+
+## Installation
+
+
+
+
+## Usage
+
+The `hydna`-module exposes two functions:
+
+    require 'hydna'
+
+	begin
+	  # sending messages
+	  Hydna.push("https://public.hydna.net/4000", "Hello World")
+
+	  # sending signals
+	  Hydna.emit("https://public.hydna.net/4000", "Hello World") 
+
+	rescue Exception => e
+	  puts e.message
+	end

data/lib/hydna.rb

@@ -0,0 +1,169 @@
+require 'uri'
+require 'net/http'
+require 'net/https'
+
+module Hydna
+  
+  DEFAULT_CHANNEL   = 1
+  MAX_PAYLOAD_SIZE  = 10240;
+  MAX_CHANNEL_VALUE = 0xFFFFFFF
+  MAX_TOKEN_SIZE    = 0xFFF8
+  
+  def self.emit(domain, data, ctoken=nil, agent='hydna-ruby-push')
+
+    headers = {
+      'Content-Type' => 'text/plain',
+      'User-Agent' => agent,
+      'X-Emit' => 'yes'
+    }
+
+    token = clean_token(ctoken) 
+
+    if token != nil
+      headers['X-Token'] = token
+    end
+
+    send(domain, headers, data)
+
+  end
+
+  def self.push(domain, data, prio=1, ctoken=nil, agent='hydna-ruby-push')
+
+    headers = {
+      'Content-Type' => 'text/plain',
+      'User-Agent' => agent
+    }
+
+    token = clean_token(ctoken) 
+
+    if token != nil
+      headers['X-Token'] = token
+    end
+
+    prio = clean_prio(prio)
+
+    headers['X-Priority'] = prio.to_s()
+
+    send(domain, headers, data)
+
+  end
+  
+  private
+  
+  def self.send(domain, headers, data)
+
+    uri = parse_uri(domain)
+
+    data = clean_payload(data)
+
+    http = Net::HTTP::new(uri['host'], uri['port'])
+    
+    if uri['scheme'] == 'https'
+      http.use_ssl = true
+      http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+    end
+
+    path = "/%d/" % uri['channel']
+
+    if uri['token'] != nil
+      path = "%s?%s" % [path, uri['token']]
+    end
+
+    resp, body = http.post(path, data, headers)
+    
+    if Integer(resp.code) != 200
+      raise resp.message
+    end
+
+    return true
+
+  end
+  
+  def self.clean_prio(prio)
+    if !is_numeric(prio)
+      raise "Priority needs to be a number 1-4"
+    end
+
+    if prio < 0 or prio > 4
+      raise "Priority needs to be 1-4"
+    end  
+
+    return prio
+  end
+
+  def self.clean_payload(data)
+
+    if data.bytesize == 0
+      raise "Payload expected" 
+    end
+
+    if data.bytesize > MAX_PAYLOAD_SIZE:
+      raise "Payload exceeds maximum length allowed"
+    end
+
+    return data
+  end
+
+  def self.clean_token(token=nil)
+
+    if token == nil
+      return nil
+    end
+
+    if token.bytesize > MAX_TOKEN_SIZE
+      raise "Token exceeds maximum length allowed"
+    end
+
+    return token
+
+  end
+
+  def self.is_numeric(str)
+    begin Float(str) ; true end rescue false
+  end
+
+  def self.path_to_channel(query)
+    if query.length < 2
+      return DEFAULT_CHANNEL;  
+    end
+
+    parts = query.split("/");
+
+    if parts.length > 3
+      raise "Unable to parse channel"
+    end
+
+    if !is_numeric(parts[1])
+      raise "Invalid channel"
+    end
+
+    channel = Integer(parts[1]);
+
+    if channel > MAX_CHANNEL_VALUE or channel <= 0
+      raise "Invalid channel"
+    end
+
+    return channel;
+  end
+
+  def self.parse_uri(domain)
+
+    if domain.index("http") == nil
+      domain = "http://%s" % domain
+    end
+
+    uri = URI.parse(domain)
+
+    channel = path_to_channel(uri.path)
+    token = clean_token(uri.query)
+
+    return {
+      'scheme' => uri.scheme,
+      'host' => uri.host,
+      'channel' => channel,
+      'token' => token,
+      'port' => uri.port
+    }
+
+  end
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification 
+name: hydna
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- "Isak Wistr\xC3\xB6m"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-04-11 00:00:00 Z
+dependencies: []
+
+description: Hydna exposes a straightforward API over HTTP. It uses a single resource; sending messages is done by making POST requests to the same URI you'd use to connect to Hydna in any client library.
+email: iw@hydna.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.md
+files: 
+- LICENSE
+- README.md
+- lib/hydna.rb
+homepage: https://github.com/hydna/hydna-ruby
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.21
+signing_key: 
+specification_version: 3
+summary: Bindings for hydna push API.
+test_files: []
+