hanami 1.0.0 → 1.1.0.beta1

data/lib/hanami/cli/commands/generate/action/action.erb

@@ -0,0 +1,8 @@
+module <%= app.classify %>::Controllers::<%= controller.classify %>
+  class <%= action.classify %>
+    include <%= app.classify %>::Action
+
+    def call(params)
+    end
+  end
+end

data/lib/hanami/cli/commands/generate/action/action_spec.minitest.erb

@@ -0,0 +1,11 @@
+require_relative '../../../spec_helper'
+
+describe <%= app.classify %>::Controllers::<%= controller.classify %>::<%= action.classify %> do
+  let(:action) { <%= app.classify %>::Controllers::<%= controller.classify %>::<%= action.classify %>.new }
+  let(:params) { Hash[] }
+
+  it 'is successful' do
+    response = action.call(params)
+    response[0].must_equal 200
+  end
+end

data/lib/hanami/{generators/action/action_spec.rspec.tt → cli/commands/generate/action/action_spec.rspec.erb}

@@ -1,6 +1,4 @@
-require_relative '<%= config[:relative_action_path] %>'
-
-RSpec.describe <%= config[:app] %>::Controllers::<%= config[:controller] %>::<%= config[:action] %> do
+RSpec.describe <%= app.classify %>::Controllers::<%= controller.classify %>::<%= action.classify %> do
   let(:action) { described_class.new }
   let(:params) { Hash[] }
 

data/lib/hanami/cli/commands/generate/action/action_without_view.erb

@@ -0,0 +1,9 @@
+module <%= app.classify %>::Controllers::<%= controller.classify %>
+  class <%= action.classify %>
+    include <%= app.classify %>::Action
+
+    def call(params)
+      self.body = 'OK'
+    end
+  end
+end

data/lib/hanami/cli/commands/generate/action/view.erb

@@ -0,0 +1,5 @@
+module <%= app.classify %>::Views::<%= controller.classify %>
+  class <%= action.classify %>
+    include <%= app.classify %>::View
+  end
+end

data/lib/hanami/cli/commands/generate/action/view_spec.minitest.erb

@@ -0,0 +1,15 @@
+require_relative '../../../spec_helper'
+
+describe <%= app.classify %>::Views::<%= controller.classify %>::<%= action.classify %> do
+  let(:exposures) { Hash[foo: 'bar'] }
+  let(:template)  { Hanami::View::Template.new('<%= template %>') }
+  let(:view)      { <%= app.classify %>::Views::<%= controller.classify %>::<%= action.classify %>.new(template, exposures) }
+  let(:rendered)  { view.render }
+
+  it 'exposes #foo' do
+    skip 'This is an auto-generated test. Edit it and add your own tests.'
+
+    # Example
+    view.foo.must_equal exposures.fetch(:foo)
+  end
+end

data/lib/hanami/{generators/action/view_spec.rspec.tt → cli/commands/generate/action/view_spec.rspec.erb}

@@ -1,8 +1,6 @@
-require_relative '<%= config[:relative_view_path] %>'
-
-RSpec.describe <%= config[:app] %>::Views::<%= config[:controller] %>::<%= config[:action] %> do
+RSpec.describe <%= app.classify %>::Views::<%= controller.classify %>::<%= action.classify %> do
   let(:exposures) { Hash[foo: 'bar'] }
-  let(:template)  { Hanami::View::Template.new('<%= config[:template_path] %>') }
+  let(:template)  { Hanami::View::Template.new('<%= template %>') }
   let(:view)      { described_class.new(template, exposures) }
   let(:rendered)  { view.render }
 

data/lib/hanami/cli/commands/generate/app.rb

@@ -0,0 +1,231 @@
+module Hanami
+  class CLI
+    module Commands
+      module Generate
+        # @since 1.1.0
+        # @api private
+        class App < Command # rubocop:disable Metrics/ClassLength
+          requires "environment"
+
+          desc "Generate an app"
+
+          argument :app, required: true, desc: "The application name (eg. `web`)"
+          option :application_base_url, desc: "The app base URL (eg. `/api/v1`)"
+
+          example [
+            "admin                              # Generate `admin` app",
+            "api --application-base-url=/api/v1 # Generate `api` app and mount at `/api/v1`"
+          ]
+
+          # @since 1.1.0
+          # @api private
+          #
+          # rubocop:disable Metrics/AbcSize
+          # rubocop:disable Metrics/MethodLength
+          def call(app:, application_base_url: nil, **options)
+            app      = Utils::String.underscore(app)
+            template = options.fetch(:template)
+            base_url = application_base_url || "/#{app}"
+            context  = Context.new(app: app, base_url: base_url, test: options.fetch(:test), template: template, options: options)
+
+            assert_valid_base_url!(context)
+
+            generate_app(context)
+            generate_routes(context)
+            generate_layout(context)
+            generate_template(context)
+            generate_favicon(context)
+
+            create_controllers_directory(context)
+            create_assets_images_directory(context)
+            create_assets_javascripts_directory(context)
+            create_assets_stylesheets_directory(context)
+
+            create_spec_features_directory(context)
+            create_spec_controllers_directory(context)
+            generate_layout_spec(context)
+
+            inject_require_app(context)
+            inject_mount_app(context)
+
+            append_development_http_session_secret(context)
+            append_test_http_session_secret(context)
+          end
+          # rubocop:enable Metrics/MethodLength
+          # rubocop:enable Metrics/AbcSize
+
+          private
+
+          # @since 1.1.0
+          # @api private
+          def assert_valid_base_url!(context)
+            if Utils::Blank.blank?(context.base_url) # rubocop:disable Style/GuardClause
+              warn "`' is not a valid URL"
+              exit(1)
+            end
+          end
+
+          # @since 1.1.0
+          # @api private
+          def generate_app(context)
+            source      = templates.find("application.erb")
+            destination = project.app_application(context)
+
+            generate_file(source, destination, context)
+            say(:create, destination)
+          end
+
+          # @since 1.1.0
+          # @api private
+          def generate_routes(context)
+            source      = templates.find("routes.erb")
+            destination = project.app_routes(context)
+
+            generate_file(source, destination, context)
+            say(:create, destination)
+          end
+
+          # @since 1.1.0
+          # @api private
+          def generate_layout(context)
+            source      = templates.find("layout.erb")
+            destination = project.app_layout(context)
+
+            generate_file(source, destination, context)
+            say(:create, destination)
+          end
+
+          # @since 1.1.0
+          # @api private
+          def generate_template(context)
+            source      = templates.find("template.#{context.template}.erb")
+            destination = project.app_template(context)
+
+            generate_file(source, destination, context)
+            say(:create, destination)
+          end
+
+          # @since 1.1.0
+          # @api private
+          def generate_favicon(context)
+            source      = templates.find("favicon.ico")
+            destination = project.app_favicon(context)
+
+            files.cp(source, destination)
+            say(:create, destination)
+          end
+
+          # @since 1.1.0
+          # @api private
+          def create_controllers_directory(context)
+            source      = templates.find("gitkeep.erb")
+            destination = project.keep(project.controllers(context))
+
+            generate_file(source, destination, context)
+            say(:create, destination)
+          end
+
+          # @since 1.1.0
+          # @api private
+          def create_assets_images_directory(context)
+            source      = templates.find("gitkeep.erb")
+            destination = project.keep(project.images(context))
+
+            generate_file(source, destination, context)
+            say(:create, destination)
+          end
+
+          # @since 1.1.0
+          # @api private
+          def create_assets_javascripts_directory(context)
+            source      = templates.find("gitkeep.erb")
+            destination = project.keep(project.javascripts(context))
+
+            generate_file(source, destination, context)
+            say(:create, destination)
+          end
+
+          # @since 1.1.0
+          # @api private
+          def create_assets_stylesheets_directory(context)
+            source      = templates.find("gitkeep.erb")
+            destination = project.keep(project.stylesheets(context))
+
+            generate_file(source, destination, context)
+            say(:create, destination)
+          end
+
+          # @since 1.1.0
+          # @api private
+          def create_spec_features_directory(context)
+            source      = templates.find("gitkeep.erb")
+            destination = project.keep(project.features_spec(context))
+
+            generate_file(source, destination, context)
+            say(:create, destination)
+          end
+
+          # @since 1.1.0
+          # @api private
+          def create_spec_controllers_directory(context)
+            source      = templates.find("gitkeep.erb")
+            destination = project.keep(project.controllers_spec(context))
+
+            generate_file(source, destination, context)
+            say(:create, destination)
+          end
+
+          # @since 1.1.0
+          # @api private
+          def generate_layout_spec(context)
+            source      = templates.find("layout_spec.#{context.options.fetch(:test)}.erb")
+            destination = project.app_layout_spec(context)
+
+            generate_file(source, destination, context)
+            say(:create, destination)
+          end
+
+          # @since 1.1.0
+          # @api private
+          def inject_require_app(context)
+            content     = "require_relative '../apps/#{context.app}/application'"
+            destination = project.environment(context)
+
+            files.inject_line_after(destination, /require_relative '\.\.\/lib\/.*'/, content)
+            say(:insert, destination)
+          end
+
+          # @since 1.1.0
+          # @api private
+          def inject_mount_app(context)
+            content     = "  mount #{context.app.classify}::Application, at: '#{context.base_url}'"
+            destination = project.environment(context)
+
+            files.inject_line_after(destination, /Hanami.configure do/, content)
+            say(:insert, destination)
+          end
+
+          # @since 1.1.0
+          # @api private
+          def append_development_http_session_secret(context)
+            content     = %(#{context.app.upcase}_SESSIONS_SECRET="#{project.app_sessions_secret}")
+            destination = project.env(context, "development")
+
+            files.append(destination, content)
+            say(:append, destination)
+          end
+
+          # @since 1.1.0
+          # @api private
+          def append_test_http_session_secret(context)
+            content     = %(#{context.app.upcase}_SESSIONS_SECRET="#{project.app_sessions_secret}")
+            destination = project.env(context, "test")
+
+            files.append(destination, content)
+            say(:append, destination)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/hanami/{generators/app/application.rb.tt → cli/commands/generate/app/application.erb}

@@ -1,7 +1,7 @@
 require 'hanami/helpers'
 require 'hanami/assets'
 
-module <%= config[:classified_app_name] %>
+module <%= app.classify %>
   class Application < Hanami::Application
     configure do
       ##
@@ -81,7 +81,7 @@ module <%= config[:classified_app_name] %>
       #
       # See: http://www.rubydoc.info/gems/rack/Rack/Session/Cookie
       #
-      # sessions :cookie, secret: ENV['<%= config[:upcase_app_name] %>_SESSIONS_SECRET']
+      # sessions :cookie, secret: ENV['<%= app.upcase %>_SESSIONS_SECRET']
 
       # Configure Rack middleware for this application
       #
@@ -116,7 +116,7 @@ module <%= config[:classified_app_name] %>
 
       # The layout to be used by all views
       #
-      layout :application # It will load <%= config[:classified_app_name] %>::Views::ApplicationLayout
+      layout :application # It will load <%= app.classify %>::Views::ApplicationLayout
 
       # The relative path to templates
       #
@@ -254,7 +254,7 @@ module <%= config[:classified_app_name] %>
       # FRAMEWORKS
       #
 
-      # Configure the code that will yield each time <%= config[:classified_app_name] %>::Action is included
+      # Configure the code that will yield each time <%= app.classify %>::Action is included
       # This is useful for sharing common functionality
       #
       # See: http://www.rubydoc.info/gems/hanami-controller#Configuration
@@ -263,13 +263,13 @@ module <%= config[:classified_app_name] %>
         # before :authenticate!    # run an authentication before callback
       end
 
-      # Configure the code that will yield each time <%= config[:classified_app_name] %>::View is included
+      # Configure the code that will yield each time <%= app.classify %>::View is included
       # This is useful for sharing common functionality
       #
       # See: http://www.rubydoc.info/gems/hanami-view#Configuration
       view.prepare do
         include Hanami::Helpers
-        include <%= config[:classified_app_name] %>::Assets::Helpers
+        include <%= app.classify %>::Assets::Helpers
       end
     end
 

data/lib/hanami/cli/commands/generate/app/layout.erb

@@ -0,0 +1,7 @@
+module <%= app.classify %>
+  module Views
+    class ApplicationLayout
+      include <%= app.classify %>::Layout
+    end
+  end
+end

data/lib/hanami/cli/commands/generate/app/layout_spec.minitest.erb

@@ -0,0 +1,11 @@
+require "spec_helper"
+
+describe <%= app.classify %>::Views::ApplicationLayout do
+  let(:layout)   { <%= app.classify %>::Views::ApplicationLayout.new(template, {}) }
+  let(:rendered) { layout.render }
+  let(:template) { Hanami::View::Template.new('apps/<%= app %>/templates/application.html.<%= template %>') }
+
+  it 'contains application name' do
+    rendered.must_include('<%= app.classify %>')
+  end
+end

data/lib/hanami/cli/commands/generate/app/layout_spec.rspec.erb

@@ -0,0 +1,11 @@
+require "spec_helper"
+
+RSpec.describe <%= app.classify %>::Views::ApplicationLayout do
+  let(:layout)   { <%= app.classify %>::Views::ApplicationLayout.new(template, {}) }
+  let(:rendered) { layout.render }
+  let(:template) { Hanami::View::Template.new('apps/<%= app %>/templates/application.html.<%= template %>') }
+
+  it 'contains application name' do
+    expect(rendered).to include('<%= app.classify %>')
+  end
+end

data/lib/hanami/{generators/app/templates/application.html.erb.tt → cli/commands/generate/app/template.erb.erb}

@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html>
   <head>
-    <title><%= config[:classified_app_name] %></title>
+    <title><%= app.classify %></title>
     <%%= favicon %>
   </head>
   <body>

data/lib/hanami/{generators/app/templates/application.html.haml.tt → cli/commands/generate/app/template.haml.erb}

@@ -1,7 +1,7 @@
 !!!
 %html
   %head
-    %title <%= config[:classified_app_name] %>
+    %title <%= app.classify %>
     = favicon
   %body
     = yield

data/lib/hanami/{generators/app/templates/application.html.slim.tt → cli/commands/generate/app/template.slim.erb}

@@ -2,7 +2,7 @@ doctype html
 html
   head
     title
-      | <%= config[:classified_app_name] %>
+      | <%= app.classify %>
     = favicon
   body
     = yield

data/lib/hanami/cli/commands/generate/mailer.rb

@@ -0,0 +1,94 @@
+module Hanami
+  class CLI
+    module Commands
+      module Generate
+        # @since 1.1.0
+        # @api private
+        class Mailer < Command
+          requires "environment"
+
+          desc "Generate a mailer"
+
+          argument :mailer, required: true, desc: "The mailer name (eg. `welcome`)"
+
+          option :from,    desc: "The default `from` field of the mail"
+          option :to,      desc: "The default `to` field of the mail"
+          option :subject, desc: "The mail subject"
+
+          example [
+            "welcome                                         # Basic usage",
+            'welcome --from="noreply@example.com"            # Generate with default `from` value',
+            'announcement --to="users@example.com"           # Generate with default `to` value',
+            'forgot_password --subject="Your password reset" # Generate with default `subject`'
+          ]
+
+          # @since 1.1.0
+          # @api private
+          def call(mailer:, **options)
+            from    = options.fetch(:from,    DEFAULT_FROM)
+            to      = options.fetch(:to,      DEFAULT_TO)
+            subject = options.fetch(:subject, DEFAULT_SUBJECT)
+            context = Context.new(mailer: mailer, test: options.fetch(:test), from: from, to: to, subject: subject, options: options)
+
+            generate_mailer(context)
+            generate_mailer_spec(context)
+            generate_text_template(context)
+            generate_html_template(context)
+          end
+
+          private
+
+          # @since 1.1.0
+          # @api private
+          DEFAULT_FROM = "'<from>'".freeze
+
+          # @since 1.1.0
+          # @api private
+          DEFAULT_TO = "'<to>'".freeze
+
+          # @since 1.1.0
+          # @api private
+          DEFAULT_SUBJECT = "'Hello'".freeze
+
+          # @since 1.1.0
+          # @api private
+          def generate_mailer(context)
+            source      = templates.find("mailer.erb")
+            destination = project.mailer(context)
+
+            generate_file(source, destination, context)
+            say(:create, destination)
+          end
+
+          # @since 1.1.0
+          # @api private
+          def generate_mailer_spec(context)
+            source      = templates.find("mailer_spec.#{context.test}.erb")
+            destination = project.mailer_spec(context)
+
+            generate_file(source, destination, context)
+            say(:create, destination)
+          end
+
+          # @since 1.1.0
+          # @api private
+          def generate_text_template(context)
+            destination = project.mailer_template(context, "txt")
+
+            files.touch(destination)
+            say(:create, destination)
+          end
+
+          # @since 1.1.0
+          # @api private
+          def generate_html_template(context)
+            destination = project.mailer_template(context, "html")
+
+            files.touch(destination)
+            say(:create, destination)
+          end
+        end
+      end
+    end
+  end
+end