epc 1.0.2

data/lib/epc/command/update_solution_command.rb

@@ -0,0 +1,45 @@
+module EPC::Command
+  class UpdateSolutionCommand < BaseCommand
+    UPDATABLE_ATTRIBUTES = ["name"]
+
+    def execute(*args)
+      path = "."
+      path = File.expand_path(path)
+      path = project_solution_path(path)
+
+
+      solution_id, solution_name = infer_solution_context(@options[:solution_name], path)
+
+      raise FatalError, "Solution could not be determined" if solution_id.nil?
+
+      args_hash = {}
+      args.each do |arg|
+        key, val = arg.split("=")
+        args_hash[key] = val
+      end
+
+      unless @options[:file].nil?
+        args_hash = EPC::Config.read_content_as_json(@options[:file]).merge(args_hash)
+      end
+
+      args_hash.each do |attr, val|
+        if !UPDATABLE_ATTRIBUTES.include?(attr)
+          args_hash.delete(attr)
+          say("Cannot update #{attr}. Updatable attributes are: #{UPDATABLE_ATTRIBUTES.join(',')}")
+          next
+        end
+      end
+
+
+      unless args_hash.empty?
+        status, response, message = client.put(EPC::Config::SOLUTIONS_PATH + "/#{solution_id}", args_hash)
+        if status.failure?
+          say("Update failed with: [#{response['message']}]")
+        else
+          say("Update succesful") 
+        end
+        return status
+      end
+    end
+  end
+end

data/lib/epc/command/update_user_command.rb

@@ -0,0 +1,57 @@
+module EPC::Command
+  class UpdateUserCommand < BaseCommand
+
+    def execute(user = nil)
+
+      raise FatalError, "You need to specify a user id/email" if user.nil?
+
+      if @options[:password].present?
+        if numeric?(user)
+          email = get_resource_attribute(EPC::Config::USERS_PATH, :email, :id, user.to_i)
+        else
+          email = user
+        end
+        raise FatalError, "User could not be determined" if email.blank?
+
+        raise FatalError, "You need to specify the password change token with the --token option" if @options[:token].blank?
+
+        status, response, headers = client.put(EPC::Config::USERS_PATH + "/#{email}/change_password", {:token => @options[:token], :password => @options[:password]})
+
+        if status.successful?
+          say("Password change successful")
+        else
+          say("Request failed: [#{response[:message]}]")
+        end
+
+        return status
+      end
+
+      if @options[:email].present? || @options[:name].present?
+        if numeric?(user)
+          user_id = user.to_i
+        else
+          user_id = get_resource_id(EPC::Config::USERS_PATH, :email, user)
+        end
+
+        raise FatalError, "User could not be determined" if user_id.blank?
+
+        params = {}
+        params[:email] = @options[:email] if @options[:email].present?
+        params[:name] = @options[:name] if @options[:name].present?
+
+        status, response, headers = client.put(EPC::Config::USERS_PATH + "/#{user_id}", params)
+        
+        if status.successful?
+          say("User updated")
+        else
+          say("Request failed: [#{response[:message]}]")
+        end
+
+        return status
+      end
+
+
+    end
+    
+  end
+end

data/lib/epc/command/user/create_user_command.rb

@@ -0,0 +1,27 @@
+module EPC::Command
+  class CreateUserCommand < BaseCommand
+    def execute(*params)
+
+      email = params[1]
+
+      raise FatalError, "You must supply an email address" if email.blank?
+
+      password = options[:password]
+      password = ask("Password: ") { |q| q.echo = '*' } unless password
+			
+			params = {}
+			params[:email] = email
+			params[:password] = password
+			params[:name] = @options[:name] if @options[:name].present?
+
+      status, response, headers = client.post("#{EPC::Config::USERS_PATH}", params)
+      if status.successful? && response
+        say("Successfully created the user with [#{target_url}]")
+      elsif response
+        say("User creation failed [#{response[:message]}].")
+      end
+      return status
+
+    end
+  end
+end

data/lib/epc/command/vote_deployment_command.rb

@@ -0,0 +1,29 @@
+module EPC::Command
+  class VoteDeploymentCommand < BaseCommand
+
+    def execute(deployment_id = nil)
+      approved = false
+      command_usage = EPC::Help::COMMAND_USAGES[:deny_deployment]
+
+      if @options[:approval] == "approve"
+        approved = true
+        command_usage = EPC::Help::COMMAND_USAGES[:approve_deployment]
+      end
+
+      if deployment_id.nil?
+        say("You must specify a deployment id.")
+        say(command_usage)
+        return 1
+      end
+
+      status, response, headers = client.put(EPC::Config::DEPLOYMENTS_PATH + "/#{deployment_id}/vote", {:approved => approved})
+      if status.successful?
+        say("Deployment [#{deployment_id}] has been #{approved ? "approved" : "rejected"} by you.")
+      else
+        say("Request failed: [#{response[:message]}]")
+      end
+      return status
+    end
+
+  end
+end

data/lib/epc/config.rb

@@ -0,0 +1,245 @@
+require 'fileutils'
+require 'json'
+
+module EPC
+  class Config
+    class << self
+      attr_accessor :target_file, :target_url, :caller_file, :caller_id,
+                    :token_file, :auth_token, :solutions_projects_file, :solutions_projects, :username_file, :username
+    end
+    
+    DEFAULT_TARGET  = 'localhost:3000'
+    
+    # Server Paths
+    SCOPE                    = '/api/v1'
+    TOKENS_PATH              = "#{SCOPE}/tokens"
+    SOLUTIONS_PATH           = "#{SCOPE}/solutions"
+    PROJECTS_PATH            = "#{SCOPE}/projects"
+    PUSHES_PATH              = "#{SCOPE}/pushes"
+    USERS_PATH               = "#{SCOPE}/users"
+    BUILDS_PATH              = "#{SCOPE}/builds"
+    PULLS_PATH               = "#{SCOPE}/pulls"
+    DEPLOYMENTS_PATH         = "#{SCOPE}/deployments"
+    CONFIGURATIONS_PATH      = "#{SCOPE}/config_values"
+    RUNTIMES_PATH            = "#{SCOPE}/runtime_envs"
+    SERVICE_TYPES_PATH       = "#{SCOPE}/service_types"
+    SERVICE_DEFINITIONS_PATH = "#{SCOPE}/service_definitions"
+    DEPLOYMENT_CONFIGS_PATH  = "#{SCOPE}/deployment_configs"
+    DEPLOYMENT_STAGES_PATH   = "#{SCOPE}/deployment_stages"
+    DEPENDENCIES_PATH        = "#{SCOPE}/dependency_definitions"
+    LIBRARIES_PATH           = "#{SCOPE}/libraries"
+    LIBRARY_LANGUAGES_PATH   = "#{SCOPE}/library_languages"
+    LIBRARY_SETS_PATH        = "#{SCOPE}/library_sets"
+    SERVICE_VERSIONS_PATH    = "#{SCOPE}/service_versions"
+    PROJECT_TYPES_PATH       = "#{SCOPE}/project_types"
+    GROUPS_PATH              = "#{SCOPE}/user_groups"
+    ROLES_PATH               = "#{SCOPE}/roles"
+    PERMISSIONS_PATH         = "#{SCOPE}/permissions"
+    GRANTS_PATH              = "#{SCOPE}/grants"
+    OBJECT_TYPES_PATH        = "#{SCOPE}/object_type_identifiers"
+
+
+    class << self
+      def target_file
+        @target_file || '~/.epc_target'
+      end
+      
+      def target_url
+        # return @target_url if @target_url
+      
+        file = File.expand_path(target_file)
+        if File.exists?(file)
+          @target_url = File.read(file).strip!
+        else
+          @target_url = DEFAULT_TARGET
+        end
+        @target_url = "http://#{@target_url}" unless @target_url =~ /^https?/
+        @target_url = @target_url.gsub(/\/+$/, '')
+      
+        @target_url
+      end
+      
+      def store_target_url(url)
+        file = File.expand_path(target_file)
+        File.open(file, 'w+') { |f| f.puts(url) }
+        FileUtils.chmod(0600, file)
+      end
+      
+      def caller_file
+        @caller_file || '~/.epc_caller'
+      end
+    
+      def caller_id
+        return @caller_id if @caller_id
+      
+        file = File.expand_path(caller_file)
+        if File.exists?(file)
+          @caller_id = File.read(file).strip!
+        end
+      
+        @caller_id
+      end
+      
+      def store_caller_id(caller_id)
+        file = File.expand_path(caller_file)
+        File.open(file, 'w+') { |f| f.puts(caller_id) }
+        FileUtils.chmod(0600, file)
+      end
+
+      def username_file
+        @username_file || '~/.epc_user'
+      end
+
+      def store_username(username)
+        file = File.expand_path(username_file)
+        File.open(file, 'w+') { |f| f.puts(username) }
+        FileUtils.chmod(0600, file)
+      end
+
+      def remove_username
+        FileUtils.rm_f(File.expand_path(username_file))
+      end
+
+      def username
+        return @username if @username
+
+        file = File.expand_path(username_file)
+        if File.exists?(file)
+          @username = File.read(file).strip!
+        end
+
+        @username
+      end
+    
+      def token_file
+        @token_file || '~/.epc_token'
+      end
+      
+      def auth_token
+        return @auth_token if @auth_token
+      
+        file = File.expand_path(token_file)
+        if File.exists?(file)
+          @auth_token = File.read(file).strip!
+        end
+      
+        @auth_token
+      end
+      
+      def store_auth_token(token)
+        file = File.expand_path(token_file)
+        File.open(file, 'w+') { |f| f.puts(token) }
+        FileUtils.chmod(0600, file)
+      end
+      
+      def remove_auth_token
+        FileUtils.rm_f(File.expand_path(token_file))
+      end
+      
+
+      def underscore(camel_cased_word)
+        camel_cased_word.to_s.gsub(/::/, '/').
+          gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+          gsub(/([a-z\d])([A-Z])/,'\1_\2').
+          tr("-", "_").
+          downcase
+      end
+
+      # Solutions Projects Management
+      # These convenience methods are here to keep each command from having to know
+      # the structure of the file. This also gives Config control over when to
+      # re-write the file.
+      #
+      def read_content_as_json(file)
+        return JSON.parse(File.read(file)) rescue {}
+      end
+
+      def write_content_as_json(file, content)
+        File.open(file, "w+") {|f| f.puts(content.to_json)}
+      end
+
+      # SOLUTION METHODS
+      
+      
+      def add_solution(solution_name, solution_id)
+        file = File.join(File.expand_path(solution_name), ".epc_solution")
+        write_content_as_json(file, {:name => solution_name, :id => solution_id})
+        FileUtils.chmod(0600, file)
+      end
+
+      def get_solution_value(path, value)
+        return read_content_as_json(File.join(path, ".epc_solution"))[value] rescue nil
+      end
+
+      def set_solution_value(path, key, value)
+        path += "/.epc_solution"
+        content = read_content_as_json(path)
+        content[key] = value
+        write_content_as_json(path, content)
+      end
+
+      def is_solution_dir?(dirname)
+        return File.exists?(File.join(File.expand_path(dirname), ".epc_solution"))
+      end
+      
+      def update_solution_metadata(data, path)
+        set_solution_value(path, "id", data[:id])
+        set_solution_value(path, "name", data[:name])
+
+      end
+
+      def update_solution_directory(path)
+        parent_dir = File.join(path, "../")
+        new_name = get_solution_value(path, "name")
+        new_path = File.join(parent_dir, new_name)
+        (FileUtils.mv(path, new_path) unless path.split("/").last == new_name) rescue ""
+      end
+
+      # PROJECT METHODS
+      
+      def write_project_metadata(project_id, client, base_path = nil)
+        attributes = [:id, :name, :solution_id, :project_type]
+        status, response, headers = client.get(PROJECTS_PATH + "/#{project_id}")
+        if status.failure? || response.empty?
+          raise Exception, "cannot retrieve project details"
+        end
+        metadata = response.keep_if{|k,v| attributes.include?(k)}
+        if base_path.nil?
+          file = File.join(File.expand_path(metadata[:name]), ".epc_project")
+        else
+          file = File.join(base_path, ".epc_project")
+        end
+        write_content_as_json(file, metadata)
+        FileUtils.chmod(0600, file)
+      end
+
+      def update_project_metadata(data, path)
+        set_project_value(path, "id", data[:id])
+        set_project_value(path, "name", data[:name])
+      end
+        
+      def get_project_value(path, value)
+        return read_content_as_json(path + "/.epc_project")[value] rescue nil
+      end
+
+      def set_project_value(path, key, value)
+        path += "/.epc_project"
+        content = read_content_as_json(path)
+        content[key] = value
+        write_content_as_json(path, content)
+      end
+
+      def update_project_directory(path)
+        parent_dir = File.join(path, "..")
+        new_name = get_project_value(path, "name")
+        new_path = File.join(parent_dir, new_name)
+        FileUtils.mv path, new_path unless path.split("/").last == new_name
+      end
+  
+      def is_project_dir?(dirname)
+        return File.exists?(File.join(File.expand_path(dirname), ".epc_project"))
+      end
+      
+    end
+  end
+end

data/lib/epc/error/basic_error.rb

@@ -0,0 +1,6 @@
+module EPC
+  module Error
+    class BasicError < StandardError
+    end
+  end
+end

data/lib/epc/error/fatal_error.rb

@@ -0,0 +1,6 @@
+module EPC
+  module Error
+    class FatalError < StandardError
+    end
+  end
+end

data/lib/epc/error/input_error.rb

@@ -0,0 +1,6 @@
+module EPC
+  module Error
+    class InputError < StandardError
+    end
+  end
+end

data/lib/epc/error/internal_error.rb

@@ -0,0 +1,6 @@
+module EPC
+  module Error
+    class InternalError < StandardError
+    end
+  end
+end

data/lib/epc/help.rb

@@ -0,0 +1,292 @@
+module EPC
+  module Help
+    COMMAND_USAGES = {
+      :info                       => 'epc info',
+      :target                     => 'epc target <url>',
+      :login                      => 'epc login <email> [--passwd PASS]',
+      :list_solutions             => 'epc list solutions',
+      :create_solution            => 'epc create solution <name>',
+      :show_solution              => 'epc show solution [SOLUTION]',
+      :update_solution            => 'epc update solution [-s SOLUTION] name=value',
+      :delete_solution            => 'epc delete solution SOLUTION',
+      :archive_solution           => 'epc archive solution [SOLUTION]',
+      :unarchive_solution         => 'epc unarchive solution [SOLUTION]',
+      :refresh_solution           => 'epc refresh solution [SOLUTION]',
+      :list_projects              => 'epc list projects [SOLUTION]',
+      :create_project             => 'epc create project <name> [uri-name] <--type PROJECT_TYPE>',
+      :show_project               => 'epc show project [-s SOLUTION] <PROJECT>',
+      :update_project             => 'epc update project [-s SOLUTION] [-p PROJECT] <attribute=value>',
+      :delete_project             => 'epc delete project [-s SOLUTION] [PROJECT] [--force]',
+      :attach_runtime             => 'epc attach runtime <runtime_id> [-p PROJECT] [--stage STAGE]',
+      :list_servicetypes          => 'epc list service-types', 
+      :define_service             => 'epc define service <-t service_type> <service_name>', 
+      :undefine_service           => 'epc undefine service <SERVICE>', 
+      :list_servicedefinitions    => 'epc list service-definitions',
+      :create_serviceversion      => 'epc create service-version <label> <definition_name_or_id> [--up-script file] [--down-script file]',
+      :list_serviceversions       => 'epc list service-versions',
+      :delete_serviceversion      => 'epc delete service-version (<version_id>) || (<version_label> <definition_name>)',
+      :bind_service               => 'epc bind service [-s SOLUTION] [-p PROJECT] <service version>',
+      :unbind_service             => 'epc unbind service [-s SOLUTION] [-p PROJECT] <service version>',
+      :list_boundservices         => 'epc list bound-services [-s SOLUTION] <PROJECT>',
+      :create_user                => 'epc create user <email> [--name NAME]',
+      :push                       => 'epc push [PROJECT NAME] [--note NOTE] [--timeout value | --nopoll]',
+      :pull                       => 'epc pull [SOLUTION]',
+      :build                      => 'epc build [project_name=version] [--note NOTE] [--timeout value | --nopoll]',
+      :list_deploymentconfigs     => 'epc list deployment-configs [--stage STAGE] [-p PROJECT]',
+      :list_stages                => 'epc list stages',
+      :create_deployment          => 'epc create deployment [-s SOLUTION] <stage name: development|testing|staging|production> [-p project_id:version:instances] [--replaces deployment_id]',
+      :show_deployment            => 'epc show deployment <DEPLOYMENT_ID>',
+      :submit_deployment          => 'epc submit deployment <DEPLOYMENT_ID>',
+      :list_deployments           => 'epc list deployments [-s SOLUTION] [-S STAGE] [-u DEPLOYER]',
+      :copy_deployment            => 'epc copy deployment <DEPLOYMENT_ID> <STAGE>',
+      :approve_deployment         => 'epc approve deployment <DEPLOYMENT_ID>',
+      :deny_deployment            => 'epc deny deployment <DEPLOYMENT_ID>',
+      :create_dependency          => 'epc create dependency [PROJECT] [-s SOLUTION] <--depends DEPENDENCY> <--runtime | --compile>',
+      :list_dependencies          => 'epc list dependencies [-s SOLUTION] [PROJECT]',
+      :delete_dependency          => 'epc delete dependency [-s SOLUTION] [-p PROJECT] <DEPENDENCY_ID>',
+      :create_library             => 'epc create library <name> <language> <version> <group> [-f file] [--scope runtime | compile | provided | test]',
+      :list_libraries             => 'epc list libraries',
+      :delete_library             => 'epc delete library <name> <version> <group>',
+      :attach_library             => 'epc attach library [-s SOLUTION] [-p PROJECT] <name> <version> <group> [-f FILE] [--pom POM FILE]',
+      :detach_library             => 'epc detach library [-s SOLUTION] [-p PROJECT] <LIBRARY>',
+      :deploy                     => 'epc deploy [stage] [-d DEPLOYMENT_ID] [--timeout value | --nopoll]',
+      :undeploy                   => 'epc undeploy [-s SOLUTION] <DEPLOYMENT_ID>',
+      :list_approvals             => 'epc list approvals <DEPLOYMENT_ID>',
+      :renew                      => 'epc renew',
+      :logout                     => 'epc logout',
+      :create_config              => 'epc create config <TargetType:TargetId> [--required] [--no_override] [--value-type TYPE] name=value',
+      :list_config                => 'epc list config <TargetType:TargetType>',
+      :list_projecttypes          => 'epc list project-types',
+      :show_projecttype           => 'epc show project-type <project_type_id>',
+      :update_deploymentproject   => 'epc update deployment-project <DEPLOYMENT_ID> <PROJECT> [--instances instance_count] [--uris comma_separated_uris]',
+      :list_versions              => 'epc list versions [-s SOLUTION] PROJECT',
+      :update_config              => 'epc update config <--org | --runtime | --stage | --solution | --project | --user id> [--required] [--no_override] name=value',
+      :archive_project            => 'epc archive project [-s SOLUTION] PROJECT',
+      :unarchive_project          => 'epc unarchive project [-s SOLUTION] PROJECT',
+      :list_attachedlibraries     => 'epc list attached-libraries [-s SOLUTION] [PROJECT] [--json]',
+      :create_group               => 'epc create group <name>',
+      :delete_group               => 'epc delete group <GROUP>',
+      :list_groups                => 'epc list groups',
+      :update_group               => 'epc update group <GROUP> [--add-user USER_ID] [--remove-user USER_ID]',
+      :show_group                 => 'epc show group <groupId>|<groupName>',
+      :list_roles                 => 'epc list roles [--user user_id]',
+      :list_objectroles           => 'epc list object-roles <ObjectType:ObjectId>',
+      :delete_role                => 'epc delete role',
+      :update_role                => 'epc update role <ROLE> [--add-user USER_ID] [--remove-user USER_ID]',
+      :create_role                => 'epc create role <name>',
+      :create_objectrole          => 'epc create role <name> <ObjectType:ObjectId>',
+      :show_role                  => 'epc show role <roleId>|<roleName>',
+      :list_users                 => 'epc list users',
+      :delete_user                => 'epc delete user <user_id>|<email>',
+      :show_user                  => 'epc show user <user_id>|<email>',
+      :create_librarylanguage     => 'epc create library-language <name>',
+      :list_librarylanguages      => 'epc list library-languages',
+      :delete_librarylanguage     => 'epc delete library-language <language>',
+      :update_librarylanguage     => 'epc update library-language <language> <new-name>',
+      :create_libraryset          => 'epc create library-set <name> <language> [--file file]',
+      :show_libraryset            => 'epc show library-set <name>|<id> [--json]',
+      :list_librarysets           => 'epc show library-sets',
+      :update_libraryset          => 'epc update library-set name|id [--add-library id|name:version:group] [--remove-library id|name:version:group] [--file file]',
+      :delete_libraryset          => 'epc delete library-set name|id [-y]',
+      :attach_libraryset          => 'epc attach library-set name|id [-s solution] [-p project]',
+      :detach_libraryset          => 'epc detach library-set name|id [-s solution] [-p project]',
+      :request_passwordchange     => 'epc request password-change <email>',
+      :update_user                => 'epc update user <user_id>|<email> [--passwd password] [--token token] [--email new_email] [--name new_name]',
+      :list_rolepermissions       => 'epc list role-permissions',
+      :update_rolepermissions     => 'epc update role-permissions <--add-grant ObjectType:action:ObjectId> <--remove-grant ObjectType:action:ObjectId> [--file json]',
+      :list_permissiongroups      => 'epc list permission-groups',
+      :list_objecttypes           => 'epc list object-types'
+    }
+    
+    def display_usage
+      say(usage)
+      exit
+    end
+    
+    def display_verbose_usage
+      say(verbose_usage)
+    end
+    
+    def display_command_usage(*commands)
+      if commands.empty?
+        say verbose_usage
+        return
+      end
+      key = commands.join('_').gsub("-", "").to_sym
+      if COMMAND_USAGES.keys.include?(key)
+        say("Usage: #{COMMAND_USAGES[key]}")
+      else
+        say("No such command: #{commands.join(' ')}")
+      end      
+    end
+    
+    private
+    
+    def usage
+      "Usage: epc command [<args>] [command_options]\n"
+    end
+    
+    def verbose_usage
+      <<-USAGE
+
+#{usage}
+
+Currently available epc commands are:
+
+  Getting Started
+    target                   Sets a new target
+    login                    Logs user into the target system
+  
+
+  Solutions
+    list solutions           Lists the solutions that the current user has
+                             access to
+    show solution            Retrieves details about the solution
+    create solution          Creates a solution with the given name
+    update solution          Updates the attribute of the solution
+    delete solution          Deletes the solution from the system and removes
+                             local metadata files.
+                             Does not remove local directories.
+    archive solution         Archives the solution. Arabeline, kschived solution do
+                             not appear when listing solutions.
+    unarchive solution       Archives solution. 
+                             The solution will appear in solution listings.
+    refresh solution         Retrieves and stores attributes for a solution.
+
+    pull                     Downloads and extracts a solution skeleton
+    
+
+  Projects
+    list projects            Lists projects.
+    create project           Creates a project with the given name and
+                             assigns it to a solution
+    show project             Retrieves details about the project.
+    update project           Updates the specified attributes.
+    delete project           Deletes the project.Removes only the
+                             metadata files.
+                             All other files are left intact.
+    epc create dependency    Creates a dependency such as parent_name_or_id will
+                             depend on dependency_name_or_id.
+                             You can choose between a runtime dependency
+                             or a compilation dependency.
+    epc list dependencies    Lists the projects that the current project
+                             depends on.
+    epc delete dependencies  Deletes the specified dependency.
+    epc bind service         Binds the service to the project.
+    epc unbind service       Unbinds the service from the project.
+    epc list bound-services  Lists the services bound to the project
+    attach runtime           Sets the runtime environment the project
+                             will run on at deployment.
+    list project-types       Lists available project types.
+    show project-type        Show details about a project type
+    list versions            Lists the project versions.
+                             
+
+  Services
+    list service-types       List available service types provided by ePaas
+    define service           Defines a service
+    undefine service         Undefines a service
+    list service-definitions Lists services
+    create service-version   Creates a service version from an existing
+                             service definition.
+    list service-versions    Lists all service versions defined.
+    delete service-version   Deletes the specified service version.
+    
+
+  Deployments
+    push                      Zips the project and pushes it to the 
+                              build manager repository
+    build                     Builds a previously pushed project
+    show deployment           Retrieves detailed information about
+                              the deployment
+    list stages               Lists available stages for deploying.
+    create deployment         Creates a deployment for a solution
+                              and the given stage
+    list deployments          Lists all deployments created
+    approve deployment        Approves the specified deployment
+    deny deployment           Denies the specified deployment
+    deploy                    Deploys a previously created deployment
+    list approvals            List approvals needed by the deployment
+    copy deployment           Copies a previously created deployment
+                              to the specified stage
+    update deployment-project Updates projects from a deployment. Can
+                              change the number of instances a project
+                              is deployed to with --instances, or
+                              change the uris where the project will be
+                              accessible with --uris.
+                              
+
+
+  Libraries
+    create library           Creates a library with the given parameters
+    list libraries           Lists available libraries
+    delete library           Deletes the library
+    list attached-libraries   Lists attached libraries
+    attach library           Attaches the library to the project.
+    detach library           Detaches the library from the project.
+    create library-language  Creates a new language for libraries.
+    list library-languages   Lists library languages defined.
+    delete library-language  Deletes a library language
+    update library-language  Updates a library language
+    create library-set       Creates a library set
+    show library-set         Retrieves details about a library-set
+    list library-sets        Lists library sets defined
+    update library-set       Allows adding/removing of libraries from
+                             the set
+    delete library-set       Deletes a library-set
+    attach library-set       Attaches the libraries in the set to the
+                             specified project
+
+    detach library-set       Detaches the libraries in the set from
+                             the specified project
+
+
+  Configuration                                        
+    list config              Lists all configuration options
+    create config            Sets the value of of <key>
+    update config            Updates the value of <key> with <value>
+    remove config            Removes <key>
+
+  Roles
+    create role              Creates a role
+    list roles               Lists roles available
+    delete role              Deletes a role
+    update role              Adds/removes user to a role
+    show role                Retrieves details about the role
+    list role-permissions    List permission that are grantable to a role
+    update role-permissions  Adds/removes grants to a role
+    list object-roles        Lists roles that belong to a specified object
+    list permission-groups   Lists permission groups
+    list object-types        Lists available objects in the system
+
+  Users
+    list users               List users
+    show user                Retrieves details about the user
+    delete user              Deletes a user
+    update user              Allows changing of a users email 
+                             or password
+    create group             Creates a user group
+    delete group             Deletes an empty group
+    list groups              Lists user groups
+    update group             Allows you to add or remove users from
+                             the group
+    show group               Retrieves details about the group
+    request password-change  Sends a request for a password change to
+                             the server. The user will receive an
+                             email with the password change token.
+        
+
+  Administration
+    create user              Creates a new user account with the target system  
+    renew                    Refreshes the current user login
+                             session with the target system
+    logout                   Logs current user out of the target system
+    
+
+  Help
+    help                    Shows the usage for the command
+
+USAGE
+    end
+  end
+end