Add ruby support (#916)

Fixes #114
https://aws.amazon.com/about-aws/whats-new/2018/11/aws-lambda-supports-ruby/

.gitignore

@@ -1,6 +1,8 @@
 *.zip
 .DS_Store
 examples/go/main
+_examples/ruby/functions/dependency/.bundle/
+_examples/ruby/functions/dependency/Gemfile.lock
 cov.out
 node_modules
 vendor/

Readme.md

@@ -34,6 +34,7 @@ Currently supports:
 - Node.js
 - Golang
 - Python
+- Ruby
 - Java
 - Rust
 - Clojure

_examples/ruby/Readme.md

@@ -0,0 +1,14 @@
+
+To run the example first setup your [AWS Credentials](http://apex.run/#aws-credentials), and ensure "role" in ./project.json is set to your Lambda function ARN.
+
+Deploy the functions:
+
+```
+$ apex deploy
+```
+
+Try it out:
+
+```
+$ apex invoke simple < event.json
+```

_examples/ruby/event.json

@@ -0,0 +1,3 @@
+{
+  "hello": "world"
+}

_examples/ruby/functions/dependency/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gem 'activesupport'

_examples/ruby/functions/dependency/README.md

@@ -0,0 +1,10 @@
+The build hook can be used to install required libraries using bundle. You need to install these libraries at function level so that they become part of the zip files.
+
+The requirements are mentioned in the Gemfile and the build hook is used to install the dependencies before the build
+
+```
+"hooks":{
+    "build": "bundle install && bundle install --deployment"
+  }
+```
+

_examples/ruby/functions/dependency/function.json

@@ -0,0 +1,6 @@
+{
+  "description": "Example with ruby dependency on an external package",
+  "hooks":{
+    "build": "bundle install && bundle install --deployment"
+  }
+}

_examples/ruby/functions/dependency/lambda.rb

@@ -0,0 +1,7 @@
+puts "start dependency function"
+
+require 'active_support/core_ext/object/blank'
+
+def handler(event:, context:)
+  puts "event.blank?: #{event.blank?}"
+end

_examples/ruby/functions/simple/lambda.rb

@@ -0,0 +1,5 @@
+puts "start simple function"
+
+def handler(event:, context:)
+  puts "processing event: #{event}"
+end

_examples/ruby/project.json

@@ -0,0 +1,5 @@
+{
+  "name": "ruby",
+  "description": "Ruby example project",
+  "role": "arn:aws:iam::293503197324:role/apex_lambda_function"
+}

cmd/apex/main.go

@@ -34,6 +34,7 @@ import (
 	_ "github.com/apex/apex/plugins/java"
 	_ "github.com/apex/apex/plugins/nodejs"
 	_ "github.com/apex/apex/plugins/python"
+	_ "github.com/apex/apex/plugins/ruby"
 	_ "github.com/apex/apex/plugins/rust_gnu"
 	_ "github.com/apex/apex/plugins/rust_musl"
 	_ "github.com/apex/apex/plugins/shim"

docs/projects.md

@@ -80,6 +80,7 @@ Runtimes supported:
 - __java__ (Java 8)
 - __python2.7__ (Python 2.7)
 - __python3.6__ (Python 3.6)
+- __ruby2.5__ (Ruby 2.5)
 - __nodejs4.3__ (Node.js 4.3)
 - __nodejs4.3-edge__ (Node.js 4.3 Edge)
 - __nodejs6.10__ (Node.js 6.10)

function/function.go

@@ -50,6 +50,7 @@ var defaultPlugins = []string{
 	"rust-gnu",
 	"golang",
 	"python",
+	"ruby",
 	"nodejs",
 	"java",
 	"clojure",

function/function_test.go

@@ -9,6 +9,7 @@ import (
 	_ "github.com/apex/apex/plugins/inference"
 	_ "github.com/apex/apex/plugins/nodejs"
 	_ "github.com/apex/apex/plugins/python"
+	_ "github.com/apex/apex/plugins/ruby"
 	_ "github.com/apex/apex/plugins/shim"
 
 	"github.com/apex/log"

plugins/inference/inference.go

@@ -10,6 +10,7 @@ import (
 	"github.com/apex/apex/plugins/java"
 	"github.com/apex/apex/plugins/nodejs"
 	"github.com/apex/apex/plugins/python"
+	"github.com/apex/apex/plugins/ruby"
 )
 
 func init() {
@@ -20,6 +21,7 @@ func init() {
 			"main.go":             golang.Runtime,
 			"target/apex.jar":     java.Runtime,
 			"build/libs/apex.jar": java.Runtime,
+			"lambda.rb":           ruby.Runtime,
 		},
 	})
 }

plugins/ruby/ruby.go

@@ -0,0 +1,37 @@
+// Package ruby implements the "ruby" runtime.
+package ruby
+
+import (
+	"strings"
+
+	"github.com/apex/apex/function"
+)
+
+const (
+	// Runtime for inference.
+	Runtime = "ruby2.5"
+)
+
+func init() {
+	function.RegisterPlugin("ruby", &Plugin{})
+}
+
+// Plugin implementation.
+type Plugin struct{}
+
+// Open adds ruby defaults.
+func (p *Plugin) Open(fn *function.Function) error {
+	if !strings.HasPrefix(fn.Runtime, "ruby") {
+		return nil
+	}
+
+	if fn.Runtime == "ruby" {
+		fn.Runtime = Runtime
+	}
+
+	if fn.Handler == "" {
+		fn.Handler = "lambda.handler"
+	}
+
+	return nil
+}