Merge pull request #251 from marcoroth/refactor_generators

Refactor and improve generators

Author: pascalwengerter

docs/tooling/generators/matestack_app_generator.md

@@ -13,15 +13,15 @@ Generates matestack apps to `app/matestack/apps`.
 ## Example 1
 
 ```bash
-rails generate matestack_app example_app
+rails generate matestack:app example_app
 ```
 
 Creates an ExampleApp in `app/matestack/apps/example_app.rb`.
 
 ## Example 2
 
 ```bash
-rails generate matestack_app simple_app --all_inclusive
+rails generate matestack:app simple_app --all_inclusive
 ```
 
 Creates:
@@ -32,5 +32,5 @@ Creates:
 
 To see all options, run
 ```bash
-rails generate matestack_app -h
+rails generate matestack:app -h
 ```

docs/tooling/generators/matestack_component_generator.md

@@ -17,12 +17,12 @@ Generates matestack components to `app/matestack/components`.
 ## Example
 
 ```bash
-rails generate matestack_component simple_component
+rails generate matestack:component simple_component
 ```
 
 Creates a SimpleComponent in `app/matestack/components/simple_component.rb`.
 
 To see all options, run
 ```bash
-rails generate matestack_component -h
+rails generate matestack:component -h
 ```

docs/tooling/generators/matestack_page_generator.md

@@ -17,7 +17,7 @@ Generates matestack pages to `app/matestack/pages`.
 ## Example 1
 
 ```bash
-rails generate matestack_page simple_page --app_name example_app
+rails generate matestack:page simple_page --app_name example_app
 ```
 
 Creates a SimplePage in `app/matestack/pages/example_app/simple_page.rb`.
@@ -33,7 +33,7 @@ in the terminal to use in your controller.
 ## Example 2
 
 ```bash
-rails generate matestack_page second_page --app_name example_app --namespace sample_namespace
+rails generate matestack:page second_page --app_name example_app --namespace sample_namespace
 ```
 
 Creates a SimplePage in `app/matestack/pages/example_app/sample_namespace/second_page.rb`.
@@ -48,5 +48,5 @@ in the terminal to use in your, e.g., `example_app_controller.rb`.
 
 To see all options, run
 ```bash
-rails generate matestack_page -h
+rails generate matestack:page -h
 ```

lib/generators/matestack/app/USAGE

@@ -0,0 +1,21 @@
+Description:
+  Stubs out a new matestack app. Pass the app name under_scored.
+
+  If you want so, pass the option '--all_inclusive' to also create
+  a corresponding matestack example_page, a controller, its action
+  and the route in 'config/routes.rb'.
+
+Example 1:
+  `rails generate matestack:app example_app`
+
+  This will create:
+    app/matestack/apps/example_app.rb
+
+Example 2:
+  `rails generate matestack:app example_app --all_inclusive`
+
+  This will create:
+    app/matestack/apps/example_app.rb
+    app/matestack/pages/example_app/example_page.rb
+    app/controllers/example_app_controller.rb
+    route  get 'example_app/example_page', to: 'example_app#example_page'

lib/generators/matestack/app/app_generator.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Matestack
+  module Generators
+    class AppGenerator < Rails::Generators::NamedBase
+      source_root File.expand_path('templates', __dir__)
+
+      class_option :all_inclusive, type: :boolean, default: false
+
+      def create_app
+        template 'app/matestack/apps/%file_name%.rb.tt'
+
+        if options[:all_inclusive] == true
+          template 'app/controllers/%file_name%_controller.rb'
+
+          route %{get '#{file_name}/example_page', to: '#{file_name}\#example_page'}
+
+          generate "matestack:page example_page --app_name #{file_name} --called_by_app_generator=true"
+
+          puts "You can visit your new matestack apps' example page under http://localhost:3000/#{file_name}/example_page"
+        end
+      end
+    end
+  end
+end

lib/generators/matestack_app/templates/matestack_app_controller.erb renamed to lib/generators/matestack/app/templates/app/controllers/%file_name%_controller.rb.tt

@@ -1,7 +1,5 @@
 class <%= class_name %>Controller < ApplicationController
-
   def example_page
     responder_for(Pages::<%= class_name %>::ExamplePage)
   end
-
 end

lib/generators/matestack_app/templates/matestack_app.erb renamed to lib/generators/matestack/app/templates/app/matestack/apps/%file_name%.rb.tt

@@ -1,5 +1,4 @@
 class Apps::<%= class_name %> < Matestack::Ui::App
-
   # OPTIONAL: Prepare data that gets used on every page of this app
   # def prepare
   #   API calls and db queries go here
@@ -26,5 +25,4 @@ class Apps::<%= class_name %> < Matestack::Ui::App
   #     # your components go here
   #   }
   # end
-
 end

lib/generators/matestack/component/USAGE

@@ -0,0 +1,20 @@
+Description:
+  Stubs out a new matestack component. Pass the component name, under_scored.
+
+  To create a dynamic component, specify it using the --dynamic option.
+
+  To place this component within a namespace, specify the namespace name under_scored and it
+  will get generated into 'app/matestack/components/namespace/*'.
+
+Example 1:
+  `rails generate matestack:component NAME`
+
+  This will create:
+    app/matestack/components/NAME.rb
+
+Example 2:
+  `rails generate matestack:component NAME --dynamic --namespace sample_namespace`
+
+  This will create:
+    app/matestack/components/sample_namespace/NAME.rb
+    app/matestack/components/sample_namespace/NAME.js

lib/generators/matestack/component/component_generator.rb

@@ -0,0 +1,29 @@
+module Matestack
+  module Generators
+    class ComponentGenerator < Rails::Generators::NamedBase
+      source_root File.expand_path('templates', __dir__)
+
+      class_option :dynamic, type: :boolean, default: false
+      class_option :scss, type: :boolean, default: false
+      class_option :haml, type: :boolean, default: false
+      class_option :namespace, type: :string
+
+      def namespace
+        options[:namespace]
+      end
+
+      def dynamic
+        options[:dynamic]
+      end
+
+      def create_component
+        # Future: Check for matestack-compatible namespacing!
+
+        template 'app/matestack/components/%namespace%/%file_name%.rb.tt'
+        template 'app/matestack/components/%namespace%/%file_name%.js.tt' if options[:dynamic]
+        template 'app/matestack/components/%namespace%/%file_name%.scss.tt' if options[:scss]
+        template 'app/matestack/components/%namespace%/%file_name%.haml.tt' if options[:haml]
+      end
+    end
+  end
+end