capistrano-npm 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 03279ddd9f7ac5efad92ec70586f4e1d2a26479d
+  data.tar.gz: d7dd5ac3a5d933c9b9fafb1b66d24442ac447b3f
+SHA512:
+  metadata.gz: a298db70c092b5f5c2769ec4f32492eeb56600b6721caa8769a237c4b63874994f06f00e3792088666d51a42e43d24a7a1f67ed41f75078dcd5b47d41fd03574
+  data.tar.gz: 50fde150def4605b3b9e4afceb15a65e6df600b4f7ae72de71ff36b826bb1bc591c160abc7501b63e7cae27bf05f56edd9f049f110aa7185117ed756ddcd2884

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

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

data/README.md

@@ -0,0 +1,54 @@
+# capistrano-npm
+
+capistrano-npm is a [Capistrano](https://github.com/capistrano/capistrano) extension that will let you run [npm](https://npmjs.org/) during your deploy process.
+
+## Installation
+
+1. Install the Gem
+
+```bash
+gem install capistrano-npm
+```
+
+Or if you're using Bundler, add it to your `Gemfile`:
+
+```ruby
+gem 'capistrano-npm', github: 'swalkinshaw/npm'
+```
+
+2. Add to `Capfile` or `config/deploy.rb`:
+
+```ruby
+require 'capistrano/npm'
+```
+
+## Usage
+
+Add the task to your `deploy.rb`:
+
+```ruby
+after 'deploy:finalize_update', 'npm:install'
+```
+
+### Optimize
+
+Ideally when using npm, you should add `node_modules` to your `.gitignore` file to keep them out of your repository.
+
+Since `npm install` does not guarantee that you will get the same package versions when deploying, you should use `npm shrinkwrap` (https://npmjs.org/doc/shrinkwrap.html) first.
+
+Running `npm shrinkwrap` will created a `npm-shrinkwrap.json` file that locks down the dependency versions. Check this file into your repository.
+
+Now when deploying, `npm install` will detect the `npm-shrinkwrap.json` file and use that to install the packages.
+
+### Tasks
+
+* `npm:install`: Runs `npm install`.
+
+### Dependencies
+
+This extension also adds the `npm` command as a Capistrano dependency. Meaning when you run `cap deploy:check`, it will make sure the `npm` command exists.
+
+### Configuration
+
+* `npm_path`: Path to npm bin on the remote server. Defaults to just `npm` as its assumed to be in your `$PATH`.
+* `npm_options`: Options for `npm` command. Defaults to `--production` to avoid installing dev dependencies.

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/capistrano-npm.gemspec

@@ -0,0 +1,20 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'capistrano/npm/version'
+
+Gem::Specification.new do |s|
+  s.name          = 'capistrano-npm'
+  s.version       = Capistrano::Npm::VERSION
+  s.authors       = ['Scott Walkinshaw']
+  s.email         = ['scott.walkinshaw@gmail.com']
+  s.homepage      = 'https://github.com/swalkinshaw/capistrano-npm'
+  s.summary       = %q{Capistrano extension for npm (Node Packaged Modules)}
+  s.license       = 'MIT'
+
+  s.files         = `git ls-files`.split($/)
+  s.require_paths = %w(lib)
+
+  s.add_dependency 'capistrano', '>= 2.5.5'
+end

data/lib/capistrano/npm.rb

@@ -0,0 +1,13 @@
+Capistrano::Configuration.instance(true).load do
+  set :npm_path,    'npm'
+  set :npm_options, '--production'
+
+  depend :remote, :command, npm_path
+
+  namespace :npm do
+    desc 'Runs npm install.'
+    task :install, :roles => :app, :except => { :no_release => true } do
+      try_sudo "cd #{latest_release} && #{npm_path} #{npm_options} install"
+    end
+  end
+end

data/lib/capistrano/npm/version.rb

@@ -0,0 +1,5 @@
+module Capistrano
+  module Npm
+    VERSION = '0.0.1'
+  end
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification
+name: capistrano-npm
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Scott Walkinshaw
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: capistrano
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 2.5.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 2.5.5
+description: 
+email:
+- scott.walkinshaw@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- capistrano-npm.gemspec
+- lib/capistrano/npm.rb
+- lib/capistrano/npm/version.rb
+homepage: https://github.com/swalkinshaw/capistrano-npm
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.0
+signing_key: 
+specification_version: 4
+summary: Capistrano extension for npm (Node Packaged Modules)
+test_files: []