19 |
22 | -
10 | {% assign event_docs = site.docs | where: "categories","events" %}
11 | {% for doc in event_docs %}
12 |
- {{doc.title}} 13 | {% endfor %} 14 |
3 |
13 |
4 |
9 |
5 |
8 | Architecture
6 | 7 |
10 | 
11 |
12 |
11 |
8 | {% include sidebar.html %}
9 |
24 |
25 | {% endif %}
26 |
--------------------------------------------------------------------------------
/lib/jets/builders/rackup_wrappers/rackup:
--------------------------------------------------------------------------------
1 | #!/bin/bash
2 |
3 | set -e
4 |
5 | export JETS_MEGA=1
6 |
7 | # Figure out where this script is located.
8 | PROJECTDIR="`dirname \"$0\"`"
9 | PROJECTDIR="`cd \"$PROJECTDIR/..\" && pwd`"
10 |
11 | unset BUNDLE_IGNORE_CONFIG
12 | # When jets packages the app code it creates .bundle/config in the project root.
13 | # We want that to be used.
14 |
15 | # Drop a pidfile
16 | # echo $$ > /tmp/jets-rackup.pid
17 |
18 | # Run the actual app using the bundled Ruby interpreter, with Bundler activated.
19 | exec ruby -rbundler/setup bin/rackup.rb "$@"
20 |
--------------------------------------------------------------------------------
/lib/jets/commands/db/tasks/dummy/app.rb:
--------------------------------------------------------------------------------
1 | require "recursive-open-struct"
2 |
3 | module Jets::Commands::Db::Tasks::Dummy
4 | class App
5 | def config
6 | Config.new(
7 | active_record: {
8 | belongs_to_required_by_default: true
9 | },
10 | paths: {
11 | db: ["db"],
12 | "db/migrate": ["db/migrate"]
13 | }
14 | )
15 | end
16 |
17 | def paths
18 | RecursiveOpenStruct.new(
19 | paths: {
20 | "db/migrate": ["db/migrate"]
21 | }
22 | )
23 | end
24 | end
25 | end
26 |
--------------------------------------------------------------------------------
/spec/lib/jets/resource/child_stack/api_deployment_spec.rb:
--------------------------------------------------------------------------------
1 | describe Jets::Resource::ChildStack::ApiDeployment do
2 | let(:resource) do
3 | Jets::Resource::ChildStack::ApiDeployment.new("s3-bucket")
4 | end
5 |
6 | describe "resource" do
7 | it "contains child stack info" do
8 | expect(resource.logical_id).to match(/ApiDeployment(\d+)/)
9 | properties = resource.properties
10 | expect(properties["TemplateURL"]).to eq "https://s3.amazonaws.com/s3-bucket/jets/cfn-templates/#{Jets.config.project_namespace}-api-deployment.yml"
11 | end
12 | end
13 | end
14 |
--------------------------------------------------------------------------------
/spec/lib/jets/resource/api_gateway/domain_name_spec.rb:
--------------------------------------------------------------------------------
1 | describe Jets::Resource::ApiGateway::DomainName do
2 |
3 | context 'default' do
4 | let(:domain_name) do
5 | Jets::Resource::ApiGateway::DomainName.new
6 | end
7 |
8 | it "domain_name" do
9 | allow(Jets.config.domain).to receive(:name).and_return("test.com")
10 | expect(domain_name.logical_id).to eq "DomainName"
11 | properties = domain_name.properties
12 | # pp properties # uncomment to debug
13 | expect(properties["DomainName"]).to eq "test.com"
14 | end
15 | end
16 |
17 | end
18 |
--------------------------------------------------------------------------------
/docs/vendor/font-awesome/less/stacked.less:
--------------------------------------------------------------------------------
1 | // Stacked Icons
2 | // -------------------------
3 |
4 | .@{fa-css-prefix}-stack {
5 | position: relative;
6 | display: inline-block;
7 | width: 2em;
8 | height: 2em;
9 | line-height: 2em;
10 | vertical-align: middle;
11 | }
12 | .@{fa-css-prefix}-stack-1x, .@{fa-css-prefix}-stack-2x {
13 | position: absolute;
14 | left: 0;
15 | width: 100%;
16 | text-align: center;
17 | }
18 | .@{fa-css-prefix}-stack-1x { line-height: inherit; }
19 | .@{fa-css-prefix}-stack-2x { font-size: 2em; }
20 | .@{fa-css-prefix}-inverse { color: @fa-inverse; }
21 |
--------------------------------------------------------------------------------
/lib/jets/mega/request/source.rb:
--------------------------------------------------------------------------------
1 | class Jets::Mega::Request
2 | class Source
3 | def initialize(event)
4 | @event = event
5 | env = Jets::Controller::Rack::Env.new(@event, {}).convert # convert to Rack env
6 | @source_request = Rack::Request.new(env)
7 | end
8 |
9 | def body
10 | if @source_request.body.respond_to?(:read)
11 | body = @source_request.body.read
12 | @source_request.body.rewind
13 | end
14 | body
15 | end
16 |
17 | def content_length
18 | @source_request.content_length.to_i
19 | end
20 | end
21 | end
22 |
--------------------------------------------------------------------------------
/lib/jets/rule/base.rb:
--------------------------------------------------------------------------------
1 | require 'json'
2 |
3 | # Base public methods get turned into Lambda functions.
4 | #
5 | # Jets::Rule::Base < Jets::Lambda::Functions
6 | # Both Jets::Rule::Base and Jets::Lambda::Functions have Dsl modules included.
7 | # So the Jets::Rule::Dsl overrides some of the Jets::Lambda::Functions behavior.
8 | module Jets::Rule
9 | class Base < Jets::Lambda::Functions
10 | include Dsl
11 |
12 | class << self
13 | def process(event, context, meth)
14 | job = new(event, context, meth)
15 | job.send(meth)
16 | end
17 | end
18 | end
19 | end
20 |
--------------------------------------------------------------------------------
/spec/lib/jets/generate_spec.rb:
--------------------------------------------------------------------------------
1 | describe "jets generate" do
2 | describe "migration" do
3 | it "creates a migration file" do
4 | command = "exe/jets dynamodb:generate create_posts --partition-key id:string"
5 | out = execute(command)
6 | # pp out # uncomment to debug
7 | expect(out).to include("Generating migration")
8 | migration_path = Dir.glob("#{Dynomite.app_root}dynamodb/migrate/*").first
9 | migration_exist = File.exist?(migration_path)
10 | expect(migration_exist).to be true
11 | FileUtils.rm_f(migration_path)
12 | end
13 | end
14 | end
15 |
--------------------------------------------------------------------------------
/Rakefile:
--------------------------------------------------------------------------------
1 | require "bundler/setup"
2 | Bundler.setup
3 | require "bundler/gem_tasks"
4 | require "rspec/core/rake_task"
5 |
6 | task :default => :spec
7 |
8 | RSpec::Core::RakeTask.new
9 |
10 | require_relative "lib/jets"
11 | desc "Generates cli reference docs as markdown"
12 | task :docs do
13 | Jets::Autoloaders.once.eager_load
14 | Jets::Commands::Markdown::Creator.create_all
15 | end
16 |
17 | # Thanks: https://docs.ruby-lang.org/en/2.1.0/RDoc/Task.html
18 | require 'rdoc/task'
19 | require 'jets/rdoc'
20 |
21 | RDoc::Task.new do |rdoc|
22 | rdoc.options += Jets::Rdoc.options
23 | end
24 |
25 |
--------------------------------------------------------------------------------
/docs/vendor/font-awesome/scss/_stacked.scss:
--------------------------------------------------------------------------------
1 | // Stacked Icons
2 | // -------------------------
3 |
4 | .#{$fa-css-prefix}-stack {
5 | position: relative;
6 | display: inline-block;
7 | width: 2em;
8 | height: 2em;
9 | line-height: 2em;
10 | vertical-align: middle;
11 | }
12 | .#{$fa-css-prefix}-stack-1x, .#{$fa-css-prefix}-stack-2x {
13 | position: absolute;
14 | left: 0;
15 | width: 100%;
16 | text-align: center;
17 | }
18 | .#{$fa-css-prefix}-stack-1x { line-height: inherit; }
19 | .#{$fa-css-prefix}-stack-2x { font-size: 2em; }
20 | .#{$fa-css-prefix}-inverse { color: $fa-inverse; }
21 |
--------------------------------------------------------------------------------
/docs/vendor/font-awesome/less/font-awesome.less:
--------------------------------------------------------------------------------
1 | /*!
2 | * Font Awesome 4.7.0 by @davegandy - http://fontawesome.io - @fontawesome
3 | * License - http://fontawesome.io/license (Font: SIL OFL 1.1, CSS: MIT License)
4 | */
5 |
6 | @import "variables.less";
7 | @import "mixins.less";
8 | @import "path.less";
9 | @import "core.less";
10 | @import "larger.less";
11 | @import "fixed-width.less";
12 | @import "list.less";
13 | @import "bordered-pulled.less";
14 | @import "animated.less";
15 | @import "rotated-flipped.less";
16 | @import "stacked.less";
17 | @import "icons.less";
18 | @import "screen-reader.less";
19 |
--------------------------------------------------------------------------------
/lib/jets/stack/main/dsl/cloudwatch.rb:
--------------------------------------------------------------------------------
1 | module Jets::Stack::Main::Dsl
2 | module Cloudwatch
3 | def cloudwatch_alarm(id, hash={})
4 | if hash.key?(:depends_on)
5 | attributes = hash # leave structure alone and add type only
6 | attributes[:type] = "AWS::CloudWatch::Alarm"
7 | else
8 | # the attributes are properties
9 | properties = hash
10 | attributes = {
11 | type: "AWS::CloudWatch::Alarm",
12 | properties: properties,
13 | }
14 | end
15 | resource(id, attributes)
16 | output(id)
17 | end
18 | end
19 | end
--------------------------------------------------------------------------------
/spec/fixtures/apps/franky/app/javascript/packs/framework.js:
--------------------------------------------------------------------------------
1 | /* eslint no-console:0 */
2 | // This file is automatically compiled by Webpack, along with any other files
3 | // present in this directory. You're encouraged to place your actual framework logic in
4 | // a relevant structure within app/javascript and only use these pack files to reference
5 | // that code so it'll be compiled.
6 | //
7 | // To reference this file, add <%= javascript_pack_tag 'framework' %> to the appropriate
8 | // layout file, like app/views/layouts/framework.html.erb
9 |
10 | import '../src/framework'
11 | import './delete-item'
12 |
--------------------------------------------------------------------------------
/spec/lib/jets/middleware/default_stack_spec.rb:
--------------------------------------------------------------------------------
1 | describe Jets::Middleware::DefaultStack do
2 | let(:default_stack) { Jets::Middleware::DefaultStack.new(Jets.application, Jets.config) }
3 | context "default_stack" do
4 | it "build_stack" do
5 | stack = default_stack.build_stack
6 | middlewares = stack.instance_variable_get(:@middlewares)
7 | expect(middlewares).to include(Rack::Runtime)
8 | end
9 |
10 | it "session store" do
11 | session_store = default_stack.send(:session_store)
12 | expect(session_store).to eq Rack::Session::Cookie
13 | end
14 | end
15 | end
16 |
--------------------------------------------------------------------------------
/docs/_reference/jets-clean-log.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: jets clean:log
3 | reference: true
4 | ---
5 |
6 | ## Usage
7 |
8 | jets clean:log
9 |
10 | ## Description
11 |
12 | Cleans CloudWatch log groups assocated with app.
13 |
14 | Essentially removes the CloudWatch groups assocated with the app. Lambda requests re-create the log groups so this is pretty safe to do.
15 |
16 | ## Example
17 |
18 | jets log:clean
19 |
20 | ## Options
21 |
22 | ```
23 | [--noop], [--no-noop] # noop or dry-run mode
24 | [--mute], [--no-mute] # mute output
25 | [--sure], [--no-sure] # bypass are you sure prompt
26 | ```
27 |
28 |
--------------------------------------------------------------------------------
/lib/jets/router/resources/options.rb:
--------------------------------------------------------------------------------
1 | module Jets::Router::Resources
2 | class Options < Base
3 | def build(action)
4 | controller = @options[:singular_resource] ? @name.to_s.pluralize : @name
5 | options = @options.merge(to: "#{controller}##{action}") # important to create a copy of the options
6 | # remove special options from getting to create_route. For some reason .slice! doesnt work
7 | options.delete(:only)
8 | options.delete(:except)
9 | options[:from_scope] = true # flag to drop the prefix later in Route#compute_path
10 | options
11 | end
12 | end
13 | end
14 |
--------------------------------------------------------------------------------
/lib/jets/logger.rb:
--------------------------------------------------------------------------------
1 | require 'logger'
2 |
3 | module Jets
4 | class Logger < ::Logger
5 | # Only need to override the add method as the other calls all lead to it.
6 | def add(severity, message = nil, progname = nil)
7 | # Taken from Logger#add source
8 | # https://ruby-doc.org/stdlib-2.5.1/libdoc/logger/rdoc/Logger.html#method-i-add
9 | if message.nil?
10 | if block_given?
11 | message = yield
12 | else
13 | message = progname
14 | progname = @progname
15 | end
16 | end
17 |
18 | super # original logical
19 | end
20 | end
21 | end
--------------------------------------------------------------------------------
/spec/lib/jets/resource/replacer_spec.rb:
--------------------------------------------------------------------------------
1 | describe Jets::Resource::Replacer do
2 | let(:replacer) { Jets::Resource::Replacer.new(replacements) }
3 | let(:attributes) do
4 | {
5 | k: "{namespace}-value",
6 | a: {
7 | b: "{namespace}-value"
8 | }
9 | }
10 | end
11 | let(:replacements) { { namespace: "FooBar" } }
12 |
13 | context "raw cloudformation definition" do
14 | it "replace_placeholders" do
15 | result = replacer.replace_placeholders(attributes)
16 | # pp result
17 | expect(result).to eq(a: {b: "FooBar-value"}, k: "FooBar-value")
18 | end
19 | end
20 | end
--------------------------------------------------------------------------------
/lib/jets/commands/clean/base.rb:
--------------------------------------------------------------------------------
1 | class Jets::Commands::Clean
2 | class Base
3 | def initialize(options={})
4 | @options = options
5 | end
6 |
7 | private
8 | def say(message)
9 | prefix = 'NOOP ' if @options[:noop]
10 | puts "#{prefix}#{message}" unless @options[:mute]
11 | end
12 |
13 | def are_you_sure?(message)
14 | return true if @options[:yes]
15 |
16 | puts "Are you sure that you want to #{message}? (y/N)"
17 | yes = $stdin.gets.strip
18 | unless yes =~ /^y/
19 | puts "Phew that was close!"
20 | exit 0
21 | end
22 | end
23 | end
24 | end
--------------------------------------------------------------------------------
/spec/fixtures/apps/franky/app/controllers/books_controller/node/list.js:
--------------------------------------------------------------------------------
1 | 'use strict';
2 |
3 | exports.handler = function(event, context, callback) {
4 | var body = {'message': 'hi from node'};
5 | var response = {
6 | statusCode: "200",
7 | headers: {
8 | 'Content-Type': 'application/json',
9 | 'Access-Control-Allow-Origin': '*'
10 | },
11 | body: JSON.stringify(body)
12 | };
13 | callback(null, response);
14 | };
15 |
16 | // if (require.main === module) {
17 | // console.log('called directly');
18 | // } else {
19 | // console.log('required as a module');
20 | // }
--------------------------------------------------------------------------------
/spec/lib/jets/resource/child_stack/shared_spec.rb:
--------------------------------------------------------------------------------
1 | describe Jets::Resource::ChildStack::Shared do
2 | let(:resource) do
3 | path = "/tmp/jets/demo/templates/demo-test-shared-custom.yml"
4 | Jets::Resource::ChildStack::Shared.new("s3-bucket", path: path)
5 | end
6 |
7 | describe "resource" do
8 | it "contains child stack info" do
9 | expect(resource.logical_id).to eq "Custom"
10 | properties = resource.properties
11 | expect(properties["TemplateURL"]).to eq "https://s3.amazonaws.com/s3-bucket/jets/cfn-templates/#{Jets.config.project_namespace}-shared-custom.yml"
12 | end
13 | end
14 | end
15 |
--------------------------------------------------------------------------------
/Guardfile:
--------------------------------------------------------------------------------
1 | guard "bundler", cmd: "bundle" do
2 | watch("Gemfile")
3 | watch(/^.+\.gemspec/)
4 | end
5 |
6 | guard :rspec, cmd: "bundle exec rspec" do
7 | require "guard/rspec/dsl"
8 | dsl = Guard::RSpec::Dsl.new(self)
9 |
10 | # RSpec files
11 | rspec = dsl.rspec
12 | watch(rspec.spec_helper) { rspec.spec_dir }
13 | watch(rspec.spec_support) { rspec.spec_dir }
14 | watch(rspec.spec_files)
15 |
16 | # Ruby files
17 | ruby = dsl.ruby
18 | puts "ruby.lib_files #{ruby.lib_files.inspect}"
19 | dsl.watch_spec_files_for(ruby.lib_files)
20 |
21 | watch(%r{^lib/(.+)\.rb$}) { |m| "spec/lib/#{m[1]}_spec.rb" }
22 | end
23 |
--------------------------------------------------------------------------------
/docs/_docs/routing/authorizers/authorizer-caching.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: Authorizer Caching
3 | ---
4 |
5 | You can cache the authorizer with the `ttl` convenience property. This means the Authorizer lambda function will not be called again until the ttl expires. Example:
6 |
7 | ```ruby
8 | authorizer(
9 | name: "MainProtect", # required
10 | ttl: 60,
11 | )
12 | ```
13 |
14 | The `ttl` option is shorthand for the `authorizer_result_ttl_in_seconds` property associated with the CloudFormation [ApiGateway::Authorizer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-authorizer.html) properties.
15 |
16 |
--------------------------------------------------------------------------------
/lib/jets/commands/help/server.md:
--------------------------------------------------------------------------------
1 | The local server for mimics API Gateway and provides a way to test your app locally without deploying to AWS.
2 |
3 | ## Examples
4 |
5 | $ jets server
6 | => bundle exec shotgun --port 8888 --host 127.0.0.1
7 | Jets booting up in development mode!
8 | == Shotgun/WEBrick on http://127.0.0.1:8888/
9 | [2018-08-17 05:31:33] INFO WEBrick 1.4.2
10 | [2018-08-17 05:31:33] INFO ruby 2.5.1 (2018-03-29) [x86_64-linux]
11 | [2018-08-17 05:31:33] INFO WEBrick::HTTPServer#start: pid=27433 port=8888
12 |
13 | Start up server binding to host `0.0.0.0`:
14 |
15 | jets server --host 0.0.0.0
16 |
--------------------------------------------------------------------------------
/lib/jets/poly_fun/python_executor.rb:
--------------------------------------------------------------------------------
1 | class Jets::PolyFun
2 | class PythonExecutor < BaseExecutor
3 | # Code for wrapper script that mimics lambda execution. Wrapper script usage:
4 | #
5 | # python WRAPPER_SCRIPT EVENT
6 | #
7 | # Example:
8 | #
9 | # python /tmp/jets/demo/executor/20180804-12816-imqb9/lambda_executor.py '{}'
10 | def code
11 | <<-EOL
12 | import sys
13 | import json
14 | from #{@task.meth} import #{handler}
15 | event = json.loads(sys.argv[1])
16 | context = {}
17 | resp = #{handler}(event, context)
18 | result = json.dumps(resp)
19 | print(result)
20 | EOL
21 | end
22 | end
23 | end
--------------------------------------------------------------------------------
/lib/jets/resource/child_stack/base.rb:
--------------------------------------------------------------------------------
1 | # Inheriting classes should implement:
2 | #
3 | # definition
4 | # template_filename
5 | #
6 | module Jets::Resource::ChildStack
7 | class Base < Jets::Resource::Base
8 | def initialize(s3_bucket, options={})
9 | @s3_bucket = s3_bucket
10 | @options = options
11 | end
12 |
13 | def outputs
14 | {
15 | logical_id => "!Ref #{logical_id}",
16 | }
17 | end
18 |
19 | def template_url
20 | basename = File.basename(template_filename)
21 | "https://s3.amazonaws.com/#{@s3_bucket}/jets/cfn-templates/#{basename}"
22 | end
23 | end
24 | end
25 |
--------------------------------------------------------------------------------
/spec/fixtures/apps/franky/config/database.yml:
--------------------------------------------------------------------------------
1 | default: &default
2 | adapter: mysql2
3 | encoding: utf8mb4
4 | pool: <%= ENV["DB_POOL"] || 5 %>
5 | database: <%= ENV['DB_NAME'] || 'demo_dev' %>
6 | username: <%= ENV['DB_USER'] || 'tung' %>
7 | password: <%= ENV['DB_PASS'] %>
8 | host: <%= ENV["DB_HOST"] %>
9 |
10 | development:
11 | <<: *default
12 | database: demo_dev
13 |
14 | test:
15 | <<: *default
16 | database: demo_test
17 |
18 | staging:
19 | <<: *default
20 | url: <%= ENV['DB_URL'] %>
21 |
22 | production:
23 | <<: *default
24 | # TODO: remove hardcode of test database url
25 | url: <%= ENV['DB_URL'] %>
26 |
--------------------------------------------------------------------------------
/docs/_docs/extras/elb-override.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: ELB Server Override Flag for jets server
3 | ---
4 |
5 | ## Background
6 |
7 | While the goal of Jets is to create and deploy serverless services, there is often a need to run Jets in the server mode to debug your applications.
8 | This may include hosting it on AWS and having it reachable through a load balancer such as an Application Load Balancer.
9 |
10 | In the event you have a need to run it through an Elastic Load Balancer while running `jets server`, setting `JETS_ELB=1` will guarantee `jets server` behaviour even when behind an ELB. Context [#584](https://github.com/boltops-tools/jets/pull/584)
11 |
--------------------------------------------------------------------------------
/lib/jets/commands/clean.rb:
--------------------------------------------------------------------------------
1 | module Jets::Commands
2 | class Clean < Jets::Commands::Base
3 | class_option :noop, type: :boolean, desc: "noop or dry-run mode"
4 | class_option :mute, type: :boolean, desc: "mute output"
5 | class_option :yes, type: :boolean, desc: "bypass are you sure prompt"
6 |
7 | desc "log", "Cleans CloudWatch log groups assocated with app"
8 | long_desc Help.text('clean:log')
9 | def log
10 | Log.new(options).clean
11 | end
12 |
13 | desc "build", "Cleans jets build"
14 | long_desc Help.text('clean:build')
15 | def build
16 | Build.new(options).clean
17 | end
18 | end
19 | end
20 |
--------------------------------------------------------------------------------
/docs/_docs/rails-support.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: Rails Support
3 | ---
4 |
5 | {% include rails-update.md %}
6 |
7 | Jets supports deploying Rails applications with a few approaches that are experimental.
8 |
9 | 1. [Jets Afterburner Mode]({% link _docs/rails/afterburner.md %})
10 | 2. [Jets Mega Mode]({% link _docs/rails/megamode.md %})
11 |
12 | ## Mount Rails App?
13 |
14 | Rails is also rack compatible, so you may wonder if you can mount a Rails app with Jets [routes mount]({% link _docs/routing/mount.md %}) support. Mounting a Rails app is not currently recommended. Some thoughts on this here: [Mounting Rails Apps]({% link _docs/rails/mount.md %})
15 |
16 |
--------------------------------------------------------------------------------
/docs/_docs/debug-ruby-errors.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: Debugging Ruby Errors
3 | ---
4 |
5 | Ruby stack trace errors surface up to the Lambda Console.
6 |
7 | ## Example
8 |
9 | Here's an example of Ruby code throwing an intentional error:
10 |
11 | ```ruby
12 | class PostsController < ApplicationController
13 | # ...
14 | def ruby_example_error
15 | INTENTIONAL_RUBY_ERROR
16 | render json: {message: "hello from ruby #{RUBY_VERSION}"}
17 | end
18 | end
19 | ```
20 |
21 | Here's what the stack trace appears like in the Lambda Console.
22 |
23 | 
24 |
25 | You keep your mental context in Ruby land the entire time 😁
--------------------------------------------------------------------------------
/docs/_reference/jets-db-generate.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: jets db:generate
3 | reference: true
4 | ---
5 |
6 | ## Usage
7 |
8 | jets db:generate
9 |
10 | ## Description
11 |
12 | Creates a migration to change a db table.
13 |
14 | Generates migration in `db/migrate`
15 |
16 | ## Examples
17 |
18 | jets db:generate create_articles title:string user_id:integer
19 | jets db:generate AddTitleBodyToPost title:string body:text published:boolean
20 |
21 | This task delegates to Rails `rails generate migration`. For more examples, refer to the [Active Record Migrations Rails Guide](https://edgeguides.rubyonrails.org/active_record_migrations.html).
22 |
23 |
24 |
--------------------------------------------------------------------------------
/docs/_reference/jets-runner.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: jets runner
3 | reference: true
4 | ---
5 |
6 | ## Usage
7 |
8 | jets runner
9 |
10 | ## Description
11 |
12 | Run Ruby code in the context of Jets app non-interactively.
13 |
14 | ## Examples
15 |
16 | $ jets runner 'puts "hi"'
17 | hi
18 | $ jets runner 'puts Jets.env'
19 | development
20 |
21 | Using a script in a file. Let's say you have a script:
22 |
23 | script.rb:
24 |
25 | ```ruby
26 | puts "hello world: #{Jets.env}"
27 | ```
28 |
29 | $ jets runner file://script.rb
30 | hello world: development
31 |
32 | ## Options
33 |
34 | ```
35 | [--noop], [--no-noop]
36 | ```
37 |
38 |
--------------------------------------------------------------------------------
/spec/lib/jets/builders/md5_zip_spec.rb:
--------------------------------------------------------------------------------
1 | require "active_support/number_helper"
2 |
3 | describe Jets::Builders::Md5Zip do
4 | include ActiveSupport::NumberHelper
5 |
6 | let(:instance) { described_class.new(folder) }
7 | let(:folder) { 'test-folder' }
8 |
9 | describe 'initialize' do
10 | it { expect(instance.instance_variable_get(:@path)).to eq("#{Jets.build_root}/#{folder}") }
11 | end
12 |
13 | describe '#number_to_human_size' do
14 | it 'converts file size to human readable number' do
15 | file_size = 25000
16 | expect(instance.send(:number_to_human_size, file_size)).to eq(number_to_human_size(file_size))
17 | end
18 | end
19 | end
--------------------------------------------------------------------------------
/lib/jets/resource/s3/bucket.rb:
--------------------------------------------------------------------------------
1 | module Jets::Resource::S3
2 | class Bucket < Jets::Resource::Base
3 | attr_reader :bucket_logical_id
4 | def initialize(props={})
5 | @props = props # associated_properties from dsl.rb
6 | @bucket_logical_id = props.delete(:logical_id) || "{namespace}_s3_bucket"
7 | end
8 |
9 | def definition
10 | {
11 | bucket_logical_id => {
12 | type: "AWS::S3::Bucket",
13 | properties: @props,
14 | }
15 | }
16 | end
17 |
18 | def outputs
19 | {
20 | bucket_logical_id => "!Ref #{bucket_logical_id.to_s.camelize}",
21 | }
22 | end
23 | end
24 | end
25 |
--------------------------------------------------------------------------------
/spec/fixtures/apps/franky/app/javascript/packs/application.js:
--------------------------------------------------------------------------------
1 | /* eslint no-console:0 */
2 | // This file is automatically compiled by Webpack and Jets, along with any other files
3 | // present in this directory. You're encouraged to place your actual application logic in
4 | // a relevant structure within app/javascript and only use these pack files to reference
5 | // that code so it'll be compiled.
6 | //
7 | // To reference this file, add <%= javascript_pack_tag 'application' %> to the appropriate
8 | // layout file, like app/views/layouts/application.html.erb
9 |
10 | import '../src/application'
11 | import './delete-item'
12 | console.log('Hello World from Webpacker')
13 |
--------------------------------------------------------------------------------
/docs/_docs/app-config/filtering_params.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: Filtering Params
3 | ---
4 |
5 | By default, all params and event payload will be logged to CloudWatch in every request. You can override this setting with `filtered_parameters` to
6 | filter out sensitive information and mask it as FILTERED within the request log.
7 |
8 | ```ruby
9 | Jets.application.configure do
10 | config.controllers.filtered_parameters += [:password, :credit_card]
11 | end
12 | ```
13 |
14 | You can also use dot notation for nested parameters
15 |
16 | ```ruby
17 | class PostsController < ApplicationController
18 | config.controllers.filtered_parameters += ["user.password"]
19 | end
20 | ```
21 |
22 |
--------------------------------------------------------------------------------
/spec/fixtures/apps/franky/spec/spec_helper.rb:
--------------------------------------------------------------------------------
1 | ENV['JETS_TEST'] = "1"
2 | # Ensures aws api never called. Fixture home folder does not contain ~/.aws/credentails
3 | ENV['HOME'] = "spec/fixtures/home"
4 | ENV['JETS_ENV'] = "test"
5 |
6 | # require "simplecov"
7 | # SimpleCov.start
8 |
9 | require "pp"
10 | require "byebug"
11 | require "fileutils"
12 |
13 | require "jets"
14 | Jets.boot
15 |
16 | module Helpers
17 | def payload(name)
18 | JSON.load(IO.read("spec/fixtures/payloads/#{name}.json"))
19 | end
20 | end
21 |
22 | RSpec.configure do |c|
23 | c.before(:suite) do
24 | Aws.config.update(stub_responses: true)
25 | end
26 | c.include Helpers
27 | end
28 |
29 |
--------------------------------------------------------------------------------
/lib/jets/resource/iam/managed_policy.rb:
--------------------------------------------------------------------------------
1 | module Jets::Resource::Iam
2 | class ManagedPolicy
3 | extend Memoist
4 |
5 | attr_reader :definitions
6 | def initialize(*definitions)
7 | @definitions = definitions.flatten.compact
8 | end
9 |
10 | def arns
11 | definitions.map { |definition| standardize(definition) }
12 | end
13 | memoize :arns # only process arns once
14 |
15 | # AmazonEC2ReadOnlyAccess => arn:aws:iam::aws:policy/AmazonEC2ReadOnlyAccess
16 | def standardize(definition)
17 | return definition if definition.include?('iam::aws:policy')
18 |
19 | "arn:aws:iam::aws:policy/#{definition}"
20 | end
21 | end
22 | end
23 |
--------------------------------------------------------------------------------
/spec/fixtures/db_configs/database.single.yml:
--------------------------------------------------------------------------------
1 | default: &default
2 | adapter: mysql2
3 | encoding: utf8mb4
4 | pool: <%= ENV["DB_POOL"] || 5 %>
5 | database: <%= ENV['DB_NAME'] || 'demo_development' %>
6 | username: <%= ENV['DB_USER'] || 'root' %>
7 | password: <%= ENV['DB_PASS'] %>
8 | host: <%= ENV["DB_HOST"] %>
9 | url: <%= ENV['DATABASE_URL'] %> # takes higher precedence than other settings
10 |
11 | development:
12 | <<: *default
13 | database: <%= ENV['DB_NAME'] || 'demo_development' %>
14 |
15 | test:
16 | <<: *default
17 | database: demo_test
18 |
19 | production:
20 | <<: *default
21 | database: demo_production
22 | url: <%= ENV['DATABASE_URL'] %>
23 |
--------------------------------------------------------------------------------
/spec/fixtures/resource_pages/demo-test-api-resources-1.yml:
--------------------------------------------------------------------------------
1 | ---
2 | Resources:
3 | HiApiResource:
4 | Type: AWS::ApiGateway::Resource
5 | Properties:
6 | ParentId: !Ref RootResourceId
7 | PathPart: hi
8 | RestApiId: !Ref RestApi
9 | Hi1ApiResource:
10 | Type: AWS::ApiGateway::Resource
11 | Properties:
12 | ParentId: !Ref HiApiResource
13 | PathPart: '1'
14 | RestApiId: !Ref RestApi
15 | Parameters:
16 | RestApi:
17 | Type: String
18 | Description: RestApi
19 | RootResourceId:
20 | Type: String
21 | Outputs:
22 | HiApiResource:
23 | Value: !Ref HiApiResource
24 | Hi1ApiResource:
25 | Value: !Ref Hi1ApiResource
26 |
--------------------------------------------------------------------------------
/spec/fixtures/resource_pages/demo-test-api-resources-2.yml:
--------------------------------------------------------------------------------
1 | ---
2 | Resources:
3 | Hi2ApiResource:
4 | Type: AWS::ApiGateway::Resource
5 | Properties:
6 | ParentId: !Ref HiApiResource
7 | PathPart: '2'
8 | RestApiId: !Ref RestApi
9 | Hi3ApiResource:
10 | Type: AWS::ApiGateway::Resource
11 | Properties:
12 | ParentId: !Ref HiApiResource
13 | PathPart: '3'
14 | RestApiId: !Ref RestApi
15 | Parameters:
16 | RestApi:
17 | Type: String
18 | Description: RestApi
19 | HiApiResource:
20 | Type: String
21 | Outputs:
22 | Hi2ApiResource:
23 | Value: !Ref Hi2ApiResource
24 | Hi3ApiResource:
25 | Value: !Ref Hi3ApiResource
26 |
--------------------------------------------------------------------------------
/lib/jets/cfn/builders/rule_builder.rb:
--------------------------------------------------------------------------------
1 | # Implements:
2 | #
3 | # compose
4 | # template_path
5 | #
6 | module Jets::Cfn::Builders
7 | class RuleBuilder < BaseChildBuilder
8 | def compose
9 | add_common_parameters
10 | add_functions
11 | add_resources
12 | add_managed_rules
13 | end
14 |
15 | # Handle config_rules associated with aws managed rules.
16 | # List of AWS Config Managed Rules: https://amzn.to/2BOt9KN
17 | def add_managed_rules
18 | @app_class.managed_rules.each do |rule|
19 | resource = Jets::Resource.new(rule[:definition], rule[:replacements])
20 | add_resource(resource)
21 | end
22 | end
23 | end
24 | end
25 |
--------------------------------------------------------------------------------
/spec/fixtures/apps/franky/app/extensions/iot_extension.rb:
--------------------------------------------------------------------------------
1 | module IotExtension
2 | def thermostat_rule(logical_id, props={})
3 | logical_id = "#{logical_id}_topic_rule"
4 | defaults = {
5 | topic_rule_payload: {
6 | sql: "select * from TemperatureTopic where temperature > 60"
7 | },
8 | actions: [
9 | lambda: { function_arn: "!Ref {namespace}LambdaFunction" }
10 | ]
11 | }
12 | props = defaults.deep_merge(props)
13 | resource(logical_id, "AWS::Iot::TopicRule", props)
14 | # resource(
15 | # logical_id => {
16 | # type: "AWS::Iot::TopicRule",
17 | # properites: props
18 | # }
19 | # )
20 | end
21 | end
22 |
--------------------------------------------------------------------------------
/lib/jets/commands/help/degenerate.md:
--------------------------------------------------------------------------------
1 | This piggy backs off of the [rails scaffold destroy](https://guides.rubyonrails.org/command_line.html#rails-destroy).
2 |
3 | ## Example
4 |
5 | $ jets degenerate scaffold post title:string body:text published:boolean
6 | invoke active_record
7 | remove db/migrate/20190225231821_create_posts.rb
8 | remove app/models/post.rb
9 | invoke resource_route
10 | route resources :posts
11 | invoke scaffold_controller
12 | remove app/controllers/posts_controller.rb
13 | invoke erb
14 | invoke helper
15 | remove app/helpers/posts_helper.rb
16 | $
17 |
--------------------------------------------------------------------------------
/lib/jets/commands/help/import/rack.md:
--------------------------------------------------------------------------------
1 | Imports a generic Rack application into a Jets project and configures it for [Mega Mode](http://rubyonjets.com/docs/megamode/).
2 |
3 | Note, generic rack projects will likely need some adjustments to take into account API Gateway stages and logging. For more info refer to [Mega Mode Considerations](http://rubyonjets.com//megamode-details/).
4 |
5 | ## Example
6 |
7 | jets import:rack http://github.com/tongueroo/jets-mega-rails.git
8 |
9 | ## More Examples
10 |
11 | jets import:rack tongueroo/jets-mega-rails # expands to github
12 | jets import:rack git@github.com:tongueroo/jets-mega-rails.git
13 | jets import:rack /path/to/folder/jets-mega-rails
14 |
--------------------------------------------------------------------------------
/lib/jets/internal/app/controllers/jets/bare_controller.rb:
--------------------------------------------------------------------------------
1 | # Parent class for MountController and RackController
2 | class Jets::BareController < Jets::Controller::Base
3 | layout false
4 | internal true
5 | skip_forgery_protection
6 |
7 | private
8 | # Override process! so it doesnt go through the complete Jets project middleware stack which could interfer with
9 | # the mounted Rack app.
10 | def process!
11 | status, headers, body = dispatch!
12 | # Use the adapter only to convert the Rack triplet to a API Gateway hash structure
13 | adapter = Jets::Controller::Rack::Adapter.new(event, context, meth)
14 | adapter.convert_to_api_gateway(status, headers, body)
15 | end
16 | end
--------------------------------------------------------------------------------
/lib/jets/rdoc.rb:
--------------------------------------------------------------------------------
1 | module Jets
2 | module Rdoc
3 | # Use for both jets.gemspec and rake rdoc task
4 | def options
5 | exclude = %w[
6 | docs
7 | spec
8 | vendor
9 | core.rb
10 | .js
11 | templates
12 | commands
13 | internal
14 | support
15 | Dockerfile
16 | Dockerfile.base
17 | Gemfile
18 | Gemfile.lock
19 | Guardfile
20 | LICENSE
21 | Procfile
22 | Rakefile
23 | bin
24 | ]
25 | exclude = exclude.map { |word| ['-x', word] }.flatten
26 | ["-m", "README.md", "--markup", "tomdoc"] + exclude
27 | end
28 | extend self
29 | end
30 | end
--------------------------------------------------------------------------------
/spec/lib/jets/cfn/builders/api_deployment_spec.rb:
--------------------------------------------------------------------------------
1 | describe Jets::Cfn::Builders::ApiDeploymentBuilder do
2 | let(:builder) do
3 | Jets::Cfn::Builders::ApiDeploymentBuilder.new
4 | end
5 |
6 | describe "ApiDeploymentBuilder" do
7 | it "builds a child stack the deployment" do
8 | builder.compose
9 | # puts builder.text # uncomment to see template text
10 |
11 | resources = builder.template["Resources"]
12 | resource_types = resources.values.map { |i| i["Type"] }
13 | expect(resource_types).to include("AWS::ApiGateway::Deployment")
14 |
15 | expect(builder.template_path).to eq "#{Jets.build_root}/templates/demo-test-api-deployment.yml"
16 | end
17 | end
18 | end
19 |
--------------------------------------------------------------------------------
/spec/fixtures/apps/franky/app/shared/resources/custom.rb:
--------------------------------------------------------------------------------
1 | class Custom < Jets::Stack
2 | resource(:howdy,
3 | type: "AWS::Lambda::Function",
4 | properties: {
5 | function_name: "howdy",
6 | code: {
7 | s3_bucket: "!Ref S3Bucket",
8 | s3_key: code_s3_key
9 | },
10 | description: "Hello world",
11 | handler: handler("howdy.lambda_handler"),
12 | memory_size: 128,
13 | role: "!Ref IamRole",
14 | runtime: "python3.6",
15 | timeout: 20,
16 | }
17 | )
18 |
19 | function(:gru, runtime: :ruby, handler: "gru.handle")
20 |
21 | ruby_function(:bob)
22 | python_function(:kevin)
23 | node_function(:stuart)
24 |
25 | output("test")
26 | end
27 |
--------------------------------------------------------------------------------
/docs/_docs/custom-resources.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: Custom Resources
3 | ---
4 |
5 | You can create any custom AWS resources with Jets as a first-class citizen. There are 2 types of custom resources:
6 |
7 | 1. **Associated Custom Resources**: You define these resources above your methods, and they are meant to be associated with the Lambda function below it.
8 | 2. **Shared Custom Resources**: You define these resources in the `app/shared/resources` folder, and they are standalone resources.
9 |
10 | The custom resources are added to the generated AWS CloudFormation templates as part of the build process. The next sections provide an introduction to the core resource modeling behind Jets and examples of the custom resources.
11 |
12 |
--------------------------------------------------------------------------------
/lib/jets/builders/util.rb:
--------------------------------------------------------------------------------
1 | module Jets::Builders
2 | module Util
3 | private
4 | def sh(command)
5 | puts "=> #{command}".color(:green)
6 | success = system(command)
7 | unless success
8 | puts "#{command} failed to run.".color(:red)
9 | puts caller[0]
10 | exit 1
11 | end
12 | success
13 | end
14 |
15 | def headline(message)
16 | puts "=> #{message}".color(:cyan)
17 | end
18 |
19 | def build_area
20 | Jets.build_root
21 | end
22 |
23 | def stage_area
24 | "#{build_area}/stage"
25 | end
26 |
27 | def cache_area
28 | "#{build_area}/cache" # cleaner to use full path for this setting
29 | end
30 | end
31 | end
--------------------------------------------------------------------------------
/docs/_docs/local-server.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: Local Server
3 | ---
4 |
5 | To speed up development, you can run a local server which mimics API Gateway. Test your application code locally and then deploy to AWS when ready.
6 |
7 | jets server
8 |
9 | You can test your app at [http://localhost:8888](http://localhost:8888). Here's a curl command to create a post:
10 |
11 | curl -X POST http://localhost:8888/posts \
12 | -H 'Content-Type: application/json' \
13 | -d '{
14 | "post": {
15 | "title": "My Test Post 1",
16 | "desc": "test desc",
17 | }
18 | }
19 | '
20 |
21 | You can find examples of all the CRUD actions at [Jets CRUD Tutorials]({% link _docs/tutorials.md %}).
22 |
23 |
--------------------------------------------------------------------------------
/docs/_sass/cta.scss:
--------------------------------------------------------------------------------
1 | // Styling for the call to action section
2 | section.cta {
3 | padding: 50px 0;
4 | text-align: center;
5 | margin: 0 auto;
6 | background-position: center;
7 | background-color: #730c0c;
8 | @include background-cover;
9 | .cta-content {
10 | h2 {
11 | text-align: center;
12 | margin: 0 auto 25px auto;
13 | font-size: 50px;
14 | font-weight: 200;
15 | max-width: 450px;
16 | color: white;
17 | border: none;
18 | }
19 | @media (min-width: 768px) {
20 | h2 {
21 | text-align: center;
22 | margin: 0 auto;
23 | font-size: 80px;
24 | border: none;
25 | font-weight: 200;
26 | }
27 | }
28 | }
29 | }
30 |
--------------------------------------------------------------------------------
/lib/jets/commands/markdown/index.rb:
--------------------------------------------------------------------------------
1 | module Jets::Commands::Markdown
2 | class Index
3 | def path
4 | "docs/reference.md"
5 | end
6 |
7 | def command_list
8 | commands = Jets::Commands::Base.namespaced_commands.sort.reject {|c| c.include?('help') }
9 | commands.map do |full_command|
10 | # Example: [jets deploy]({% link _reference/jets-deploy.md %})
11 | link = full_command.gsub(':','-')
12 | "* [jets #{full_command}]({% link _reference/jets-#{link}.md %})"
13 | end.join("\n")
14 | end
15 |
16 | def doc
17 | <<-EOL
18 | ---
19 | title: CLI Reference
20 | ---
21 | {% include reference.md %}
22 |
23 | #{command_list}
24 | EOL
25 | end
26 | end
27 | end
28 |
--------------------------------------------------------------------------------
/spec/lib/jets/cfn/builders/job_builder_spec.rb:
--------------------------------------------------------------------------------
1 | describe Jets::Cfn::Builders::JobBuilder do
2 | let(:builder) do
3 | Jets::Cfn::Builders::JobBuilder.new(HardJob)
4 | end
5 |
6 | describe "compose" do
7 | it "builds a child stack with the scheduled events" do
8 | builder.compose
9 | # puts builder.text # uncomment to see template text
10 |
11 | resources = builder.template["Resources"]
12 | expect(resources).to include("DigLambdaFunction")
13 | expect(resources).to include("DigPermission")
14 | expect(resources).to include("LiftEventsRule")
15 |
16 | expect(builder.template_path).to eq "#{Jets.build_root}/templates/demo-test-app-hard_job.yml"
17 | end
18 | end
19 | end
20 |
--------------------------------------------------------------------------------
/docs/vendor/font-awesome/less/bordered-pulled.less:
--------------------------------------------------------------------------------
1 | // Bordered & Pulled
2 | // -------------------------
3 |
4 | .@{fa-css-prefix}-border {
5 | padding: .2em .25em .15em;
6 | border: solid .08em @fa-border-color;
7 | border-radius: .1em;
8 | }
9 |
10 | .@{fa-css-prefix}-pull-left { float: left; }
11 | .@{fa-css-prefix}-pull-right { float: right; }
12 |
13 | .@{fa-css-prefix} {
14 | &.@{fa-css-prefix}-pull-left { margin-right: .3em; }
15 | &.@{fa-css-prefix}-pull-right { margin-left: .3em; }
16 | }
17 |
18 | /* Deprecated as of 4.4.0 */
19 | .pull-right { float: right; }
20 | .pull-left { float: left; }
21 |
22 | .@{fa-css-prefix} {
23 | &.pull-left { margin-right: .3em; }
24 | &.pull-right { margin-left: .3em; }
25 | }
26 |
--------------------------------------------------------------------------------
/spec/lib/jets/middleware_spec.rb:
--------------------------------------------------------------------------------
1 | class MiddlewareTestClass
2 | include Jets::Middleware
3 | end
4 |
5 | describe Jets::Middleware do
6 | let(:env) do
7 | event = json_file("spec/fixtures/dumps/api_gateway/posts/index.json")
8 | context = nil
9 | env = Jets::Controller::Rack::Env.new(event, context).convert
10 | route = Jets::Controller::Middleware::Local::RouteMatcher.new(env).find_route
11 | mimic = Jets::Controller::Middleware::Local::MimicAwsCall.new(route, env)
12 | env.merge!(mimic.vars)
13 | env
14 | end
15 |
16 | context "middleware" do
17 | it "call" do
18 | status, headers, body = MiddlewareTestClass.new.call(env)
19 | expect(status).to eq "200"
20 | end
21 | end
22 | end
23 |
--------------------------------------------------------------------------------
/lib/jets/middleware/layer.rb:
--------------------------------------------------------------------------------
1 | module Jets::Middleware
2 | class Layer
3 | attr_reader :args, :block, :klass
4 |
5 | def initialize(klass, args, block)
6 | @klass = klass
7 | @args = args
8 | @block = block
9 | end
10 |
11 | def name; klass.name; end
12 |
13 | def ==(middleware)
14 | case middleware
15 | when Layer
16 | klass == middleware.klass
17 | when Class
18 | klass == middleware
19 | end
20 | end
21 |
22 | def inspect
23 | if klass.is_a?(Class)
24 | klass.to_s
25 | else
26 | klass.class.to_s
27 | end
28 | end
29 |
30 | def build(app)
31 | klass.new(app, *args, &block)
32 | end
33 | end
34 | end
35 |
--------------------------------------------------------------------------------
/spec/fixtures/dumps/logs/log_event.json:
--------------------------------------------------------------------------------
1 | {
2 | "awslogs": {
3 | "data": "H4sIAGPuZFwAA61SXY/SQBT9K83ER2pn7nzzVkJdVwEN7WYftsRM6YCNLcW2gEj4705xN2yiJms083Jzzsy55565J1TZtjVrmxy3Fg3ROEzCT9MojsObCA1QfdjYxsGEAFDKGOdCOLis1zdNvds6JjCHNihNleUm+GzLsv5Jx11jTeV4wEQHGALCgodXkzCJ4mRBLcYYhMkwFWy5IgYruTKgNNF5JlbaSbS7rF02xbYr6s2bouxs06LhA8ptVfu53fuTev2uznx+f/8ez2AKah76c7utmy7+5aWfjKaT8I7g2W3yFi0u/qK93XS95AkVubNJGRdKcglSUCw0BayIdEdJLbFkkmJGGFZUc0LdRAyUFFzoPoyucBF2pnJpEM4xIaJXInLwFK2TvyTjHeqmzNMNOg/+rat8YVfbD+mdUvTFHkmKhinam3JnXTm4YHDF4AmjV8yV59+71UpLygFzJRQWRIEW3LGcSQWOUFoDEPedgoCQ7E9uhVTP3UazsTe3X3fu4m0+9NiSaMUw9YnRzGcgM1/nyvqMG8BLt1YA5j+44y90N48+fpgnf22wG+8a06/i0COSvpbUq9q0GxVlaXPvygHGjvDSbuoWvDl6cfHduhegvOnIgeab90jctda15vyC9+Mvzj8ACHlavMMDAAA="
4 | }
5 | }
--------------------------------------------------------------------------------
/spec/lib/jets/functions/base_path_spec.rb:
--------------------------------------------------------------------------------
1 | require "ostruct"
2 | require "render_me_pretty"
3 |
4 | code = RenderMePretty.result("./lib/jets/internal/app/functions/jets/base_path.rb", stage_name: "test")
5 | # Hack to mimic lambda
6 | eval %Q{
7 | class MainScope
8 | #{code}
9 | end
10 | }
11 |
12 | describe "base_path" do
13 | before do
14 | allow(CfnResponse).to receive(:new).and_return(null)
15 | end
16 | let(:event) { null }
17 | let(:context) { null }
18 | let(:null) { double(:null).as_null_object }
19 |
20 | let(:main) do
21 | MainScope.new
22 | end
23 |
24 | # mainly test for silly syntax errors
25 | it "BasePathMapping" do
26 | main.lambda_handler(event: event, context: context)
27 | end
28 | end
29 |
--------------------------------------------------------------------------------
/docs/vendor/font-awesome/less/rotated-flipped.less:
--------------------------------------------------------------------------------
1 | // Rotated & Flipped Icons
2 | // -------------------------
3 |
4 | .@{fa-css-prefix}-rotate-90 { .fa-icon-rotate(90deg, 1); }
5 | .@{fa-css-prefix}-rotate-180 { .fa-icon-rotate(180deg, 2); }
6 | .@{fa-css-prefix}-rotate-270 { .fa-icon-rotate(270deg, 3); }
7 |
8 | .@{fa-css-prefix}-flip-horizontal { .fa-icon-flip(-1, 1, 0); }
9 | .@{fa-css-prefix}-flip-vertical { .fa-icon-flip(1, -1, 2); }
10 |
11 | // Hook for IE8-9
12 | // -------------------------
13 |
14 | :root .@{fa-css-prefix}-rotate-90,
15 | :root .@{fa-css-prefix}-rotate-180,
16 | :root .@{fa-css-prefix}-rotate-270,
17 | :root .@{fa-css-prefix}-flip-horizontal,
18 | :root .@{fa-css-prefix}-flip-vertical {
19 | filter: none;
20 | }
21 |
--------------------------------------------------------------------------------
/docs/vendor/font-awesome/scss/_bordered-pulled.scss:
--------------------------------------------------------------------------------
1 | // Bordered & Pulled
2 | // -------------------------
3 |
4 | .#{$fa-css-prefix}-border {
5 | padding: .2em .25em .15em;
6 | border: solid .08em $fa-border-color;
7 | border-radius: .1em;
8 | }
9 |
10 | .#{$fa-css-prefix}-pull-left { float: left; }
11 | .#{$fa-css-prefix}-pull-right { float: right; }
12 |
13 | .#{$fa-css-prefix} {
14 | &.#{$fa-css-prefix}-pull-left { margin-right: .3em; }
15 | &.#{$fa-css-prefix}-pull-right { margin-left: .3em; }
16 | }
17 |
18 | /* Deprecated as of 4.4.0 */
19 | .pull-right { float: right; }
20 | .pull-left { float: left; }
21 |
22 | .#{$fa-css-prefix} {
23 | &.pull-left { margin-right: .3em; }
24 | &.pull-right { margin-left: .3em; }
25 | }
26 |
--------------------------------------------------------------------------------
/spec/lib/jets/cfn/builders/rule_builder_spec.rb:
--------------------------------------------------------------------------------
1 | describe Jets::Cfn::Builders::RuleBuilder do
2 | let(:builder) do
3 | Jets::Cfn::Builders::RuleBuilder.new(GameRule)
4 | end
5 |
6 | describe "compose" do
7 | it "builds a child stack with the scheduled events" do
8 | builder.compose
9 | # puts builder.text # uncomment to see template text
10 |
11 | resources = builder.template["Resources"]
12 | expect(resources).to include("ProtectLambdaFunction")
13 | expect(resources).to include("ProtectPermission")
14 | expect(resources).to include("ProtectConfigRule")
15 |
16 | expect(builder.template_path).to eq "#{Jets.build_root}/templates/demo-test-app-game_rule.yml"
17 | end
18 | end
19 | end
20 |
--------------------------------------------------------------------------------
/docs/_docs/database/dynamodb.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: Database DynamoDB
3 | ---
4 |
5 | Jets supports DynamoDB via [Dynomite](https://github.com/tongueroo/dynomite).
6 |
7 | ## Migrations
8 |
9 | Here's an example of creating migrations:
10 |
11 | jets dynamodb:generate create_posts # generates migration
12 | jets dynamodb:migrate dynamodb/migrate/20171112194549-create_posts_migration.rb # run migration. replace with your timestamp
13 |
14 | If you are using DynamoDB it can be useful to use DynamoDB Local, just like you would use a local SQL server. It's simply a jar file you download and run. Here's a [DynamoDB Local Setup Walkthrough](https://github.com/boltops-tools/jets/wiki/Dynamodb-Local-Setup-Walkthrough) that takes about 5 minutes.
15 |
16 |
--------------------------------------------------------------------------------
/docs/_docs/next-steps.md:
--------------------------------------------------------------------------------
1 | ---
2 | title: Next Steps
3 | ---
4 |
5 | Hopefully, you have a good feel for how Jets works now. From here, there are a few resources that can help you continue along:
6 |
7 | * Check out the [Jets](https://github.com/boltops-tools/jets) repo on GitHub
8 | * ⭐️ the Jets project on GitHub
9 | * Write a blog post about Jets
10 | * Post on your favorite discussion about Jets
11 | * Contribute a pull request
12 |
13 | Everyone can contribute to making jets better, including the documentation. These docs are the jets repo located the [docs folder](https://github.com/boltops-tools/jets/tree/master/docs). Please fork the project and open a pull request! We love your pull requests. Contributions are encouraged and welcomed!
14 |
15 |
--------------------------------------------------------------------------------
/spec/fixtures/db_configs/database.multi.yml:
--------------------------------------------------------------------------------
1 | default: &default
2 | adapter: mysql2
3 | pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
4 | timeout: 5000
5 | encoding: utf8mb4
6 |
7 | test:
8 | primary:
9 | <<: *default
10 | database: my_primary_database
11 | user: root
12 | primary_replica:
13 | <<: *default
14 | database: my_primary_database
15 | user: root # user: root_readonly
16 | replica: true
17 | animals:
18 | <<: *default
19 | database: my_animals_database
20 | user: root # user: animals_root
21 | migrations_paths: db/animals_migrate
22 | animals_replica:
23 | <<: *default
24 | database: my_animals_database
25 | user: root # user: animals_readonly
26 | replica: true
27 |
--------------------------------------------------------------------------------
/lib/jets/commands/help/routes.md:
--------------------------------------------------------------------------------
1 | ## Example
2 |
3 | $ jets routes
4 | +--------+----------------+--------------------+
5 | | Verb | Path | Controller#action |
6 | +--------+----------------+--------------------+
7 | | GET | posts | posts#index |
8 | | GET | posts/new | posts#new |
9 | | GET | posts/:id | posts#show |
10 | | POST | posts | posts#create |
11 | | GET | posts/:id/edit | posts#edit |
12 | | PUT | posts/:id | posts#update |
13 | | DELETE | posts/:id | posts#delete |
14 | | ANY | *catchall | jets/public#show |
15 | +--------+----------------+--------------------+
16 | $
--------------------------------------------------------------------------------
/spec/lib/jets/resource/api_gateway/rest_api/routes/change_detection.rb:
--------------------------------------------------------------------------------
1 | describe Jets::Resource::ApiGateway::RestApi do
2 | let(:detection) { Jets::Resource::ApiGateway::RestApi::ChangeDetection.new }
3 |
4 | context "general" do
5 | it "default binary media type" do
6 | expect(detection.new_binary_media_types).to eq ["multipart/form-data"]
7 | end
8 | end
9 |
10 | # TODO: have a spec in place right now for basic syntax checking. Eventually add
11 | # more specs in the future.
12 | # context "changes detected" do
13 | # it "reuses the existing rest api logical id" do
14 | # end
15 | # end
16 |
17 | # context "no changes detected" do
18 | # it "updates the rest api logical id" do
19 | # end
20 | # end
21 | end
22 |
--------------------------------------------------------------------------------
/.github/ISSUE_TEMPLATE/documentation.md:
--------------------------------------------------------------------------------
1 | ---
2 | name: Documentation
3 | about: Found a typo or something that isn't crystal clear in the docs?
4 | title: ''
5 | labels: docs
6 | assignees: ''
7 |
8 | ---
9 |
10 |
17 |
18 | ## Motivation
19 |
20 |
21 |
22 |
23 | ## Suggestion
24 |
25 |
26 |
27 |
28 |
--------------------------------------------------------------------------------
/backers.md:
--------------------------------------------------------------------------------
1 |
10 |
17 |
18 |
23 | Backers
2 | 3 | [Jets](http://rubyonjets.com/) is an MIT-licensed open source project. It's an independent project with its ongoing development made possible entirely thanks to the support by these awesome [backers](https://github.com/tongueroo/jets/blob/master/backers.md). If you'd like to join them, please consider: 4 | 5 | - [Become a backer or sponsor on Patreon](https://www.patreon.com/tongueroo). 6 | 7 | Funds donated via Patreon go directly to support Tung Nguyen's full-time work on Jets. 8 | 9 |10 | 11 |