jets 4.0.9 → 5.0.0.beta1

data/lib/jets/commands/dbconsole.rb

@@ -1,134 +0,0 @@
-# Thanks: Rails dbconsole_command.rb
-module Jets::Commands
-  class Dbconsole
-    extend Memoist
-
-    def self.start(*args)
-      new(*args).start
-    end
-
-    def initialize(options = {})
-      defaults = {"include_password" => true}
-      @options = defaults.merge(options)
-    end
-
-    def start
-      ENV["RAILS_ENV"] ||= @options[:environment] || environment
-
-      case config["adapter"]
-      when /^(jdbc)?mysql/
-        args = {
-          "host"      => "--host",
-          "port"      => "--port",
-          "socket"    => "--socket",
-          "username"  => "--user",
-          "encoding"  => "--default-character-set",
-          "sslca"     => "--ssl-ca",
-          "sslcert"   => "--ssl-cert",
-          "sslcapath" => "--ssl-capath",
-          "sslcipher" => "--ssl-cipher",
-          "sslkey"    => "--ssl-key"
-        }.map { |opt, arg| "#{arg}=#{config[opt]}" if config[opt] }.compact
-
-        if config["password"] && @options["include_password"]
-          args << "--password=#{config['password']}"
-        elsif config["password"] && !config["password"].to_s.empty?
-          args << "-p"
-        end
-
-        args << config["database"]
-
-        find_cmd_and_exec(["mysql", "mysql5"], *args)
-
-      when /^postgres|^postgis/
-        ENV["PGUSER"]     = config["username"] if config["username"]
-        ENV["PGHOST"]     = config["host"] if config["host"]
-        ENV["PGPORT"]     = config["port"].to_s if config["port"]
-        ENV["PGPASSWORD"] = config["password"].to_s if config["password"] && @options["include_password"]
-        find_cmd_and_exec("psql", config["database"])
-
-      when "sqlite3"
-        args = []
-
-        args << "-#{@options['mode']}" if @options["mode"]
-        args << "-header" if @options["header"]
-        args << File.expand_path(config["database"], Jets.root)
-
-        find_cmd_and_exec("sqlite3", *args)
-
-      when "oracle", "oracle_enhanced"
-        logon = ""
-
-        if config["username"]
-          logon = config["username"]
-          logon << "/#{config['password']}" if config["password"] && @options["include_password"]
-          logon << "@#{config['database']}" if config["database"]
-        end
-
-        find_cmd_and_exec("sqlplus", logon)
-
-      when "sqlserver"
-        args = []
-
-        args += ["-D", "#{config['database']}"] if config["database"]
-        args += ["-U", "#{config['username']}"] if config["username"]
-        args += ["-P", "#{config['password']}"] if config["password"]
-
-        if config["host"]
-          host_arg = "#{config['host']}"
-          host_arg << ":#{config['port']}" if config["port"]
-          args += ["-S", host_arg]
-        end
-
-        find_cmd_and_exec("sqsh", *args)
-
-      else
-        abort "Unknown command-line client for #{config['database']}."
-      end
-    end
-
-    def config
-      configs = configurations.configs_for(env_name: environment)
-      if configs.blank?
-        raise ActiveRecord::AdapterNotSpecified, "'#{environment}' database is not configured. Available configuration: #{configurations.inspect}"
-      else
-        configs.first.configuration_hash.dup.stringify_keys!
-      end
-    end
-    memoize :config
-
-    def environment
-      Jets.env.to_s
-    end
-
-    private
-      def configurations # :doc:
-        db_config = Jets.application.config.database
-        ActiveRecord::Base.configurations = db_config
-        ActiveRecord::Base.configurations
-      end
-
-      def find_cmd_and_exec(commands, *args) # :doc:
-        commands = Array(commands)
-
-        dirs_on_path = ENV["PATH"].to_s.split(File::PATH_SEPARATOR)
-        unless (ext = RbConfig::CONFIG["EXEEXT"]).empty?
-          commands = commands.map { |cmd| "#{cmd}#{ext}" }
-        end
-
-        full_path_command = nil
-        found = commands.detect do |cmd|
-          dirs_on_path.detect do |path|
-            full_path_command = File.join(path, cmd)
-            File.file?(full_path_command) && File.executable?(full_path_command)
-          end
-        end
-
-        if found
-          exec full_path_command, *args
-        else
-          abort("Couldn't find database client: #{commands.join(', ')}. Check your $PATH and try again.")
-        end
-      end
-  end
-end

data/lib/jets/commands/delete.rb

@@ -1,136 +0,0 @@
-class Jets::Commands::Delete
-  include Jets::AwsServices
-
-  def initialize(options)
-    @options = options
-  end
-
-  def run
-    puts("Deleting project...")
-    return if @options[:noop]
-
-    are_you_sure?
-
-    confirm_project_exists
-
-    # Must first remove all objects from s3 bucket in order to delete stack
-    puts "First, deleting objects in s3 bucket #{s3_bucket_name}" if s3_bucket_name
-    empty_s3_bucket
-
-    stack_in_progress?(parent_stack_name)
-
-    cfn.delete_stack(stack_name: parent_stack_name)
-    puts "Deleting #{Jets.config.project_namespace.color(:green)}..."
-
-    wait_for_stack if @options[:wait]
-
-    delete_logs
-
-    puts "Project #{Jets.config.project_namespace.color(:green)} deleted!"
-  end
-
-  def wait_for_stack
-    status = Jets::Cfn::Status.new(@options)
-    start_time = Time.now
-    status.wait
-    took = Time.now - start_time
-    puts "Time took for deletion: #{status.pretty_time(took).color(:green)}."
-  end
-
-  def delete_logs
-    puts "Deleting CloudWatch logs"
-    log = Jets::Commands::Clean::Log.new(mute: true, yes: true)
-    log.clean
-  end
-
-  def confirm_project_exists
-    cfn.describe_stacks(stack_name: parent_stack_name)
-  end
-
-  def empty_s3_bucket
-    return unless s3_bucket_name # Happens when minimal stack fails to build
-    return unless bucket_exists?(s3_bucket_name)
-
-    resp = s3.list_objects(bucket: s3_bucket_name)
-    if resp.contents.size > 0
-      # IE: objects = [{key: "objectkey1"}, {key: "objectkey2"}]
-      objects = resp.contents.map { |item| {key: item.key} }
-      s3.delete_objects(
-        bucket: s3_bucket_name,
-        delete: {
-          objects: objects,
-          quiet: false,
-        }
-      )
-      empty_s3_bucket # keep deleting objects until bucket is empty
-    end
-  end
-
-  def s3_bucket_name
-    return @s3_bucket_name if defined?(@s3_bucket_name)
-
-    resp = cfn.describe_stacks(stack_name: parent_stack_name)
-    outputs = resp.stacks[0].outputs
-    if outputs.empty?
-      @s3_bucket_name = false
-    else
-      @s3_bucket_name = outputs.find {|o| o.output_key == 'S3Bucket'}.output_value
-    end
-  end
-
-  # Thanks: https://docs.aws.amazon.com/sdk-for-ruby/v3/developer-guide/s3-example-does-bucket-exist.html
-  def bucket_exists?(bucket_name)
-    bucket_exists = false
-    begin
-      resp = s3.head_bucket(bucket: bucket_name, use_accelerate_endpoint: false)
-      bucket_exists = true
-    rescue
-    end
-    bucket_exists
-  end
-
-  def parent_stack_name
-    Jets::Names.parent_stack_name
-  end
-
-  def are_you_sure?
-    if @options[:yes]
-      sure = 'y'
-    else
-      puts "Are you sure you want to want to delete the #{Jets.config.project_namespace.color(:green)} project? (y/N)"
-      sure = $stdin.gets
-    end
-
-    unless sure =~ /^y/
-      puts "Phew! Jets #{Jets.config.project_namespace.color(:green)} project was not deleted."
-      exit 0
-    end
-  end
-
-    # All CloudFormation states listed here: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-describing-stacks.html
-    #
-    # Returns resp so we can use it to grab data about the stack without calling api again.
-    def check_deleteable_status
-      return true if !stack_exists?(@parent_stack_name)
-
-      # Assumes stack exists
-      resp = cfn.describe_stacks(stack_name: @parent_stack_name)
-      status = resp.stacks[0].stack_status
-
-      return true if status == 'ROLLBACK_COMPLETE'
-
-      if status =~ /_IN_PROGRESS$/
-        puts "The '#{@parent_stack_name}' stack status is #{status}. " \
-             "It is not in an updateable status. Please wait until the stack is ready and try again.".color(:red)
-        exit 0
-      elsif resp.stacks[0].outputs.empty?
-        # This Happens when the miminal stack fails at the very beginning.
-        # There is no s3 bucket at all.  User should delete the stack.
-        puts "The minimal stack failed to create. Please delete the stack first and try again. " \
-        "You can delete the CloudFormation stack or use the `jets delete` command"
-        exit 0
-      else
-        true
-      end
-    end
-end

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

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

@@ -1,36 +0,0 @@
-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 Jets.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/dynamodb.rb

@@ -1,19 +0,0 @@
-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/gems.rb

@@ -1,13 +0,0 @@
-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")
-    option :verbose, type: :boolean, desc: "Verbose mode"
-    def check
-      check = Jets::Gems::Check.new(@options)
-      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
-  end
-end

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

@@ -1,69 +0,0 @@
-## 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
-
-If you want to call a function which runs too long time, you can set `read_timeout`.
-
-    jets call some_long_job-index --read_timeout 900
-    
-And you can set `retry_limit`. If you don't want to retry you can set 0.
-
-    jets call some_long_job-index --retry_limit 0
-
-## 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/dynamodb/generate.md

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

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

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

@@ -1,16 +0,0 @@
-## Example
-
-    $ jets routes
-    +--------+----------------+--------------------+
-    |  Verb  |      Path      | Controller#action  |
-    +--------+----------------+--------------------+
-    | GET    | posts          | posts#index        |
-    | GET    | posts/new      | posts#new          |
-    | GET    | posts/:id      | posts#show         |
-    | POST   | posts          | posts#create       |
-    | GET    | posts/:id/edit | posts#edit         |
-    | PUT    | posts/:id      | posts#update       |
-    | DELETE | posts/:id      | posts#delete       |
-    | ANY    | *catchall      | jets/public#show   |
-    +--------+----------------+--------------------+
-    $

data/lib/jets/commands/help.rb

@@ -1,9 +0,0 @@
-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/import/base.rb

@@ -1,49 +0,0 @@
-class Jets::Commands::Import
-  class Base < Sequence
-    # Ugly, but when the class_option is only defined in the Thor::Group class
-    # it doesnt show up with jets new help :(
-    # If anyone knows how to fix this let me know.
-    def self.cli_options
-      [
-        [:submodule, type: :boolean, default: false, desc: "Imports the project as a submodule"],
-      ]
-    end
-    cli_options.each { |args| class_option(*args) }
-
-    # Since setup is public it will automatically run in the subclasses
-    def setup
-      start_message
-      create_rack_folder
-      configure_ruby
-      create_rackup_wrappers
-    end
-
-  private
-    def start_message
-      puts "Importing app into the rack folder..."
-    end
-
-    def create_rack_folder
-      repo? ? clone_project : copy_project
-    end
-
-    def configure_ruby
-      gsub_file 'rack/Gemfile', /^ruby(.*)/, '# ruby\1' # comment out ruby declaration
-      create_file "rack/.ruby-version", RUBY_VERSION, force: true
-    end
-
-    def create_rackup_wrappers
-      path = File.expand_path("../../builders/rackup_wrappers", File.dirname(__FILE__))
-      Dir.glob("#{path}/*").each do |p|
-        FileUtils.cp(p, "#{rack_folder}/bin/")
-      end
-      chmod "#{rack_folder}/bin/rackup", 0755
-    end
-
-    def bundle_install
-      Bundler.with_unbundled_env do
-        run "cd rack && bundle install"
-      end
-    end
-  end
-end

data/lib/jets/commands/import/cheatsheet.rb

@@ -1,35 +0,0 @@
-class Jets::Commands::Import
-  class Cheatsheet
-    def self.create(rack_repo_url)
-      new(rack_repo_url).create
-    end
-
-    def initialize(rack_repo_url)
-      @rack_repo_url = rack_repo_url
-    end
-
-    def create
-      path = File.expand_path("./templates/", File.dirname(__FILE__)) + "/submodules-cheatsheet.md"
-      basename = File.basename(path)
-      dest = "#{Jets.root}/#{basename}"
-      cheatsheet = Jets::Erb.result(path, cheatsheet_vars)
-      FileUtils.mkdir_p(File.dirname(dest))
-      IO.write(dest, cheatsheet)
-      puts "Created #{basename} to help with using submodules."
-    end
-
-    def cheatsheet_vars
-      import_command = ARGV[0]
-      {
-        import_command: import_command,
-        rack_repo_url: @rack_repo_url,
-        jets_project_repo_url: jets_project_repo_url,
-      }
-    end
-
-    def jets_project_repo_url
-      # Thanks: https://stackoverflow.com/questions/4089430/how-can-i-determine-the-url-that-a-local-git-repository-was-originally-cloned-fr/4089452
-      `git config --get remote.origin.url`.strip rescue 'https://github.com/user/repo'
-    end
-  end
-end

data/lib/jets/commands/import/rack.rb

@@ -1,16 +0,0 @@
-class Jets::Commands::Import
-  class Rack < Base
-    def install
-      bundle_install
-    end
-
-    def finish_message
-      puts <<~EOL
-        #{"="*30}
-        Congrats! The Rack project from #{@source} has been imported to the rack folder.
-
-        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/).
-      EOL
-    end
-  end
-end