stormmq-client 0.0.4

data/bin/stormmq-list-amqpusers

@@ -0,0 +1,142 @@
+#!/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'
+require 'json'
+
+class StormMQ::Application::ListAMQPUsers < StormMQ::Application
+
+  def initialize
+    synopsis "--help | <userName> <systemName> <companyName> <environmentName>"
+    options :help
+    expected_args :user, :system, :company, :environment
+  end
+
+  def main
+    puts JSON.pretty_generate(self.rest_client(@user).amqp_users(@company, @system, @environment))
+  end
+
+  def man
+    <<-EOM
+NAME
+
+  #{File.basename(__FILE__)}
+
+PURPOSE
+
+  Lists all the AMQP user names and passwords. For a recently signed
+  up user, we've created you a default system with a default AMQP
+  user name (amqpUserName) the same as your userName, so you don't
+  need this tool yet.
+
+USAGE
+
+  #{File.basename(__FILE__)} --help
+  #{File.basename(__FILE__)} <userName> <systemName> <companyName> <environmentName>
+
+  For ordinary users, your companyName is the same as your userName.
+
+  For recently signed up users, the systemName is the same as your
+  userName.
+
+  For recently signed up users, the environmentName is one of:
+
+  * development
+  * testing
+  * production
+
+  For recently signed up users, the amqpUserName is the same as your
+  userName.
+
+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>
+
+  <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).
+
+  --help, -h
+
+    Displays this help page then quits.
+
+RESULT
+
+  Outputs a simple JSON object of string keys (user names to use with
+  AMQP) to string values (AMQP passwords, to be used as is without
+  decoding but excluding the quotes).
+
+  If using the default system created when you signed up, then the
+  user name to log on to AMQP ('amqpUserName') will be the same as
+  your userName.
+
+REST API
+
+  Equivalent is GET /companies/<companyName>/<systemName>/<environmentName>/users/.
+
+NOTES
+
+  Output is not JSON, so not suitable for use with XHTML, etc, response documents.
+
+  To find you companyName, use:
+
+    stormmq-list-companies
+
+  To delete your default system, use:
+
+    stormmq-delete-system <userName>
+
+  To create a new system, use:
+
+    stormmq-create-system <userName> <systemName>
+
+COPYRIGHT
+
+  Copyright (c) 2010, Tony Byrne & StormMQ Ltd.
+  All rights reserved.
+
+SELF TEST
+
+  #{self_test}
+
+    EOM
+  end
+
+
+end
+
+StormMQ::Application::ListAMQPUsers.run

data/bin/stormmq-list-apis

@@ -0,0 +1,86 @@
+#!/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'
+require 'json'
+
+class StormMQ::Application::ListAPIs < StormMQ::Application
+
+  def initialize
+    synopsis  "--help | <userName>"
+    options :help
+    expected_args :user
+  end
+
+  def main
+    puts JSON.pretty_generate(self.rest_client(@user).apis)
+  end
+
+  def man
+    <<-EOM
+NAME
+
+  #{File.basename(__FILE__)}
+
+PURPOSE
+
+  Describes all current APIs available (as JSON).
+
+USAGE
+
+  #{File.basename(__FILE__)} --help
+  #{File.basename(__FILE__)} <userName>
+
+PARAMETERS
+
+  <userName>
+
+    The user name you log into the site with. When provided, lists
+    the companies associated with that user name.
+
+    Note:
+
+  --help, -h
+
+    Displays this help page then quits.
+
+RESULT
+
+  Outputs a pretty-printed complex JSON list to standard out.
+
+REST API
+
+  Equivalent is 'GET /'.
+
+NOTES
+
+  Use #{File.basename(__FILE__)} to verify that your setup works.
+
+  Pretty prints JSON, so not suitable for use with XHTML etc.,
+  response documents.
+
+COPYRIGHT
+
+  Copyright (c) 2010, Tony Byrne & StormMQ Ltd.
+  All rights reserved.
+
+SELF TEST
+
+  #{self_test}
+
+    EOM
+  end
+
+
+end
+
+StormMQ::Application::ListAPIs.run

data/bin/stormmq-list-bindings

@@ -0,0 +1,130 @@
+#!/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'
+require 'json'
+
+class StormMQ::Application::ListBindings < StormMQ::Application
+
+  def initialize
+    synopsis "--help | <userName> <systemName> <companyName> <environmentName>"
+    options :help
+    expected_args :user, :system, :company, :environment
+  end
+
+  def main
+    puts JSON.pretty_generate(self.rest_client(@user).bindings(@company, @system, @environment))
+  end
+
+  def man
+    <<-EOM
+NAME
+
+  #{File.basename(__FILE__)}
+
+PURPOSE
+
+  Describes the currently known queue bindings for an Environment.
+
+USAGE
+
+  #{File.basename(__FILE__)} --help
+  #{File.basename(__FILE__)} <userName> <systemName> <companyName> <environmentName>
+
+  For ordinary users, your companyName is the same as your userName.
+
+  For recently signed up users, the systemName is the same as your
+  userName.
+
+  For recently signed up users, the environmentName is one of:
+
+  * development
+  * testing
+  * production
+
+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>
+
+  <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).
+
+  --help, -h
+
+    Displays this help page then quits.
+
+RESULT
+
+  Outputs a pretty-printed complex JSON list to STDOUT.
+
+REST API
+
+  Equivalent is GET /companies/<companyName>/<systemName>/<environmentName>/bindings/.
+
+NOTES
+
+  Output is not JSON, so not suitable for use with XHTML, etc, response documents.
+
+  To find you companyName, use:
+
+    stormmq-list-companies
+
+  To delete your default system, use:
+
+    stormmq-delete-system <userName>
+
+  To create a new system, use:
+
+    stormmq-create-system <userName> <systemName>
+
+COPYRIGHT
+
+  Copyright (c) 2010, Tony Byrne & StormMQ Ltd.
+  All rights reserved.
+
+SELF TEST
+
+  #{self_test}
+
+    EOM
+  end
+
+
+end
+
+StormMQ::Application::ListBindings.run

data/bin/stormmq-list-clusters

@@ -0,0 +1,101 @@
+#!/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::ListClusters < StormMQ::Application
+
+  def initialize
+    synopsis  "--help | <userName> | <userName> <companyName>"
+    options :help
+    expected_args [1,2]
+  end
+
+  def main
+    user    = argv[0]
+    company = argv[1] || user
+    puts JSON.pretty_generate(self.rest_client(user).clusters(company))
+  end
+
+  def man
+    <<-EOM
+NAME
+
+  #{File.basename(__FILE__)}
+
+PURPOSE
+
+  Lists the names of the clusters in our Messaging Cloud you can
+  access through your company. You'll need this information if you're
+  creating complex system-environment combinations.
+
+  Currently, the only cluster everyone can access is free-1.
+
+  Ordinary users can only access free clusters. If you're sending a
+  lot of messages, you might want to use Contended Clusters or
+  Co-Located Dedicated Clusters. Please ask us for more information.
+
+USAGE
+
+  #{File.basename(__FILE__)} --help
+  #{File.basename(__FILE__)} <userName>
+  #{File.basename(__FILE__)} <userName> <companyName>
+
+  The second form assumes your companyName is the same as your
+  userName. This is true for ordinary users.
+
+PARAMETERS
+
+  <userName>
+
+    The user name you log into the site with.
+
+  <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>
+
+  --help, -h
+
+    Displays this help page then quits.
+
+RESULT
+
+  Outputs a simple JSON list of strings to STDOUT.
+
+REST API
+
+  Equivalent is GET /clusters/<companyName>.
+
+NOTES
+
+  To find you companyName, use:
+
+    stormmq-list-companies
+
+COPYRIGHT
+
+  Copyright (c) 2010, Tony Byrne & StormMQ Ltd.
+  All rights reserved.
+
+SELF TEST
+
+  #{self_test}
+
+    EOM
+  end
+
+end
+
+StormMQ::Application::ListClusters.run