lam 0.1.0 → 0.1.1

data/spec/fixtures/project/bin/lam

@@ -0,0 +1,22 @@
+#!/bin/bash
+
+set -e
+
+# Figure out where this script is located.
+PROJECTDIR="`dirname \"$0\"`"
+PROJECTDIR="`cd \"$PROJECTDIR/..\" && pwd`"
+
+# Tell Bundler where the Gemfile and gems are.
+# IMPORTANT: the Gemfile must be in the same bundled/gems folder
+export BUNDLE_GEMFILE="$PROJECTDIR/Gemfile"
+unset BUNDLE_IGNORE_CONFIG
+
+# Run the actual app using the bundled Ruby interpreter, with Bundler activated.
+os=$(uname)
+if [[ "$os" == 'Darwin' ]]; then
+  # used macosx ruby for development
+  exec lam "$@"
+else
+  # used bundled ruby for Lambda
+  exec "$PROJECTDIR/bundled/ruby/bin/ruby" -rbundler/setup "$PROJECTDIR/bundled/gems/ruby/2.2.0/bin/lam" "$@"
+fi

data/spec/fixtures/project/handlers/controllers/posts.js

@@ -0,0 +1,156 @@
+'use strict';
+
+// handler: handlers/controllers/posts.create
+const spawn = require('child_process').spawn;
+
+// Once hooked up to API Gateway can use the curl command to test:
+// curl -s -X POST -d @event.json https://endpoint | jq .
+
+// Filters out lines so only the error lines remain.
+// Uses the "RubyError: " marker to find the starting error lines.
+//
+// Input: String
+// random line
+// RubyError: RuntimeError: error in submethod
+// line1
+// line2
+// line3
+//
+// Output: String
+// RubyError: RuntimeError: error in submethod
+// line1
+// line2
+// line3
+function filterErrorLines(text) {
+  var lines = text.split("\n")
+  var markerIndex = lines.findIndex(line => line.startsWith("RubyError: ") )
+  lines = lines.filter((line, index) => index >= markerIndex )
+  return lines.join("\n")
+}
+
+// Produces an Error object that displays in the AWS Lambda test console nicely.
+// The backtrace are the ruby lines, not the nodejs shim error lines.
+// The json payload in the Lambda console looks something like this:
+//
+// {
+//   "errorMessage": "RubyError: RuntimeError: error in submethod",
+//   "errorType": "RubyError",
+//   "stackTrace": [
+//     [
+//       "line1",
+//       "line2",
+//       "line3"
+//     ]
+//   ]
+// }
+//
+// Input: String
+// RubyError: RuntimeError: error in submethod
+// line1
+// line2
+// line3
+//
+// Output: Error object
+// { RubyError: RuntimeError: error in submethod
+// line1
+// line2
+// line3 name: 'RubyError' }
+function customError(text) {
+  text = filterErrorLines(text) // filter for error lines only
+  var lines = text.split("\n")
+  var message = lines[0]
+  var error = new Error(message)
+  error.name = message.split(':')[0]
+  error.stack = lines.slice(0, lines.length-1) // drop final empty line
+                  .map(e => e.replace(/^\s+/g,'')) // trim leading whitespaces
+                  .join("\n")
+  return error
+}
+
+module.exports.create = (event, context, callback) => {
+  // To test on mac, set these environment variables:
+  // export RUBY_BIN=$HOME/.rbenv/shims/ruby
+  // export PROCESSOR_COMMAND="lam process controller"
+
+  // Command: lam process controller [event] [context] [handler]
+  const processor_command = process.env.PROCESSOR_COMMAND || "lam"
+  var args = [
+    "process",
+    "controller",
+    JSON.stringify(event),
+    JSON.stringify(context),
+    "handlers/controllers/posts.create"
+  ]
+  // console.log("processor_command %o", processor_command)
+  // console.log("args %o", args)
+
+  var ruby = spawn("bin/lam", args);
+
+  // string concatation in javascript is faster than array concatation
+  // http://bit.ly/2gBMDs6
+  var stdout_buffer = ""; // stdout buffer
+  // In the processor_command we do NOT call puts directly and write to stdout
+  // because it will mess up the eventual response that we want API Gateway to
+  // process.
+  // The Lambda prints out function to whatever the return value the ruby method
+  ruby.stdout.on('data', function(data) {
+    // Not using console.log because it decorates output with a newline.
+    //
+    // Uncomment process.stdout.write to see stdout streamed for debugging.
+    // process.stdout.write(data)
+    stdout_buffer += data;
+  });
+
+  // react to potential errors
+  var stderr_buffer = "";
+  ruby.stderr.on('data', function(data) {
+    // not using console.error because it decorates output with a newline
+    stderr_buffer += data
+    process.stderr.write(data)
+  });
+
+  //finalize when ruby process is done.
+  ruby.on('close', function(exit_code) {
+    // http://docs.aws.amazon.com/lambda/latest/dg/nodejs-prog-model-handler.html#nodejs-prog-model-handler-callback
+
+    // succcess
+    if (exit_code == 0) {
+      var result
+      try {
+        result = JSON.parse(stdout_buffer)
+      } catch(e) {
+        // if json cannot be parse assume simple text output intended
+        process.stderr.write("WARN: error parsing json, assuming plain text is desired.")
+        result = stdout_buffer
+      }
+      callback(null, result);
+
+      // callback(null, stdout_buffer);
+    } else {
+
+      // TODO: if this works, allow a way to not decorate the error in case
+      // it actually errors in javascript land
+      // Customize error object with ruby error info
+      var error = customError(stderr_buffer)
+      callback(error);
+      // console.log("error!")
+    }
+  });
+}
+
+// for local testing
+if (process.platform == "darwin") {
+  // fake event and context
+  var event = {"hello": "world"}
+  // var event = {"body": {"hello": "world"}} // API Gateway wrapper structure
+  var context = {"fake": "context"}
+  module.exports.create(event, context, (error, message) => {
+    console.error("\nLOCAL TESTING OUTPUT")
+    if (error) {
+      console.error("error message: %o", error)
+    } else {
+      console.error("success message %o", message)
+      // console.log(JSON.stringify(message)) // stringify
+    }
+  })
+}

data/spec/lib/cli_spec.rb

@@ -0,0 +1,20 @@
+require "spec_helper"
+
+# to run specs with what"s remembered from vcr
+#   $ rake
+#
+# to run specs with new fresh data from aws api calls
+#   $ rake clean:vcr ; time rake
+describe Lam::CLI do
+  before(:all) do
+    @args = "--noop"
+  end
+
+  describe "lam" do
+    it "build" do
+      out = execute("bin/lam build #{@args}")
+      # puts out
+      expect(out).to include("Building project")
+    end
+  end
+end

data/spec/lib/lam/base_controller_spec.rb

@@ -0,0 +1,18 @@
+require "spec_helper"
+
+# For testing lambda_function_names
+class FakeController < Lam::BaseController
+  def handler1; end
+  def handler2; end
+end
+
+describe Lam::BaseController do
+  describe "lambda_functions" do
+    it "should only list public user defined methods" do
+      controller = FakeController.new(nil, nil)
+      expect(controller.lambda_functions).to eq(
+        [:handler1, :handler2]
+      )
+    end
+  end
+end

data/spec/lib/lam/build/lambda_deducer_spec.rb

@@ -0,0 +1,20 @@
+require_relative "../../../spec_helper"
+
+describe Lam::Build::LambdaDeducer do
+  let(:deducer) do
+    Lam::Build::LambdaDeducer.new("app/controllers/posts_controller.rb")
+  end
+
+  describe "LambdaDeducer" do
+    it "deduces lambda js info" do
+      deducer.run
+      expect(deducer.handlers).to eq([
+        {
+          handler: "handlers/controllers/posts.create",
+          js_path: "handlers/controllers/posts.js",
+          js_method: "create"
+        }
+      ])
+    end
+  end
+end

data/spec/lib/lam/build_spec.rb

@@ -0,0 +1,29 @@
+require "spec_helper"
+
+describe Lam::Build do
+  before(:each) do
+    FileUtils.rm_f("spec/fixtures/project/handlers/controllers/posts.js")
+  end
+  let(:build) do
+    Lam::Build.new(noop: true)
+  end
+
+  describe "Build" do
+    it "#handlers" do
+      expect(build.handlers).to eq([
+        {
+          handler: "handlers/controllers/posts.create",
+          js_path: "handlers/controllers/posts.js",
+          js_method: "create"
+        }
+      ])
+    end
+
+    it "builds handlers javascript files" do
+      build.build
+      file_exist = File.exist?("#{Lam.root}handlers/controllers/posts.js")
+      expect(file_exist).to be true
+    end
+  end
+end
+

data/spec/lib/lam/process/controller_processor_spec.rb

@@ -0,0 +1,22 @@
+require_relative "../../../spec_helper"
+
+describe Lam::Process::ControllerProcessor do
+  before(:all) do
+    @event = { "we" => "love", "using" => "Lambda" }
+    @context = {"test" => "1"}
+  end
+  let(:processor) do
+    Lam::Process::ControllerProcessor.new(
+      JSON.dump(@event),
+      JSON.dump(@context),
+      'handlers/controllers/posts.create' # handler
+    )
+  end
+
+  describe "ControllerProcessor" do
+    it "find public_instance_methods" do
+      processor.run
+      expect(processor.event).to eq(@event)
+    end
+  end
+end

data/spec/lib/lam/process/infer_spec.rb

@@ -0,0 +1,24 @@
+require "spec_helper"
+
+describe Lam::Process::ProcessorDeducer do
+  describe "ProcessorDeducer" do
+    let(:deducer) { Lam::Process::ProcessorDeducer.new(handle) }
+
+    context("controller") do
+      let(:handle) { "handlers/controllers/posts.create" }
+      it "deduces processor info" do
+        expect(deducer.controller[:path]).to include "app/controllers/posts_controller.rb"
+        expect(deducer.controller[:code]).to eq "PostsController.new(event, context).create"
+      end
+    end
+
+    context("function") do
+      let(:handle) { "handlers/functions/posts.create" }
+      it "deduces processor info" do
+        expect(deducer.function[:path]).to include "app/functions/posts.rb"
+        expect(deducer.function[:code]).to eq "create(event, context)"
+      end
+    end
+
+  end
+end

data/spec/lib/lam/process_spec.rb

@@ -0,0 +1,18 @@
+require_relative "../../spec_helper"
+
+describe Lam::Process do
+  before(:all) do
+    # @args = "--noop --project-root spec/fixtures/my_project"
+    @args = '\'{ "we" : "love", "using" : "Lambda" }\' \'{"test": "1"}\' "handlers/controllers/posts.create"'
+  end
+
+  describe "lam process" do
+    it "controller [event] [context] [handler]" do
+      out = execute("bin/lam process controller #{@args}")
+      # pp out # uncomment to debug
+      data = JSON.parse(out)
+      expect(data["statusCode"]).to eq 200
+      expect(data["body"]).to eq({"we"=>"love", "using"=>"Lambda"})
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,25 @@
+ENV["TEST"] = "1"
+ENV["PROJECT_ROOT"] = "./spec/fixtures/project"
+
+# require "simplecov"
+# SimpleCov.start
+
+require "pp"
+require "byebug"
+require "fileutils"
+
+root = File.expand_path("../../", __FILE__)
+require "#{root}/lib/lam"
+
+module Helpers
+  def execute(cmd)
+    puts "Running: #{cmd}" if ENV["DEBUG"]
+    out = `#{cmd}`
+    puts out if ENV["DEBUG"]
+    out
+  end
+end
+
+RSpec.configure do |c|
+  c.include Helpers
+end

metadata

@@ -1,63 +1,217 @@
 --- !ruby/object:Gem::Specification
 name: lam
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Tung Nguyen
 autorequire: 
-bindir: exe
+bindir: bin
 cert_chain: []
-date: 2017-10-10 00:00:00.000000000 Z
+date: 2017-10-26 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: hashie
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.16.a
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 1.16.a
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
-description: Lambda tool
+        version: '0'
+description: Test
 email:
 - tongueroo@gmail.com
-executables: []
+executables:
+- lam
+- lamb
 extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".rspec"
+- ".ruby-version"
 - Gemfile
+- Gemfile.lock
+- Guardfile
+- LICENSE.txt
 - README.md
 - Rakefile
-- bin/console
-- bin/setup
+- bin/lam
+- bin/lamb
 - lam.gemspec
 - lib/lam.rb
+- lib/lam/base_controller.rb
+- lib/lam/build.rb
+- lib/lam/build/handler_generator.rb
+- lib/lam/build/lambda_deducer.rb
+- lib/lam/build/templates/handler.js
+- lib/lam/build/traveling_ruby.rb
+- lib/lam/cli.rb
+- lib/lam/cli/help.rb
+- lib/lam/command.rb
+- lib/lam/process.rb
+- lib/lam/process/base_processor.rb
+- lib/lam/process/controller_processor.rb
+- lib/lam/process/help.rb
+- lib/lam/process/processor_deducer.rb
+- lib/lam/util.rb
 - lib/lam/version.rb
+- notes/design.md
+- notes/traveling-ruby-packaging-lam.md
+- notes/traveling-ruby-packaging.md
+- notes/traveling-ruby.md
+- spec/fixtures/project/.gitignore
+- spec/fixtures/project/.ruby-version
+- spec/fixtures/project/Gemfile
+- spec/fixtures/project/Gemfile.lock
+- spec/fixtures/project/app/controllers/application_controller.rb
+- spec/fixtures/project/app/controllers/posts_controller.rb
+- spec/fixtures/project/bin/lam
+- spec/fixtures/project/handlers/controllers/posts.js
+- spec/lib/cli_spec.rb
+- spec/lib/lam/base_controller_spec.rb
+- spec/lib/lam/build/lambda_deducer_spec.rb
+- spec/lib/lam/build_spec.rb
+- spec/lib/lam/process/controller_processor_spec.rb
+- spec/lib/lam/process/infer_spec.rb
+- spec/lib/lam/process_spec.rb
+- spec/spec_helper.rb
 homepage: https://github.com/tongueroo/lam
-licenses: []
-metadata:
-  allowed_push_host: https://rubygems.org
+licenses:
+- MIT
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -74,8 +228,24 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.11
+rubygems_version: 2.4.5
 signing_key: 
 specification_version: 4
-summary: Lambda tool
-test_files: []
+summary: Test
+test_files:
+- spec/fixtures/project/.gitignore
+- spec/fixtures/project/.ruby-version
+- spec/fixtures/project/Gemfile
+- spec/fixtures/project/Gemfile.lock
+- spec/fixtures/project/app/controllers/application_controller.rb
+- spec/fixtures/project/app/controllers/posts_controller.rb
+- spec/fixtures/project/bin/lam
+- spec/fixtures/project/handlers/controllers/posts.js
+- spec/lib/cli_spec.rb
+- spec/lib/lam/base_controller_spec.rb
+- spec/lib/lam/build/lambda_deducer_spec.rb
+- spec/lib/lam/build_spec.rb
+- spec/lib/lam/process/controller_processor_spec.rb
+- spec/lib/lam/process/infer_spec.rb
+- spec/lib/lam/process_spec.rb
+- spec/spec_helper.rb