stormmq-client 0.0.4

data/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2010, Tony Byrne & StormMQ Ltd.
+All rights reserved.
+
+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

@@ -0,0 +1 @@
+=== Client for StormMQ's Cloud Messaging Service.

data/Rakefile

@@ -0,0 +1,19 @@
+#--
+# Copyright (c) 2010, Tony Byrne & StormMQ Ltd.
+# All rights reserved.
+#
+# Please refer to the LICENSE file that accompanies this source
+# for terms of use and redistribution.
+#++
+
+require 'rake'
+require 'spec/rake/spectask'
+
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.spec_opts  = ['--colour','--format progress']
+  t.rcov       = true
+  t.rcov_opts  = ['--exclude "spec/*,gems/*"']
+end
+
+task :default  => :spec

data/TODO

@@ -0,0 +1,11 @@
+* Implement Windows support / Windows GEM.
+
+* stormmq-create-system: implement template reading from file
+
+* Test proxy support
+
+* SSL certificate support
+
+* Refactor REST methods
+
+* Tests and coverage.

data/bin/stormmq-amqp-echo-test

@@ -0,0 +1,204 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+#--
+# Copyright (c) 2010, Tony Byrne & StormMQ Ltd.
+# All rights reserved.
+#
+# Please refer to the LICENSE file that accompanies this source
+# for terms of use and redistribution.
+#++
+
+$:.unshift File.join(File.expand_path(File.dirname(__FILE__)), "..", "lib")
+
+require 'stormmq/amqp'
+require 'stormmq/application'
+
+class StormMQ::Application::AMQPEchoTest < StormMQ::Application
+
+  def initialize
+    synopsis  "--help | --company <companyName> --system <systemName> --environment <environmentName> --amqpUser <amqpUserName> --amqpPassword <amqpUserPassword> [--host <host>] [--port <port>] [--debug]"
+    options :help, :debug
+
+    option  :names           => %w(--host),
+            :opt_description => "server to connect to - defaults to 'amqp.stormmq.com'",
+            :arity           => [1,1],
+            :opt_found       => get_args,
+            :opt_not_found   => 'amqp.stormmq.com'
+
+    option  :names           => %w(--port),
+            :opt_description => "SSL port on server to connect to - defaults to '443'",
+            :arity           => [1,1],
+            :opt_found       => get_args,
+            :opt_not_found   => '443'
+
+    option  :names           => %w(--amqpUser -u),
+            :opt_description => "a valid user name, i.e. the login you use at http://stormmq.com/",
+            :arity           => [1,1],
+            :opt_found       => get_args,
+            :opt_not_found   => CommandLine::OptionParser::OPT_NOT_FOUND_BUT_REQUIRED
+
+    option  :names           => %w(--amqpPassword -p),
+            :opt_description => "Base64 encoded password, e.g. 'BNuWk1agaAUPTZ15sx44kHvNkTnJXsevqTjIo1M1iwFOeNaUqr3qPn75Dnk=='",
+            :arity           => [1,1],
+            :opt_found       => get_args,
+            :opt_not_found   => CommandLine::OptionParser::OPT_NOT_FOUND_BUT_REQUIRED
+
+    option  :names           => %w(--company -c),
+            :opt_description => "your company identifier, usually the same as --amqpUser",
+            :arity           => [1,1],
+            :opt_found       => get_args,
+            :opt_not_found   => CommandLine::OptionParser::OPT_NOT_FOUND_BUT_REQUIRED
+
+    option  :names           => %w(--system -s),
+            :opt_description => "your system, usually the same as --amqpUser",
+            :arity           => [1,1],
+            :opt_found       => get_args,
+            :opt_not_found   => CommandLine::OptionParser::OPT_NOT_FOUND_BUT_REQUIRED
+
+    option  :names           => %w(--environment -e),
+            :opt_description => "the environment to use, e.g 'production', 'development', or 'testing'",
+            :arity           => [1,1],
+            :opt_found       => get_args,
+            :opt_not_found   => CommandLine::OptionParser::OPT_NOT_FOUND_BUT_REQUIRED
+
+  end
+
+  def main
+
+    EM.run do
+
+      puts "creating connection"
+      connection = StormMQ::AMQPClient.connect(
+        :user        => opt.amqpUser,
+        :password    => opt.amqpPassword,
+        :company     => opt.company,
+        :system      => opt.system,
+        :environment => opt.environment,
+        :host        => opt.host,
+        :port        => opt.port,
+        :logging     => opt['--debug']
+      )
+
+      puts "opening a channel on the A MQP connection"
+      channel = MQ.new(connection)
+
+      puts "declaring a queue on the channel"
+      queue = MQ::Queue.new(channel, 'test queue')
+
+      puts "creating a test exchange"
+      exchange = MQ::Exchange.new(channel, :direct, 'test exchange')
+
+      puts "binding the queue the the exchange"
+      queue.bind(exchange)
+
+      puts "publishing test message to the exchange"
+      exchange.publish('hello world')
+
+      puts "subsribing to the queue"
+      queue.subscribe do |headers, msg|
+        puts "recevied message from the queue:"
+        pp headers
+        puts msg
+        puts msg == 'hello world' ? 'Succeeded' : 'Failed'
+        connection.close{ EM.stop_event_loop }
+      end
+
+    end
+
+  end
+
+  def man
+    <<-EOM
+NAME
+
+  #{File.basename(__FILE__)}
+
+PURPOSE
+
+  Tests connections to our AMQP servers (default: amqp.stormmq.com)
+  to try to troubleshoot problems with users, passwords and SSL.
+
+USAGE
+
+  #{File.basename(__FILE__)} --help
+  #{File.basename(__FILE__)} --company <companyName> --system <systemName> --environment <environmentName> --amqpUser <amqpUserName> --amqpPassword <amqpUserPassword>
+
+PARAMETERS
+
+  <systemName>
+
+    If you're not sure if you've already created a system, use:
+
+    stormmq-list-systems <userName>
+
+    Note: A systemName can not contain a '/' or ':'
+
+  <companyName>
+
+    For ordinary users, this is the same as your userName. If you're
+    not sure of your companyName, you can retrieve it with:
+
+    stormmq-list-companies <userName>
+
+  <environmentName>
+
+    One of:
+
+      * development
+      * testing
+      * production
+
+    for the default system created when you signed up, or for any
+    system created by stormmq-create-system <userName>
+    (except advanced use).
+
+  <amqpUserName>
+
+    This is your userName for the default system we created when you
+    signed up, or for any system created by
+    stormmq-create-system <userName> (except advanced use).
+
+  <amqpUserPassword>
+
+   Retrieve this using:
+
+   stormmq-get-amqpuser-password <userName> <companyName> <systemName> \\
+      <environmentName> <amqpUserName>
+
+  --help, -h
+
+    Displays this help page then quits.
+
+  --debug, -d
+
+    Display dialogue between client and server.
+
+  --host
+
+    Specify the amqp server to connect to. Defaults to:
+
+      amqp.stormmq.com
+
+  --port
+
+    Specify the port on the amqp server to connect to.
+
+RESULT
+
+  Outputs test results to STDOUT.
+
+NOTES
+
+  For a default system, you'll just need your userName.
+
+COPYRIGHT
+
+  Copyright (c) 2010, Tony Byrne & StormMQ Ltd.
+  All rights reserved.
+
+    EOM
+  end
+
+end
+
+StormMQ::Application::AMQPEchoTest.run

data/bin/stormmq-create-system

@@ -0,0 +1,211 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+#--
+# Copyright (c) 2010, Tony Byrne & StormMQ Ltd.
+# All rights reserved.
+#
+# Please refer to the LICENSE file that accompanies this source
+# for terms of use and redistribution.
+#++
+
+$:.unshift File.join(File.expand_path(File.dirname(__FILE__)), "..", "lib")
+
+require 'stormmq/application'
+
+class StormMQ::Application::CreateSystem < StormMQ::Application
+
+  def initialize
+    synopsis  "--help | <userName> | <userName> <systemName> | <userName> <systemName> <companyName>"
+    options :help
+    expected_args [1,4]
+  end
+
+  def main
+    user     = argv[0]
+    system   = argv[1] || user
+    company  = argv[2] || user
+    template = argv[3]
+
+    if template
+      json = read_template(template)
+    else
+      json = default_template(user, company, system)
+    end
+
+    self.rest_client(user).create_system(company, system, json)
+  end
+
+  def read_template(path)
+    IO.read(path)
+  end
+
+  def default_template(user, company, system)
+    <<-EOT
+    {
+      "companyName" : "#{user}",
+      "systemName" : "#{system}",
+      "environments" :
+      [
+        {
+          "environmentName" : "development",
+          "clusterName" : "free-1",
+          "permittedStormMQUserNames" :
+          [
+            "#{user}"
+          ]
+        },
+        {
+          "environmentName" : "testing",
+          "clusterName" : "free-1",
+          "permittedStormMQUserNames" :
+          [
+            "#{user}"
+          ]
+        },
+        {
+          "environmentName" : "production",
+          "clusterName" : "free-1",
+          "permittedStormMQUserNames" :
+          [
+            "#{user}"
+          ]
+        }
+      ],
+      "amqpUserPermissions" :
+      {
+        "#{user}" :
+        {
+          "create" : ".*",
+          "read" : ".*",
+          "write" : ".*"
+        }
+      }
+    }
+    EOT
+  end
+
+  def man
+    <<-EOM
+NAME
+
+  #{File.basename(__FILE__)}
+
+PURPOSE
+
+  A system is a logical view of resources in our Messaging Cloud.
+  Typically you'd only need one system, eg 'AccountRocks',
+  'InflationSwapCalculator', 'Jibbit-X', etc. A system has
+  environments.
+
+  A company-system-environment triplet matches an AMQP Virtual Host.
+  E.g., if your company is widgetcorp, your system is accountrock
+  and you want to use an environment of development, your AMQP
+  virtual host name is widgetcorp/accountrock/development.
+
+  If you've just signed up as an ordinary user, then we've already
+  created a system called <userName>for you (see stormmq-list-systems),
+  with an AMQP virtual host called /<userName>/<userName>/development,
+  accessible at amqp.stormmq.com
+
+  All AMQP virtual hosts are virtually hosted on
+  amqp.stormmq.com.
+
+  To find the passwords to log onto them with AMQP, use
+  stormmq-get-amqpuser-password.
+
+USAGE
+
+  #{File.basename(__FILE__)} --help
+  #{File.basename(__FILE__)} <userName>
+  #{File.basename(__FILE__)} <userName> <systemName>
+  #{File.basename(__FILE__)} <userName> <systemName> <companyName>
+  #{File.basename(__FILE__)} <userName> <systemName> <companyName> </path/to/json/template>
+
+  The second form assumes your companyName and systemName is the same
+  as your userName. This is true for ordinary users who've just
+  signed up.
+
+  The third form assumes your companyName is the same as your
+  userName. This is true for ordinary users.
+
+  The fifth form is for advanced use only.
+
+PARAMETERS
+
+  <userName>
+
+    The user name you log into the site with.
+
+  <systemName>
+
+    If you're not sure if you've already created a system, use:
+
+    stormmq-list-systems <userName>
+
+    A systemName can not contain a '/' or ':'
+
+  <companyName>
+
+    For ordinary users, this is the same as your userName. If you're
+    not sure of your companyName, you can retrieve it with:
+
+    stormmq-list-companies <userName>
+
+  </path/to/json/template>
+
+    This is a template used to create a system. Use this to create
+    systems with:
+
+    * Environments using contended or dedicated clusters.
+    * Multiple AMQP users.
+    * Restrictions on whom can access production passwords.
+    * Bespoke per-queue or per-exchange permissions.
+
+    Environment variables will be substituted in the template
+    (specified using ${<NAME>}). If using strings you'll need to
+    make sure they are properly JSON escaped.
+
+  --help, -h
+
+    Displays this help page then quits.
+
+RESULT
+
+  Outputs a simple JSON object if accepted, or nothing if the system
+  already exists with identical settings
+
+REST API
+
+  Equivalent is PUT /companies/<companyName>/<systemName>.
+
+NOTES
+
+  If the system already exists with a different set up, then resources
+  will be created, modified and destroyed as needed. Be careful!
+
+  If using the advanced form, note that your companyName and systemName
+  on the command line must match the values used in the JSON template.
+
+  To find you companyName, use:
+
+    stormmq-list-companies
+
+  To delete your default system, use:
+
+    stormmq-delete-system <userName>
+
+COPYRIGHT
+
+  Copyright (c) 2010, Tony Byrne & StormMQ Ltd.
+  All rights reserved.
+
+SELF TEST
+
+  #{self_test}
+
+    EOM
+  end
+
+end
+
+StormMQ::Application::CreateSystem.run