lanes 0.1.2 → 0.1.5

data/client/lanes/workspace/styles/tabs.scss

@@ -0,0 +1,147 @@
+.active-screens .nav    a {
+    background-color: $gray-dark;
+}
+
+.header-top {
+
+    
+    .menu-container {
+        position:absolute;
+        left: 0;
+        position: absolute;
+        overflow-x: visible;
+        overflow-y: auto;
+        border: 0;
+        top: 5px;
+        transition: all 0.15s ease-in-out 0s;
+        overflow-x: visible;
+        overflow-y: auto;
+        left: 200px;
+        right: 35px;
+    }
+
+    /* &.with-screen-menu { */
+    /*   .menu-container { */
+    /*     left: 0px; */
+    /*   } */
+    /* } */
+
+
+    .active-screens {
+        display: inline-block;
+    }
+
+    .menu-container {
+        .active-screens {
+            width: 100%;
+            .wrapper{
+                position:relative;
+                margin:0 auto;
+                overflow:hidden;
+                padding:5px;
+                height:45px;
+
+            }
+            .nav {
+                position:absolute;
+                left:0px;
+                top: 1px;
+                min-width:3000px;
+                /* margin-left:12px; */
+                margin-top:0px;
+
+                li {
+                    display:table-cell;
+                    position:relative;
+                    text-align:center;
+                    cursor:grab;
+                    cursor:-webkit-grab;
+                    color:#efefef;
+                    vertical-align:middle;
+                }
+            }
+
+            .scroller {
+                text-align:center;
+                cursor:pointer;
+                visibility: hidden;
+                padding:7px;
+                padding-top:11px;
+                white-space:no-wrap;
+                vertical-align:middle;
+                color: $link-color;
+                &:hover{
+                    color: $link-hover-color;
+                }
+                &.enabled {
+                    visibility: visible;
+                }
+            }
+            
+            .scroller-right{
+                float:right;
+                &:before {
+                    @extend .font-icon-display;
+                    @extend .icon-arrow-right:before;
+                }
+            }
+
+            .scroller-left {
+                float:left;
+                &:before {
+                    @extend .font-icon-display;
+                    @extend .icon-arrow-left:before;
+                }
+            }
+        }
+    }
+
+
+    &.screen-menu-hidden {
+        .menu-container {
+            max-height: 45px;
+            overflow: hidden;
+        }
+        .screens-menu {
+            
+        }
+    }
+
+    &.screen-menu-visible {
+        .menu-container {
+            top: 50px;
+            left: 0px;
+            right: 0px;
+            /* bottom: unset; */
+            max-height: 300px;
+        }
+        .active-screens {
+            display: none;
+        }
+    }
+
+    .active-screens {
+        
+        height: 45px;
+        padding: 0 5px;
+
+        .nav-tabs {
+            border-bottom: 0;
+            position: absolute;
+            bottom: 0px;
+        }
+
+        .close {
+            position: absolute;
+            right: 7px;
+            top: 0px;    
+        }
+
+        /* a { */
+        /*   white-space: nowrap; */
+        /* } */
+
+    }
+
+
+}

data/client/lanes/workspace/styles/toolbar.scss

@@ -0,0 +1,4 @@
+.navbar-header {
+  @include clearfix;
+  float: left;
+}

data/client/lanes/workspace/styles.scss

@@ -0,0 +1,20 @@
+@import "lanes/styles/bootstrap";
+@import "lanes/styles/fonts";
+// extensions are rooted at .lanes
+&{
+  padding: 0px;
+  margin: 0px;
+  background-color: $body-bg;
+  position: relative;
+  min-height: 10px; // needs height for resizing sensor to function
+}
+
+@import "styles/layout";
+@import "styles/header";
+@import "styles/tabs";
+@import "styles/screens";
+@import "styles/toolbar";
+@import "styles/forms";
+@import "styles/changes-notification";
+@import "styles/keybindings";
+

data/docs/model.md

@@ -1,10 +1,10 @@
 ---
 title: Model
-heading: Lanes.Data.Model
+heading: Lanes.Models.Base
 position_after: view
 ---
 
-Lanes provides a Lanes.Data.Model class that all other models extend from.
+Lanes provides a Lanes.Models.Base class that all other models extend from.
 
 A Model is an extension of [Ampersand State](http://ampersandjs.com/docs#ampersand-state), and supports all the features that AmpersandState does.
 
@@ -22,6 +22,38 @@ Model methods that make requests to the server can specify options to control wh
 
 ### API Reference
 
+# @where
+
+Load models from server that match the query. Returns [Collection](#@query)
+
+``` coffee
+class Person extends Lanes.Models.Base
+    props:
+        id: 'integer'
+        name: 'string'
+
+
+collection = Person.where( last_name: "smith" )
+````
+
+
+# @Collection
+
+A collection definition is provided for each model.
+
+Read more about [Request Options](#request-options)
+
+``` coffee
+class Person extends Lanes.Models.Base
+    props:
+        id: 'integer'
+        name: 'string'
+
+
+collection = Person.Collection.fetch(query:{ name: "John" }, limit: 10, with: [ 'address','photo' ] )
+````
+
+
 # initialize
 
 `new Model({options})`
@@ -35,7 +67,7 @@ If a collection reference is provided to initalize, it will be copied onto the m
 Fetches and instantiates a record.  Is useful for when you all you know is the record's ID.  The identity map is consulted, and if the record is present there the existing copy is returned.
 
 ``` coffee
-class Balance extends Lanes.Data.Model
+class Balance extends Lanes.Models.Base
     props:
         id: 'integer'
         amount: 'bigdec'
@@ -59,7 +91,7 @@ Saves record state to server.  If options.saveAll is true, then the entire data
 Save also saves it's associations along with itself.
 
 ``` coffee
-class Car extends Lanes.Data.Model
+class Car extends Lanes.Models.Base
     associations:
         driver: { model: Person }
     props:
@@ -85,7 +117,7 @@ Sets field and values.  Marks the fields as unsaved and the record as "dirty".
 returns the field and values that have been modified and the unsavedData from associations as well.
 
 ``` coffee
-class Car extends Lanes.Data.Model
+class Car extends Lanes.Models.Base
     associations:
         driver: { model: Person }
     props:
@@ -113,7 +145,7 @@ Returns a string with an appropriate error message for setting the field to valu
 
 If the change is considered valid, an empty string is returned.
 
-The default implementation only checks the 'required' status of the field.  Models inheriting from `Lanes.Data.Model` may provide an alternative implementation.
+The default implementation only checks the 'required' status of the field.  Models inheriting from `Lanes.Models.Base` may provide an alternative implementation.
 
 # withAssociations(list...)
 
@@ -153,7 +185,7 @@ end
 It can be queried by the client:
 
 ``` coffee
-class Invoice extends Lanes.Data.Model
+class Invoice extends Lanes.Models.Base
     props:
         id: 'integer'
         total: 'bigdec'

data/docs/todo-example-part-1.md

@@ -15,7 +15,7 @@ lanes new todo
 
 This will create a new directory with a skeleton Lanes application.  Read more about the directories and what their purposes are at {% doc_link command heading:'lanes new' %}.
 
-[Our example app at this point](https://github.com/argosity/lanes-todo-demo/tree/2d649b314a826cbbdbf54e3f72041caeeee8e428)
+[Our example app at this point](https://github.com/argosity/lanes-todo-demo/tree/a0909c52d63d3c8e577bdb4338c91ba74e4b1dfa)
 
 # Setup
 
@@ -25,24 +25,24 @@ Fire up the lanes testing server: `lanes serve`.  The test server will start the
 
 We'll copy the styles from the [TodoMVC template](https://github.com/tastejs/todomvc/tree/master/template).
 
-Looking at the Todo app, it has four distinct areas. A `sidebar`, `header`, `footer` and `listing` views. We can create views for them by executing `lanes generate view <name>`, where '< name >' is the view to create. [commit](https://github.com/argosity/lanes-todo-demo/commit/758d0e63359db18ee0291467656454c9fc1c3573)
+Looking at the Todo app, it has four distinct areas. A `sidebar`, `header`, `footer` and `listing` views. We can create views for them by executing `lanes generate view <name>`, where '< name >' is the view to create. [commit](https://github.com/argosity/lanes-todo-demo/commit/6d34c981637f75a182bf708290a146fdc72c77f2)
 
-First we take the TodoMVC html template and break it apart into sections and copy them to each view.  We're then able to plug each view's reference into the Screen as subviews. [commit](https://github.com/argosity/lanes-todo-demo/commit/8c5178a76f2a8abc0ffadbafb1239f7a8ba113b9)
+First we take the TodoMVC html template and break it apart into sections and copy them to each view.  We're then able to plug each view's reference into the Screen as subviews. [commit](https://github.com/argosity/lanes-todo-demo/commit/33d3d56b7a03e403276e894cc9233d4d2aa353e8)
 
-Next we'll create a data model `lanes generate model task title:string{80} completed:boolean` [commit](https://github.com/argosity/lanes-todo-demo/commit/5080c286aa4fb35a2b8372cc86ca4e9e18a18c3f)
+Next we'll create a data model `lanes generate model task title:string{80} completed:boolean` [commit](https://github.com/argosity/lanes-todo-demo/commit/c157f43fbf13a431e9ea08c67d65026c1b96e6dd)
 
-Since a task should default to being non-completed, we'll edit the migration to default that field to `false` and add a validation to the model [commit](https://github.com/argosity/lanes-todo-demo/commit/e3f7edf9f2863f0669cccac13f7f8e2b88276b5a)
+Since a task should default to being non-completed, we'll edit the migration to default that field to `false` and add a validation to the model [commit](https://github.com/argosity/lanes-todo-demo/commit/6ab50c30eee4b11a4406eacc53b1f5e63de76b45)
 
 Run migration: `lanes db migrate`
 
-We'll also create a TaskSummary model that is in charge of summarizing the state of the tasks.  It will listen to the tasks collection and perform calculations when events occur. [commit](https://github.com/argosity/lanes-todo-demo/commit/65da191ee749ab749855e06ce69c3bd09662e0d5)
+We'll also create a TaskSummary model that is in charge of summarizing the state of the tasks.  It will listen to the tasks collection and perform calculations when events occur. [commit](https://github.com/argosity/lanes-todo-demo/commit/c3372a0d76b5aafb4921b98c10f91d34c86ab86f)
 
 # Data and events
 
 ## Header View
 It's responsible for interaction with the "What needs to be done?" input.  When text is present and the "enter" key is pressed, it should save a record and add it to the collection.  We're able to do so in [just a few lines of code](https://github.com/argosity/lanes-todo-demo/blob/master/client/todo/views/Header.coffee#L22-L25)
 
-We can easily test that it performs as it should by [adding a few specs](https://github.com/argosity/lanes-todo-demo/blob/master/spec/todo/views/HeaderSpec.coffee#L18-L29). 
+We can easily test that it performs as it should by [adding a few specs](https://github.com/argosity/lanes-todo-demo/blob/master/spec/todo/views/HeaderSpec.coffee). 
 
 ## Listing View
 This view is a bit more complex.  It has a parent view which handles toggling all todo's between being complete and pending, and a collection of subviews that model each individual task. [ListingView](https://github.com/argosity/lanes-todo-demo/blob/master/client/todo/views/Listing.coffee)

data/docs/view.md

@@ -56,8 +56,7 @@ All views have a single DOM element.  If a view does is not provided an el when
 
 # template
 
-Either an string or a function that returns a string.  The string can be either a path to a pre-compiled template, or a HTML string.
-
+Templates are specified either as inline strings on the "template" property, or as an external file with the same name as the view, but with the HTML extension.  If an external file is used, embedded CoffeeScript can be used inside it.  The name of the external template file can be changed by specifying a `templateName`
 
 ``` coffee
 class MyView extends Lanes.Views.Base
@@ -69,43 +68,41 @@ view.render()
 # view.el.innerHTML => <div><p>Hello World</p></div>
 ```
 
-
-
-``` coffee
-class MyView extends Lanes.Views.Base
-    template: "views/myview"
-
-view = new MyView
-# attempt to render a template from path "views/myview"
-view.render()
+Given a template file located in `myapp/views/file-list`
+
+```text
+<% if @files.length: %>
+  <h1>My Files:</h1>
+  <% for file in @files: %>
+    <p><%= file.name %></p>
+  <% end %>
+<% else: %>
+  No files
+<% end %>
 ```
 
-
 ``` coffee
-# Contained in file MyView.coffee
-
+# Contained in file FileList.coffee
 class MyApp.Views.MyView extends Lanes.Views.Base
     source: FILE
-
-view = new MyView
-# will use the "source" information to render
-# a template from "myapp/views/my_view"
+    templateData: ->
+      {
+        files: [
+          { name: "Gifts" }, { name: "Secrets" }, { name: "Games" }
+        ]
+      {
+
+view = new FileList
+# will use the "FILE" information to render
+# template above from "myapp/views/file-list"
 view.render()
 ```
 
-# templateName
-
-A string (or function that returns one) that contains the name of a template.  The template will be loaded from the same path but using the templateName instead of one with the same name as the file.
-
-``` coffee
-class MyApp.Views.MyView extends Lanes.Views.Base
-    source: FILE
-    templateName: "contents"
-
-view = new MyView
-# will use the "source" information to render
-# a template from "myapp/views/contents"
-view.render()
+```html
+  <h1>My Files:</h1>
+    <p>Gifts</p>
+    <p></p>
+    <p>Gifts</p>
 ```
 
 # subviews
@@ -146,7 +143,7 @@ class MyApp.Views.MyView extends Lanes.Views.Base
            <div class='grid'></div>
            <div class='names'></div>
         </div>"
-```            
+```
 
 Notes:
 
@@ -162,9 +159,9 @@ Notes:
  * **names**
    * Since the "view" is given as a simple string, Lanes will search for it in the MyApp namespace, and will expect `MyApp.Views.NamesItem` to be defined
    * A collection is specified.  A collectionView will be created and the NamesItem class given as the child view to the collectionView.  The collectionView will then handle rendering the collection whenever it has items added/removed.
-   
 
-# subviewOptions(name,def)
+
+# subviewOptions
 
 When subviews are created, they are initialized with an options object containing the parent view, and any other options that are returned by the `subviewOptions` method.
 
@@ -183,14 +180,12 @@ class MyApp.Views.MyView extends Lanes.Views.Base
             view: 'Heading'
         footer:
             view: 'Footer'
-    subviewOptions: ->
+    subviewOptions: (name,definition)->
         {model: @model, status: "red"}
 
 ```
 
-
-
-# events
+# domEvents
 
 Listens for DOM events that occur within the view _(under it's el)_.  Events are specified as a
  hash containing "event selector" for the key and either a name of a method or function for the value.
@@ -201,13 +196,35 @@ If the selector is ommited, the event will be bound to the root element.
 ``` coffee
 class MyApp.Views.MyView extends Lanes.Views.Base
     template: "<div><a class='title'>click me!</a></div>"
-    events:
+    domEvents:
         "click .title": "onTitleClick"
         "click": -> console.log("I feel like I was clicked somewhere")
     onTitleClick: ->
         console.log "Title Was Clicked!"
 ```
 
+# modelEvents
+
+### and collectionEvents
+
+Listens for events fired by the model and calls the given function when they occur.
+
+The function may be specified as either an inline function, or as a method reference.
+
+**Note**: The model and collection events are usually not needed.  If the only action taken is to update the DOM, it's almost always better to use bindings.
+
+``` coffee
+class MyApp.Views.MyView extends Lanes.Views.Base
+    modelEvents:
+        "read", "render"
+        "change:birthday_now", -> alert("Happy Birthday!")
+    collectionEvents:
+        "change:length", "recalcAll"
+
+    recalcAll: (ev)->
+        doStuff()
+```
+
 # ui
 
 A View will often need to access a given DOM element repeatedly.  By specifying a the elements as part of the UI property, they will be cached when the view is rendered for speedy access.
@@ -220,7 +237,7 @@ class MyApp.Views.MyView extends Lanes.Views.Base
     ui:
         title: "a.title"
     template: "<div><a class='title'>click me!</a></div>"
-    events:
+    domEvents:
         "click @ui.title": "onTitleClick"
     onTitleClick: ->
         console.log "Title Was Clicked!"

data/lib/lanes/access/authentication_provider.rb

@@ -0,0 +1,59 @@
+module Lanes
+    module API
+        class AuthenticationProvider
+
+            def initialize(session:nil, params:nil, request_type: type)
+                @session = session
+                @params  = params
+                @request_type = request_type
+            end
+
+            def current_user
+                @current_user ||= Lanes::User.where(id: @session['user_id']).first
+            end
+
+            def error_message
+                current_user ? "User not found" : error_message_for_access
+            end
+
+            def error_message_for_access
+                return "Unable to " + case @request_type
+                                      when 'GET' then "read"
+                                      when 'POST','PATCH','PUT' then "write"
+                                      when 'DELETE' then "delete"
+                                      else
+                                          "perform action"
+                                      end
+            end
+
+            def allowed_access_to?(klass)
+                return false if current_user.nil?
+                case @request_type
+                when 'GET'
+                    klass.can_read_attributes?(@params,current_user)
+                when 'POST','PATCH','PUT'
+                    klass.can_write_attributes?(@params,current_user)
+                when 'DELETE'
+                    klass.can_delete_attributes?(@params,current_user)
+                else
+                    false
+                end
+            end
+
+            def wrap_request(model, req)
+                if allowed_access_to?(model)
+                    ::Lanes::User.scoped_to(current_user) do | user |
+                        Lanes.logger.debug "User   : #{user.id} (#{user.login})"
+                        Lanes.logger.debug "Params : #{@params}"
+                        yield
+                    end
+                else
+                    req.halt( 401, Oj.dump({
+                      success:false, errors: {user: "Access Denied"}, message: "Access Denied"
+                    }))
+                end
+            end
+        end
+
+    end
+end

data/lib/lanes/access/config/routes.rb

@@ -0,0 +1,26 @@
+module Lanes
+    API.routes.draw do
+
+        post "/user-session.json" do
+            wrap_json_reply do
+                user = User.where(login: data['login']).first
+                if user && user.authenticate(data['password'])
+                    session[:user_id] = user.id
+                    { success: true, message: "Login succeeded", data: user.workspace_data }
+                else
+                    { success: false, message: "Login failed", errors: { login: 'failed' }, data: {} }
+                end
+            end
+        end
+
+        delete "/user-session/:id.json" do
+            session.destroy
+            wrap_json_reply do
+                { success: true, message: "Logout succeeded", data: {} }
+            end
+        end
+
+        resources User
+
+    end
+end

data/lib/lanes/access/config/screens.rb

@@ -0,0 +1,16 @@
+Lanes::Screen.define "user-management" do | screen |
+    screen.title       = "User Management"
+    screen.description = "Add/Remove/Modify User Accounts"
+    screen.icon        = "icon-group"
+    screen.group_id    = "system-settings"
+    screen.model_class = "User"
+    screen.view_class  = "Lanes.Access.Screens.UserManagement"
+    screen.js  = 'lanes/access/screens/user-management.js'
+    screen.css = 'lanes/access/screens/user-management.css'
+end
+
+Lanes::Screen.define_group "system-settings" do | group |
+    group.title       = "System Settings"
+    group.description = "Modify system settings"
+    group.icon        = "icon-wrench"
+end

data/lib/lanes/access/db/migrate/20140615031600_create_lanes_users.rb

@@ -0,0 +1,12 @@
+class CreateLanesUsers < ActiveRecord::Migration
+    def change
+        create_table "lanes_users" do | t |
+            t.string :login, :name, :email,  null: false
+            t.string :password_digest, null: false
+            t.string  "role_names",   array: true, null:false, default: []
+            t.hstore "options",       null: false, default:  {}
+            t.timestamps null:false
+        end
+        add_index  :lanes_users, :role_names, using: 'gin'
+    end
+end

data/lib/lanes/access/extension.rb

@@ -0,0 +1,40 @@
+require_relative '../workspace/extension'
+
+module Lanes
+    module Access
+        class Extension < Lanes::Extensions::Definition
+
+            identifier "lanes-access"
+
+            components 'modal', 'grid', 'select-field'
+
+            root_path Pathname.new(__FILE__).dirname.expand_path
+
+            def stylesheet_include
+                'lanes/access/styles'
+            end
+
+            def javascript_include
+                'lanes/access'
+            end
+
+            def client_namespace
+                'Access'
+            end
+
+            def client_paths
+                []
+            end
+
+            def client_bootstrap_data(view)
+                data = {}
+                if (user_id = view.session['user_id']) && (user = Lanes::User.where( id: user_id ).first)
+                    data.merge!(user.workspace_data)
+                end
+                data
+            end
+
+        end
+
+    end
+end

data/lib/lanes/access/locked_fields.rb

@@ -0,0 +1,43 @@
+module Lanes
+    module Access
+
+        class LockedFields
+
+            @definitions = Hash.new{ |fields,klass|
+                fields[klass] = Hash.new{ |grants,field| grants[field] = [] }
+            }
+            class << self
+
+                # @param klass [Lanes::Model]
+                # @param field [Symbol]
+                # @param access_type [:read, :write]
+                # @return [Array<Role>] Roles that are allowed to access the field.
+                # An empty array indicates that the field is not locked and the Model
+                # should be used for determining access
+                def roles_needed_for(klass, attribute, access_type)
+                    if @definitions.has_key?(klass) && @definitions[klass].has_key?(attribute)
+                        @definitions[klass][attribute].each_with_object([]) do | grant, result |
+                            result.push(grant[:role]) if grant[:only].nil? || grant[:only] == access_type
+                        end
+                    else
+                        []
+                    end
+                end
+
+                # Lock a given class and attribute to a given role
+                # @param klass [Lanes::Model]
+                # @param field [Symbol]
+                # @param only [:read, :write]
+                def lock(klass, field, role, only=nil)
+                    @definitions[klass][field] << { role: role, only: only }
+                end
+
+                def definitions
+                    @definitions
+                end
+            end
+
+        end
+
+    end
+end