jets 0.2.0 → 0.5.0

data/lib/jets/cfn/template_mappers/events_rule_mapper.rb

@@ -0,0 +1,40 @@
+class Jets::Cfn::TemplateMappers
+  class EventsRuleMapper
+    # task is a Jets::Job::Task
+    def initialize(task)
+      @task = task
+    end
+
+    # Example: "HardJobDigScheduledEvent"
+    def logical_id
+      "#{full_task_name}ScheduledEvent"
+    end
+
+    # Example: "HardJobDigLambdaFunction"
+    def lambda_function_logical_id
+      "#{full_task_name}LambdaFunction"
+    end
+
+    # Target Id: A unique, user-defined identifier for the target. Acceptable values include alphanumeric characters, periods (.), hyphens (-), and underscores (_).
+    #
+    # Example: RuleTargetHardJobDig
+    def rule_target_id
+      "#{full_task_name}RuleTarget"
+    end
+
+    # Example: HardJobDigEventsRulePermission
+    def permission_logical_id
+      "#{full_task_name}EventsRulePermission"
+    end
+
+  private
+    # Full camelized task name including the class
+    # Example: HardJobDig
+    def full_task_name
+      class_name = @task.class_name.gsub('::','')
+      task_name = @task.meth.to_s.camelize
+      "#{class_name}#{task_name}"
+    end
+  end
+end
+

data/lib/jets/cfn/template_mappers/function_mapper.rb

@@ -0,0 +1,4 @@
+class Jets::Cfn::TemplateMappers
+  class FunctionMapper < ChildMapper
+  end
+end

data/lib/jets/cfn/template_mappers/gateway_method_mapper.rb

@@ -0,0 +1,56 @@
+class Jets::Cfn::TemplateMappers
+  class GatewayMethodMapper
+    def initialize(route)
+      @route = route # {to: "posts#index", path: "posts", method: :get}
+    end
+
+    def logical_id
+      if @route.homepage?
+        "RootPathHomepageGetApiGatewayMethod"
+      else
+        "#{path_method_id}ApiGatewayMethod"
+      end
+    end
+
+    def path_method_id
+      path = @route.path.gsub(':','_').gsub('/','_').gsub('*','')
+      method = @route.method.downcase
+      "#{path}_#{method}".camelize
+    end
+
+    # Example returns:
+    #   ApiGatewayResourcePostsIdEdit or
+    #   ApiGatewayResourcePostsId or
+    #   ApiGatewayResourcePosts
+    def gateway_resource_logical_id
+      resource_map.logical_id
+    end
+
+    def cors_logical_id
+      resource_map.cors_logical_id
+    end
+
+    def resource_map
+      @resource_map ||= GatewayResourceMapper.new(@route.path)
+    end
+
+    def lambda_function_logical_id
+      "#{controller_action_logical_id}LambdaFunction"
+    end
+
+    def permission_logical_id
+      "#{controller_action_logical_id}ApiGatewayPermission"
+    end
+
+    # Example: PostsControllerIndex
+    def controller_action_logical_id
+      controller, action = @route.to.split('#')
+      "#{controller}_controller_#{action}".camelize.gsub('::','')
+    end
+
+    def controller
+      controller, action = @route.to.split('#')
+      "#{controller}_controller".camelize
+    end
+  end
+end

data/lib/jets/cfn/template_mappers/gateway_resource_mapper.rb

@@ -0,0 +1,62 @@
+class Jets::Cfn::TemplateMappers
+  class GatewayResourceMapper
+    def initialize(path)
+      @path = path # Examples: "posts/:id/edit" or "posts"
+    end
+
+    # Returns: "ApiGatewayResourcePostsController"
+    def logical_id
+      homepage = @path == ''
+      if homepage
+        "RootResourceId"
+      else
+        "#{path_logical_id(@path)}ApiGatewayResource"
+      end
+    end
+
+    def cors_logical_id
+      "#{path_logical_id(@path)}CorsApiGatewayResource"
+    end
+
+    # Modify the path to conform to API Gateway capture expressions
+    def path
+      @path.split('/').map {|s| transform_capture(s) }.join('/')
+    end
+
+    def desc
+      path.empty? ? 'Homepage route: /' : "Route for: /#{path}"
+    end
+
+    def transform_capture(text)
+      if text.starts_with?(':')
+        text = text.sub(':','')
+        text = "{#{text}}" # :foo => {foo}
+      end
+      if text.starts_with?('*')
+        text = text.sub('*','')
+        text = "{#{text}+}" # *foo => {foo+}
+      end
+      text
+    end
+
+    def parent_id
+      if @path.include?('/') # posts/:id or posts/:id/edit
+        parent_path = @path.split('/')[0..-2].join('/')
+        parent_logical_id = path_logical_id(parent_path)
+        "!Ref #{parent_logical_id}ApiGatewayResource"
+      else
+        "!GetAtt RestApi.RootResourceId"
+      end
+    end
+
+    def path_part
+      last_part = path.split('/').last
+      last_part.split('/').map {|s| transform_capture(s) }.join('/')
+    end
+
+  private
+    def path_logical_id(path)
+      path.gsub('/','_').gsub(':','').gsub('*','').camelize
+    end
+  end
+end

data/lib/jets/cfn/template_mappers/job_mapper.rb

@@ -0,0 +1,4 @@
+class Jets::Cfn::TemplateMappers
+  class JobMapper < ChildMapper
+  end
+end

data/lib/jets/cfn/template_mappers/lambda_function_mapper.rb

@@ -0,0 +1,50 @@
+class Jets::Cfn::TemplateMappers
+  class LambdaFunctionMapper
+    def initialize(task)
+      @task = task
+      @app_class = task.class_name.to_s
+      # @app_class examples: PostsController, HardJob, Hello, HelloFunction
+    end
+
+    # Example: SleepJobPerformLambdaFunction
+    def logical_id
+      "#{class_action}LambdaFunction".gsub('::','')
+    end
+
+    def environment
+      env = Jets.config.environment ? Jets.config.environment.to_h : {}
+      env.deep_merge(JETS_ENV: Jets.env.to_s)
+    end
+
+    # Example: PostsControllerIndex or SleepJobPerform
+    def class_action
+      "#{@app_class}_#{@task.meth}".camelize
+    end
+
+    # Examples:
+    #   "#{Jets.config.project_namespace}-sleep_job-perform"
+    #   "demo-dev-sleep_job-perform"
+    def function_name
+      # Example values:
+      #   @app_class: admin/pages_controller
+      #   @task.meth: index
+      method = @app_class.underscore
+      # method: admin/pages_controller
+      method = method.sub('/','-') + "-#{@task.meth}"
+      # method: admin-pages_controller-index
+      "#{Jets.config.project_namespace}-#{method}"
+    end
+
+    def handler
+      handler_value(@task.meth)
+    end
+
+    def handler_value(meth)
+      "handlers/#{@task.type.pluralize}/#{@app_class.underscore}.#{meth}"
+    end
+
+    def code_s3_key
+      Jets::Naming.code_s3_key
+    end
+  end
+end

data/lib/jets/cfn/template_mappers/rule_mapper.rb

@@ -0,0 +1,5 @@
+# Used in the parent_builder.rb to build Lambda functions
+class Jets::Cfn::TemplateMappers
+  class RuleMapper < ChildMapper
+  end
+end

data/lib/jets/cli.rb

@@ -1,23 +1,188 @@
 require "thor"
-require "jets/cli/help"
 
-module Jets
+class Jets::CLI
+  def self.start(given_args=ARGV)
+    new(given_args).start
+  end
+
+  def self.thor_tasks
+    Jets::Commands::Base.namespaced_commands
+  end
 
-  class CLI < Command
-    class_option :verbose, type: :boolean
-    class_option :noop, type: :boolean
+  def initialize(given_args=ARGV, **config)
+    @given_args = given_args.dup
+    @config = config
+  end
 
-    desc "build", "Builds and prepares project for Lambda"
-    long_desc Help.build
-    option :force, type: :boolean, aliases: "-f", desc: "override existing starter files"
-    option :quiet, type: :boolean, aliases: "-q", desc: "silence the output"
-    option :format, type: :string, default: "yaml", desc: "starter project template format: json or yaml"
-    def build
-      Jets::Build.new(options).run
+  def start
+    command_class = lookup(full_command)
+    if command_class
+      boot_jets
+      command_class.perform(full_command, thor_args)
+    elsif version_requested?
+      puts Jets.version
+    else
+      main_help
     end
+  end
 
-    desc "process TYPE", "process subcommand tasks"
-    long_desc Help.process
-    subcommand "process", Jets::Process
+  def version_requested?
+    #   jets --version
+    #   jets -v
+    version_flags = ["--version", "-v"]
+    @given_args.length == 1 && !(@given_args & version_flags).empty?
   end
+
+  # The commands new and help do not call Jets.boot. Main reason is that
+  # Jets.boot are ran inside a Jets project folder.
+  #
+  # * jets new - need to generate a project outside a project folder.
+  # * jets help - don't need to be in a project folder general help.
+  #   When you are inside a project folder though, more help commands
+  #   are available and displayed.
+  #
+  def boot_jets
+    command = thor_args.first
+    if !%w[new help].include?(command)
+      set_jets_env_for_deploy_command!
+      Jets.boot
+    end
+  end
+
+  # Adjust JETS_ENV before boot_jets is called for the jets deploy
+  # command.  Must do this early in the process before Jets.boot because
+  # Jets.boot calls Jets.env as part of the bootup process in
+  # require_bundle_gems and sets the Jets.env to whatever the JETS_ENV is
+  # at the time.
+  #
+  # Defaults to development when not set.
+  def set_jets_env_for_deploy_command!
+    command, env = thor_args[0..1]
+    return unless command == "deploy"
+    env = nil if env&.starts_with?('-')
+    ENV['JETS_ENV'] = env ? env : 'development'
+  end
+
+  # thor_args normalized the args Array to work with our Thor command
+  # subclasses.
+  # 1. The namespace is stripe
+  # 2. Help is shifted in front if a help flag is detected
+  def thor_args
+    args = @given_args.clone
+
+    help_args = args & help_flags
+    unless help_args.empty?
+      # Allow using help flags at the end of the command to trigger help menu
+      args -= help_flags # remove "help" and help flags from args
+      args[0] = meth # first command will always be the meth now since
+        # we removed the help flags
+      args.unshift("help")
+      args.compact!
+      return args
+    end
+
+    # reassigns the command without the namespace if reached here
+    args[0] = meth
+    args.compact
+  end
+
+  ALIASES = {
+    "g"  => "generate",
+    "c"  => "console",
+    "s"  => "server",
+    "db" => "dbconsole",
+  }
+  def full_command
+    # Removes any args that starts with -, those are option args.
+    # Also remove "help" flag.
+    args = @given_args.reject {|o| o =~ /^-/ } - help_flags
+    command = args[0] # first argument should always be the command
+    command = ALIASES[command] || command
+    Jets::Commands::Base.autocomplete(command)
+  end
+
+  # 1. look up Thor tasks
+  # 2. look up Rake tasks
+  # 3. help menu with all commands when both Thor and Rake tasks are not found
+  def lookup(full_command)
+    thor_task_found = Jets::Commands::Base.namespaced_commands.include?(full_command)
+    if thor_task_found
+      return Jets::Commands::Base.klass_from_namespace(namespace)
+    end
+
+    rake_task_found = Jets::Commands::RakeCommand.namespaced_commands.include?(full_command)
+    if rake_task_found
+      return Jets::Commands::RakeCommand
+    end
+  end
+
+  # ["-h", "-?", "--help", "-D", "help"]
+  def help_flags
+    Thor::HELP_MAPPINGS + ["help"]
+  end
+
+  def namespace
+    return nil unless full_command
+
+    if full_command.include?(':')
+      words = full_command.split(':')
+      words.pop
+      words.join(':')
+    end
+  end
+
+  def meth
+    return nil unless full_command
+
+    if full_command.include?(':')
+      full_command.split(':').pop
+    else
+      full_command
+    end
+  end
+
+  def main_help
+    shell = Thor::Shell::Basic.new
+    shell.say "Commands:"
+    shell.print_table(thor_list, :indent => 2, :truncate => true)
+
+    unless rake_list.empty?
+      shell.say "\nCommands via rake:"
+      shell.print_table(rake_list, :indent => 2, :truncate => true)
+    end
+
+    shell.say "\n"
+    shell.say main_help_body
+  end
+
+  def thor_list
+    Jets::Commands::Base.help_list(show_all_tasks)
+  end
+
+  def rake_list
+    list = Jets::Commands::RakeCommand.formatted_rake_tasks(show_all_tasks)
+    list.map do |array|
+      array[0] = "jets #{array[0]}"
+      array
+    end
+  end
+
+  def show_all_tasks
+    @given_args.include?("--all") || @given_args.include?("-A")
+  end
+
+  def main_help_body
+    <<-EOL
+Add -h to any of the commands for more help.  Examples:
+
+  jets call -h
+  jets routes -h
+  jets deploy -h
+  jets status -h
+  jets dynamodb:create -h
+  jets db:create -h
+
+EOL
+  end
+
 end

data/lib/jets/commands.rb

@@ -0,0 +1,22 @@
+module Jets::Commands
+  autoload :Help, "jets/commands/help"
+  autoload :Base, "jets/commands/base"
+  autoload :Build, "jets/commands/build"
+  autoload :Deploy, "jets/commands/deploy"
+  autoload :Delete, "jets/commands/delete"
+  autoload :New, "jets/commands/new"
+  autoload :Call, "jets/commands/call"
+  autoload :Console, "jets/commands/console"
+  autoload :Db, "jets/commands/db"
+  autoload :Dynamodb, "jets/commands/dynamodb"
+  autoload :Main, "jets/commands/main"
+  autoload :Process, "jets/commands/process"
+  autoload :RakeCommand, "jets/commands/rake_command"
+  autoload :RakeTasks, 'jets/commands/rake_tasks'
+  autoload :WebpackerTemplate, 'jets/commands/webpacker_template'
+  autoload :Sequence, "jets/commands/sequence"
+  autoload :StackInfo, "jets/commands/stack_info"
+  autoload :Dbconsole, "jets/commands/dbconsole"
+  autoload :Url, "jets/commands/url"
+  autoload :Markdown, "jets/commands/markdown"
+end