jets_bb_fork 0.0.4

data/lib/jets/commands/dynamodb.rb

@@ -0,0 +1,19 @@
+module Jets::Commands
+  class Dynamodb < Jets::Commands::Base
+    desc "migrate [path]", "Runs migrations"
+    long_desc Help.text('dynamodb:migrate')
+    def migrate(path)
+      Migrator.new(path, options).run
+    end
+
+    desc "generate [name]", "Creates a migration for a DynamoDB table"
+    long_desc Help.text('dynamodb:generate')
+    option :partition_key, default: "id:string:hash", desc: "table's partition key"
+    option :sort_key, default: nil, desc: "table's sort key"
+    option :table_name, desc: "override the the conventional table name"
+    option :table_action, desc: "create_table or update_table. Defaults to convention based on the name of the migration."
+    def generate(name)
+      Dynomite::Migration::Generator.new(name, options).generate
+    end
+  end
+end

data/lib/jets/commands/dynamodb/migrate.rb

@@ -0,0 +1,9 @@
+class Jets::Commands::Dynamodb::Migrate < Jets::Commands::Base
+  desc "down", "Runs migrations down"
+  # desc "migrate:down [path]", "Runs migrations down"
+  # long_desc Help.migrate
+  def down#(path)
+    # Migrate.new(path, options).run
+    puts "Jets::Commands::Dynamodb::Down ran"
+  end
+end

data/lib/jets/commands/dynamodb/migrator.rb

@@ -0,0 +1,36 @@
+begin
+  require "dynomite"
+rescue LoadError # Commands::Base.eager_load
+  nil
+end
+
+class Jets::Commands::Dynamodb::Migrator
+  def initialize(path, options)
+    @path = path
+    @options = options
+  end
+
+  def run
+    puts "Running database migrations"
+    return if @options[:noop]
+    migrate
+  end
+
+  def migrate
+    path = "#{Jets.root}/#{@path}"
+    unless File.exist?(path)
+      puts "Unable to find the migration file: #{path}"
+      exit 1 unless ENV['TEST']
+    end
+
+    require path
+    migration_class = get_migration_class
+    migration_class.new.up
+  end
+
+  def get_migration_class
+    filename = File.basename(@path, '.rb')
+    filename = filename.sub(/\d+[-_]/, '') # strip leading timestsamp
+    filename.camelize.constantize
+  end
+end

data/lib/jets/commands/gems.rb

@@ -0,0 +1,21 @@
+module Jets::Commands
+  class Gems < Jets::Commands::Base
+    desc "check", "Check if pre-built Lambda gems are available from the sources"
+    long_desc Help.text("gems:check")
+    def check
+      check = Jets::Gems::Check.new(cli: true)
+      check.run! # exits early if missing gems found
+      # If reach here, means all gems are ok.
+      puts "Congrats! All gems are available in as pre-built Lambda gems 👍"
+    end
+
+    desc "sources", "List pre-built Lambda gem sources"
+    long_desc Help.text("gems:sources")
+    def sources
+      puts "Your pre-built Lambda gem sources are:"
+      Jets.config.gems.sources.each do |source|
+        puts "  #{source}"
+      end
+    end
+  end
+end

data/lib/jets/commands/help.rb

@@ -0,0 +1,9 @@
+module Jets::Commands::Help
+  class << self
+    def text(namespaced_command)
+      path = namespaced_command.to_s.gsub(':','/')
+      path = File.expand_path("../help/#{path}.md", __FILE__)
+      IO.read(path) if File.exist?(path)
+    end
+  end
+end

data/lib/jets/commands/help/build.md

@@ -0,0 +1,6 @@
+Builds a zip file package to be uploaded to AWS Lambda. This allows you to build the project without deploying and inspect the zip file that gets deployed to AWS Lambda. The package contains:
+
+* your application code
+* generated shims
+
+If the application has no Ruby code and only uses Polymorphic functions, then gems are not bundled up.

data/lib/jets/commands/help/call.md

@@ -0,0 +1,61 @@
+## Remote mode
+
+Invoke the lambda function on AWS. The `jets call` command does a few extra things for your convenience:
+
+It adds the function namespace to the function name.  So, you pass in `posts_controller-index` and the Lambda function is `demo-dev-posts_controller-index`.
+
+CLI Name | Lambda Function
+--- | ---
+posts_controller-index | demo-dev-posts_controller-index
+
+The `jets call` command can also print out the last 4KB of the lambda logs with the `--show-logs` option. The logging output is directed to stderr and the response output from the lambda function itself is directed to stdout so you can safely pipe the results of the call command to other tools like `jq`.
+
+For [controllers](http://rubyonjets.com/docs/controllers/), the event you pass at the CLI is automatically transformed into [Lambda Proxy](https://docs.aws.amazon.com/apigateway/latest/developerguide/set-up-lambda-proxy-integrations.html) payload that contains the params as the `queryStringParameters`.  For example:
+
+    {"test":1}
+
+Gets changed to:
+
+    {"queryStringParameters":{"test":1}}
+
+This spares you from assembling the event payload manually to the payload that Jets controllers normally receive.  If you would like to disable this Lambda Proxy transformation then use the `--no-lambda-proxy` flag.
+
+For [jobs](http://rubyonjets.com/docs/jobs/), the event is passed through untouched.
+
+## Examples
+
+    jets call hard_job-drive '{"test":1}'
+    jets call hard_job-drive '{"test":1}' | jq .
+    jets call hard_job-drive file://event.json | jq . # load event with a file
+    jets call posts_controller-index # event payload is optional
+    jets call posts_controller-index '{"path":"/posts"}' --show-log | jq .
+    jets call posts_controller-index 'file://event.json' --show-log | jq .
+
+The equivalent AWS Lambda CLI command:
+
+    aws lambda invoke --function-name demo-dev-hard_job-dig --payload '{"path":"/posts","test":1}' outfile.txt
+    cat outfile.txt | jq '.'
+
+    aws lambda invoke --function-name demo-dev-posts_controller-index --payload '{"queryStringParameters":{"path":"/posts",test":1}}' outfile.txt
+    cat outfile.txt | jq '.'
+
+For convenience, you can also provide the function name with only dashes and `jets call` figures out what function you intend to call. Examples:
+
+    jets call posts-controller-index
+    jets call admin-related-pages-controller-index
+
+Are the same as:
+
+    aws lambda invoke --function-name demo-dev-posts_controller-index
+    aws lambda invoke --function-name demo-dev-admin/related_pages_controller-index
+
+Jets figures out what functions to call by evaluating the app code and finds if the controller and method exists.  If you want to turn guess mode off and want to always explicitly provide the method name use the `--no-guess` option.  The function name will then have to match the lambda function without the namespace. Example:
+
+    jets call admin-related_pages_controller-index --no-guess
+
+## Local mode
+
+Instead of calling AWS lambda remote, you can also have `jets call` use the code directly on your machine.  To enable this, use the `--local` flag. Example:
+
+    jets call hard_job-drive --local
+

data/lib/jets/commands/help/clean/build.md

@@ -0,0 +1,5 @@
+Removes the build files that jets creates. Essentially, deletes `/tmp/jets`. This will remove all build files for all jets projects. This is safe as jets uses `/tmp/jets` merely as a cache to speed up incrementally builds. Cleaning this out can clean up cruft in the `/tmp/jets` directory that builds over time.
+
+## Example
+
+    jets clean:build

data/lib/jets/commands/help/clean/log.md

@@ -0,0 +1,5 @@
+Essentially removes the CloudWatch groups assocated with the app. Lambda requests re-create the log groups so this is pretty safe to do.
+
+## Example
+
+    jets log:clean

data/lib/jets/commands/help/console.md

@@ -0,0 +1,18 @@
+## Example
+
+    $ jets console
+    >> Post.table_name
+    => "posts"
+    >> ActiveRecord::Base.connection.tables
+    => ["schema_migrations", "ar_internal_metadata", "posts"]
+    >> Jets.env
+    => "development"
+    >>
+
+## Use .env.development.remote
+
+To use the remote values also in the `jets console` you can use the `JETS_ENV_REMOTE=1` env variable. Example:
+
+    JETS_ENV_REMOTE=1 jets console
+
+More info at [Env Files](http://rubyonjets.com/docs/env-files/)

data/lib/jets/commands/help/db/generate.md

@@ -0,0 +1,8 @@
+Generates migration in `db/migrate`
+
+## Examples
+
+    jets db:generate create_articles title:string user_id:integer
+    jets db:generate AddTitleBodyToPost title:string body:text published:boolean
+
+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).

data/lib/jets/commands/help/dbconsole.md

@@ -0,0 +1,9 @@
+This is like running the psql command with the `config/database.yml` values and set for you.
+
+## Example
+
+    $ jets dbconsole
+    psql (9.2.24)
+    Type "help" for help.
+
+    demo_dev=>

data/lib/jets/commands/help/delete.md

@@ -0,0 +1,22 @@
+This deletes the all the contents in the internal s3 bucket that jets uses and the associated CloudFormation stacks.
+
+## Examples
+
+    $ jets delete
+    Deleting project...
+    Are you sure you want to want to delete the 'demo-dev' project? (y/N)
+    y
+    First, deleting objects in s3 bucket demo-dev-s3bucket-89jrrj60c7bj
+    Deleting demo-dev...
+    05:14:09AM DELETE_IN_PROGRESS AWS::CloudFormation::Stack demo-dev User Initiated
+    ...
+    05:14:23AM DELETE_IN_PROGRESS AWS::CloudFormation::Stack PostsController
+    05:15:31AM DELETE_COMPLETE AWS::S3::Bucket S3Bucket
+    Stack demo-dev deleted.
+    Time took for deletion: 1m 27s.
+    Project demo-dev deleted!
+    $
+
+You can bypass the are you sure prompt with the `--sure` flag.
+
+    $ jets delete --sure

data/lib/jets/commands/help/deploy.md

@@ -0,0 +1,32 @@
+This builds the project and deploys it AWS Lambda. The deployment is mainly handled by CloudFormation.  To check on the status of the deploy you can also check the CloudFormation console.
+
+![](http://rubyonjets.com/img/cli/deploy-cloudformation-status.png)
+
+## Example
+
+    $ jets deploy
+    Deploying to Lambda demo-dev environment...
+    => Compling assets in current project directory
+    => Copying current project directory to temporary build area: /tmp/jets/demo/app_root
+    => Tidying project: removing ignored files to reduce package size.
+    => Generating node shims in the handlers folder.
+    => Bundling: running bundle install in cache area: /tmp/jets/demo/cache.
+    => Setting up a vendored copy of ruby.
+    => Replacing compiled gems with AWS Lambda Linux compiled versions.
+    Creating zip file.
+    => cd /tmp/jets/demo/app_root && zip --symlinks -rq /tmp/jets/demo/code/code-temp.zip .
+    Building CloudFormation templates.
+    Deploying CloudFormation stack with jets app!
+    Uploading /tmp/jets/demo/code/code-7169d0ac.zip (88.8 MB) to S3
+    Time to upload code to s3: 1s
+    Deploying CloudFormation stack with jets app!
+    02:08:20AM UPDATE_IN_PROGRESS AWS::CloudFormation::Stack demo-dev User Initiated
+    02:08:23AM CREATE_IN_PROGRESS AWS::CloudFormation::Stack ApiGateway
+    ...
+    02:08:48AM CREATE_IN_PROGRESS AWS::CloudFormation::Stack PostsController
+    02:10:03AM UPDATE_COMPLETE AWS::CloudFormation::Stack demo-dev
+    Stack success status: UPDATE_COMPLETE
+    Time took for stack deployment: 1m 46s.
+    Prewarming application.
+    API Gateway Endpoint: https://ewwnealfk0.execute-api.us-west-2.amazonaws.com/dev/
+    $

data/lib/jets/commands/help/destroy.md

@@ -0,0 +1,16 @@
+This piggy backs off of the [rails scaffold destroy](https://guides.rubyonrails.org/command_line.html#rails-destroy).
+
+## Example
+
+    $ jets destroy scaffold Post title:string body:text published:boolean
+          invoke  active_record
+          remove    db/migrate/20190225231821_create_posts.rb
+          remove    app/models/post.rb
+          invoke  resource_route
+          route    resources :posts
+          invoke  scaffold_controller
+          remove    app/controllers/posts_controller.rb
+          invoke    erb
+          invoke    helper
+          remove      app/helpers/posts_helper.rb
+    $

data/lib/jets/commands/help/dynamodb/generate.md

@@ -0,0 +1,52 @@
+Generates a migration file which can be used to create a DynamoDB table.  To run the migration file use `jets dynamodb:migrate`.
+
+The table name will have a namespace. For example, if your project is called `demo`, the environment is `development`, and you create a table called `posts`.  The DynamoDB full table name will be `demo-dev-posts`.  You can change this behavior by editing your `config/dynamodb.yml` and adjusting the `table_namespace` value.
+
+DynamoDB tables support certain types of attribute types. The CLI will parse the `--partition-key` option and use the second part of the option to map it to the underlying DynamoDB type using this mapping.
+
+```ruby
+ATTRIBUTE_TYPE_MAP = {
+  'string' => 'S',
+  'number' => 'N',
+  'binary' => 'B',
+  's' => 'S',
+  'n' => 'N',
+  'b' => 'B',
+}
+```
+
+For example, `--partition-key id:string`  maps 'string' to 's'.  More info on DynamoDB types is available at the ruby aws-sdk docs: [Aws::DynamoDB::Types::AttributeDefinition](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/DynamoDB/Types/AttributeDefinition.html)
+
+## Examples
+
+    $ jets dynamodb:generate create_posts --partition-key id # default attribute type is string
+    $ jets dynamodb:generate create_posts --partition-key id:number # attribute type will be number
+    $ jets dynamodb:generate create_comments --partition-key post_id:string --sort-key created_at:string
+
+## Running migrations
+
+    $ jets dynamodb:migrate path/to/migration
+    $ jets dynamodb:migrate dynamodb/migrate/20171112162404-create_articles_migration.rb
+
+To add global secondary indexes:
+
+    $ jets dynamodb:generate update_comments --partition-key user_id:string --sort-key created_at:string
+
+To run:
+
+    $ jets dynamodb:migrate dynamodb/migrate/20171112161530-create_posts_migration.rb
+
+## Conventions
+
+A create_table or update_table migration file is generated based name you provide.  If `update` is included in the name then an update_table migration table is generated. If `create` is included in the name then a create_table migration table is generated.
+
+The table_name is also inferred from the migration name you provide.  Examples:
+
+    $ jets dynamodb:generate create_posts # table_name: posts
+    $ jets dynamodb:generate update_comments # table_name: comments
+
+You can override both of these conventions:
+
+    $ jets dynamodb:generate create_my_posts --table-name posts
+    $ jets dynamodb:generate my_posts --table-action create_table --table-name posts
+    $ jets dynamodb:generate my_posts --table-action update_table --table-name posts

data/lib/jets/commands/help/dynamodb/migrate.md

@@ -0,0 +1,4 @@
+## Examples
+
+    jets dynamodb:migrate path/to/migration
+    jets dynamodb:migrate db/migrate/posts_migration.rb

data/lib/jets/commands/help/gems/check.md

@@ -0,0 +1,8 @@
+You can configure additional gem sources in config/application.rb:
+
+    # Sources for check for pre-compiled Lambda gems. Checks the list in order.
+    Jets.application.configure do
+      config.gems.sources = [
+        "https://gems2.lambdagems.com"
+      ]
+    end

data/lib/jets/commands/help/generate.md

@@ -0,0 +1,22 @@
+This piggy backs off of the [rails scaffold generator](https://guides.rubyonrails.org/command_line.html#rails-generate).
+
+## Example
+
+    $ jets generate scaffold post title:string body:text published:boolean
+          invoke  active_record
+          create    db/migrate/20180817052529_create_posts.rb
+          create    app/models/post.rb
+          invoke  resource_route
+           route    resources :posts
+          invoke  scaffold_controller
+          create    app/controllers/posts_controller.rb
+          invoke    erb
+          create      app/views/posts
+          create      app/views/posts/index.html.erb
+          create      app/views/posts/edit.html.erb
+          create      app/views/posts/show.html.erb
+          create      app/views/posts/new.html.erb
+          create      app/views/posts/_form.html.erb
+          invoke    helper
+          create      app/helpers/posts_helper.rb
+    $

data/lib/jets/commands/help/import/rack.md

@@ -0,0 +1,13 @@
+Imports a generic Rack application into a Jets project and configures it for [Mega Mode](http://rubyonjets.com/docs/megamode/).
+
+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/).
+
+## Example
+
+    jets import:rack http://github.com/tongueroo/jets-mega-rails.git
+
+## More Examples
+
+    jets import:rack tongueroo/jets-mega-rails # expands to github
+    jets import:rack git@github.com:tongueroo/jets-mega-rails.git
+    jets import:rack /path/to/folder/jets-mega-rails

data/lib/jets/commands/help/import/rails.md

@@ -0,0 +1,11 @@
+Imports a Rails application into a Jets project and configures it for [Mega Mode](http://rubyonjets.com/docs/rails-support/).
+
+## Example
+
+    jets import:rails http://github.com/tongueroo/demo-rails.git
+
+## More Examples
+
+    jets import:rails tongueroo/demo-rails # expands to github
+    jets import:rails git@github.com:tongueroo/demo-rails.git
+    jets import:rails /path/to/folder/jets-examples-rails

data/lib/jets/commands/help/new.md

@@ -0,0 +1,42 @@
+## Examples
+
+    $ jets new demo
+    Creating a new Jets project called demo.
+          create  demo/app/controllers/application_controller.rb
+          create  demo/app/helpers/application_helper.rb
+          create  demo/app/jobs/application_job.rb
+    ...
+    ================================================================
+    Congrats  You have successfully created a Jets project.
+
+    Cd into the project directory:
+      cd demo
+
+    To start a server and test locally:
+      jets server # localhost:8888 should have the Jets welcome page
+
+    Scaffold example:
+      jets generate scaffold post title:string body:text published:boolean
+
+    To deploy to AWS Lambda:
+      jets deploy
+    $
+
+## Mode Option
+
+The `--mode` is a notable option. With it, you can generate different starter Jets projects. Examples:
+
+    jets new demo --mode html # default
+    jets new api --mode api
+    jets new cron --mode job
+
+* The html mode generates a starter app useful for html web application.
+* The api mode is useful for building an API.
+* The job mode creates a very lightweight project. It is useful when you just need to run a Lambda function.
+
+## Repo Option
+Use the `--repo` flag to clone an example project from GitHub instead.  With this flag, jets new command clones a jets project repo from GitHub:
+
+    $ jets new blog --repo tongueroo/tutorial
+    $ jets new todos --repo tongueroo/todos
+    $ jets new whatever --repo user/repo # any github repo