sombrero 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: af202b91c5e9642c9c273a24d5efd257f84a1040
-  data.tar.gz: bc18c9a59cdbecb2a8a69e97165d203e62a660ab
+  metadata.gz: 7e63221dd6689f29ae064f7b74182f25a1953226
+  data.tar.gz: 80792a8594b681d53d42e9c2a001aef3b9507e2d
 SHA512:
-  metadata.gz: 3de1aadd490934eecef1ae4173a7a8dffef21561e3701eb78131a5769fdb9a2cd49b2100ec8f467c5326e44430f8b1f6eeccdb3e2ea8d336b77517edb31687b4
-  data.tar.gz: 95acee3df9f7ab331098ceb59becfc2bb972cc256899a9f9abd837ffae842248f2fdce1ccfb993465664d5e026bd94f881c7fd88e1cb09b632b355feb26939ae
+  metadata.gz: 9dc87a61ae7064de27c0e339eb4efee3933a73eda9060ec79a7bc860791bb7eceac2cd35d3459f5c7c3f8487ad7cd6cc85bd40c35b5b455041ad294cc0efb7c2
+  data.tar.gz: 7217715f408adbeb81d1bc30e4b9807e354837c9e518b74a664396ce0c3b999396fe3a13c293b607ba851107b1568d2f779dc80d3c5bfcb1089aca764ee31c5d

data/.gitignore

@@ -7,3 +7,4 @@
 /pkg/
 /spec/reports/
 /tmp/
+.DS_Store

data/Rakefile

@@ -1,2 +1 @@
-require "bundler/gem_tasks"
-task :default => :spec
+require 'bundler/gem_tasks'

data/app/.gitignore

@@ -0,0 +1,6 @@
+.git
+node_modules
+var
+tmp
+Gemfile.lock
+__tmpbuildir__

data/app/.pryrc

@@ -0,0 +1 @@
+require File.expand_path('../core/load', __FILE__)

data/app/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+# do NOT remove this
+eval File.read(File.expand_path('../core/Gemfile', __FILE__))
+
+# add gems here

data/app/Rakefile

@@ -0,0 +1 @@
+require File.expand_path('../core/boot', __FILE__)

data/app/base/base_controller.rb

@@ -0,0 +1,3 @@
+class BaseController < Sombrero::BaseController
+  map Cfg.baseurl
+end

data/app/base/boot.rb

@@ -0,0 +1,2 @@
+# first file to be loaded when app starts.
+# it is loaded on bare metal, e.g. before any gems, configs, helpers.

data/app/base/helpers/application_helpers.rb

@@ -0,0 +1 @@
+# this file will be loaded before other files found in helpers/ folder

data/app/base/load_controllers.rb

@@ -0,0 +1,2 @@
+# All "official" controllers are loaded by core/load_controllers.rb
+# This file is intended to load any "custom" controllers, ones that are not seen by default loader.

data/app/base/rtcp_controller.rb

@@ -0,0 +1,22 @@
+class RTCPController < BaseController
+  map Cfg.baseurl + '__rtcp__'
+
+  private
+  # called after socket connection established.
+  def connected
+  end
+
+  # data sent to client after connection established.
+  def initialization_data
+    {}
+  end
+
+  # merged into original env when calling a controller
+  def rtcp_env
+    {}
+  end
+
+  # called when socket connection closed
+  def disconnected
+  end
+end

data/app/config/config.rb

@@ -0,0 +1,11 @@
+# === Cfg is a required reserved hard-coded constant. === #
+# === If you change it the entire app will broke.     === #
+
+# loading .yml configs from current directory. config.yml will be loaded first.
+Cfg = Sombrero.load_config(File.expand_path('..', __FILE__))
+
+# it is highly recommended to freeze configs so they stay unaltered on runtime.
+Cfg.freeze
+
+# loading any .rb files in current dir. this one will be skipped automatically.
+Dir[File.expand_path('../**/*.rb', __FILE__)].each {|f| require(f)}

data/app/config/config.yml

@@ -0,0 +1,11 @@
+# module SystemRequiredConfigs # Do NOT Remove!
+baseurl: /
+app:
+  url:
+    development: /app
+    production:  /app
+  dir: ./public
+# end
+
+# put here configs that will be the same on all environments.
+# environment-aware configs should be set in config/env/ files.

data/app/config.ru

@@ -0,0 +1,3 @@
+require File.expand_path('../core/load', __FILE__)
+
+run RocketIO::Application.new

data/app/core/Gemfile

@@ -0,0 +1,5 @@
+# DO NOT EDIT THIS FILE, all updates will be lost on next update.
+
+gem 'sombrero'
+gem 'rocketio'
+gem 'tubesock'

data/app/core/boot.rb

@@ -0,0 +1,17 @@
+# DO NOT EDIT THIS FILE, all updates will be lost on next update.
+# edit base/boot.rb instead.
+
+Dir.chdir File.expand_path('../..', __FILE__) do
+  require './base/boot'
+
+  require 'bundler/setup'
+  Bundler.require(:default)
+  Bundler.require(RocketIO.environment)
+
+  require './config/config'
+
+  require './base/helpers/application_helpers'
+  Dir['./base/helpers/**/*.rb'].each {|f| require(f)}
+
+  require './base/load'
+end

data/app/core/client/activity_observer.coffee

@@ -0,0 +1,37 @@
+_ =
+  debounce: require('lodash/debounce')
+  isFunction: require('lodash/isFunction')
+#end
+
+ONLINE = 'online'
+AWAY = 'away'
+OFFLINE = 'offline'
+
+module.exports = (consider_idle_after, report_status = ->) ->
+  is_idle = false
+  idle_time = 0
+
+  if report_status && !_.isFunction(report_status)
+    throw new Error('activity_observer expects second argument to be a function')
+
+  activity_detected = ->
+    report_status(ONLINE) if is_idle
+    is_idle = false
+    idle_time = 0
+    true
+  #end
+
+
+  tictac = ->
+    return if is_idle
+    idle_time += 1
+    is_idle = idle_time >= consider_idle_after
+    if is_idle
+      report_status(AWAY)
+  #end
+
+
+  window.onload = document.onmousemove = document.onkeypress = _.debounce(activity_detected, 500)
+  window.onunload = -> report_status(OFFLINE)
+  window.setInterval(tictac, 1000)
+#end

data/app/core/client/api.coffee

@@ -0,0 +1,248 @@
+_ =
+  isObject: require('lodash/isObject')
+  last: require('lodash/last')
+  has: require('lodash/has')
+  isFunction: require('lodash/isFunction')
+  isArray: require('lodash/isArray')
+  forEach: require('lodash/forEach')
+#end
+
+ReconnectingWebSocket = require('reconnectingwebsocket')
+QueryString = require('qs')
+
+Page = require('./page')
+Load = require('./load')
+Channels = require('./channels')
+Controllers = require('../../controllers.json')
+
+App =
+  connected: false
+  listeners: {}
+  call_on_reconnect: []
+  rtcp_serial: 0
+#end
+
+App.urlify = (url) ->
+  fn = (args...) ->
+    args.unshift(url)
+    q = ''
+    if _.isObject(_.last(args))
+      q = '?' + QueryString.stringify(args.pop())
+    '/' + args.join('/').replace(/^\/+/, '') + q
+  fn.toString = -> url
+  fn
+#end
+
+
+App.controller_loader = (controller) ->
+  ->
+
+    url = [App.app_url, controller.path].join('/') + '.js'
+    window.exports = {}
+    window.module = {url: url, exports: window.exports}
+
+    done = ->
+      unless api = window.module.exports
+        throw new Error("Looks like #{url} does not contain a CommonJS module")
+
+      unless window.module && window.module.url == url
+        throw new Error("Looks like #{url} exports was overridden while downloading the script")
+
+      Core.on_controller_loaded(controller, api)
+    #end
+
+    failed = ->
+      console.log("Error loading #{controller.name}")
+    #end
+
+    Load.script(url, done, failed)
+#end
+
+
+App.controllers = ->
+  controllers = {}
+
+  Controllers.forEach (controller) ->
+
+    controller.url = App.urlify(controller.url)
+    controller.load = App.controller_loader(controller)
+
+    if _.isArray(controller.api)
+      api = {}
+
+      _.forEach controller.api, (meth) ->
+        api[meth] = (args...) ->
+          cb = if _.isFunction(_.last(args)) then args.pop() else null
+          App.send_rtcp_message(controller.url, meth, args, cb)
+      #end
+
+      controller.api = api
+    #end
+
+    Page.Api controller.url_pattern, (context, next) ->
+      controller.load()
+    #end
+
+    if controller.name
+      controllers[controller.name] = controller
+  #end
+
+  controllers
+#end
+
+
+App.onmessage = (evt) ->
+  msg = JSON.parse(evt.data)
+
+  unless typeof msg == 'object'
+    throw new Error("Wrong message format, #{typeof msg} given, Object expected")
+
+  if msg.error
+    throw new Error(msg.error)
+
+  if msg.channel
+    return Core.on_channel_message(msg)
+
+  if msg.controller
+    return App.handle_rpc_message(msg)
+
+  unless typeof msg.serial == 'number'
+    throw new Error('Received a message without or with a wrong serial')
+
+  if msg.serial < 0
+    throw new Error('A subzero serial received')
+
+  unless _.has(msg, 'data')
+    throw new Error('Received a message without data')
+
+  if msg.data.__rtcp_error__
+    return App.handle_standard_message(msg)
+
+  if msg.serial == 0
+    return App.handle_initialization_message(msg)
+
+  return App.handle_standard_message(msg)
+#end
+
+
+App.handle_initialization_message = (msg) ->
+
+  # avoid repetitive bootstraping on reconnects
+  return if App.initialized
+  App.initialized = true
+  App.app_url = msg.data.app_url
+
+  Core.on_initialize(msg)
+
+  Page.Api.start()
+#end
+
+
+App.handle_standard_message = (msg) ->
+  return unless listener = App.listeners[msg.serial]
+
+  delete App.listeners[msg.serial]
+
+  return unless _.isFunction(listener)
+
+  return listener(msg.data.__rtcp_error__) if msg.data.__rtcp_error__
+
+  if _.isArray(msg.data)
+    listener(null, msg.data...)
+  else
+    listener(null, msg.data)
+  #end
+#end
+
+
+App.handle_rpc_message = (msg) ->
+  unless Core.controllers[msg.controller]
+    throw new Error('Unknown controller called')
+
+  Core.controllers[msg.controller].load (api) ->
+
+    unless method = api[msg.method]
+      throw new Error('Unknown method called')
+
+    if args = msg.arguments
+      args = [args] unless _.isArray(args)
+    else
+      args = []
+
+    method.apply(api, args)
+#end
+
+
+App.send_rtcp_message = (controller, method, args, callback) ->
+  unless App.connected
+    App.call_on_reconnect.push(-> App.send_rtcp_message(controller, method, args, callback))
+    Core.connect() if App.explicitly_disconnected
+    return
+  #end
+
+  if _.isFunction(controller)
+    controller = controller()
+  #end
+
+  App.rtcp_serial += 1
+  data =
+    controller: controller
+    method: method
+    arguments: args
+    serial: App.rtcp_serial
+  #end
+
+  if callback
+    App.listeners[App.rtcp_serial] = callback
+    data.reply = true
+  #end
+
+  App.socket.send(JSON.stringify(data), binary: true)
+#end
+
+
+Core =
+  on_socket_open: ->
+  on_socket_close: ->
+  on_initialize: ->
+  on_controller_loaded: ->
+
+  on_channel_message: Channels.on_message
+  subscribe: Channels.subscribe
+  unsubscribe: Channels.unsubscribe
+
+  controllers: App.controllers()
+  send_rtcp_message: App.send_rtcp_message
+
+  connect: (url = '__rtcp__')->
+
+    return if typeof window.WebSocket == 'undefined'
+    protocol = if window.location.protocol.toLowerCase() == 'https:' then 'wss' else 'ws'
+    App.socket = new ReconnectingWebSocket("#{protocol}://#{window.location.host}/#{url}")
+
+    App.socket.onopen = ->
+      App.connected = true
+      _.forEach App.call_on_reconnect, (fn) ->
+        try
+          fn()
+      #end
+      App.call_on_reconnect = []
+      Core.on_socket_open(App.socket)
+    #end
+
+    App.socket.onerror = App.socket.onclose = ->
+      App.connected = false
+      Core.on_socket_close()
+    #end
+
+    App.socket.onmessage = App.onmessage
+  #end
+
+  disconnect: ->
+    App.explicitly_disconnected = true
+    App.socket.close()
+  #end
+
+#end
+
+module.exports = Core

data/app/core/client/channels.coffee

@@ -0,0 +1,37 @@
+_ =
+  isRegExp: require('lodash/isRegExp')
+#end
+
+subscriptions = {}
+awaiting_subscriptions = {}
+
+module.exports =
+  on_message: (msg) ->
+    # if there is a handler, call it
+    if handler = subscriptions[msg.channel]
+      delete subscriptions[msg.channel] if msg.unsubscribe
+      handler(msg.data) if msg.data
+    else
+      # otherwise store message for when handler defined to handle it straight away
+      awaiting_subscriptions[msg.channel] = msg.data
+  #end
+
+
+  subscribe: (channel, handler) ->
+    # if there is a awaiting subscription handle it right away
+    if msg = awaiting_subscriptions[channel]
+      delete awaiting_subscriptions[channel]
+      return handler(msg)
+    # otherwise subscribe
+    subscriptions[channel] = handler
+  #end
+
+
+  unsubscribe: (channel) ->
+    if _.isRegExp(channel)
+      for c in Object.keys(subscriptions).filter((c) -> channel.text(c))
+        delete subscriptions[c]
+    else
+      delete subscriptions[channel]
+  #end
+#end

data/app/core/client/load.coffee

@@ -0,0 +1,20 @@
+module.exports =
+
+  script: (url, done, failed) ->
+    script = document.createElement('script')
+    script.async = true
+    script.onload = done
+    script.onerror = failed
+    script.src = url
+    document.getElementsByTagName('head')[0].appendChild(script)
+  #end
+
+
+  stylesheet: (url, done) ->
+    link = document.createElement('link')
+    link.onload = done
+    link.type = 'text/css'
+    link.rel = 'stylesheet'
+    link.href = url
+    document.getElementsByTagName('head')[0].appendChild(link)
+  #end

data/app/core/client/page.coffee

@@ -0,0 +1,68 @@
+_ =
+  isFunction: require('lodash/isFunction')
+  isObject: require('lodash/isObject')
+  isArray: require('lodash/isArray')
+  has: require('lodash/has')
+#end
+
+QueryString = require('qs')
+Api = require('page')
+
+page = ->
+
+  this.navigate = (path, options) ->
+    if _.isFunction(path)
+      path = path()
+
+    if !path || _.isObject(path)
+      options = path
+      path = window.location.pathname
+
+    options = {} unless _.isObject(options)
+
+    if _.isArray(options.path)
+      path = '/' + options.path
+        .filter((x) -> x)
+        .map((x) -> String(x))
+        .join('/')
+        .replace(/\/+/, '/')
+        .replace(/^\//, '')
+
+    if _.isObject(options.params)
+      path = path + '?' + QueryString.stringify(options.params)
+
+    if options.reload
+      Api.stop()
+      window.location = path
+
+    parser = document.createElement('a')
+    parser.href = path
+    if parser.hostname
+      unless parser.hostname == location.hostname
+        throw new Error('Guess what! Someone tries to navigate out!')
+
+    args = [
+      path,
+      (if _.has(options, 'state')    then options.state    else {}),
+      (if _.has(options, 'dispatch') then options.dispatch else true),
+      (if _.has(options, 'push')     then options.push     else true)
+    ]
+    Api.show.apply(this, args)
+
+    this.update_params()
+  #end
+
+
+  this.update_params = ->
+    this.params = QueryString.parse(window.location.search.slice(1))
+    this.path_params = window.location.pathname.replace(/^\/+|\/+$/g, '').split(/\/+/).filter((x) -> x.length > 0)
+  #end
+
+  this.update_params()
+
+  this
+#end
+
+page.Api = Api
+
+module.exports = page

data/app/core/client/polyfills/array.compact.coffee

@@ -0,0 +1,4 @@
+
+Array.prototype.compact = ->
+  this.filter (x) -> x
+#end

data/app/core/client/polyfills/array.compact_join.coffee

@@ -0,0 +1,4 @@
+
+Array.prototype.compact_join = (glue) ->
+  (this.filter (x) -> x).join(glue)
+#end

data/app/core/client/polyfills/number.to_money.coffee

@@ -0,0 +1,3 @@
+Number.prototype.to_money = (n = 2, x = 3) ->
+  re = '(\\d)(?=(\\d{' + x + '})+' + (n > 0 ? '\\.' : '$') + ')'
+  this.toFixed(Math.max(0, ~~n)).replace(new RegExp(re, 'g'), '$1,')

data/app/core/client/polyfills/string.capitalize.coffee

@@ -0,0 +1,4 @@
+
+String.prototype.capitalize = ->
+  this.charAt(0).toUpperCase() + this.slice(1)
+#end

data/app/core/client/polyfills/string.strip.coffee

@@ -0,0 +1,5 @@
+
+
+String.prototype.strip = ->
+  this.replace(/^\s+|\s+$/g, '')
+#end

data/app/core/client/polyfills.coffee

@@ -0,0 +1,6 @@
+
+require './polyfills/array.compact.coffee'
+require './polyfills/array.compact_join.coffee'
+require './polyfills/number.to_money.coffee'
+require './polyfills/string.capitalize.coffee'
+require './polyfills/string.strip.coffee'

data/app/core/client/render.coffee

@@ -0,0 +1,57 @@
+_ =
+  extend: require('lodash/extend')
+  has: require('lodash/has')
+  isFunction: require('lodash/isFunction')
+#end
+
+extend = (data) ->
+  _.extend({}, data || {}, api.global_data || {})
+#end
+
+api = (opts) ->
+  api.default_el || throw new Error('Render.default_el not set')
+  opts.data = extend(opts.data)
+  opts.el = opts.el || api.default_el
+  opts.magic = if _.has(opts, 'magic') then opts.magic else true
+
+  ractive = new api.Ractive(opts)
+
+  for h,f of api.global_handlers || {}
+    ractive.on(h, f)
+
+  ractive
+#end
+
+api.Ractive = require('ractive')
+
+api.global_data = {}
+api.global_handlers = {}
+api.default_el = null
+
+api.component = (opts) ->
+  data = opts.data
+  opts.data = ->
+    if _.isFunction(data)
+      extend(data())
+    else
+      extend(data)
+  #end
+
+  opts.magic = if _.has(opts, 'magic') then opts.magic else true
+
+  oninit = opts.oninit
+  opts.oninit = ->
+    for h,f of api.global_handlers || {}
+      this.on(h, f)
+    oninit?()
+  #end
+  api.Ractive.extend(opts)
+#end
+
+
+api.string = (opts = {}) ->
+  opts.data = extend(opts.data)
+  new api.Ractive(opts).toHTML()
+#end
+
+module.exports = api