stormmq-client 0.0.4

data/bin/stormmq-list-companies

@@ -0,0 +1,89 @@
+#!/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::ListCompanies < StormMQ::Application
+
+  def initialize
+    synopsis      "--help | <userName>"
+    options       :help
+    expected_args :user
+  end
+
+  def main
+    puts JSON.pretty_generate(self.rest_client(@user).companies)
+  end
+
+  def man
+    <<-EOM
+NAME
+
+  #{File.basename(__FILE__)}
+
+PURPOSE
+
+  Lists the names of all the companies you belong to. Ordinary users
+  belong to only one company. For ordinary users, your userName is
+  the same as your companyName. For example, if you signed up as
+  'bob', then your userName is bob and your company is bob.
+
+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 simple JSON list of strings to STDOUT.
+
+REST API
+
+  Equivalent is 'GET /companies/'.
+
+NOTES
+
+  Use #{File.basename(__FILE__)} to find your companyName for
+  use with the other tools.
+
+  Security prevents you from obtaining information about which other
+  users belong to which companies.
+
+COPYRIGHT
+
+  Copyright (c) 2010, Tony Byrne & StormMQ Ltd.
+  All rights reserved.
+
+SELF TEST
+
+  #{self_test}
+
+    EOM
+  end
+
+end
+
+StormMQ::Application::ListCompanies.run

data/bin/stormmq-list-exchanges

@@ -0,0 +1,131 @@
+#!/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::ListExchanges < 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).exchanges(@company, @system, @environment))
+  end
+
+  def man
+    <<-EOM
+NAME
+
+  #{File.basename(__FILE__)}
+
+PURPOSE
+
+  Describes the currently known exchanges and their state 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>/exchanges/.
+
+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::ListExchanges.run

data/bin/stormmq-list-queues

@@ -0,0 +1,131 @@
+#!/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::ListQueues < 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).queues(@company, @system, @environment))
+  end
+
+  def man
+    <<-EOM
+NAME
+
+  #{File.basename(__FILE__)}
+
+PURPOSE
+
+  Describes the currently known queues and their state 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>/queues/.
+
+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::ListQueues.run

data/bin/stormmq-list-systems

@@ -0,0 +1,111 @@
+#!/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::ListSystems < 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).systems(company))
+  end
+
+  def man
+    <<-EOM
+NAME
+
+  #{File.basename(__FILE__)}
+
+PURPOSE
+
+  Lists the names of all the systems you've created in our Messaging
+  Cloud. A system is a logical view of resources. When you activate
+  your account, we'll create a default system for you, named the same
+  as your userName (we were going to call it default, but we worried
+  that'd be too easy to guess). Typically you'd only need one system,
+  e.g. 'AccountRocks', 'InflationSwapCalculator', 'Jibbit-X', etc.
+  A system has environments. A system-environment pair matches an
+  AMQP Virtual Host.
+
+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, once you activated your account, we created a
+    system with the same name as your userName. If you're not sure of
+    any systems you've subsequently created you can retrieve them with:
+
+    stormmq-list-systems <userName>
+
+  --help, -h
+
+    Displays this help page then quits.
+
+RESULT
+
+  Outputs a simple JSON list of strings to STDOUT.
+
+REST API
+
+  Equivalent is GET /companies/<companyName>/.
+
+NOTES
+
+  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::ListSystems.run