marionette_rails_generators 0.1.2

data/lib/generators/marionette/install/templates/base/controllers/_base_controller.js.coffee

@@ -0,0 +1,42 @@
+@Backbone.app.module "Controllers", (Controllers, App, Backbone, Marionette, $, _) ->
+
+  class Controllers.Application extends Marionette.Controller
+
+    constructor: (options = {}) ->
+      @region = options.region or App.request "default:region"
+      super options
+      @_instance_id = _.uniqueId("controller")
+      App.request "register:instance", @, @_instance_id
+
+    close: ->
+      console.log 'closing', @
+      App.request "unregister:instance", @, @_instance_id
+      super
+
+    show: (view, options = {}) ->
+      _.defaults options,
+        loading: false
+        region: @region
+        preventDestroy: false
+
+      @setMainView view
+      callback = onShowAllView
+      @_manageView view, options, callback
+
+    setMainView: (view) ->
+
+      # the first view we show is always going to become the mainView of our
+      # controller (whether its a layout or another view type). So if this
+      # *is* a layout, when we show other tegions inside of that layout, we
+      # check for the existance of a naminView first, so our controller is only
+      # closed down when the original mainView is closed.
+
+      return if @_mainView
+      @_mainView = view
+      @listenTo view, "close", @close
+
+    _manageView: (view, options, callback) ->
+      if options.loading
+        App.request "show:loading", view, options, callback
+      else
+        options.region.show view, options

data/lib/generators/marionette/install/templates/base/models/_base_collection.js.coffee

@@ -0,0 +1,3 @@
+@Backbone.app.module "Entities", (Entities, App, Backbone, Marionette, $, _) ->
+
+  class Entities.Collection extends Backbone.Collection

data/lib/generators/marionette/install/templates/base/models/_base_model.js.coffee

@@ -0,0 +1,40 @@
+@Backbone.app.module "Entities", (Entities, App, Backbone, Marionette, $, _) ->
+
+  class Entities.Model extends Backbone.Model
+
+    destroy: (options = {}) ->
+      _.defaults options,
+        wait: true
+
+      @set _destroy: true
+      super options
+
+    isDestroyed: ->
+      @get "_destroy"
+
+    save: (data, options = {}) ->
+      isNew = @isNew()
+
+      _.defaults options,
+        wait: true
+        success:   _.bind(@saveSuccess, @, isNew, options.collection)
+        error:    _.bind(@saveError, @)
+
+      @unset "_errors"
+      super data, options
+
+    saveSuccess: (isNew, collection) =>
+      if isNew
+        collection?.add @
+        collection?.trigger "model:created", @
+        @trigger "created", @
+      else
+        collection ?= @collection
+        ## if model has collection property defined,
+        ## use that if no collection option exists
+        collection?.trigger "model:updated", @
+        @trigger "updated", @
+
+    saveError: (model, xhr, options) =>
+      unless xhr.status is 500 or xhr.status is 404
+        @set _errors: $.parseJSON(xhr.responseText)?.errors

data/lib/generators/marionette/install/templates/base/views/_view.js.coffee

@@ -0,0 +1,56 @@
+@Backbone.app.module "Views", (Views, App, Backbone, Marionette, $, _) ->
+
+  _remove = Marionette.View::remove
+
+  _.extend Marionette.View::,
+
+    addOpacityWrapper: (init = true) ->
+      @$el.toggleWrapper
+        className: "opacity"
+      , init
+
+    setInstancePropertiesFor: (args...) ->
+      for key, val of _.pick(@options, args...)
+        @[key] = val
+
+    remove: (args...) ->
+      console.log "removing", @ if App.environment == 'development'
+      if @model?.isDestroyed?()
+
+        wrapper = @$el.toggleWrapper
+          className: "opacity"
+        # backgroundColor: "#FFECEC"
+
+        wrapper.fadeOut 100, ->
+          $(@).remove()
+
+        @$el.fadeOut 100, =>
+          _remove.apply @, args
+      else
+        _remove.apply @, args
+
+    templateHelpers: ->
+
+      linkTo: (name, url, options = {}) ->
+        _.defaults options,
+          external: false
+
+        url = "#" + url unless options.external
+
+        "<a href='#{url}'>#{@escape(name)}</a>"
+
+
+      render_partial: ( path, options = {} ) ->
+        # add the leading underscore (like rails-partials)
+        path = path.split('/')
+        path[ path.length - 1 ] = '_' + path[ path.length - 1 ]
+        path = path.join('/')
+        # render and return the partial if existing
+        try
+          JST["backbone/app/templates/#{ path }"]( options )
+        catch error
+          if App.environment != 'production'
+            "<p class='error'>Sorry, there is no partial named '#{ path }'.</p>"
+          else
+            console.log('error in _view')
+            ''

data/lib/generators/marionette/install/templates/base/views/collectionview.js.coffee

@@ -0,0 +1,4 @@
+@Backbone.app.module "Views", (Views, App, Backbone, Marionette, $, _) ->
+
+  class Views.CollectionView extends Marionette.CollectionView
+    childViewEventPrefix: "childview"

data/lib/generators/marionette/install/templates/base/views/compositeview.js.coffee

@@ -0,0 +1,4 @@
+@Backbone.app.module "Views", (Views, App, Backbone, Marionette, $, _) ->
+
+  class Views.CompositeView extends Marionette.CompositeView
+    childViewEventPrefix: "childview"

data/lib/generators/marionette/install/templates/base/views/itemview.js.coffee

@@ -0,0 +1,3 @@
+@Backbone.app.module "Views", (Views, App, Backbone, Marionette, $, _) ->
+
+  class Views.ItemView extends Marionette.ItemView

data/lib/generators/marionette/install/templates/base/views/layout.js.coffee

@@ -0,0 +1,3 @@
+@Backbone.app.module "Views", (Views, App, Backbone, Marionette, $, _) ->
+
+  class Views.Layout extends Marionette.LayoutView

data/lib/generators/marionette/install/templates/before_backbone.js.coffee

@@ -0,0 +1,2 @@
+@onShowAllView = ->
+  false

data/lib/generators/marionette/install/templates/config/config.js.coffee

@@ -0,0 +1,72 @@
+do (Backbone) ->
+
+  _.extend Backbone.Marionette.Application::,
+
+    navigate: (route, options = { trigger: true }) ->
+      # route = "#" + route if route.charAt(0) is "/"
+      Backbone.history.navigate route, options
+
+    getCurrentRoute: ->
+      frag = Backbone.history.fragment
+      if _.isEmpty(frag) then null else frag
+
+    startHistory: ->
+      if Backbone.history
+        Backbone.history.start(
+          pushState: true,
+          root: "/"
+        )
+
+do (Marionette) ->
+  _.extend Marionette.Renderer,
+
+    lookups: ["backbone/app/templates/", "backbone/lib/components/"]
+
+
+
+    render: (template, data) ->
+      return if template is false
+      path = @getTemplate(template)
+      throw "Template #{template} not found!" unless path
+      path(data)
+
+    getTemplate: (template) ->
+      for lookup in @lookups
+        ## inserts the template at the '-1' position of the template array
+        ## this allows to omit the word 'templates' from the view but still
+        ## store the templates in a directory outside of the view
+        ## example: "users/list/layout" will become "users/list/templates/layout"
+        for path in [template, @withTemplate(template)]
+          return JST[lookup + path] if JST[lookup + path]
+
+    withTemplate: (string) ->
+      array = string.split("/")
+      array.splice(-1, 0, "templates")
+      array.join("/")
+
+do ($) ->
+  $.fn.toggleWrapper = (obj = {}, init = true) ->
+    _.defaults obj,
+      className: ""
+      backgroundColor: if @css("backgroundColor") isnt "transparent" then @css("backgroundColor") else "white"
+      zIndex: if @css("zIndex") is "auto" or 0 then 1000 else (Number) @css("zIndex")
+
+    $offset = @offset()
+    $width   = @outerWidth(false)
+    $height = @outerHeight(false)
+
+    if init
+      $("<div>")
+        .appendTo("body")
+          .addClass(obj.className)
+            .attr("data-wrapper", true)
+              .css
+                width: $width
+                height: $height
+                top: $offset.top
+                left: $offset.left
+                position: "absolute"
+                zIndex: obj.zIndex + 1
+                backgroundColor: obj.backgroundColor
+    else
+      $("[data-wrapper]").remove()

data/lib/generators/marionette/install/templates/config/controllers/loading/loading_controller.js.coffee

@@ -0,0 +1,55 @@
+@Backbone.app.module "Utilites.Loading", (Loading, App, Backbone, Marionette, $, _) ->
+
+  class Loading.LoadingController extends App.Controllers.Application
+
+    initialize: (options) ->
+      { view, config } = options
+
+      config = if _.isBoolean(config) then {} else config
+
+      _.defaults config,
+        loadingType: 'spinner'
+        entities: @getEntities(view)
+        debug: false
+
+      switch config.loadingType
+        when 'opacity'
+          @region.currentView.$el.css '-moz-transition',  'opacity 1s ease-in-out' if @region.hasView()
+          @region.currentView.$el.css '-ms-transition',  'opacity 1s ease-in-out' if @region.hasView()
+          @region.currentView.$el.css '-o-transition',  'opacity 1s ease-in-out' if @region.hasView()
+          @region.currentView.$el.css '-webkit-transition', 'opacity 1s ease-in-out' if @region.hasView()
+          @region.currentView.$el.css 'opacity', 0 if @region.hasView()
+        when 'spinner'
+          loadingView = @getLoadingView()
+          @show loadingView
+        else
+          throw new Error("Invalid loadingType")
+
+      @showRealView view, loadingView, config, options.callback
+
+    showRealView: (realView, loadingView, config, callback) ->
+      unless callback
+        callback = ->
+          return false
+      App.request 'when:fetched', config.entities, =>
+        switch config.loadingType
+          when "opacity"
+            @region.currentView.$el.removeAttr "style" if @region.hasView()
+          when "spinner"
+            return realView.close() if @region.currentView isnt loadingView
+        callback()
+
+        @show realView unless config.debug
+
+    getEntities: (view) ->
+      _.chain(view).pick('model', 'collection').toArray().compact().value()
+
+    getLoadingView: ->
+      new Loading.LoadingView
+
+  App.reqres.setHandler 'show:loading', (view, options, callback) ->
+    new Loading.LoadingController
+      view: view
+      region: options.region
+      config: options.loading
+      callback: callback

data/lib/generators/marionette/install/templates/config/controllers/loading/loading_view.js.coffee

@@ -0,0 +1,30 @@
+@Backbone.app.module "Utilites.Loading", (Loading, App, Backbone, Marionette, $, _) ->
+
+  class Loading.LoadingView extends App.Views.ItemView
+    template: false
+    className: 'loading-container'
+
+    onShow: ->
+      opts = @_getOptions()
+      @$el.spin opts
+
+    onClose: ->
+      @$el.spin false
+
+    _getOptions: ->
+      lines:      10         # The number of lines to draw
+      length:     6          # The length of each line
+      width:      2.5        # The line thickness
+      radius:     7          # The radius of the inner circle
+      corners:    1          # Corner roundness (0..1)
+      rotate:     9          # The rotation offset
+      direction:  1          # 1: clockwise, -1: counterclockwise
+      color:      '#000'     # #rgb or #rrggbb or array of colors
+      speed:      1          # Rounds per second
+      trail:      60         # Afterglow percentage
+      shadow:     false      # Whether to render a shadow
+      hwaccel:    true       # Whether to use hardware acceleration
+      className:  'spinner'  # The CSS class to assign to the spinner
+      zIndex:     2e9        # The z-index (defaults to 2000000000)
+      top:        'auto'     # Top position relative to parent in px
+      left:       'auto'     # Left position relative to parent in px

data/lib/generators/marionette/install/templates/config/models/fetch.js.coffee

@@ -0,0 +1,11 @@
+@Backbone.app.module "Entities", (Entities, App, Backbone, Marionette, $, _) ->
+  App.reqres.setHandler "when:fetched", (entities, callback) ->
+    xhrs = _.chain([entities]).flatten().pluck("_fetch").value()
+
+    # if _.isArray(entities)
+    #   xhrs.push(entity._fetch) for entity in entities
+    # else
+    #   xhrs.push(entities._fetch)
+
+    $.when(xhrs...).done ->
+      callback()

data/lib/generators/marionette/install/templates/config/models/sync.js.coffee

@@ -0,0 +1,19 @@
+do (Backbone) ->
+  _sync = Backbone.sync
+
+  Backbone.sync = (method, entity, options = {}) ->
+
+    _.defaults options,
+      beforeSend: _.bind(methods.beforeSend, entity)
+      complete:  _.bind(methods.complete, entity)
+
+    sync = _sync(method, entity, options)
+    if !entity._fetch and method is "read"
+      entity._fetch = sync
+
+  methods =
+    beforeSend: ->
+      @trigger "sync:start", @
+
+    complete: ->
+      @trigger "sync:stop", @

data/lib/generators/marionette/install/templates/index.html.erb

@@ -0,0 +1,9 @@
+<div id="main-region"></div>
+
+<%%= javascript_tag do %>
+  $(function() {
+    Backbone.app.start({
+      environment: '<%%= ::Rails.env %>'
+    });
+  });
+<%% end %>

data/lib/generators/marionette/install/templates/routes.js.coffee

@@ -0,0 +1,13 @@
+@Backbone.app.module "Router", (Router, App, Backbone, Marionette, $, _) ->
+
+  class Router extends Marionette.AppRouter
+    appRoutes:
+      "(/)": "root"
+
+  API =
+    root: ->
+      console.log 'Hello world!'
+
+  App.addInitializer ->
+    Backbone.app.router = new Router
+      controller: API

data/lib/generators/marionette/model/model_generator.rb

@@ -0,0 +1,42 @@
+require 'generators/marionette/resource_helpers'
+
+# :nodoc:
+class Marionette::ModelGenerator < Rails::Generators::Base
+  include Marionette::ResourceHelpers
+  desc %(Description:
+    Stubs out a new model - Entity class and EntityCollection class.
+    Pass the model name, either CamelCased or
+    under_scored, and an optional list of attribute pairs as arguments.
+
+    Optional list of attribute pairs can be represented as
+    javascript object with 'schema' method.
+
+    Attribute pairs are field:type arguments specifying the
+    model's attributes.
+
+    Example:
+      rails g marionette:entity post title:string description:text
+        generates entity 'Backbone.app.Entities.All.Post'
+      rails g marionette:entity blogs/post
+        generates entity 'Backbone.app.Entities.Blogs.Post'
+  )
+
+  source_root File.expand_path('../templates', __FILE__)
+
+  argument :title, type: :string, required: true, banner: 'Entity'
+  argument :schema, type: :hash, default: {}, banner: 'title:string description:text'
+
+  def vars
+    @module = 'All'
+    if @title =~ /\//
+      parse = @title.match /(.*)\/(.*)/
+      @title = parse[2]
+      @module = parse[1]
+    end
+  end
+
+  def generate_entity
+    template 'app/models/entity.js.coffee',
+             "#{backbone_path}/app/models/#{ @module.underscore }/#{ @title.underscore }.js.coffee"
+  end
+end

data/lib/generators/marionette/model/templates/app/models/entity.js.coffee

@@ -0,0 +1,14 @@
+@Backbone.app.module "Entities.<%= @module.split('/').map{ |v| v.camelcase }.join('.') %>", (<%= @module.split('/').map{ |v| v.camelcase }.last.to_s %>, App, Backbone, Marionette, $, _) ->
+
+  class <%= @module.split('/').map{ |v| v.camelcase }.last.to_s %>.<%= @title.camelcase %> extends App.Entities.Model
+    urlRoot: -> '/api/<%= @title.underscore.pluralize %>'
+    schema:
+      {
+      <%- @schema.each_with_index do |val, i| -%>
+        <%= val[0] %>: '<%= val[1] %>'<%= (i == @schema.size - 1) ? '' : ',' %>
+      <%- end -%>
+      }
+
+  class <%= @module.split('/').map{ |v| v.camelcase }.last.to_s %>.<%= @title.camelcase %>Collection extends App.Entities.Collection
+    model: <%= @module.split('/').map{ |v| v.camelcase }.last.to_s %>.<%= @title.camelcase %>
+    url: -> '/api/<%= @title.underscore.pluralize %>'