apigee_cli 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2abec78aa81785c59bad5ee3701a8ef516a5534c
+  data.tar.gz: 601c222a8621f1f758b161b7b58fb062c1d22109
+SHA512:
+  metadata.gz: df99dee88e32dd2b020dfa9d049335bbbaa3d6bda30757772799b7186a69add283b91e89b474b255762bcf2e13d09f944f329e9e0398beccdb561d81205953a0
+  data.tar.gz: 0646b46581aa48fabfd29e070da357450d2677573ce9c8e24f40d2a3feb0b83e4420bbfbde9012b04744a2968c4027b1ba6852edfd684d50bb5aa766dfd561d0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in apigee_cli.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Darby Frey
+
+MIT License
+
+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.md

@@ -0,0 +1,143 @@
+# ApigeeCli
+
+An API Wrapper and CLI for Apigee
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'apigee_cli'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install apigee_cli
+
+## Commands
+
+### Top level commands
+
+  Commands:
+    apigee apigeetool [COMMAND]  # Run a command using the apigeetool Node.js module
+    apigee config [COMMAND]      # Run a command within the context of an app configuration
+    apigee help [COMMAND]        # Describe available commands or one specific command
+    apigee resource [COMMAND]    # Run a command within the context of a resource
+    apigee settings              # Show the current apigeerc settings
+    apigee version               # Shows the Apigee CLI version number
+
+### To see sublevel commands, you can run:
+
+    apigee help apigeetool
+    apigee help config
+    apigee help resource
+
+### Usage
+
+A. Deployment (leverages apigeetool Node.js module)
+
+#### apigee apigeetool listdeployments [DEFAULT]
+
+    # by environment
+    $ apigee apigeetool listdeployments -e=ENVIRONMENT
+
+    # by proxy name
+    $ apigee apigeetool listdeployments -n PROXY_NAME
+
+#### apigee apigeetool deploy
+
+    $ apigee apigeetool deploy -e=ENVIRONMENT -n PROXY_NAME -d ROOT_DIR_OF_PROXY -V
+
+#### apigee apigeetool nodedeploy
+
+    $ apigee apigeetool nodedeploy -e=ENVIRONMENT -n NODE_PROXY_NAME -d ROOT_DIR_OF_NODE_PROXY -m MAIN_JS_FILE -b BASE_PATH -v secure
+
+#### apigee apigeetool undeploy
+
+    $ apigee apigeetool undeploy -e=ENVIRONMENT -n PROXY_NAME -D
+
+#### apigee apigeetool fetchproxy
+
+    $ apigee apigeetool fetchproxy -n PROXY_NAME -r REVISION_NUMBER
+
+#### apigee apigeetool delete
+
+NOTE: This deletes all revisions of PROXY_NAME. It is an error to delete a proxy that still has deployed revisions. Revisions must be undeployed using "undeploy" before this command may be used.
+
+    $ apigee apigeetool delete -n PROXY_NAME
+
+#### apigee apigeetool getlogs [from a Node app]
+
+    $ apigee apigeetool getlogs -e=ENVIRONMENT -n NODE_PROXY_NAME
+
+
+B. Configuration Settings on Apigee Server
+
+#### apigee config list [DEFAULT]
+
+    # defaults
+    -e=test|--environment=test
+
+    # List configs for default environment of test
+    $ apigee config list
+
+    # List config for a particular config_name
+    $ apigee config list --config_name=configuration_one
+
+#### apigee config push
+
+    # defaults
+    -e=test|--environment=test
+    --config_name=configuration
+
+    # Create config key-value map
+    $ apigee config push --config_name=new_config
+
+    # Update config key-value pair
+    $ apigee config push key_one=value_one
+
+    # Overwrite existing config key-value pair
+    $ apigee config push key_one=changed_value_one --overwrite=true
+
+#### apigee config delete
+
+    # defaults
+    -e=test|--environment=test
+    --config_name=configuration
+
+    # Delete config key-value pair (default config_name is configuration)
+    $ apigee config delete --entry_name=key_one
+
+    # Delete config for that config_name
+    $ apigee config delete --config_name=configuration_one
+
+
+C. Resource Files on Apigee Server
+
+#### apigee resource list [DEFAULT]
+
+    # List resource files for organization
+    $ apigee resource list
+
+    # Get resource file with resource_name
+    $ apigee resource list --name=testing.js
+
+#### apigee resource upload
+
+    # Upload resource files from resource_folder
+    $ apigee resource upload --folder=jsc
+
+#### apigee resource delete
+
+    # Delete resource file of resource_name
+    $ apigee resource delete --name=testing.js
+
+## Contributing
+
+1. Fork it ( http://github.com/<my-github-username>/apigee_cli/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/apigee_cli.gemspec

@@ -0,0 +1,34 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'apigee_cli/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "apigee_cli"
+  spec.version       = ApigeeCli::VERSION
+  spec.authors       = ["Darby Frey"]
+  spec.email         = ["darbyfrey@gmail.com"]
+  spec.summary       = %q{A CLI for Apigee}
+  spec.description   = %q{A CLI for Apigee}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+
+  spec.add_dependency 'httparty', '~> 0.13'
+  spec.add_dependency 'faraday', '~> 0.9.1'
+  spec.add_dependency 'thor', '~> 0.19'
+  spec.add_dependency 'hashie', '~> 3.3'
+  spec.add_dependency 'git', '~> 1.2'
+
+  spec.add_development_dependency 'bundler', '~> 1.5'
+  spec.add_development_dependency 'rake', '~> 10.4'
+  spec.add_development_dependency 'pry', '~> 0.10.1'
+  spec.add_development_dependency 'rspec', '~> 3.1'
+  spec.add_development_dependency 'rack-test', '~> 0.6.3'
+  spec.add_development_dependency 'webmock', '~> 1.21.0'
+end

data/bin/apigee

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+
+require 'apigee_cli'
+
+require 'thor'
+require 'apigee_cli/cli/thor_cli'
+require 'apigee_cli/cli/app_config'
+require 'apigee_cli/cli/apigee_tool'
+require 'apigee_cli/cli/resource'
+require 'apigee_cli/cli'
+
+ApigeeCli::Cli.start

data/lib/apigee_cli/base.rb

@@ -0,0 +1,61 @@
+require 'faraday'
+
+module ApigeeCli
+  class Base
+    attr_accessor :org, :environment
+
+    def initialize(environment = nil)
+      @username     = ApigeeCli.configuration.username
+      @password     = ApigeeCli.configuration.password
+      @org          = ApigeeCli.configuration.org
+      @environment  = environment || ApigeeCli.configuration.environment
+    end
+
+    def get(url, params = {})
+      conn = Faraday.new(url: url)
+      conn.basic_auth(@username, @password)
+      conn.get do |request|
+        request.params = params
+      end
+    end
+
+    def upload_file(url, file)
+      conn = Faraday.new(url: url)
+      conn.basic_auth(@username, @password)
+      conn.post do |request|
+        request.headers['Content-Type'] = "application/octet-stream"
+        request.headers['Content-Length'] = File.size(file).to_s
+        request.body = Faraday::UploadIO.new(file, 'text/plain')
+      end
+    end
+
+    def post(url, body)
+      conn = Faraday.new(url: url)
+      conn.basic_auth(@username, @password)
+      conn.post do |request|
+        request.headers['Content-Type'] = "application/json"
+        request.body = body.to_json
+      end
+    end
+
+    def put(url, body)
+      conn = Faraday.new(url: url)
+      conn.basic_auth(@username, @password)
+      conn.put do |request|
+        request.headers['Content-Type'] = "application/json"
+        request.body = body.to_json
+      end
+    end
+
+    def delete(url)
+      conn = Faraday.new(url: url)
+      conn.basic_auth(@username, @password)
+      conn.delete
+    end
+
+    def response_error(response)
+      raise "Response Error: #{response.status} #{response.body}"
+    end
+
+  end
+end

data/lib/apigee_cli/cli/apigee_tool.rb

@@ -0,0 +1,55 @@
+class ApigeeTool < ThorCli
+  namespace 'apigeetool'
+  default_task :listdeployments
+
+  no_commands do
+    def load_config
+      @username = ApigeeCli.configuration.username
+      @password = ApigeeCli.configuration.password
+      @org      = ApigeeCli.configuration.org
+      @env      = environment
+    end
+  end
+
+  desc 'deploy', 'Deploy a proxy'
+  def deploy(*args)
+    load_config
+    say `apigeetool deployproxy -u #{@username} -p #{@password} -o #{@org} -e #{@env} #{args.join(' ')}`
+  end
+
+  desc 'nodedeploy', 'Deploy a node app'
+  def nodedeploy(*args)
+    load_config
+    say `apigeetool deploynodeapp -u #{@username} -p #{@password} -o #{@org} -e #{@env} #{args.join(' ')}`
+  end
+
+  desc 'undeploy', 'Undeploy a proxy or node app'
+  def undeploy(*args)
+    load_config
+    say `apigeetool undeploy -u #{@username} -p #{@password} -o #{@org} -e #{@env} #{args.join(' ')}`
+  end
+
+  desc 'listdeployments', 'List all the deployments for a given environment'
+  def listdeployments(*args)
+    load_config
+    say `apigeetool listdeployments -u #{@username} -p #{@password} -o #{@org} -e #{@env} #{args.join(' ')}`
+  end
+
+  desc 'fetchproxy', 'Download a proxy as a zip file'
+  def fetchproxy(*args)
+    load_config
+    say `apigeetool fetchproxy -u #{@username} -p #{@password} -o #{@org} -e #{@env} #{args.join(' ')}`
+  end
+
+  desc 'delete', 'Delete a proxy or node app'
+  def deleteproxy(*args)
+    load_config
+    say `apigeetool delete -u #{@username} -p #{@password} -o #{@org} -e #{@env} #{args.join(' ')}`
+  end
+
+  desc 'getlogs', 'Retrieve the last set of logs from a Node app'
+  def getlogs(*args)
+    load_config
+    say `apigeetool getlogs -u #{@username} -p #{@password} -o #{@org} -e #{@env} #{args.join(' ')}`
+  end
+end

data/lib/apigee_cli/cli/app_config.rb

@@ -0,0 +1,147 @@
+require 'apigee_cli/cli/thor_cli'
+
+class AppConfig < ThorCli
+  namespace 'config'
+  default_task :list
+
+  desc 'list', 'Pulls down keyvaluemaps from Apigee server'
+  option :config_name, type: :string
+  def list
+    config_name = options[:config_name]
+    config_set  = ApigeeCli::ConfigSet.new(environment)
+
+    if config_name
+      pull_config(config_set, config_name)
+    else
+      pull_list(config_set)
+    end
+  end
+
+  desc 'push', 'Push up keyvaluemaps for [config_name] to Apigee server'
+  option :config_name, type: :string, default: ApigeeCli::ConfigSet::DEFAULT_CONFIG_NAME
+  option :overwrite, type: :boolean, default: false
+  def push(*entries)
+    config_name = options[:config_name]
+    overwrite   = options[:overwrite] || false
+
+    config_set  = ApigeeCli::ConfigSet.new(environment)
+
+    data = populate_data(entries)
+    result, changed_keys = config_set.add_config(config_name, data, overwrite)
+
+    if result == :error
+      say "Error [#{changed_keys.first}] pushing config for [#{config_name}] to [#{environment}] environment"
+      exit
+    end
+
+    if result == :new
+      say "Creating new config for [#{config_name}] in [#{environment}] environment"
+    elsif result == :existing
+      say "Adding new keys #{changed_keys} to config [#{config_name}] in [#{environment}] environment"
+    elsif result == :overwritten
+      say "Overwriting existing config [#{config_name}] in [#{environment}] environment"
+    end
+
+    updated_config = config_set.read_config(config_name)[ApigeeCli::ConfigSet::ENTRY_KEY]
+
+    render_config(config_name, updated_config, changed_keys)
+  end
+
+  desc 'delete', 'Delete keyvaluemaps for [config_name] from Apigee server'
+  option :config_name, type: :string, default: ApigeeCli::ConfigSet::DEFAULT_CONFIG_NAME
+  option :entry_name, type: :string
+  def delete
+    config_name = options[:config_name]
+    entry_name  = options[:entry_name]
+
+    config_set  = ApigeeCli::ConfigSet.new(environment)
+
+    pull_list(config_set)
+
+    if entry_name
+      confirm = yes? "Are you sure you want to delete #{entry_name} from #{config_name} in #{environment} environment? [y/n]"
+      exit if !confirm
+
+      remove_entry(config_set, config_name, entry_name)
+    else
+      confirm = yes? "Are you sure you want to delete #{config_name} from #{environment} environment? [y/n]"
+      exit if !confirm
+
+      remove_config(config_set, config_name)
+    end
+  end
+
+  private
+
+    def pull_list(config_set)
+      begin
+        response = Hashie::Mash.new(config_set.list_configs)
+        render_list(response[ApigeeCli::ConfigSet::MAP_KEY])
+      rescue RuntimeError => e
+        render_error(e)
+      end
+    end
+
+    def pull_config(config_set, config_name)
+      begin
+        response = Hashie::Mash.new(config_set.read_config(config_name))
+        render_config(config_name, response[ApigeeCli::ConfigSet::ENTRY_KEY])
+      rescue RuntimeError => e
+        render_error(e)
+      end
+    end
+
+    def remove_config(config_set, config_name)
+      begin
+        response = Hashie::Mash.new(config_set.remove_config(config_name))
+        say "Config [#{config_name}] has been deleted from [#{environment}] environment", :red
+      rescue RuntimeError => e
+        render_error(e)
+      end
+    end
+
+    def remove_entry(config_set, config_name, entry_name)
+      begin
+        response = Hashie::Mash.new(config_set.remove_entry(config_name, entry_name))
+        say "Entry [#{entry_name}] has been deleted from [#{config_name}] in [#{environment}] environment", :red
+      rescue RuntimeError => e
+        render_error(e)
+      end
+    end
+
+    def populate_data(entries)
+      entries.each_with_object([]) do |entry, data|
+        name  = entry.split("=", 2).first
+        value = entry.split("=", 2).last
+
+        data << Hashie::Mash.new({ name: name, value: value })
+      end
+    end
+
+    def render_list(configs)
+      configs.each do |config|
+        render_config(config['name'], config[ApigeeCli::ConfigSet::ENTRY_KEY])
+      end
+    end
+
+    def render_config(config_name, entries, highlight = [])
+      say "Environment: #{environment}, Config Name: #{config_name}", :blue
+      entries.each do |entry|
+        name  = entry['name']
+        color = highlight.include?(name) ? :yellow : :green
+
+        render_entry(entry, color)
+      end
+    end
+
+    def render_entry(entry, color = :green)
+      name  = entry['name']
+      value = entry['value']
+
+      say "\s\s#{name}: #{value}", color
+    end
+
+    def render_error(error)
+      say error.to_s, :red
+    end
+end

data/lib/apigee_cli/cli/resource.rb

@@ -0,0 +1,83 @@
+require 'apigee_cli/cli/thor_cli'
+
+class Resource < ThorCli
+  namespace 'resource'
+  default_task :list
+
+  desc 'list', 'List resource files'
+  option :name, type: :string
+  def list
+    name = options[:name]
+
+    resource = ApigeeCli::ResourceFile.new(environment)
+
+    if name
+      response = resource.read(name, ApigeeCli::ResourceFile::DEFAULT_RESOURCE_TYPE)
+      say response
+    else
+      pull_list(resource)
+    end
+  end
+
+  desc 'upload', 'Upload resource files'
+  option :folder, type: :string, required: true
+  def upload
+    folder = options[:folder]
+
+    files = Dir.entries(folder).select{ |f| f =~ /.js$/ }
+
+    resource = ApigeeCli::ResourceFile.new(environment)
+
+    files.each do |file|
+      result = resource.upload file, ApigeeCli::ResourceFile::DEFAULT_RESOURCE_TYPE, "#{folder}/#{file}"
+      if result == :overwritten
+        say "Overwriting current resource for #{file}", :green
+      elsif result == :new_file
+        say "Creating resource for #{file}", :green
+      end
+    end
+  end
+
+  desc 'delete', 'Delete resource file'
+  option :name, type: :string, required: true
+  def delete
+    name = options[:name]
+
+    resource = ApigeeCli::ResourceFile.new(environment)
+
+    confirm = yes? "Are you sure you want to delete #{name} from #{org}? [y/n]"
+
+    if confirm
+      begin
+        say "Deleting current resource for #{name}", :red
+        resource.remove(name, ApigeeCli::ResourceFile::DEFAULT_RESOURCE_TYPE)
+      rescue RuntimeError => e
+        render_error(e)
+        exit
+      end
+    else
+      exit
+    end
+  end
+
+  private
+
+    def pull_list(resource)
+      response = Hashie::Mash.new(resource.all)
+      render_list(response[ApigeeCli::ResourceFile::RESOURCE_FILE_KEY])
+    end
+
+    def render_list(resource_files)
+      say "Resource files for #{org}", :blue
+      resource_files.each do |resource_file|
+        name = resource_file['name']
+        type = resource_file['type']
+
+        say "  #{type} file - #{name}", :green
+      end
+    end
+
+    def render_error(error)
+      say error.to_s, :red
+    end
+end

data/lib/apigee_cli/cli/thor_cli.rb

@@ -0,0 +1,15 @@
+require 'thor'
+
+class ThorCli < Thor
+  class_option :environment, aliases: [:env, :e]
+
+  no_commands do
+    def environment
+      options[:environment] || 'test'
+    end
+
+    def org
+      options[:org] || 'bellycard'
+    end
+  end
+end

data/lib/apigee_cli/cli.rb

@@ -0,0 +1,24 @@
+require 'thor'
+
+module ApigeeCli
+  class Cli < Thor
+    desc "version", "Shows the Apigee CLI version number"
+    def version
+      say ApigeeCli::VERSION
+    end
+
+    desc 'settings', 'Show the current apigeerc settings'
+    def settings
+      puts ApigeeCli.configuration.apigeerc_config.to_yaml
+    end
+
+    desc 'config [COMMAND]', 'Run a command within the context of an app configuration'
+    subcommand 'config', ::AppConfig
+
+    desc 'apigeetool [COMMAND]', 'Run a command using the apigeetool Node.js module'
+    subcommand 'apigeetool', ::ApigeeTool
+
+    desc 'resource [COMMAND]', 'Run a command within the context of a resource'
+    subcommand 'resource', ::Resource
+  end
+end