jets 0.2.0 → 0.5.0

data/.codebuild/scripts/install-docker.sh

@@ -0,0 +1,12 @@
+#!/bin/bash -eux
+
+# docker client
+# https://docs.docker.com/install/linux/docker-ce/debian/#install-using-the-convenience-script
+# Install docker client because we're going to use docker to
+curl -fsSL https://get.docker.com -o get-docker.sh && sh get-docker.sh
+
+# docker-compose
+# to find latest releases:
+# https://github.com/docker/compose/releases
+curl -s -L https://github.com/docker/compose/releases/download/1.22.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
+chmod +x /usr/local/bin/docker-compose

data/.codebuild/scripts/install-dynamodb-local.sh

@@ -0,0 +1,22 @@
+#!/bin/bash -eux
+
+mkdir -p /usr/local/dynamodb_local
+curl -s https://s3-us-west-2.amazonaws.com/dynamodb-local/dynamodb_local_latest.tar.gz -o /usr/local/dynamodb_local/dynamodb_local_latest.tar.gz
+cd /usr/local/dynamodb_local
+tar zxf dynamodb_local_latest.tar.gz
+
+cat > /usr/local/bin/dynamodb-local <<EOL
+#!/bin/bash
+
+# for dynamodb-local and dynamodb-admin
+# More details: https://github.com/tongueroo/jets/wiki/Dynamodb-Local-Setup-Walkthrough
+export AWS_SECRET_ACCESS_KEY=fakekey
+export AWS_ACCESS_KEY_ID=fakeid
+
+# Based on: https://github.com/Homebrew/homebrew-cask/blob/master/Casks/dynamodb-local.rb
+# I manually extracted out the dynamodb local tar to /opt/dynamodb_local
+cd /usr/local/dynamodb_local
+
+exec java -Djava.library.path='./DynamoDBLocal_lib' -jar 'DynamoDBLocal.jar' "$@" 2>&1 &
+EOL
+chmod a+x /usr/local/bin/dynamodb-local

data/.codebuild/scripts/install-java.sh

@@ -0,0 +1,20 @@
+#!/bin/bash -exu
+
+# https://www.digitalocean.com/community/tutorials/how-to-install-java-with-apt-get-on-debian-8
+apt-get update
+apt-get install default-jre -y
+
+# to make java 1.8 by default if you keep java-1.7.0.  We dont need to do this:
+# update-alternatives --config java #pick java 1.8
+# update-alternatives --config javac #pick java 1.8
+
+# to show java_home
+java -XshowSettings:properties -version
+
+###
+# maven install: https://maven.apache.org/install.html
+wget http://mirror.cogentco.com/pub/apache/maven/maven-3/3.5.3/binaries/apache-maven-3.5.3-bin.tar.gz
+tar zxf apache-maven-3.5.3-bin.tar.gz
+mkdir -p /opt
+mv apache-maven-3.5.3 /opt/maven
+ln -s /opt/maven/bin/mvn /usr/local/bin/mvn

data/.codebuild/scripts/install-node.sh

@@ -0,0 +1,4 @@
+#!/bin/bash -eux
+curl -sL https://deb.nodesource.com/setup_10.x | bash -
+apt-get install -y nodejs
+npm install -g yarn

data/.gitignore

@@ -14,3 +14,6 @@ spec/reports
 test/tmp
 test/version_tmp
 tmp
+
+spec/fixtures/project/handlers
+.codebuild/definitions

data/.gitmodules

@@ -0,0 +1,9 @@
+[submodule "spec/fixtures/apps/demo"]
+	path = spec/fixtures/apps/demo
+	url = https://github.com/tongueroo/demo.git
+[submodule "vendor/lambdagem"]
+	path = vendor/lambdagem
+	url = https://github.com/tongueroo/lambdagem.git
+[submodule "vendor/dynomite"]
+	path = vendor/dynomite
+	url = https://github.com/tongueroo/dynomite.git

data/.python-version

@@ -0,0 +1 @@
+3.6.6

data/.rspec

@@ -1,2 +1,4 @@
 --color
+--exclude-pattern spec/fixtures/apps/**/*
 --format documentation
+--require spec_helper

data/.ruby-version

@@ -1 +1 @@
-2.2.2
+2.5.1

data/CHANGELOG.md

@@ -3,5 +3,8 @@
 All notable changes to this project will be documented in this file.
 This project *tries* to adhere to [Semantic Versioning](http://semver.org/), even before v1.0.
 
+## [0.5.0]
+- First good release
+
 ## [0.1.2]
 - Fix bundled gems.

data/Dockerfile

@@ -0,0 +1,16 @@
+FROM tongueroo/jets:base
+MAINTAINER Tung Nguyen <tongueroo@gmail.com>
+
+# Install bundle of gems first in a layer
+# so if the Gemfile doesnt chagne it wont have to install gems again
+WORKDIR /tmp
+COPY Gemfile* /tmp/
+RUN bundle install && rm -rf /root/.bundle/cache
+
+# Add the Rails app
+ENV HOME /root
+WORKDIR /app
+COPY . /app
+RUN bundle install
+
+CMD ["uptime"]

data/Dockerfile.base

@@ -0,0 +1,53 @@
+FROM ruby:2.5.1
+MAINTAINER Tung Nguyen <tongueroo@gmail.com>
+
+RUN apt-get update && \
+  apt-get install -y net-tools netcat && \
+  rm -rf /var/lib/apt/lists/* && apt-get clean && apt-get purge
+
+# Packages
+# capybara-webkit: libqt4-dev libqtwebkit-dev
+RUN apt-get update && \
+  apt-get install -y software-properties-common && \
+  add-apt-repository ppa:git-core/ppa -y && \
+  apt-get update && \
+  apt-get install -y \
+    build-essential \
+    libqt4-dev libqtwebkit-dev \
+    nodejs \
+    telnet \
+    curl \
+    vim \
+    htop \
+    mysql-client \
+    lsof && \
+  rm -rf /var/lib/apt/lists/* && apt-get clean && apt-get purge
+
+# ssh key for bundle to access gems that are in private repos
+# COPY config/ssh /root/.ssh
+# RUN chmod 600 /root/.ssh/id_rsa-boltops-docker
+
+# Install bundle of gems
+RUN gem install bundler
+WORKDIR /tmp
+COPY lib/jets/version.rb /tmp/lib/jets/version.rb
+COPY jets.gemspec /tmp/
+COPY Gemfile* /tmp/
+RUN bundle install --jobs=4 --retry=3 && rm -rf /root/.bundle/cache
+
+# Do not try to precompile assets here because it could resurrect files
+# This happened with config/initializers/rollbar.rb.
+
+# Add development like customizations
+# COPY config/home/irbrc /root/.irbrc
+ENV TERM xterm
+
+COPY .codebuild/scripts /tmp/scripts
+RUN bash -eux /tmp/scripts/install-docker.sh
+RUN bash -exu /tmp/scripts/install-java.sh
+RUN bash -exu /tmp/scripts/install-dynamodb-local.sh
+RUN bash -exu /tmp/scripts/install-node.sh
+
+RUN apt-get install -y zip
+
+CMD ["/bin/bash"]

data/Gemfile

@@ -3,4 +3,11 @@ source "https://rubygems.org"
 # Specify your gem dependencies in jets.gemspec
 gemspec
 
-gem "codeclimate-test-reporter", group: :test, require: nil
+# required here for specs
+# TODO: Would like to only required this in the project's Gemfile
+# right now need both because of jets/application.rb and
+# jets/webpacker/middleware_setup.rb
+group :development, :test do
+  gem "webpacker", git: "https://github.com/tongueroo/webpacker.git", branch: "jets"
+  gem "rspec_junit_formatter"
+end

data/Gemfile.lock

@@ -1,54 +1,154 @@
+GIT
+  remote: https://github.com/tongueroo/webpacker.git
+  revision: a8c46614c6757fab65e4d0c47d8203014e7b4ef9
+  branch: jets
+  specs:
+    webpacker (3.2.0)
+      activesupport (>= 4.2)
+      rack-proxy (>= 0.6.1)
+      railties (>= 4.2)
+
 PATH
   remote: .
   specs:
     jets (0.2.0)
+      actionpack
+      actionview
+      activerecord
       activesupport
+      aws-sdk-cloudformation
+      aws-sdk-dynamodb
+      aws-sdk-lambda
+      aws-sdk-s3
       colorize
+      dotenv
+      gems
       hashie
+      json
+      kramdown
+      memoist
+      pg (= 0.21)
+      rack
+      railties
+      recursive-open-struct
+      text-table
       thor
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (5.1.4)
+    actionpack (5.2.1)
+      actionview (= 5.2.1)
+      activesupport (= 5.2.1)
+      rack (~> 2.0)
+      rack-test (>= 0.6.3)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.0, >= 1.0.2)
+    actionview (5.2.1)
+      activesupport (= 5.2.1)
+      builder (~> 3.1)
+      erubi (~> 1.4)
+      rails-dom-testing (~> 2.0)
+      rails-html-sanitizer (~> 1.0, >= 1.0.3)
+    activemodel (5.2.1)
+      activesupport (= 5.2.1)
+    activerecord (5.2.1)
+      activemodel (= 5.2.1)
+      activesupport (= 5.2.1)
+      arel (>= 9.0)
+    activesupport (5.2.1)
       concurrent-ruby (~> 1.0, >= 1.0.2)
-      i18n (~> 0.7)
+      i18n (>= 0.7, < 2)
       minitest (~> 5.1)
       tzinfo (~> 1.1)
-    byebug (9.1.0)
-    codeclimate-test-reporter (1.0.8)
-      simplecov (<= 0.13)
+    arel (9.0.0)
+    aws-eventstream (1.0.1)
+    aws-partitions (1.98.0)
+    aws-sdk-cloudformation (1.6.0)
+      aws-sdk-core (~> 3)
+      aws-sigv4 (~> 1.0)
+    aws-sdk-core (3.24.1)
+      aws-eventstream (~> 1.0)
+      aws-partitions (~> 1.0)
+      aws-sigv4 (~> 1.0)
+      jmespath (~> 1.0)
+    aws-sdk-dynamodb (1.10.0)
+      aws-sdk-core (~> 3)
+      aws-sigv4 (~> 1.0)
+    aws-sdk-kms (1.7.0)
+      aws-sdk-core (~> 3)
+      aws-sigv4 (~> 1.0)
+    aws-sdk-lambda (1.8.0)
+      aws-sdk-core (~> 3)
+      aws-sigv4 (~> 1.0)
+    aws-sdk-s3 (1.17.0)
+      aws-sdk-core (~> 3, >= 3.21.2)
+      aws-sdk-kms (~> 1)
+      aws-sigv4 (~> 1.0)
+    aws-sigv4 (1.0.3)
+    builder (3.2.3)
+    byebug (10.0.2)
     colorize (0.8.1)
     concurrent-ruby (1.0.5)
+    crass (1.0.4)
     diff-lcs (1.3)
-    docile (1.1.5)
-    hashie (3.5.6)
-    i18n (0.9.0)
+    dotenv (2.5.0)
+    erubi (1.7.1)
+    gems (1.1.1)
+      json
+    hashie (3.6.0)
+    i18n (1.1.0)
       concurrent-ruby (~> 1.0)
+    jmespath (1.4.0)
     json (2.1.0)
-    minitest (5.10.3)
-    rake (12.2.1)
-    rspec (3.7.0)
-      rspec-core (~> 3.7.0)
-      rspec-expectations (~> 3.7.0)
-      rspec-mocks (~> 3.7.0)
-    rspec-core (3.7.0)
-      rspec-support (~> 3.7.0)
-    rspec-expectations (3.7.0)
+    kramdown (1.17.0)
+    loofah (2.2.2)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.5.9)
+    memoist (0.16.0)
+    method_source (0.9.0)
+    mini_portile2 (2.3.0)
+    minitest (5.11.3)
+    nokogiri (1.8.4)
+      mini_portile2 (~> 2.3.0)
+    pg (0.21.0)
+    rack (2.0.5)
+    rack-proxy (0.6.4)
+      rack
+    rack-test (1.1.0)
+      rack (>= 1.0, < 3)
+    rails-dom-testing (2.0.3)
+      activesupport (>= 4.2.0)
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.0.4)
+      loofah (~> 2.2, >= 2.2.2)
+    railties (5.2.1)
+      actionpack (= 5.2.1)
+      activesupport (= 5.2.1)
+      method_source
+      rake (>= 0.8.7)
+      thor (>= 0.19.0, < 2.0)
+    rake (12.3.1)
+    recursive-open-struct (1.1.0)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.1)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.7.0)
-    rspec-mocks (3.7.0)
+      rspec-support (~> 3.8.0)
+    rspec-mocks (3.8.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.7.0)
-    rspec-support (3.7.0)
-    simplecov (0.13.0)
-      docile (~> 1.1.0)
-      json (>= 1.8, < 3)
-      simplecov-html (~> 0.10.0)
-    simplecov-html (0.10.2)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.0)
+    rspec_junit_formatter (0.4.1)
+      rspec-core (>= 2, < 4, != 2.12.0)
+    text-table (1.2.4)
     thor (0.20.0)
     thread_safe (0.3.6)
-    tzinfo (1.2.3)
+    tzinfo (1.2.5)
       thread_safe (~> 0.1)
 
 PLATFORMS
@@ -57,7 +157,11 @@ PLATFORMS
 DEPENDENCIES
   bundler
   byebug
-  codeclimate-test-reporter
   jets!
   rake
   rspec
+  rspec_junit_formatter
+  webpacker!
+
+BUNDLED WITH
+   1.16.3

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2013 Tung Nguyen
+Copyright (c) 2017 Tung Nguyen
 
 MIT License
 

data/Procfile

@@ -0,0 +1,2 @@
+local: dynamodb-local # port 8000
+admin: env AWS_ACCESS_KEY_ID=$DYNAMODB_ADMIN_AWS_ACCESS_KEY_ID PORT=8001 dynamodb-admin # port 8001

data/README.md

@@ -1,37 +1,136 @@
-# Jets
+<div align="center">
+  <link href="http://rubyonjets.com"><img src="http://rubyonjets.com/img/logos/jets-logo.png" /></img>
+</div>
 
-[![Build Status](https://magnum.travis-ci.com/)](https://magnum.travis-ci.com/)
-[![Code Climate](https://codeclimate.com/)](https://codeclimate.com/)
-[![Code Climate](https://codeclimate.com/)](https://codeclimate.com/)
+![Build Status](https://codebuild.us-west-2.amazonaws.com/badges?uuid=eyJlbmNyeXB0ZWREYXRhIjoiUE12K3ljQTFQUjVpRW0reGhGVHVQdkplTHlOdUtENnBya2JhVWVXaFIvTU92MlBtV3hIUE9pb25jWGw0MS9jN2RXMERKRHh5Nzhvd01Za0NyeUs5SCtzPSIsIml2UGFyYW1ldGVyU3BlYyI6IkMybEJFaXdzejJEaHNWVmEiLCJtYXRlcmlhbFNldFNlcmlhbCI6MX0%3D&branch=master)
+[![CircleCI](https://circleci.com/gh/tongueroo/jets.svg?style=svg)](https://circleci.com/gh/tongueroo/jets)
 
-To these the jets, run these commands:
+Ruby and Lambda splat out a baby and that child's name is Jets.
 
-TODO: Write a gem description
+## What is Jets?
 
-## Installation
+Jets is a Ruby Serverless Framework that allows you to create applications.  It includes everything required to build an application and deploy it to on AWS Lambda.
 
-Add this line to your application's Gemfile:
+It is key to understand AWS Lambda and API Gateway to understand Jets conceptually.  Jets maps your code to Lambda functions and API Gateway resources.
 
-```sh
-gem "jets"
-```
+* **AWS Lambda** is Functions as a Service. It allows you to upload and run functions without worrying about the underlying infrastructure.
+* **API Gateway** is the routing layer for Lambda. It is used to route REST URL endpoints to Lambda functions.
+
+The official documentation is at: [Ruby on Jets](http://rubyonjets.com).
+
+Refer to the official docs for more info, but here's a quick intro.
+
+### Jets Controllers
 
-And then execute:
+A Jets controller handles a web request and renders a response.  Here's an example:
 
-```sh
-$ bundle
+`app/controllers/posts_controller.rb`:
+
+```ruby
+class PostsController < ApplicationController
+  def index
+    # renders Lambda Proxy structure compatiable with API Gateway
+    render json: {hello: "world", action: "index"}
+  end
+
+  def show
+    id = params[:id] # params available
+    # puts goes to the lambda logs
+    puts event # raw lambda event available
+    render json: {action: "show", id: id}
+  end
+end
 ```
 
-Or install it yourself as:
+Jets creates Lambda functions each the public method in your controller.
+
+### Jets Routing
+
+You connect Lambda functions to API Gateway URL endpoints with a routes file:
 
+`config/routes.rb`:
+
+```ruby
+Jets.application.routes.draw do
+  get  "posts", to: "posts#index"
+  get  "posts/new", to: "posts#new"
+  get  "posts/:id", to: "posts#show"
+  post "posts", to: "posts#create"
+  get  "posts/:id/edit", to: "posts#edit"
+  put  "posts", to: "posts#update"
+  delete  "posts", to: "posts#delete"
+
+  resources :comments # expands to the RESTful routes above
+
+  any "posts/hot", to: "posts#hot" # GET, POST, PUT, etc request all work
+end
 ```
-$ gem install jets
+
+Test your API Gateway endpoints with curl or postman. Note, replace the URL endpoint with the one that is created:
+
+	$ curl -s "https://quabepiu80.execute-api.us-east-1.amazonaws.com/dev/posts" | jq .
+	{
+	  "hello": "world",
+	  "action": "index"
+	}
+
+### Jets Workers
+
+A Jets worker handles background jobs.  It is performed outside of the web request/response cycle. Here's an example:
+
+```ruby
+class HardJob < ApplicationJob
+  rate "10 hours" # every 10 hours
+  def dig
+    {done: "digging"}
+  end
+
+  cron "0 */12 * * ? *" # every 12 hours
+  def lift
+    {done: "lifting"}
+  end
+end
 ```
 
+`HardJob#dig` will be ran every 10 hours and `HardJob#lift` will be ran every 12 hours.
+
+### Jets Deployment
+
+You can test your application with a local server that mimics API Gateway: [Jets Local Server](http://rubyonjets.com/docs/local-server/). Once ready, deploying to AWS Lambda is a single command.
+
+	jets deploy
+
+After deployment, you can test the Lambda functions with the AWS Lambda console or the CLI.
+
+### AWS Lambda Console
+
+![Lambda Console](https://s3.amazonaws.com/boltops-demo/images/screenshots/lambda-console-posts-controller-index.png)
+
+### More Info
+
+For more documentation, check out the official docs: [Ruby on Jets](http://rubyonjets.com/).  Here's a list of useful links:
+
+* [Quick Start](http://rubyonjets.com/quick-start/)
+* [Local Jets Server](http://rubyonjets.com/docs/local-server/)
+* [REPL Console](http://rubyonjets.com/docs/repl-console/)
+* [Jets Call](http://rubyonjets.com/docs/jets-call/)
+* [Project Structure](http://rubyonjets.com/project-structure/)
+* [App Configuration](http://rubyonjets.com/app-config/)
+* [Database Support](http://rubyonjets.com/docs/database-support/)
+* [Polymorphic Support](http://rubyonjets.com/docs/polymorphic-support/)
+* [Tutorials](http://rubyonjets.com/docs/tutorials/)
+* [How Jets Works](http://rubyonjets.com/docs/how-jets-works/)
+* [Prewarming](http://rubyonjets.com/docs/prewarming/)
+* [Installation](http://rubyonjets.com/docs/install/)
+* [CLI Reference](http://rubyonjets.com/reference/)
+
 ## Contributing
 
+I love pull requests! Happy to answer questions to help.
+
 1. Fork it
 2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am "Add some 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
+