rang 0.1.1

data/lib/rails/generators/rang/assets/init/templates/_base.scss

@@ -0,0 +1,11 @@
+/*        BASE STYLES
+*******************************/
+
+/* In this directory you should set up your basic and reusable document styles.
+
+Here are some starters:
+
+* _typography.scss
+* _layout.scss
+* _forms.scss
+* _mixins.scss */

data/lib/rails/generators/rang/assets/init/templates/application.js

@@ -0,0 +1,14 @@
+//= require angular
+//= require angular-route
+//= require angular-templates
+
+// You should require module manifests from this file, e.g. require posts/posts
+// Those manifests should specify their own dependencies.
+
+angular.module('<%= Rang::Util.application_name %>', ['ngRoute'])
+  .config(function($routeProvider) {
+    $routeProvider.otherwise({
+      redirectTo: '/'
+    });
+  })
+  .run(AngularTemplates.load);

data/lib/rails/generators/rang/assets/init/templates/application.scss

@@ -0,0 +1,3 @@
+/* @todo: Make this more specific according to your app. */
+@import 'style/*';
+@import '**/*';

data/lib/rails/generators/rang/assets/init/templates/components.js

@@ -0,0 +1,2 @@
+// Your reusable components should go in subdirectories here.
+// Usually this means standalone directives.

data/lib/rails/generators/rang/bower/add/add_generator.rb

@@ -0,0 +1,48 @@
+module Rang
+  module Bower
+    module Generators
+      class AddGenerator < Rails::Generators::Base
+        argument :dependency_name, type: :string
+        argument :version_string, type: :string, default: ''
+        desc "Adds a dependency to Gemfile.bower."
+
+        def run_init
+          generate "rang:bower:init" unless File.exist? 'Gemfile.bower'
+        end
+
+        def add_gem_to_bower_gemfile
+          append_file "Gemfile.bower", "gem '#{gem_package}'" +
+            (", '#{version_string}'" unless version_string.empty?).to_s +
+            "\n"
+          bundle! if run_bundler?
+        end
+
+        def notify_add
+          unless args.include? 'quiet'
+            say("Don't forget to add #{bower_package} to application.js!", :cyan)
+          end
+        end
+
+        private
+
+        def gem_package
+          "rails-assets-#{bower_package}"
+        end
+
+        def bower_package
+          dependency_name.delete('@')
+        end
+
+        def bundle!
+          Bundler.with_clean_env do
+            run "bundle install"
+          end
+        end
+
+        def run_bundler?
+          dependency_name.ends_with? '@'
+        end
+      end
+    end
+  end
+end

data/lib/rails/generators/rang/bower/bower_generator.rb

@@ -0,0 +1,28 @@
+module Rang
+  module Bower
+    module Generators
+      class InitGenerator < Rails::Generators::Base
+        desc "Creates an auxilliary Gemfile for bower assets."
+
+        def create_bower_gemfile
+          create_file "Gemfile.bower", "source 'https://rails-assets.org'\n"
+        end
+
+        def include_bower_gemfile_into_gemfile
+          append_file "Gemfile", "\n"+
+            "# Include bower.json for assets via https://rails-assets.org/.\n"+
+            "eval(IO.read('Gemfile.bower'), binding)\n"
+        end
+      end
+
+      class AddGenerator < Rails::Generators::NamedBase
+        argument :dependency_name, type: :string
+        desc "Adds a dependency to Gemfile.bower."
+
+        def add_gem_to_bower_gemfile
+          append_file
+        end
+      end
+    end
+  end
+end

data/lib/rails/generators/rang/bower/init/init_generator.rb

@@ -0,0 +1,35 @@
+module Rang
+  module Bower
+    module Generators
+      class InitGenerator < Rails::Generators::Base
+        desc "Creates an auxilliary Gemfile for bower assets."
+
+        def create_bower_gemfile
+          create_file "Gemfile.bower", "" +
+          "source 'https://rails-assets.org'\n"
+        end
+
+        def include_bower_gemfile_into_gemfile
+          inject_into_file "Gemfile", after: /source.*$/ do
+            "\n\n# Include Gemfile.bower for assets via https://rails-assets.org/.\n" +
+            "eval(IO.read('Gemfile.bower'), binding) if File.exist? 'Gemfile.bower'"
+          end
+        end
+
+        def add_angular_gems
+          generate "rang:bower:add", "angular '~> 1.2.0' quiet"
+          generate "rang:bower:add", "angular-route '~> 1.2.0' quiet"
+          bundle!
+        end
+
+        private
+
+        def bundle!
+          Bundler.with_clean_env do
+            run "bundle install"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rails/generators/rang/example/example_generator.rb

@@ -0,0 +1,17 @@
+module Rang
+  module Generators
+    class ExampleGenerator < Rails::Generators::Base
+      desc "Copies example assets to frontend."
+      source_root File.expand_path("../templates", __FILE__)
+
+      def clobber_assets
+        remove_dir 'app/assets/frontend'
+      end
+
+      def copy_example
+        directory 'frontend', 'app/assets/frontend/'
+      end
+
+    end
+  end
+end

data/lib/rails/generators/rang/example/templates/frontend/application.js.tt

@@ -0,0 +1,21 @@
+//= require angular
+//= require angular-restmod/angular-restmod-bundle
+//= require angular-route
+//= require angular-templates
+
+//= require components/simple_format/simple_format.module
+//= require posts/posts.module
+
+// You should require module manifests from this file, e.g. require posts/posts
+// Those manifests should specify their own dependencies.
+
+angular.module('<%= Rang::Util.application_name %>', [
+  'ngRoute',
+  '<%= Rang::Util.application_name %>.posts',
+  'shared.simpleFormat'
+  ]).config(function($routeProvider) {
+    $routeProvider.otherwise({
+      redirectTo: '/posts'
+    });
+  })
+  .run(AngularTemplates.load);

data/lib/rails/generators/rang/example/templates/frontend/application.scss

@@ -0,0 +1,6 @@
+/* Don't do this */
+@import "//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css";
+
+/* @todo: Make this more specific according to your app. */
+@import 'style/*';
+@import '**/*';

data/lib/rails/generators/rang/example/templates/frontend/components/components.js

@@ -0,0 +1,2 @@
+// Your reusable components should go in subdirectories here.
+// Usually this means standalone directives.

data/lib/rails/generators/rang/example/templates/frontend/components/simple_format/simple_format.directive.js

@@ -0,0 +1,12 @@
+angular.module('shared.simpleFormat').directive('simpleFormat', function(){
+  return {
+    replace: true,
+    scope: {
+      simpleFormat: '='
+    },
+    controller: function($scope) {
+      $scope.paragraphs = $scope.simpleFormat.split("\n\n")
+    },
+    template: '<p ng-repeat="paragraph in paragraphs">{{paragraph}}</p>'
+  }
+})

data/lib/rails/generators/rang/example/templates/frontend/components/simple_format/simple_format.module.js

@@ -0,0 +1,4 @@
+//= require_self
+//= require ./simple_format.directive
+
+angular.module('shared.simpleFormat', [])

data/lib/rails/generators/rang/example/templates/frontend/posts/index.ctrl.js.tt

@@ -0,0 +1,6 @@
+angular.module('<%= Rang::Util.application_name %>.posts').controller('PostsIndexCtrl', function($scope, PostsService) {
+  'use strict';
+
+  $scope.posts = PostsService.posts
+
+})

data/lib/rails/generators/rang/example/templates/frontend/posts/index.ctrl.spec.js.tt

@@ -0,0 +1,12 @@
+describe('PostsIndexCtrl', function(){
+
+  beforeEach(module('<%= Rang::Util.application_name %>.posts'));
+
+  it('it should provide posts on scope', inject(function($controller) {
+    var scope = {},
+        ctrl = $controller('PostsIndexCtrl', {$scope:scope});
+
+    expect(scope.posts.length).toBe(2);
+  }));
+
+});

data/lib/rails/generators/rang/example/templates/frontend/posts/index.slim.tt

@@ -0,0 +1,14 @@
+.container
+  .row
+    .col-md-8.col-md-offset-2
+      .jumbotron
+        h1 <%= Rang::Util.application_name %> Blog
+        p This is a fake blog to demonstrate <a href="http://github.com/cultivatehq/rang">Rang</a>
+
+      .post ng-repeat="post in posts"
+        h2 {{post.title}}
+        .media
+          .pull-left ng-if="post.image"
+            img.media-object ng-src="{{post.image}}"
+          .media-body
+            div simple-format="post.body"

data/lib/rails/generators/rang/example/templates/frontend/posts/posts.module.js.tt

@@ -0,0 +1,12 @@
+//= require_self
+//= require ./posts.service
+//= require ./index.ctrl
+
+angular.module('<%= Rang::Util.application_name %>.posts', ['ngRoute'])
+  .config(function($routeProvider) {
+    $routeProvider
+      .when('/posts', {
+        controller: 'PostsIndexCtrl',
+        templateUrl: '/assets/posts/index.html'
+      })
+  })

data/lib/rails/generators/rang/example/templates/frontend/posts/posts.scss

@@ -0,0 +1,3 @@
+.post{
+  margin: 48px 0;
+}

data/lib/rails/generators/rang/example/templates/frontend/posts/posts.service.js.tt

@@ -0,0 +1,44 @@
+// The text in this file is taken from Wikipedia and licensed under the CC BY-SA
+// http://en.wikipedia.org/wiki/Wikipedia:Text_of_Creative_Commons_Attribution-ShareAlike_3.0_Unported_License
+
+angular.module('<%= Rang::Util.application_name %>.posts').service('PostsService', function() {
+
+  var posts = [
+    {
+      title: 'Oleg Popov',
+      body: 'Oleg Konstantinovich Popov (Russian: Олег Константинович Попо́в, ' +
+            'born 31 July 1930) is a famous Soviet and Russian clown and circus ' +
+            'artist. Popov is also called the "Sunshine clown".\n\n' +
+            'He was born on 31 July 1930 in Moscow, the son of a clock-maker. ' +
+            'He studied elements of acrobatics, juggling, and other circus ' +
+            'skills in his youth. In 1949, he graduated from the Russian circus ' +
+            'school in Moscow and started his career in the Moscow Circus on ' +
+            'Tsvetnoy Boulevard. Six years later, he became the first clown from ' +
+            'the Union of Soviet Socialist Republics to perform in the Western ' +
+            'world. In 1969, he was honored with the title of People\'s Artist ' +
+            'of the USSR. Popov\'s fame extended to Melbourne, Australia, where ' +
+            'he was named King of Moomba (1971).'
+    },
+
+    {
+      title: 'Grock',
+      image: 'http://upload.wikimedia.org/wikipedia/commons/thumb/4/4a/Grock_1903.jpg/108px-Grock_1903.jpg',
+      body: 'Grock (January 10, 1880 – July 14, 1959), born Charles Adrien ' +
+            'Wettach, was a Swiss clown, composer and musician. Called "the ' +
+            'king of clowns" and "the greatest of Europe\'s clowns", Grock was ' +
+            'once the most highly paid entertainer in the world.\n\n' +
+            'Grock was born in Loveresse, a village in the Bernese Jura in the C' +
+            'anton of Bern. He started early as a performer, learning musiciansh' +
+            'ip and acrobatic skills from his father. When a caravan of Roma ' +
+            'passed through, he joined them, learning more instruments and gaini' +
+            'ng confidence with them. In 1894, he debuted with Fiame Wetzel\'s t' +
+            'raveling circus. He become a clown, working first with Brick in ' +
+            '1903, adopting the name "Grock", and then the famous clown Antonet ' +
+            '(Umberto Guillaum).'
+    }
+  ]
+
+  return {
+    posts: posts
+  }
+})

data/lib/rails/generators/rang/example/templates/frontend/style/_base.scss

@@ -0,0 +1,11 @@
+/*        BASE STYLES
+*******************************/
+
+/* In this directory you should set up your basic and reusable document styles.
+
+Here are some starters:
+
+* _typography.scss
+* _layout.scss
+* _forms.scss
+* _mixins.scss */

data/lib/rails/generators/rang/example/templates/frontend/style/_layout.scss

@@ -0,0 +1,3 @@
+body {
+  padding: 24px;
+}

data/lib/rails/generators/rang/install/install_generator.rb

@@ -0,0 +1,66 @@
+module Rang
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      desc "Installs Rang."
+      source_root File.expand_path("../templates", __FILE__)
+
+      def init
+        @can_add_examples = true
+      end
+
+      def install_initializer
+        template "rang.rb", "config/initializers/rang.rb"
+      end
+
+      def install_bower
+        if !no? "\n\nSet up Gemfile.bower for frontend assets? [Yn]", :cyan
+          generate "rang:bower:init"
+        else
+          @can_add_examples = false
+        end
+      end
+
+      def restructure_assets
+        if !no? "\n\nRestructure assets/ to follow Angular recommended structure? [Yn]", :cyan
+          generate "rang:assets:init"
+        else
+          @can_add_examples = false
+        end
+      end
+
+      def configure_api
+        if !no? "\n\nConfigure default API interface with active_model_serializers and angular-restmod? [Yn]", :cyan
+          generate "rang:api:configure"
+        end
+      end
+
+      def install_teaspoon
+        if !no? "\n\nInstall & configure Teaspoon for Angular/Jasmine tests? [Yn]", :cyan
+          generate "rang:teaspoon:install"
+        end
+      end
+
+      def add_root_route
+        if !no? "\n\nAdd default root route pointing to an ng-view tag? [Yn]", :cyan
+          generate "rang:add_root"
+        else
+          @can_add_examples = false
+        end
+      end
+
+      def add_example_assets
+        if @can_add_examples && yes?("\n\nAdd example assets to demonstrate usage? [yN]", :cyan)
+          generate "rang:example"
+        end
+      end
+
+      def usage
+        say "\n\n      ******      \n\n"
+        say "Rang is now set-up.\n\n", :green
+        say "Use `rails g rang:bower:add package '~> 0.1'` to install bower packages.", :cyan
+        say "See README for full docs: https://github.com/CultivateHQ/rang/blob/master/README.md\n\n"
+      end
+
+    end
+  end
+end

data/lib/rails/generators/rang/install/templates/rang.rb

@@ -0,0 +1,25 @@
+Rang.configure do |config|
+
+  # This does some admittedly ugly patching to allow you to address your
+  # templates with the more intuitive extension '.html' rather than '.htm'.
+  #
+  # If you prefer, you can disable this and ensure your asset filenames follow
+  # the format `file.html.slim` — you'll still need to refer to them using
+  # `file.html` in your ng-routes.
+  config.patch_sprockets_to_use_html_extension = true
+
+  # This disables individual precompilation of HTML files in assets/.
+  # By default Rang injects them into $templateCache instead.
+  config.disable_html_precompilation = true
+
+  # Name of folder within app/assets to use for collected assets.
+  config.frontend_assets_directory = 'frontend'
+
+  # Disable { and } as Slim delimiters. This means you won't get tripped up when
+  # you use them in Angular, e.g.
+  #     p {{post.title}}
+  # But you can't do this:
+  #     a{href="#"}
+  config.remove_angular_delims_from_slim = true
+
+end

data/lib/rails/generators/rang/teaspoon/install/install_generator.rb

@@ -0,0 +1,75 @@
+module Rang
+  module Teaspoon
+    module Generators
+      class InstallGenerator < Rails::Generators::Base
+        desc "Installs teaspoon with sensible defaults for Angular."
+
+        def add_teaspoon_to_gemfile
+          gem_group :development, :test do
+            gem "teaspoon", "~> 0.8.0"
+            gem "phantomjs", "~> 1.9.0"
+          end
+        end
+
+        def add_angular_mocks_to_gemfile
+          generate "rang:bower:add", "angular-mocks '~> 1.2.0' quiet"
+        end
+
+        def bundle_install
+          bundle!
+        end
+
+        def teaspoon_install
+          generate "teaspoon:install"
+        end
+
+        def add_teaspoon_assets_hack
+          inject_into_file "spec/teaspoon_env.rb", before: "Teaspoon.configure do |config|" do
+            "# Fix for https://github.com/modeset/teaspoon/issues/197\n" +
+            "Rails.application.config.assets.debug = false\n\n"
+          end
+        end
+
+        def add_matcher
+          inject_into_file "spec/teaspoon_env.rb", after: /#suite\.matcher =.*$/ do
+            "\n    suite.matcher = \"{spec/javascripts,app/assets}/**/*[_.]spec.{js,js.coffee,coffee}\"\n"
+          end
+        end
+
+        def require_angular_mocks
+          inject_into_file "spec/javascripts/spec_helper.js", before: /\/\/= require application/ do
+            "//= require angular\n" +
+            "//= require angular-mocks\n"
+          end
+        end
+
+        def inform_of_actions
+          say "\n\n      ******      \n\n"
+          say "\nTeaspoon is installed, you can run `teaspoon` or visit `/teaspoon` to run tests.", :green
+          say "Jasmine & angular-mocks are included.\n\n", :green
+          say "You can put your specs alongside your JS like this:\n\n", :cyan
+          say "    |-- posts/\n" +
+              "    |   |-- posts_controller.js\n" +
+              "    |   |-- posts_controller.spec.js\n\n"
+          say "Or inside spec/javascripts, as you prefer.", :cyan
+        end
+
+        def inform_about_better_errors
+          if Util.gem_present? 'better_errors'
+            say "\nNote: the better_errors gem prevents ruby exceptions being " +
+                "reported when running `teaspoon`.", :cyan
+            say "See: https://github.com/modeset/teaspoon/issues/120\n\n"
+          end
+        end
+
+        private
+
+        def bundle!
+          Bundler.with_clean_env do
+            run "bundle install"
+          end
+        end
+      end
+    end
+  end
+end