dashing 0.1.2 → 1.0

data/README.md

@@ -1,197 +1 @@
-TODO:
-
-- google analytics
-- Look into a mechanism for re-loading the page when a deploy occurs
-- talk about debug mode
-
-# Dashing!
-
-A handsome dashboard framework solution
-
-## YET ANOTHER THING!?!??! Explain this part
-## Introduction
-
-Dashing is a framework for building web-based dashboards.
-
-Features:
-
- - Custom widgets! Built using whatever HTML/Coffeescript wizardry you posses
- - Multiple dashboards! You can have many different views all hosted in the same location
- - Shared widgets! It's easy to have have the same widget show up on different dashboards
- - Push or pull data, you decide!
- - Responsive grid layout! Your dashboard will look good on any sized screen
-
-## Installation and Setup
-
-  1. Install the gem from the command line:
-
-    ```gem install dashing```
-
-  2. Generate a new project:
-
-    ```dashing new sweet_dashboard_project```
-
-  3. Change your directory to ```sweet_dashboard_project``` and start Dashing
-
-    ```dashing start```
-
-  4. Point your browser at [localhost:3000](http://localhost:3000)
-
-## Building a dashboard
-
-```main.erb``` contains the layout for the default dashboard which is accessible at ```/```.
-You can add additional dashboards with by running ```dashing COMMAND THINGY new_view``` which creates a ```new_view.erb``` file in ```dashboards/```.
-That new view will be accessible at ```localhost:3000/new_view```
-
-## Widgets
-
-Widgets are represented by a ```div``` element with ```data-id``` and ```data-view``` attributes. eg:
-
-```HTML
-<div data-id="sample" data-view="SweetWidget"></div>
-```
-
-The ```data-id``` attribute is used to set the **widget ID** which will be used when to push data to the widget. Two widgets can have the same widget id, allowing you to have the same widget in multiple dashboards.
-
-```data-view``` specifies the type of widget what will be used. This field is case sensitive and must match the coffeescript class of the widget. See making your own widget section for more details.
-
-This ```<div>``` can also be used to configure your widgets. For example, the pre-bundled widgets let you set a title with ```data-title="Widget Title"```.
-
-### Layout
-
-Getting the style and layout right when you have multiple widgets is hard, that's why we've done it for you. By default Dashing uses [masonry](http://masonry.desandro.com/) to produce a grid layout. If it can, your dashboard will fill the screen with 5 columns. If there isn't enough room though, widgets will be reorganized to fit into fewer columns until you are left with a single column
-
-Examples here?
-
-Masonry requires that your widgets be contained within a ```<ul>``` element as follows:
-
-```HTML
-<ul class="list-nostyle clearfix">
-  <li class="widget-container">
-    <div data-id="widget_id1" data-view="MyWidget"></div>
-  </li>
-  <li class="widget-container">
-    <div data-id="widget_id2" data-view="MyWidget"></div>
-  </li>
-  <li class="widget-container">
-    <div data-id="widget_id3" data-view="MyWidget"></div>
-  </li>
-</ul>
-```
-
-### Making you own widget
-
-A widget consists of three parts:
-
- - an html file used for layout and bindings
- - a scss file for style
- - a coffeescript file which allows you to operate on the data
-
-To make your own run ```dashing generate sweet_widget``` which will create scaffolding files in the ```widget/``` folder or your project.
-
-#### sweet_widget.html
-
-Contains the HTML for you widget.
-We use [batman bindings](http://batmanjs.org/docs/batman.html#batman-view-bindings-how-to-use-bindings) in order to update the content of a widget.
-In the example below, updating the title attribute of the coffeescript object representing that widget will set the innerHTML of the ```<h1>``` element.
-Dashing provides a simple way to update your widgets attributes through a push interface and a pull interface. See the Getting Data into Dashing section.
-
-##### Example
-```html
-<h1 data-bind="title"></h1>
-
-<h3 data-bind="text"></h3>
-````
-
-#### sweet_widget.coffee
-
-This coffee script file allows you to perform any operations you wish on your widget. In the example below we can initialize things with the constructor method.
-We can also manipulate the data we recieve from data updates. Data will be the JSON object you pass in.
-
-##### Example
-```coffeescript
-class Dashing.SweetWidget extends Dashing.Widget
-
-  constructor: ->
-    super
-    @set('attr', 'wooo')
-
-  onData: (data) ->
-    super
-    @set('cool_thing', data.massage.split(',')[2]
-```
-
-#### sweet_widget.scss
-
-##### Example
-````scss
-$text_value-color:       #fff;
-$text_title-color:       lighten($widget-text-color, 30%);
-
-.widget-text {
-  .title {
-    color: $text_title-color;
-  }
-  .p {
-    color: $text_value-color:
-  }
-}
-```
-
-## Getting data into Dashing
-
-Providing data to widgets is easy. You specify which widget you want using a widget id. Dashing expects the data you send to be in JSON format.
-Upon getting data, dashing mixes the json into the widget object. So it's easy to update multiple attributes within the same object.
-
-### Jobs (poll)
-
-Dashing uses [rufus-scheduler](http://rufus.rubyforge.org/rufus-scheduler/) to schedule jobs.
-You can make a new job with ```dashing job super_job``` which will create a file in the jobs folder called ```super_job.rb```.
-Data is sent to a widget using the ```send_event(widget_id, json_formatted_data)``` method.
-
-#### Example
-
-```ruby
-# :first_in sets how long it takes before the job is first run. In this case, it is run immediately
-SCHEDULER.every '1m', :first_in => 0 do |job|
-  send_event('widget_id', {text: "I am #{%w(happy sad hungry).sample}"})
-end
-```
-
-### Push
-
-You can also push data directly to your dashboard! Post the data you want in json to ```/widgets/widget_id```.
-For security, you will also have to include your auth_token (which can be found in ```config.ru```) as part of the json object.
-
-#### Example
-```bash
-curl -d '{ "auth_token": "YOUR_AUTH_TOKEN", "value": 100 }' http://localhost:3000/widgets/synergy
-```
-
-or
-
-```ruby
-HTTParty.post('http://ADDRESS/widgets/widget_id',
-  :body => { auth_token: "YOUR_AUTH_TOKEN", text: "Weeeeee"}.to_json)
-```
-
-## Misc
-
-### Deploying to heroku
-
-### Using omni-auth
-
-## Dependencies
-
- - [Sinatra](http://www.sinatrarb.com/)
- - [batman.js](http://batmanjs.org/)
- - [rufus-scheduler](http://rufus.rubyforge.org/rufus-scheduler/)
- - [Thor](https://github.com/wycats/thor/)
- - [jQuery-knob](http://anthonyterrien.com/knob/)
- - [masonry](http://masonry.desandro.com/)
- - [thin](http://code.macournoyer.com/thin/)
- - [Sass](http://sass-lang.com/)
-
-## Licensing
-
-This code is released under the MIT license. See ```MIT-LICENSE``` file for more details
+Check out the [Homepage](http://shopify.github.com/dashing)

data/bin/dashing

@@ -14,7 +14,7 @@ def send_event(id, data)
   req = Net::HTTP::Post.new("/widgets/#{id}")
   req["content-type"] = "application/json"
   req.body = JSON.unparse(data.merge(:auth_token => Dashing::CLI.auth_token))
-  res = Net::HTTP.new('localhost', 3000).start { |http| http.request(req) }
+  res = Net::HTTP.new('localhost', 3030).start { |http| http.request(req) }
   puts "Data Sent to #{id}: #{data}"
 end
 
@@ -61,8 +61,9 @@ module Dashing
     desc "start", "Starts the server in style!"
     method_option :job_path, :desc => "Specify the directory where jobs are stored"
     def start(*args)
+      port_option = args.include?('-p')? '' : ' -p 3030'
       args = args.join(" ")
-      command = "bundle exec thin -R config.ru start #{args}"
+      command = "bundle exec thin -R config.ru start #{port_option} #{args}"
       command.prepend "export JOB_PATH=#{options[:job_path]}; " if options[:job_path]
       system(command)
     end

data/templates/project/README.md

@@ -0,0 +1 @@
+Check out http://shopify.github.com/dashing for more information.

data/templates/project/dashboards/sample.erb

@@ -21,5 +21,5 @@
       <div data-id="convergence" data-view="Graph" data-title="Convergence" style="background-color:#ff9618"></div>
     </li>
   </ul>
-  <center><div style="font-size: 12px">Try this: curl -d '{ "auth_token": "YOUR_AUTH_TOKEN", "text": "Hey, Look what I can do!" }' \http://localhost:3000/widgets/welcome</div></center>
+  <center><div style="font-size: 12px">Try this: curl -d '{ "auth_token": "YOUR_AUTH_TOKEN", "text": "Hey, Look what I can do!" }' \http://<%=request.host%>:<%=request.port%>/widgets/welcome</div></center>
 </div>

data/templates/project/dashboards/sampletv.erb

@@ -52,5 +52,5 @@ $(function() {
     </li>
 
   </ul>
-  <center><div style="font-size: 12px">Try this: curl -d '{ "auth_token": "YOUR_AUTH_TOKEN", "text": "Hey, Look what I can do!" }' \http://localhost:3000/widgets/welcome</div></center>
+  <center><div style="font-size: 12px">Try this: curl -d '{ "auth_token": "YOUR_AUTH_TOKEN", "text": "Hey, Look what I can do!" }' \http://<%=request.host%>:<%=request.port%>/widgets/welcome</div></center>
 </div>

data/templates/project/lib/.empty_directory

@@ -0,0 +1 @@
+.empty_directory

data/templates/project/widgets/number/number.coffee

@@ -15,9 +15,6 @@ class Dashing.Number extends Dashing.Widget
     if @get('last')
       if parseInt(@get('current')) > parseInt(@get('last')) then 'icon-arrow-up' else 'icon-arrow-down'
 
-  @accessor 'needsAttention', ->
-    @get('status') == 'warning' || @get('status') == 'danger'
-
   onData: (data) ->
     if data.status
       $(@get('node')).addClass("status-#{data.status}")

data/templates/project/widgets/number/number.html

@@ -1,4 +1,4 @@
-<h1 class="title"><i data-showif="needsAttention" class="icon-warning-sign"></i><span data-bind="title"></span></h1>
+<h1 class="title" data-bind="title"></h1>
 
 <h2 class="value" data-bind="current | shortenedNumber | prepend prefix"></h2>
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dashing
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: '1.0'
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-26 00:00:00.000000000 Z
+date: 2012-10-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sass
-  requirement: &70210076653740 !ruby/object:Gem::Requirement
+  requirement: &70129949213620 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70210076653740
+  version_requirements: *70129949213620
 - !ruby/object:Gem::Dependency
   name: coffee-script
-  requirement: &70210076653300 !ruby/object:Gem::Requirement
+  requirement: &70129949213180 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70210076653300
+  version_requirements: *70129949213180
 - !ruby/object:Gem::Dependency
   name: sinatra
-  requirement: &70210076652860 !ruby/object:Gem::Requirement
+  requirement: &70129949212760 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70210076652860
+  version_requirements: *70129949212760
 - !ruby/object:Gem::Dependency
   name: sinatra-contrib
-  requirement: &70210076652420 !ruby/object:Gem::Requirement
+  requirement: &70129949261560 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +54,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70210076652420
+  version_requirements: *70129949261560
 - !ruby/object:Gem::Dependency
   name: thin
-  requirement: &70210076652000 !ruby/object:Gem::Requirement
+  requirement: &70129949261140 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,10 +65,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70210076652000
+  version_requirements: *70129949261140
 - !ruby/object:Gem::Dependency
   name: rufus-scheduler
-  requirement: &70210076651580 !ruby/object:Gem::Requirement
+  requirement: &70129949260680 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -76,10 +76,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70210076651580
+  version_requirements: *70129949260680
 - !ruby/object:Gem::Dependency
   name: thor
-  requirement: &70210076651160 !ruby/object:Gem::Requirement
+  requirement: &70129949260240 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -87,10 +87,10 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70210076651160
+  version_requirements: *70129949260240
 - !ruby/object:Gem::Dependency
   name: sprockets
-  requirement: &70210076650740 !ruby/object:Gem::Requirement
+  requirement: &70129949259680 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -98,7 +98,7 @@ dependencies:
         version: '0'
   type: :runtime
   prerelease: false
-  version_requirements: *70210076650740
+  version_requirements: *70129949259680
 description: This framework lets you build & easily layout dashboards with your own
   custom widgets. Use it to make a status boards for your ops team, or use it to track
   signups, conversion rates, or whatever else metrics you'd like to see in one spot.
@@ -175,10 +175,11 @@ files:
 - templates/widget/%name%/%name%.coffee.tt
 - templates/widget/%name%/%name%.html
 - templates/widget/%name%/%name%.scss.tt
+- templates/project/lib/.empty_directory
 - lib/dashing.rb
 - !binary |-
   YmluL2Rhc2hpbmc=
-homepage: http://dashing.shopify.com
+homepage: http://shopify.github.com/dashing
 licenses: []
 post_install_message: 
 rdoc_options: []
@@ -201,5 +202,5 @@ rubyforge_project:
 rubygems_version: 1.8.11
 signing_key: 
 specification_version: 3
-summary: A DIY framework for creating dashboards.
+summary: The exceptionally handsome dashboard framework.
 test_files: []