lamma 0.2.1

data/.travis.yml

@@ -0,0 +1,22 @@
+language: ruby
+sudo: false
+rvm:
+- 2.3.3
+- 2.4.0
+addons:
+  code_climate:
+    repo_token:
+      secure: neUQqKyRYW9z4wBNqOzqMgRlKORVrLeczAd4ghoxdL3n+hez03Pqz3PesB5YU1jakxwPlY/f9DQOJDJOk8mNP84/McT3qeiXeAF+dVxnUmOj8GHdZlOgQi0b0b64zbAjGMI9sFtMwJ/ANx8GGCpOGa4PZDNhGddbDLVXKGJynvEC0iQ+t4nOXhUE+uOmaBeXNzmJ8bWdTwYDUvomNjOfWbZLqwOpHFHPFO2GSQ6s55i+oZcyvo+wPad6SwQf2YrJKX6a2MgZS0VDU2y9+SOVkZgXJA8+DUTqA25s8CEB1r0HadnPMI0f+666VNLn7Ds+pJBBQgEOxHTVA+WhV146tXX14ue5i08uwKjV5Uxg80m2uOt8OggMROpXNw2+oFwBG/oCuarbv/CCiF6V9NwKcD9O90ZJxvuc0OpJiQHPbPPLiegezavTlntY1gpz+Wpw294IbeYsH9cZKO913W3JFeOwYbEaVT/VMOmWkigv0WNQ+tX9xvvzQH536YRMfLz7NO0OM5myhBOrGr7Ui9xpRoq8O3p69ZLW0LDZN3NJUz/wkcz9eA4vqfPGu6d0mMrMPh/ymRKOqnaHNylHWhzf3bc6HGUyson0at7X6FlAAlok3G9Zi8VSMc6M1TYequeR7ByprvMscVIKiQjEmIkdmfLzcAu8u9/MaDrBNDjahoc=
+script:
+- bundle exec rake spec
+cache: bundler
+after_success:
+- bundle exec codeclimate-test-reporter
+deploy:
+  provider: rubygems
+  api_key:
+    secure: aN15UjA+CAG3k9v2AUgnEr4Lyg6ThB9cG2qB7hygU8CZ9ppBuQgGBHC3aSH0gP5jU7YRRli99wuEL5Pq1k97mxc5oOdQtpk5Br6dV7hByksImat6R1CWZPK0tC4VgPbFqTuTNt81ukXTYP8JJ1SJ9Z3gSXy4L62LJlhKpYKPA8ACYLdho/4nnbiMIWHnMUBEKhN2HqaIr/h87dsnJbm1fvVliOZnYFwXt2TeDTOEz+MLreJvTGYKUrV4yXLMsH68Nku07+785RWT39mYlxVg1t8Z41ScB0rAcGrk0UI/2PW6VkL9csKzCEj6PgbnBoZhIyXpNQrngSKkTjVB2Wpy9f0/NwzlfxoxhFjAuwkahXCNf6sGoYpm4iSY2Nz/riKBG/71fwSwrpE+/R7uzWZU/qFFOCpikp9EUQl3a6lhV2EM/z+yYel1Fsu3rZP//aOmQrIAxThndnHn3JGYHko6/lhaipqH8iBKbTMNgb//H9+Iy+cBWGO2KiwsfJN88jan/TeAWO6J1WGXT4PSPD6JmtE1ak4P2/KYNSWHUqsbRRgFAiHBGxOUkctqXh6ZhFep5BNpt9bQRtdRxlubZF+yAMbHS8HArL25zlBka6mHQ2GUFgM3KlKwyQ2UFNv1CzrJ56HtnpO4FvfGp30WFosBiUg5zjtEQ6zsnCvWi8qqCDU=
+  gem: lamma
+  on:
+    tags: true
+    repo: ayemos/lamma

data/Gemfile

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in lamma.gemspec
+gemspec
+
+group :test do
+  gem 'simplecov', require: false
+  gem "codeclimate-test-reporter", "~> 1.0.0"
+end

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 yuichiro-someya
+
+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,76 @@
+# Lamma
+[![Gem Version](https://badge.fury.io/rb/lamma.svg)](https://badge.fury.io/rb/lamma)
+[![Code Climate](https://codeclimate.com/github/ayemos/lamma/badges/gpa.svg)](https://codeclimate.com/github/ayemos/lamma)
+[![Test Coverage](https://codeclimate.com/github/ayemos/lamma/badges/coverage.svg)](https://codeclimate.com/github/ayemos/lamma/coverage)
+[![Issue Count](https://codeclimate.com/github/ayemos/lamma/badges/issue_count.svg)](https://codeclimate.com/github/ayemos/lamma)
+
+It will help [Amazon Lambda](http://aws.amazon.com/lambda/) developer to, 
+- Create new function,
+- Deploy current code,
+- and to Rollback last deployment.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'lamma'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install lamma
+
+## Configuration
+The gem uses [aws-sdk-ruby](http://aws.amazon.com/sdk-for-ruby/) to get an access to AWS api-es.
+
+``` AWS_ACCESS_KEY_ID ``` and ``` AWS_SECRET_ACCESS_KEY ``` have to be set within your environment.
+
+```
+export AWS_ACCESS_KEY_ID = [YOUR_AWS_ACCESS_KEY_ID]
+export AWS_SECRET_ACCESS_KEY = [YOUR_AWS_SECRET_ACCESS_KEY]
+```
+
+## Usage & Basic Workflow
+
+### Create new Lambda Function
+```
+lamma create my_function --runtime 'python2.7'
+```
+![create]()
+
+### Deploy current code to Remote
+
+You have to be in a directory created by 'create' command with 'lamma.conf' file.
+
+Make some change on nodejs/python2.7 function and
+
+```
+lamma deploy production(or development)
+```
+![create]()
+![console]()
+
+### Rollback last deploy
+
+```
+lamma rollback production(or development)
+```
+![before]()
+![after]()
+
+### Recommended setting
+It is recommended to connect your lambda with an event source via PROD/DEV version aliases, 
+so that you can keep the mapping before/after the deployment/rollback.
+([see also](https://docs.aws.amazon.com/lambda/latest/dg/versioning-aliases.html))
+
+End-to-end functionalities for 
+- Managing event-source-mappings,
+- Creating IAM roles
+ 
+will be supported in future release.
+

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "lamma"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "pry"
+Pry.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/examples/hello/lambda_function.py

@@ -0,0 +1,11 @@
+import json
+
+print('Loading function')
+
+def lambda_handler(event, context):
+    #print("Received event: " + json.dumps(event, indent=2))
+    print("value1 = " + event['key1'])
+    print("value2 = " + event['key2'])
+    print("value3 = " + event['key3'])
+    return event['key1']  # Echo back the first key value
+    #raise Exception('Something went wrong')

data/exe/lamma

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+retried = false
+begin
+  require 'lamma'
+  require 'lamma/cli'
+rescue LoadError
+  $:.unshift File.expand_path(File.join(__dir__, '..', 'lib'))
+  if retried
+    raise
+  else
+    retried = true
+    retry
+  end
+end
+
+Lamma::CLI.start(ARGV)

data/lamma.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'lamma/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "lamma"
+  spec.version       = Lamma::VERSION
+  spec.authors       = ["Yuichiro Someya"]
+  spec.email         = ["ayemos.y@gmail.com"]
+
+  spec.summary       = %q{Deploy toolset for Amazon Lambda functions.}
+  spec.description   = %q{Deploy toolset for Amazon Lambda functions..}
+  spec.homepage      = "https://github.com/ayemos/Lamma"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.10"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3"
+
+  spec.add_dependency "aws-sdk", "~> 2"
+  spec.add_dependency "thor", "~> 0.19"
+  spec.add_dependency "rubyzip", "~> 1.2"
+end

data/lib/lamma.rb

@@ -0,0 +1,4 @@
+module Lamma
+  DEFAULT_CONF_PATH = './lamma.yml'
+  LAST_DEPLOY_SUFFIX = 'LAMMA_LAST'
+end

data/lib/lamma/alias.rb

@@ -0,0 +1,74 @@
+module Lamma
+  class Alias
+    attr_accessor :description, :version
+
+    def initialize(function, name, version=nil, description=nil)
+      @function = function
+      @name = name
+      @version = version
+      @description = description
+    end
+
+    def create
+      lambda_client.create_alias({
+        function_name: @function.name,
+        name: name, # 'name' indicates the self
+        function_version: @version,
+        description: description
+      })
+    end
+
+    def update
+      lambda_client.update_alias({
+        function_name: @function.name,
+        name: name, # 'name' indicates the self
+        function_version: @version,
+        description: description
+      })
+    end
+
+    def create_or_update
+      if remote_exists?
+        update
+      else
+        create
+      end
+    end
+
+    def name
+      @name.upcase
+    end
+
+    def remote_exists?
+      begin
+        lambda_client.get_alias({
+          function_name: @function.name,
+          name: name
+        })
+      rescue Aws::Lambda::Errors::ResourceNotFoundException
+        false
+      end
+    end
+
+    def remote_version
+      begin
+        lambda_client.get_alias({
+          function_name: @function.name,
+          name: name
+        }).function_version
+      rescue Aws::Lambda::Errors::ResourceNotFoundException
+        nil
+      end
+    end
+
+    private
+
+    def description
+      @description ||= "Function alias #{name} managed by lamma"
+    end
+
+    def lambda_client
+      @lambda_client ||= Aws::Lambda::Client.new(region: @function.region)
+    end
+  end
+end

data/lib/lamma/cli.rb

@@ -0,0 +1,63 @@
+require 'lamma'
+require 'thor'
+
+module Lamma
+  class CLI < Thor
+    class_option :verbose, aliases: '-v', type: :boolean
+    map '--version' => :print_version
+
+    desc 'list', 'List lambda functions in AWS'
+    def list
+      require 'lamma/cli/list'
+      List.new(options, self).run
+    end
+
+    desc 'show FUNCTION_NAME', 'Show detailed description of the function'
+    def show(function_name)
+      require 'lamma/cli/show'
+      Show.new(options, self).run
+    end
+
+    desc 'deploy', 'Upload local lambda function to AWS and deploy.'
+    method_option :path, aliases: '-p', type: :string
+    method_option :alias, aliases: '-a', type: :string
+    method_option :message, aliases: '-m', type: :string
+    def deploy
+      require 'lamma/cli/deploy'
+      Deploy.new(options, self).run
+    end
+
+    desc 'rollback', 'Rollback last deploy.'
+    method_option :path, aliases: '-p', type: :string
+    method_option :alias, aliases: '-a', type: :string
+    def rollback
+      require 'lamma/cli/rollback'
+      Rollback.new(options, self).run
+    end
+
+    desc 'create', 'Create new remote function.'
+    method_option :path, aliases: '-p', type: :string
+    def create
+      require 'lamma/cli/create'
+      Create.new(options, self).run
+    end
+
+    desc 'init FUNCTION_NAME', 'Initialize local function'
+    method_option :runtime, aliases: '-r', type: :string, required: true
+    def init(function_name)
+      require 'lamma/cli/init'
+      Init.new(options, function_name, self).run
+    end
+
+    desc "update", "Update function configuration and upload function"
+    def update
+      require 'lamma/cli/update'
+      Update.new(options, self).run
+    end
+
+    desc "--version", "print the version"
+    def print_version
+      puts Lamma::VERSION
+    end
+  end
+end

data/lib/lamma/cli/create.rb

@@ -0,0 +1,16 @@
+require 'lamma/cli'
+
+module Lamma
+  class CLI::Create
+    def initialize(options, thor)
+      @options = options
+      @thor = thor
+      @conf_path = options[:path] || Lamma::DEFAULT_CONF_PATH
+    end
+
+    def run
+      f = Lamma::Function.new(@conf_path)
+      f.create
+    end
+  end
+end

data/lib/lamma/cli/deploy.rb

@@ -0,0 +1,79 @@
+require 'yaml'
+
+require 'lamma'
+require 'lamma/function'
+require 'lamma/alias'
+
+module Lamma
+  class CLI::Deploy
+    attr_reader :options, :thor
+
+    def initialize(options, thor)
+      @options = options
+      @thor = thor
+      @conf_path = options['path'] || Lamma::DEFAULT_CONF_PATH
+    end
+
+    def run
+      unless File.exists?(@conf_path)
+        abort("Config file #{@conf_path} is missing.")
+      end
+
+      f = Lamma::Function.new(@conf_path)
+
+      unless f.remote_exists?
+        thor.say("Function #{function.name} doesn't seem to be exist on remote.", :yellow)
+        y_or_n = thor.ask("Do you want me to create it? (y/n)", :yellow)
+
+        if y_or_n =~ /^[yY]/
+          f.create
+        end
+      end
+
+      f.update
+      new_version = f.publish_version(options['message']).version
+
+      if options['alias']
+        a = Lamma::Alias.new(f, options['alias'], new_version)
+
+        if a.remote_exists? && a.remote_version
+          last_version = a.remote_version
+          a.update
+        else
+          last_version = new_version
+
+          thor.say("Function alias #{a.name} doesn't seem to be exist on remote.", :yellow)
+          y_or_n = thor.ask("Do you want me to create it? (y/n)", :yellow)
+
+          if y_or_n =~ /^[yY]/
+            a.create
+          else
+            abort('Canceled')
+          end
+        end
+
+        la = Lamma::Alias.new(f, "#{@options['alias']}_#{Lamma::LAST_DEPLOY_SUFFIX}", last_version)
+        la.create_or_update
+      end
+    end
+
+    private
+
+    def create_function(function, config)
+      begin
+        function.create_function(config['runtime'], config['role'])
+      rescue ArgumentError
+        thor.say("ArgumentError occured. You might need to specify role arn \
+you want to pass to your function via 'lamma.conf' file or ENV['AWS_LAMBDA_IAM_ROLE'].", :red)
+        return
+      end
+      thor.say("Done.", :blue)
+      thor.say("Setting aliases.", :yellow)
+      first_version = function.publish_version.version
+      Lamma::Function::ENVIRONMENT_ALIAS_NAME_MAP.values.each do |alias_name|
+        function.create_alias(alias_name, first_version)
+        function.create_alias(alias_name << '_LAST', first_version)
+      end
+    end
+  end
+end