bower 0.0.1

data/.gitignore

@@ -0,0 +1,40 @@
+*.gem
+*.rbc
+*.sw[a-p]
+*.tmproj
+*.tmproject
+*.un~
+*~
+.DS_Store
+.Spotlight-V100
+.Trashes
+._*
+.bundle
+.config
+.directory
+.elc
+.emacs.desktop
+.emacs.desktop.lock
+.redcar
+.yardoc
+Desktop.ini
+Gemfile.lock
+Icon?
+InstalledFiles
+Session.vim
+Thumbs.db
+\#*\#
+_yardoc
+auto-save-list
+coverage
+doc
+lib/bundler/man
+pkg
+pkg/*
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+tmtags
+tramp

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format=nested
+--backtrace

data/.travis.yml

@@ -0,0 +1,8 @@
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - jruby
+  - rbx
+  - ree
+  - ruby-head

data/.yardopts

@@ -0,0 +1,3 @@
+--markup markdown
+-
+LICENSE.md

data/Gemfile

@@ -0,0 +1,24 @@
+source 'https://rubygems.org'
+
+gem 'rake'
+gem 'yard'
+gem 'multi_json'
+
+group :development do
+  gem 'kramdown'
+  gem 'guard-rspec'
+end
+
+group :test do
+  gem 'json', :platforms => :ruby_18
+  gem 'rspec-rails'
+  gem 'capybara'
+  gem 'jquery-rails'
+  gem "sprockets", "2.2.2.backport1"
+  gem 'rails', '~> 3.2.12'
+  gem 'sqlite3'
+  gem 'generator_spec'
+  gem 'simplecov', :require => false
+end
+
+gemspec

data/Guardfile

@@ -0,0 +1,6 @@
+guard 'rspec', :version => 2 do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end
+

data/LICENSE.md

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Steve Agalloco
+
+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,65 @@
+# Bower
+
+[Bower](http://twitter.github.com/bower/) integration for your ruby apps.
+
+## Usage with Sprockets
+
+### Rails
+
+Add `bower` to your application's Gemfile:
+
+```ruby
+gem 'bower'
+```
+
+Rails 4 ships with an updated version of Sprockets that supports bower's `component.json` file. If you are running, Rails 3, then you need to require Sprockets [`2.2.2.backport1`](http://rubygems.org/gems/sprockets/versions/2.2.2.backport1):
+
+```ruby
+gem 'sprockets', '2.2.2.backport1'
+```
+
+The gem includes a generator that sets up your project:
+
+    rails generate bower:install
+
+This will install a `.bowerrc` file to your project's root directory that looks like this:
+
+```json
+{
+  "directory"  : "components",
+  "json"       : "components/component.json",
+  "endpoint"   : "https://bower.herokuapp.com",
+  "searchpath" : []
+}
+
+```
+
+Add your dependencies to `components/component.json` then use bower (`bower install`, etc.) as you would in any other project.
+
+### Non-Rails Projects
+
+While offering less capability than when used in Rails' asset pipeline, you can still use the `bower` gem in a non-Rails project. Just require the gem and append the corresponding directory to Sprocket's load path:
+
+```ruby
+require 'sprockets'
+require 'bower'
+
+environment = Sprockets::Environment.new
+environment.append_path Bower.environment.directory
+```
+
+## How this gem differs from other techniques
+
+For Rails apps, integrating bower components into `lib/assets` and/or `vendor/assets` seems like the wrong approach. Since bower can support multiple searchpaths, the need to make a distinction between external dependencies and frameworks does not exist. It can all be managed in once place. This gem takes a more opinionated approach and installs components to `components/` in your project's root by default. You can always change it someplace
+
+## TODO
+
+When used with Sprockets, you still need to use a `require` directive in order to require a component's files. This seems like something that should just work.
+
+## Contributing
+
+Pull requests welcome: fork, make a topic branch, commit (squash when possible) *with tests* and I'll happily consider.
+
+## Copyright
+
+Copyright (c) 2013 Steve Agalloco. See [LICENSE](LICENSE.md) for details.

data/Rakefile

@@ -0,0 +1,17 @@
+#!/usr/bin/env rake
+
+require 'bundler/gem_tasks'
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+task :test => :spec
+
+require 'yard'
+namespace :doc do
+  YARD::Rake::YardocTask.new do |task|
+    task.files   = ['LICENSE.md', 'lib/**/*.rb']
+    task.options = ['--markup', 'markdown']
+  end
+end

data/bower.gemspec

@@ -0,0 +1,21 @@
+# encoding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'bower/version'
+
+Gem::Specification.new do |gem|
+  gem.name        = 'bower'
+  gem.version     = Bower::VERSION
+  gem.homepage    = 'https://github.com/spagalloco/bower'
+
+  gem.author      = "Steve Agalloco"
+  gem.email       = 'steve.agalloco@gmail.com'
+  gem.description = 'Bower integration for your ruby projects.'
+  gem.summary     = 'Bower integration for your ruby projects.'
+
+  gem.executables = `git ls-files -- bin/*`.split("\n").map{|f| File.basename(f)}
+  gem.files       = `git ls-files`.split("\n")
+  gem.test_files  = `git ls-files -- {test,spec,features}/*`.split("\n")
+
+  gem.require_paths = ['lib']
+end

data/lib/bower.rb

@@ -0,0 +1,19 @@
+require 'bower/environment'
+
+module Bower
+  extend self
+
+  def install
+    environment.install
+  end
+
+  def update
+    environment.update
+  end
+
+  def environment
+    @environment ||= Bower::Environment.setup('.bowerrc')
+  end
+
+  require "bower/railtie" if defined?(::Rails)
+end

data/lib/bower/environment.rb

@@ -0,0 +1,43 @@
+require 'multi_json'
+
+module Bower
+  class Environment
+    attr_accessor :directory, :json
+
+    DEFAULT_DIRECTORY = 'components'
+    DEFAULT_JSON      = 'component.json'
+
+    def self.setup(bowerrc=nil)
+      if bowerrc && File.exists?(bowerrc)
+        conf = MultiJson.load(File.open(bowerrc))
+        Environment.new(conf)
+      else
+        Environment.new
+      end
+    end
+
+    def initialize(config={})
+      @directory = config['directory'] || DEFAULT_DIRECTORY
+      @json      = config['json'] || DEFAULT_JSON
+    end
+
+    def install
+      run('bower install')
+    end
+
+    def update
+      run('bower update')
+    end
+
+    private
+
+    def run(cmd)
+      return unless Dir.exists?(directory)
+
+      Dir.chdir(directory) do
+        `#{cmd}` if File.exists?(json)
+      end
+    end
+
+  end
+end

data/lib/bower/railtie.rb

@@ -0,0 +1,10 @@
+require 'bower'
+require 'rails'
+
+module Bower
+  class Railtie < Rails::Railtie
+    initializer 'bower' do |app|
+      app.config.assets.paths << Rails.root.join(Bower.environment.directory)
+    end
+  end
+end

data/lib/bower/version.rb

@@ -0,0 +1,3 @@
+module Bower
+  VERSION = "0.0.1"
+end

data/lib/generators/bower/install_generator.rb

@@ -0,0 +1,23 @@
+require 'securerandom'
+
+module Bower
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("../../templates", __FILE__)
+
+      desc "Creates a Devise initializer and copy locale files to your application."
+
+      def create_components_directory
+        empty_directory 'components/javascripts'
+      end
+
+      def copy_component_json
+        copy_file 'component.json', 'components/javascripts/component.json'
+      end
+
+      def copy_config
+        copy_file "bowerrc", ".bowerrc"
+      end
+    end
+  end
+end

data/lib/generators/templates/bowerrc

@@ -0,0 +1,6 @@
+{
+  "directory"  : "components",
+  "json"       : "components/component.json",
+  "endpoint"   : "https://bower.herokuapp.com",
+  "searchpath" : []
+}

data/lib/generators/templates/component.json

@@ -0,0 +1,17 @@
+// Define your dependencies below, here's an example:
+
+// {
+//   "name": "myProject",
+//   "version": "1.0.0",
+//   "main": "./path/to/main.css",
+//   "dependencies": {
+//     "jquery": "~1.7.2"
+//   }
+// }
+
+{
+  "name": "",
+  "version": "",
+  "main": "",
+  "dependencies": {}
+}

data/spec/bower/environment_spec.rb

@@ -0,0 +1,71 @@
+require 'spec_helper'
+
+describe Bower::Environment do
+  context 'when initializing from a file' do
+    subject { Bower::Environment.setup(File.join(fixture_path, '.bowerrc')) }
+
+    it 'uses the specified directory' do
+      expect(subject.directory).to eq('lib/assets/javascripts')
+    end
+
+    it 'uses the specified json' do
+      expect(subject.json).to eq('bower.json')
+    end
+  end
+
+  context 'defaults' do
+    subject { Bower::Environment.setup }
+
+    it 'uses a default directory' do
+      expect(subject.directory).to eq('components')
+    end
+
+    it 'uses a default json' do
+      expect(subject.json).to eq('component.json')
+    end
+  end
+
+  describe '#install' do
+    subject { Bower::Environment.new }
+
+    it 'invokes "bower update"' do
+      subject.should_receive(:run).with('bower install').and_return(true)
+      subject.install
+    end
+  end
+
+  describe '#update' do
+    subject { Bower::Environment.new }
+
+    it 'invokes "bower update"' do
+      subject.should_receive(:run).with('bower update').and_return(true)
+      subject.update
+    end
+  end
+
+  describe '#run' do
+    subject { Bower::Environment.new }
+    it 'returns nil when the directory does not exist' do
+      Dir.stub(:exists?).and_return(false)
+
+      expect(subject.send(:run, 'bower update')).to be_nil
+    end
+
+    it 'returns nil when the component file does not exist' do
+      Dir.stub(:exists?).with(subject.directory).and_return(true)
+      Dir.should_receive(:chdir).with(subject.directory).and_yield
+      File.stub(:exists?).and_return(false)
+
+      expect(subject.send(:run, 'bower update')).to be_nil
+    end
+
+    it 'invokes the shell command wheh the component file exists' do
+      Dir.stub(:exists?).with(subject.directory).and_return(true)
+      Dir.stub(:chdir).with(subject.directory).and_yield
+      File.stub(:exists?).and_return(true)
+      subject.should_receive(:`).and_return
+
+      expect(subject.send(:run, 'bower update')).to be_nil
+    end
+  end
+end

data/spec/bower_spec.rb

@@ -0,0 +1,25 @@
+require 'spec_helper'
+
+describe Bower do
+
+  describe '.install' do
+    it 'invokes install on the environment' do
+      Bower.environment.should_receive(:install).and_return
+      Bower.install
+    end
+  end
+
+  describe '.update' do
+    it 'invokes update on the environment' do
+      Bower.environment.should_receive(:update).and_return
+      Bower.update
+    end
+  end
+
+  describe '.environment' do
+    it 'returns a Bower::Environment' do
+      Bower.environment.should be_a(Bower::Environment)
+    end
+  end
+
+end