lam 0.0.1 → 0.1.0

data/notes/traveling-ruby.md

@@ -1,82 +0,0 @@
-## Overview
-
-There are 2 things to point out:
-
-1. What the user's environment contains - cannot control this, can only suggest
-2. What the lambda environment contains - can fully control this
-
-* User can develop with ruby 2.4 and bundle gems and test and be happy. Hopefully they eventually learn to test with ruby 2.2.0 (when they run into bugs).
-* When `lam build` runs it will bundle it in ruby 2.2.0 though.
-* When lambda runs it will call `lam` with ruby 2.2.0. The gems will be installed in 2.2.0
-	* Hope all works
-
-## Download ruby commands
-
-```sh
-# linux 64bit
-wget http://d6r77u77i8pq3.cloudfront.net/releases/traveling-ruby-20150715-2.2.2-linux-x86_64.tar.gz .
-mkdir ruby-linux
-tar -xvf traveling-ruby-20150715-2.2.2-linux-x86_64.tar.gz -C ruby-linux
-# mac
-wget http://d6r77u77i8pq3.cloudfront.net/releases/traveling-ruby-20150715-2.2.2-osx.tar.gz
-mkdir ruby-mac
-tar -xvf traveling-ruby-20150715-2.2.2-osx.tar.gz -C ruby-mac
-
-# another version
-mkdir hello-1.0.0-linux-x86_64/lib/ruby && tar -xzf packaging/traveling-ruby-20150715-2.2.2-linux-x86_64.tar.gz -C hello-1.0.0-linux-x86_64/lib/ruby
-```
-
-## Launch Instance for Testing
-
-```sh
-aws ec2 run-instances --image-id ami-8c1be5f6 --count 1 --instance-type t2.micro --key-name default --security-groups demo
-```
-
-## Tree Structure
-
-```sh
-lib/
-├── app
-│   └── hello.rb
-├── ruby
-│   ├── bin
-│   │   ├── gem
-│   │   ├── irb
-│   │   ├── rake
-│   │   ├── ruby
-│   │   └── ruby_environment
-│   ├── bin.real
-│   │   ├── bundle
-│   │   ├── bundler
-│   │   ├── gem
-│   │   ├── irb
-│   │   ├── rake
-│   │   └── ruby
-│   └── lib
-│       └── ruby
-│           ├── 2.2.0
-...
-│           │   └── yaml.rb
-│           ├── gems
-│           │   └── 2.2.0
-│           │       ├── gems
-│           │       │   ├── attr_extras-5.2.0
-│           │       │   │   ├── attr_extras.gemspec
-...
-│           │       │   ├── bundler-1.9.9
-...
-│           │           └── rake-12.2.1.gemspec
-...
-└── vendor
-    ├── Gemfile
-    ├── Gemfile.lock
-    └── ruby
-        └── 2.2.0 <= IMPORTANT: bundler copies gems to folder with running ruby version
-            ├── gems
-            │   ├── concurrent-ruby-1.0.5
-            │   ├── faker-1.7.3
-            │   └── i18n-0.9.0
-...
-```
-
-* [Full tree](https://gist.github.com/tongueroo/c42f9d35b15b06eb810802243f4e2f6d)

data/spec/fixtures/project/.gitignore

@@ -1,3 +0,0 @@
-vendor
-bundled
-lam.zip

data/spec/fixtures/project/.ruby-version

@@ -1 +0,0 @@
-2.2.2

data/spec/fixtures/project/Gemfile

@@ -1,4 +0,0 @@
-source "https://rubygems.org"
-
-gem "lam", path: "/Users/tung/src/tongueroo/lam"
-gem "print_ruby_info" # test

data/spec/fixtures/project/Gemfile.lock

@@ -1,35 +0,0 @@
-PATH
-  remote: /Users/tung/src/tongueroo/lam
-  specs:
-    lam (0.0.1)
-      activesupport
-      colorize
-      hashie
-      thor
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    activesupport (5.1.4)
-      concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (~> 0.7)
-      minitest (~> 5.1)
-      tzinfo (~> 1.1)
-    colorize (0.8.1)
-    concurrent-ruby (1.0.5)
-    hashie (3.5.6)
-    i18n (0.9.0)
-      concurrent-ruby (~> 1.0)
-    minitest (5.10.3)
-    print_ruby_info (0.0.3)
-    thor (0.20.0)
-    thread_safe (0.3.6)
-    tzinfo (1.2.3)
-      thread_safe (~> 0.1)
-
-PLATFORMS
-  ruby
-
-DEPENDENCIES
-  lam!
-  print_ruby_info

data/spec/fixtures/project/app/controllers/application_controller.rb

@@ -1,2 +0,0 @@
-class ApplicationController < Lam::BaseController
-end

data/spec/fixtures/project/app/controllers/posts_controller.rb

@@ -1,12 +0,0 @@
-class PostsController < Lam::BaseController
-  def create
-    # render text: "test2" # more consistent for web controllers
-
-    # render returns Lamba Proxy struture for web requests
-    render json: event, status: 200
-  end
-
-  # def update
-  #   render json: event, status: 200
-  # end
-end

data/spec/fixtures/project/bin/lam

@@ -1,22 +0,0 @@
-#!/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

@@ -1,156 +0,0 @@
-'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

@@ -1,20 +0,0 @@
-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

@@ -1,18 +0,0 @@
-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

@@ -1,20 +0,0 @@
-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

@@ -1,29 +0,0 @@
-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

@@ -1,22 +0,0 @@
-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