fanforce-app-factory 0.7.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    MjFjYjNmZjFhZGEyZGYxNTZkZThkZjI0NWU0NzgxMDg5NTM2ZjZmNQ==
+  data.tar.gz: !binary |-
+    NzZjYmIzZmFiYWZhZjI1YTZkNWI4ZDA1MTYzNGFiMDMxNDUxZDU4Mw==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    ZmQzZmQxZjBkMTM1OTU5ODEwMTAwYWMxNDUyNWY1MzAwZTIxMmU2MTliODAw
+    Mzk5YjM5MTFlMDcxMjViNjYxZGZhZTljZDU1ZjE1ZGNhYzc1NzlhY2IyZjkx
+    OTUwYWI1ZjhjMWNhMDVmN2JlNzAzNmVmNTJmOWY0NzU4MzFiNjM=
+  data.tar.gz: !binary |-
+    ODI5OGI2NjI5MDAzNTIyYjZlYjEyMjg3MDRmOTVkMTQ3MzIxN2FhMTc4YzQ0
+    NTc2YjhmY2I2ZjA5YTNmYWQ0MzI4ZjQ2YThjODZmNTkwN2M1NDllMTkxYTlk
+    OWUwYTcxYmQ5NzY4NWUzMjczNzA4MDJlMTEwYzUzZTk4MWYzYzE=

data/.gitignore

@@ -0,0 +1,21 @@
+*.gem
+*.rbc
+.bundle
+.config
+coverage
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.idea/
+.DS_STORE
+Gemfile.lock
+
+# YARD artifacts
+.yardoc
+_yardoc
+doc/

data/Gemfile

@@ -0,0 +1,2 @@
+source "https://rubygems.org"
+gemspec

data/README.md

@@ -0,0 +1,182 @@
+fanforce-app-factory
+========
+The fanforce-app-factory is a gem that makes it really easy to create new Fanforce Apps using convention over configuration.
+
+# Easy Setup
+Only two files are required to setup a new project:
+1. Gemfile
+2. config.ru
+
+### /Gemfile
+Since the fanforce-app-factory gem is hosted on a private gem server so you'll need to specify the source for both rubygems and the private server.
+
+```ruby
+source 'https://rubygems.org'
+source 'https://gems.gemfury.com/xF8KY9sm8eS9yUQqw1jD/'
+ruby '1.9.3'
+
+gem 'fanforce-app-factory'
+```
+One you've created the Gemfile you'll need to run bundle install.
+
+### /config.ru
+Only four lines are required (you must have a Redis server).
+
+```ruby
+require 'bundler'; Bundler.setup
+require 'fanforce/app'
+FanforceApp.config { |config| config._id = 'facebook' }
+run FanforceApp
+```
+You can replace config._id (as in the example above) with an environment variable: ENV['FANFORCE_APP_ID']
+
+### Ready for the Fanforce Marketplace!
+Your app can now be added to the Fanforce Marketplace. Use the follow config settings when adding your new app into Fanforce
+
+```ruby
+"public_urls": {
+    "marketplace_img": "http://${PRIMARY_DOMAIN}/assets/marketplace.png",
+    "icon_16": "http://${PRIMARY_DOMAIN}/assets/icon-16.png",
+    "icon_32": "http://${PRIMARY_DOMAIN}/assets/icon-32.png"
+    "icon_42": "http://${PRIMARY_DOMAIN}/assets/icon-42.png"
+},
+"staffer_ui_urls": {
+    "dashboard": "http://${PRIMARY_DOMAIN}/dashboard.html"
+},
+"callback_urls": {
+    "install": "http://${PRIMARY_DOMAIN}/install",
+    "uninstall": "http://${PRIMARY_DOMAIN}/uninstall"
+},
+"plugin_dependencies": []
+```
+Note: for development and testing we recommend using the [POW server](http://pow.cx/), but you can use rackup or any other server to run your new app.
+
+====================
+
+# Customizing/Building Your App
+There are lots of ways you can start building out and customizing your app...
+
+### /assets
+Use the assets folder to store all your images, css, and javascript files. There are six asset files that are required. If any are missing, the fanforce-app-factory sends default versions when requested.
+
+*Default Assets:*
+* /js
+    * /dashboard.js - this is included in the dashboard.html file.
+* /css
+    * /dashboard.css - this is also included in the dashboard.html file.
+* /img
+    * /icon-16.png - this icon must be 16px by 16px.
+    * /icon-32.png - this icon must be 32px by 32px.
+    * /icon-42.png - this icon must be 42px by 42px.
+    * /marketplace.png - this icon must be 220px by 142px.
+
+### /views
+HAML is setup by default. The extension is changed to .html when served in the browser.
+
+*Default Views:*
+* /index.haml - default page visitors will see if they try to access domain
+* /dashboard.haml - used in the Command Center
+
+### /layouts
+You can turn off layouts from be used (see Advanced Configuration)
+
+*Default Layouts:*
+* /dashboard.haml - the wrapper layout for views/dashboard.haml
+* /promotional.haml - the wrapper layout for views/index.haml
+
+### /public
+Anything you put in here will be publicly available. The only folder you should not use is /assets, since it is used for precompiling assets (see below).
+
+*Default Files:*
+* /favicon.ico
+
+### /config/routes.rb
+The fanforce-app-factory sets up all the required routes. If you want to customize existing routes or add new ones, create a config/routes.rb file and specify routes within the FanforceApp:Sinatra class:
+```
+class FanforceApp::Sinatra
+  get '/test' do
+    "Custom route!"
+  end
+end
+```
+Check out [Sinatra's](http://www.sinatrarb.com/documentation) documentation for more details on routes and much more. The FanforceApp::Sinatra inherits from the Sinatra::Base, which gives you full control to customize the fanforce-app-factory's sinatra implementation as much as you want.
+
+Overwrite any existing routes by specifying them in your config/routes.rb. You can also pull default route logic into your new custom routes by calling route_[NAME_OF_ROUTE] method.
+```
+class FanforceApp::Sinatra
+  any '/install' do
+    # do whatever you want here
+    route_install
+  end
+end
+```
+*Default Routes:*
+- route_index:     get ['/','/index.html']
+- route_dashboard: get '/dashboard.html'
+- route_install:   post '/install'
+- route_uninstall: post '/uninstall'
+
+### /config/initializer.rb
+If you need to run Sinatra middleware or other non-route code, you'll want to create a config/initializer.rb file. This file is required before config/routes.rb. As an example, if you want to use the OmniAuth Facebook Strategy, you would include the following in config/initializer.rb:
+```
+require 'omniauth'
+require 'omniauth-constantcontact2'
+
+class FanforceApp::Sinatra
+
+  use Rack::Session::Cookie
+  use OmniAuth::Builder do
+    provider :constantcontact, ENV['CONSTANTCONTACT_API_KEY'], ENV['CONSTANTCONTACT_API_SECRET']
+  end
+
+end
+```
+
+### /lib/*
+If you create a lib/ folder in your app's home directory, it will be automatically added to your app's ruby path. This allows you to require 'any_file' that has been put in this folder.
+
+
+# Loading Pages/Layouts In Controllers
+Fanforce-app-factory adds a helper method on top of the Sinatra code base to load pages and layouts. It's called page:
+```
+get '/custom.html' do
+  page :custom, :layout => :custom
+end
+```
+*Other Examples*
+- :custom_page
+- :custom_page, :layout => :false
+
+# Rendering JSON, JSONP, and JSONR
+Fanforce-app-factory adds a "json" method you use in your routes to convert the object to json and set the correct application/json header:
+```
+get '/custom.html' do
+  json first_name: 'Caleb', last_name: 'Clark'
+end
+```
+If a callback param is sent in the request then your json is automatically converted to JSONR[http://github.com/calebclark/rack-jsonr] (JSON Resource).
+
+
+# Precompile Your Assets for Faster Delivery
+Heroku tries to run `rake assets:precompile` when pushing new code changes. Fanforce-app-factory has this rake task built-in. To activate, just create a new Rakefile in your app directory with the following:
+```
+require 'bundler'; Bundler.setup
+require 'fanforce/app'
+load 'fanforce/app.rake'
+```
+
+# Create App-Specific ENV Variables In Development
+Documentation coming soon.
+
+# Configure Redis
+By default fanforce-app-factory looks for ENV['REDIS_URL'] and if that isn't found, it falls back to redis://localhost:6379. You can specify a custom redis url with `config.redis_url = ` in config.ru:
+```
+require 'bundler'; Bundler.setup
+require 'fanforce/app'
+FanforceApp.config do |config|
+  config.redis_url = 'redis://USERNAME:PASSWORD@HOST:PORT'
+end
+load 'fanforce/app.rake'
+```
+
+

data/Rakefile

@@ -0,0 +1,16 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+require 'fileutils'
+include FileUtils
+
+# Default Rake task is compile
+#task :default => :compile
+
+########################################################################
+
+Rake::TestTask.new do |t|
+  t.libs.push "lib"
+  t.libs.push "test"
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end

data/fanforce-app-factory.gemspec

@@ -0,0 +1,40 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'fanforce/app_factory/version'
+
+Gem::Specification.new do |gem|
+  gem.name        = 'fanforce-app-factory'
+  gem.version     = Fanforce::AppFactory::VERSION
+  gem.date        = '2012-10-19'
+  gem.summary     = %q{Everything needed to setup a new app on Fanforce}
+  gem.authors     = ['Caleb Clark']
+  gem.email       = ['cclark@fanforce.com']
+  gem.homepage    = 'http://github.com/mlabs/fanforce-app-factory'
+
+  gem.files         = `git ls-files`.split($/)
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ['lib']
+
+  gem.add_development_dependency 'rake', '~> 0.8.7'
+  gem.add_runtime_dependency 'redis', '~> 3.0'
+  gem.add_runtime_dependency 'sinatra', '~> 1.3'
+  gem.add_runtime_dependency 'multi_json', '~> 1.3.6'
+  gem.add_runtime_dependency 'sinatra-contrib'
+  gem.add_runtime_dependency 'rack-contrib'
+  gem.add_runtime_dependency 'haml', '~> 3.1'
+  gem.add_runtime_dependency 'coffee-script'
+  gem.add_runtime_dependency 'coffee-filter'
+  gem.add_runtime_dependency 'activesupport', '~> 3.2'
+
+  gem.add_runtime_dependency 'sass', '~> 3.2'
+  gem.add_runtime_dependency 'compass', '~> 0.12'
+  gem.add_runtime_dependency 'sprockets', '~> 2.9'
+  gem.add_runtime_dependency 'sprockets-sass', '~> 0.9'
+  gem.add_runtime_dependency 'yui-compressor', '~> 0.9'
+  gem.add_runtime_dependency 'uglifier', '~> 1.3'
+
+  gem.add_runtime_dependency 'rack-jsonr', '~> 0.2'
+  gem.add_runtime_dependency 'fanforce', '~> 0.8'
+  gem.add_runtime_dependency 'fanforce-errors', '~> 0.2'
+end

data/lib/fanforce/app_factory.rake

@@ -0,0 +1,71 @@
+require 'fanforce'
+require 'fileutils'
+require 'json'
+require 'yaml'
+require_relative 'app_factory/sprockets/hacks'
+require_relative 'app_factory/sprockets/compiler'
+
+def load_env_from_file(file)
+  File.open(file, 'rb') do |file|
+    contents = file.read
+    lines = contents.gsub('export ', '').split(/\n\r?/).reject{|line| line.blank?}
+    lines.each do |line|
+      keyValue = line.split("=", 2)
+      next unless keyValue.count == 2
+      ENV[keyValue.first] = keyValue.last.gsub("'",'').gsub('"','')
+    end
+  end
+end
+
+if (!ENV['RACK_ENV'] or ENV['RACK_ENV'] == 'development')
+  load_env_from_file("#{FanforceApp.config.root_dir}/.powenv") if File.exists?("#{FanforceApp.config.root_dir}/.powenv")
+  load_env_from_file("#{FanforceApp.config.root_dir}/.appenv") if File.exists?("#{FanforceApp.config.root_dir}/.appenv")
+end
+
+FanforceApp.config.load_redis
+
+namespace :assets do
+  root_dir = FanforceApp.config.root_dir
+  factory_root_dir = FanforceApp.config.factory_root_dir
+
+  desc 'Precompile assets for production'
+  task :precompile => :clean do
+    sprockets = SprocketsCompiler.setup(root_dir)
+
+    puts 'PRECOMPILING ASSETS... '
+    SprocketsCompiler.new(sprockets: sprockets, precompile: [/(\/|^)[^_\/]+[^\/]*\.(css|js|png|gif|jpeg|jpg|otf|eot|svg|ttf|woff)/]).compile
+    puts 'DONE'
+
+    print 'GENERATING ASSET MANIFESTS... '
+    asset_list = {}
+    sprockets.each_logical_path do |logical_path|
+      if File.basename(logical_path) !~ /^[_]/ and asset = sprockets.find_asset(logical_path)
+        asset_list[logical_path] = "/assets/#{asset.digest_path}"
+      end
+    end
+    IO.write File.join(root_dir, '/public/asset_manifest.json'), JSON.generate(asset_list)
+    IO.write File.join(root_dir, '/public/asset_manifest.json'), "ASSETS=#{JSON.generate(asset_list)}"
+    IO.write File.join(root_dir, '/public/asset_manifest.json'), asset_list.to_yaml
+    puts 'DONE'
+
+    print 'ENSURING FAVICON EXISTS... '
+    if !File.exists?(root_dir+'/public/favicon.ico')
+      puts ''
+      FileUtils.cp("#{factory_root_dir}/public/favicon.ico", "#{root_dir}/public/favicon.ico")
+      puts "#{root_dir}/public/favicon.ico"
+    end
+    puts 'DONE'
+  end
+
+  desc 'Clean assets folder'
+  task :clean do
+    print 'DESTROYING PUBLIC/ASSETS... '
+    FileUtils.rm_rf File.join(root_dir, '/public/assets')
+    puts 'DONE'
+  end
+
+  task :test do
+    puts 'TEST WORKED!'
+  end
+
+end

data/lib/fanforce/app_factory.rb

@@ -0,0 +1,56 @@
+ENV['RACK_ENV'] ||= 'development'
+####################################################################################
+require 'fanforce'
+require 'active_support/all'
+require 'sinatra/base'
+require 'fileutils'
+require 'redis'
+
+if ENV['RACK_ENV'] == 'development'
+  require_relative 'app_factory/sprockets/hacks'
+  require_relative 'app_factory/sprockets/compiler'
+end
+
+caller[0].split(':')[0] =~ /^(.+(config\.ru|Rakefile))$/ ? ROOT_DIR = File.dirname($1) : nil
+
+module FanforceApp
+
+  def self.config(&block)
+    config = @@config ||= FanforceApp::SinatraConfig.new(ROOT_DIR)
+    if block.present?
+      block.call(config)
+      config.root_dir = File.dirname($1) if !config.root_dir and caller[0].split(':')[0] =~ /^(.+(config\.ru|Rakefile))$/
+    end
+    config
+  end
+
+  def self.root
+    config.root_dir
+  end
+
+  def self.dir_name
+    config.dir_name
+  end
+
+  def self._id
+    config._id
+  end
+
+  def self.load_config
+    config.load
+  end
+
+  def self.call(env)
+    if ENV['RACK_ENV'] == 'development' and env['PATH_INFO'] =~ /^\/assets\//
+      env['PATH_INFO'] = env['PATH_INFO'].gsub(/^\/assets/, '')
+      sprockets = SprocketsCompiler.setup(FanforceApp.config.root_dir)
+      return sprockets.index.call(env)
+    end
+    require_relative 'app_factory/_init_sinatra'
+    FanforceApp::Sinatra.new.call(env)
+  end
+
+  require_relative 'app_factory/config/sinatra_config'
+  require_relative 'app_factory/initializers/ff_globals'
+end
+

data/lib/fanforce/app_factory/_init_sinatra.rb

@@ -0,0 +1,54 @@
+require 'sinatra/content_for'
+require 'coffee-filter'
+require 'rack/jsonr'
+####################################################################################
+
+class FanforceApp::Sinatra < Sinatra::Base
+  require_relative 'config/_error_handling'
+  require_relative 'config/helpers/assets'
+  require_relative 'config/helpers/json'
+  require_relative 'config/helpers/fanforce'
+
+  use Rack::JSONR, :method_override => :all
+
+  helpers Sinatra::AssetHelpers
+  helpers Sinatra::JSONHelpers
+  helpers Sinatra::FanforceHelpers
+  helpers Sinatra::ContentFor
+
+  def self.any(url,&block)
+    get(url,&block)
+    post(url,&block)
+    put(url,&block)
+    delete(url,&block)
+  end
+
+  def page(page, options={})
+    current_dir = File.expand_path('../', __FILE__)
+    if !File.exists?("#{settings.views}/#{page}.haml")
+      rel_path = Pathname.new(current_dir).relative_path_from(Pathname.new(settings.views))
+      page = :"#{rel_path}/views/#{page}"
+    end
+
+    if options[:layout] and FanforceApp.config.respond_to?(:"layout_for_#{page}") and FanforceApp.config.method(:"layout_for_#{page}").call
+      if File.exists?("#{settings.views}/../layouts/#{options[:layout]}.haml")
+        options[:layout] = :"../layouts/#{options[:layout]}"
+      else
+        rel_path = Pathname.new(current_dir).relative_path_from(Pathname.new(settings.views))
+        options[:layout] = :"#{rel_path}/layouts/#{options[:layout]}"
+      end
+    else
+      options[:layout] = false
+    end
+    haml page, options
+  end
+
+  configure do
+    FanforceApp.load_config
+    set :haml, {:escape_attrs => false}
+    set :static, true
+    set :protection, :except => [:frame_options, :json_csrf]
+  end
+
+end
+