catapult 0.0.1

data/.gitignore

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

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in catapult.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Alex MacCaw
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,68 @@
+# Catapult
+
+Simple gem that gives pure JavaScript/CoffeeScript projects a basic structure, and manages any necessary compilation and concatenation.
+
+Catapult is especially useful alongside MVC frameworks like [Spine](http://spinejs.com) and [Backbone](http://backbonejs.org).
+
+## Installation
+
+    $ gem install catapult
+
+## Usage
+
+To generate an app, use:
+
+    catapult new myapp
+    cd myapp
+
+Now you can start a catapult server:
+
+    catapult server
+
+Or build the files for deployment:
+
+    catapult build
+
+Or watch the files for changes, and then automatically build:
+
+    catapult watch
+
+## Concatenation
+
+Catapult uses [Sprockets](https://github.com/sstephenson/sprockets) for concatenation. Sprockets uses meta comments to specify dependencies. For example:
+
+    //= require jquery
+    //= require ./other_file
+    //= require_tree ./app
+
+See the Sprockets documentation for more information.
+
+## Included compilers
+
+Sprockets will automatically compile certain file types when the files are first requested. For example, files with `.coffee` extensions will be compiled down to JavaScript before being served up to the end user.
+
+The included Sprockets compilers are: [CoffeeScript](http://coffeescript.org), [sprockets-commonjs](http://github.com/maccman/sprockets-commonjs) and [Stylus](http://learnboost.github.com/stylus/). You can include additional ones by simply adding them to your project's `Gemfile`.
+
+## Deploying to Heroku
+
+It's a good idea to just serve up static files in production, and disable the asset compilation.
+
+If you're using a system like Apache, you can just serve up the static files under the `./public` dir. Otherwise, with a [Rack](http://rack.github.com) based system, like [Heroku](http://heroku.com), you're going to need a few files:
+
+Firstly, a `Gemfile`:
+
+    source 'https://rubygems.org'
+    gem 'catapult'
+
+Then a `config.ru` file, serving up the static files:
+
+    require 'catapult'
+
+    use Catapult::TryStatic,
+        :root => Catapult.root.join('public'),
+        :urls => %w[/],
+        :try  => ['.html', 'index.html', '/index.html']
+
+    run lambda {|env|
+      [404, {}, ['Not found']]
+    }

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/bin/catapult

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'bundler/setup'
+require 'catapult'
+Bundler.require if File.exists?('Gemfile')
+
+begin
+  require 'catapult/cli'
+  Catapult::CLI.start
+rescue Interrupt => e
+  puts "\nQuitting..."
+  exit 1
+rescue SystemExit => e
+  exit e.status
+end

data/catapult.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/catapult/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Alex MacCaw"]
+  gem.email         = ["maccman@gmail.com"]
+  gem.description   = %q{A Sprockets/Rack build tool}
+  gem.summary       = %q{Easily build JavaScript projects}
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "catapult"
+  gem.require_paths = ["lib"]
+  gem.version       = Catapult::VERSION
+
+  gem.add_dependency 'rack', '~> 1.4.1'
+  gem.add_dependency 'sprockets', '~> 2.4.3'
+  gem.add_dependency 'sprockets-commonjs', '= 0.0.6.pre'
+  gem.add_dependency 'listen', '~> 0.4.2'
+  gem.add_dependency 'stylus', '~> 0.6.2'
+  gem.add_dependency 'coffee-script', '~> 2.2.0'
+  gem.add_dependency 'thor', '~> 0.15.2'
+  gem.add_dependency 'thin', '~> 1.3.1'
+end

data/example/assets/javascripts/app.js

@@ -0,0 +1 @@
+//= require_tree .

data/example/assets/stylesheets/app.css

@@ -0,0 +1 @@
+/*= require_tree .*/

data/example/browser.json

@@ -0,0 +1,7 @@
+{
+  "name": "app",
+  "version": "1.0.0",
+  "dependencies": {
+    "jquery": "latest"
+  }
+}

data/example/public/index.html

@@ -0,0 +1,10 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <link rel="stylesheet" href="/assets/app.css" type="text/css">
+  <script src="/assets/app.js"></script>
+</head>
+<body>
+  <p>Hello world!</p>
+</body>
+</html>

data/lib/catapult/cli.rb

@@ -0,0 +1,69 @@
+require 'pathname'
+require 'fileutils'
+require 'listen'
+require 'rack'
+require 'thor'
+
+module Catapult
+  class CLI < Thor
+    include Thor::Actions
+
+    def self.source_root
+      File.expand_path('../../..', __FILE__)
+    end
+
+    desc 'build', 'Build project'
+
+    def build
+      target = Pathname('./public/assets')
+
+      puts "Building: #{Catapult.root}"
+
+      Catapult.environment.each_logical_path do |logical_path|
+        if asset = Catapult.environment.find_asset(logical_path)
+          filename = target.join(logical_path)
+          FileUtils.mkpath(filename.dirname)
+          puts "Write asset: #{filename}"
+          asset.write_to(filename)
+        end
+      end
+    end
+
+    desc 'server', 'Serve up project'
+
+    method_option :port, :aliases => '-p', :desc => 'Port'
+
+    def server
+      if File.exists?('config.ru')
+        Rack::Server.start(
+          :Port => options[:port] || 9292,
+          :config => 'config.ru'
+        )
+      else
+        Rack::Server.start(
+          :Port => options[:port] || 9292,
+          :app  => Catapult.app
+        )
+      end
+    end
+
+    desc 'watch', 'Build project whenever it changes'
+
+    def watch
+      puts "Watching: #{Catapult.root}"
+
+      build
+
+      paths = Catapult.environment.paths
+      paths = paths.select {|p| File.exists?(p) }
+
+      Listen.to(*paths) { build }
+    end
+
+    desc 'new', 'Create a new project'
+
+    def new(name)
+      directory('templates/app', name)
+    end
+  end
+end

data/lib/catapult/try_static.rb

@@ -0,0 +1,36 @@
+module Catapult
+  # The Rack::TryStatic middleware delegates requests to Rack::Static middleware
+  # trying to match a static file
+  #
+  # Examples
+  #
+  # use Rack::TryStatic,
+  #   :root => "public",  # static files root dir
+  #   :urls => %w[/],     # match all requests
+  #   :try => ['.html', 'index.html', '/index.html'] # try these postfixes sequentially
+  #
+  #   uses same options as Rack::Static with extra :try option which is an array
+  #   of postfixes to find desired file
+
+  class TryStatic
+
+    def initialize(app, options)
+      @app    = app
+      @try    = ['', *options[:try]]
+      @static = ::Rack::Static.new(
+        lambda { |_| [404, {}, []] },
+        options
+      )
+    end
+
+    def call(env)
+      orig_path = env['PATH_INFO']
+      found     = nil
+      @try.each do |path|
+        resp = @static.call(env.merge!({'PATH_INFO' => orig_path + path}))
+        break if 404 != resp[0] && found = resp
+      end
+      found or @app.call(env.merge!('PATH_INFO' => orig_path))
+    end
+  end
+end

data/lib/catapult/version.rb

@@ -0,0 +1,3 @@
+module Catapult
+  VERSION = '0.0.1'
+end

data/lib/catapult.rb

@@ -0,0 +1,54 @@
+require 'pathname'
+require 'sprockets'
+require 'sprockets/commonjs'
+require 'stylus/tilt'
+require 'stylus/import_processor'
+require 'coffee_script'
+
+module Catapult
+  autoload :CLI, 'catapult/cli'
+  autoload :TryStatic, 'catapult/try_static'
+
+  def self.root
+    @root ||= Pathname('.').expand_path
+  end
+
+  def self.environment
+    @environment ||= begin
+      env = Sprockets::Environment.new(root)
+
+      env.append_path(root.join('assets', 'javascripts'))
+      env.append_path(root.join('assets', 'stylesheets'))
+      env.append_path(root.join('assets', 'images'))
+
+      env.append_path(root.join('vendor', 'assets', 'javascripts'))
+      env.append_path(root.join('vendor', 'assets', 'stylesheets'))
+
+      env.append_path(root.join('browser_modules'))
+
+      env.register_engine '.styl', Tilt::StylusTemplate
+      env.register_preprocessor 'text/css', Stylus::ImportProcessor
+
+      env
+    end
+  end
+
+  def self.app
+    app = Rack::Builder.new do
+      map '/assets' do
+        run Catapult.environment
+      end
+
+      use Catapult::TryStatic,
+          :root => Catapult.root.join('public'),
+          :urls => %w[/],
+          :try  => ['.html', 'index.html', '/index.html']
+
+      use Rack::ContentType
+
+      run lambda {|env|
+        [404, {}, ['Not found']]
+      }
+    end
+  end
+end

data/templates/app/assets/javascripts/app.js

@@ -0,0 +1 @@
+//= require_tree .

data/templates/app/assets/stylesheets/app.css

@@ -0,0 +1 @@
+/*= require_tree .*/

data/templates/app/browser.json

@@ -0,0 +1,7 @@
+{
+  "name": "app",
+  "version": "1.0.0",
+  "dependencies": {
+    "jquery": "latest"
+  }
+}

data/templates/app/public/index.html

@@ -0,0 +1,10 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <link rel="stylesheet" href="/assets/app.css" type="text/css">
+  <script src="/assets/app.js"></script>
+</head>
+<body>
+  <p>Hello world!</p>
+</body>
+</html>

metadata

@@ -0,0 +1,153 @@
+--- !ruby/object:Gem::Specification
+name: catapult
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Alex MacCaw
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-06-04 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: &70335295156740 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.4.1
+  type: :runtime
+  prerelease: false
+  version_requirements: *70335295156740
+- !ruby/object:Gem::Dependency
+  name: sprockets
+  requirement: &70335295156120 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.4.3
+  type: :runtime
+  prerelease: false
+  version_requirements: *70335295156120
+- !ruby/object:Gem::Dependency
+  name: sprockets-commonjs
+  requirement: &70335295155560 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - =
+      - !ruby/object:Gem::Version
+        version: 0.0.6.pre
+  type: :runtime
+  prerelease: false
+  version_requirements: *70335295155560
+- !ruby/object:Gem::Dependency
+  name: listen
+  requirement: &70335295155000 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.2
+  type: :runtime
+  prerelease: false
+  version_requirements: *70335295155000
+- !ruby/object:Gem::Dependency
+  name: stylus
+  requirement: &70335295154420 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.2
+  type: :runtime
+  prerelease: false
+  version_requirements: *70335295154420
+- !ruby/object:Gem::Dependency
+  name: coffee-script
+  requirement: &70335295153180 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: *70335295153180
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: &70335295151340 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.15.2
+  type: :runtime
+  prerelease: false
+  version_requirements: *70335295151340
+- !ruby/object:Gem::Dependency
+  name: thin
+  requirement: &70335295149900 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.1
+  type: :runtime
+  prerelease: false
+  version_requirements: *70335295149900
+description: A Sprockets/Rack build tool
+email:
+- maccman@gmail.com
+executables:
+- catapult
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/catapult
+- catapult.gemspec
+- example/assets/javascripts/app.js
+- example/assets/stylesheets/app.css
+- example/browser.json
+- example/public/index.html
+- lib/catapult.rb
+- lib/catapult/cli.rb
+- lib/catapult/try_static.rb
+- lib/catapult/version.rb
+- templates/app/assets/javascripts/app.js
+- templates/app/assets/stylesheets/app.css
+- templates/app/browser.json
+- templates/app/public/index.html
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: Easily build JavaScript projects
+test_files: []