Merge branch 'master' into update-request

Update year to 2017

.appveyor.yml

@@ -1,7 +1,8 @@
-# Thanks for Grunt for template of this file!
-
 # http://www.appveyor.com/docs/appveyor-yml
 
+# Set build version format here instead of in the admin panel.
+version: "{build}"
+
 # Fix line endings in Windows. (runs before repo cloning)
 init:
   - git config --global core.autocrlf input
@@ -11,33 +12,35 @@ environment:
   matrix:
     - nodejs_version: "0.10"
     - nodejs_version: "0.12"
-    - nodejs_version: "5"
     - nodejs_version: "4"
+    - nodejs_version: "6"
+    - nodejs_version: "8"
+    - nodejs_version: "9"
 
-# Allow failing jobs for bleeding-edge Node.js versions.
+# Finish on first failed build
 matrix:
-  allow_failures:
-    - nodejs_version: "0.10"
-    - nodejs_version: "5"
+  fast_finish: true
 
-# Install scripts. (runs after repo cloning)
+# Install node, display versions, install dependencies
 install:
-  # Get the latest stable version of Node 0.STABLE.latest
+  - ps: Install-Product node 8
+  - node --version && npm --version
+  - git --version && svn --version
+  - npm install -g yarn grunt
+  - yarn
   - ps: Install-Product node $env:nodejs_version
-  # Output useful info for debugging.
-  - node --version
-  - npm --version
-  - git --version
-  - svn --version
-  # Install all dependencies
-  - npm install
 
 # Post-install test scripts.
 test_script:
   - cmd: npm run ci
 
-# Don't actually build.
-build: off
+# Make clone much faster
+shallow_clone: true
 
-# Set build version format here instead of in the admin panel.
-version: "{build}"
+# Disable Visual Studio build and deploy
+build: off
+deploy: off
+
+# Cache node modules, and refresh if package.json changes
+cache:
+  - "%LOCALAPPDATA%\\Yarn"

.editorconfig

@@ -15,5 +15,4 @@ trim_trailing_whitespace = false
 insert_final_newline = false
 
 [{package,bower}.json]
-indent_style = space
 indent_size = 2

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,44 @@
+<!--
+
+If you are reporting a new issue, make sure that we do not have any duplicates.
+You can ensure this by searching the issue list for this repository.
+
+You are welcome to open issues to discuss important general topics concerning Bower.
+However for support questions, please consider using http://stackoverflow.com or
+asking for help in our Discord channel: https://discordapp.com/invite/0fFM7QF0KpZaDeN9
+
+# BUG REPORT
+
+Use the commands below to provide key information to reproduce:
+You do NOT have to include this information if this is a FEATURE REQUEST OR DISCUSSION
+
+For more information about reporting bugs, see:
+https://github.com/bower/bower/wiki/Report-a-Bug
+
+-->
+
+**Output of `bower -v && npm -v && node -v`:**
+
+```
+(paste your output here)
+```
+
+**Additional environment details (proxy, private registry, etc.):**
+
+
+
+**Steps to reproduce the issue:**
+
+1.
+2.
+3.
+
+**Describe the results you received:**
+
+
+
+**Describe the results you expected:**
+
+
+
+**Additional information:**

.travis.yml

@@ -1,31 +1,43 @@
 sudo: false
 
+language: node_js
+
+# Use node 8 for build
+node_js:
+  - "8"
+
+# Then test with specific node version
 env:
-  - NODE_VERSION=0.10
-  - NODE_VERSION=0.11
-  - NODE_VERSION=0.12
-  - NODE_VERSION=4.0
-  - NODE_VERSION=5.0
+  - TEST_NODE_VERSION="0.10"
+  - TEST_NODE_VERSION="0.12"
+  - TEST_NODE_VERSION="4"
+  - TEST_NODE_VERSION="6"
+  - TEST_NODE_VERSION="8"
+  - TEST_NODE_VERSION="9"
+
+before_install:
+  - node --version
+  - curl -o- -L https://yarnpkg.com/install.sh | bash -s -- --version 1.5.1
+  - export PATH=$HOME/.yarn/bin:$PATH
+
+cache:
+  yarn: true
 
 install:
-  - test $TRAVIS_OS_NAME = "osx" && brew install nvm && source $(brew --prefix nvm)/nvm.sh || test $TRAVIS_OS_NAME = "linux"
-  - nvm install $NODE_VERSION
-  - npm install -g npm@^2.0.0
-  - node --version
-  - npm --version
-  - git --version
-  - svn --version | head -n 1
-  - npm install -g grunt-cli
-  - npm install
+  - yarn
+  - nvm install $TEST_NODE_VERSION
+  - npm install -g grunt
 
 os:
   - osx
   - linux
 
 matrix:
+  fast_finish: true
   allow_failures:
     - os: osx
-    - env: "NODE_VERSION=0.11"
 
 script:
+  - nvm use $TEST_NODE_VERSION
+  - node --version && npm --version && git --version && svn --version | head -n 1
   - grunt travis

CHANGELOG.md

@@ -1,6 +1,29 @@
 # Changelog
 
-## 1.7.8 - 2016-01-04
+## 1.8.0 - 2016-11-07
+
+- Download tar archives from GitHub when possible (#2263)
+  - Change default shorthand resolver for github from `git://` to `https://`
+- Fix ssl handling by not setting GIT_SSL_NO_VERIFY=false (#2361)
+- Allow for removing components with url instead of name (#2368)
+- Show in warning message location of malformed bower.json (#2357)
+- Improve handling of non-semver versions in git resolver (#2316)
+- Fix handling of cached releases pluginResolverFactory (#2356)
+- Allow to type the entire version when conflict occured (#2243)
+- Allow `owner/reponame` shorthand for registering components (#2248)
+- Allow single-char repo names and package names (#2249)
+- Make `bower version` no longer honor `version` in bower.json (#2232)
+- Add `postinstall` hook (#2252)
+- Allow for `@` instead of `#` for `install` and `info` commands (#2322)
+- Upgrade all bundled modules
+
+## 1.7.9 - 2016-04-05
+
+- Show warnings for invalid bower.json fields
+- Update bower-json
+  - Less strict validation on package name (allow spaces, slashes, and "@")
+
+## 1.7.8 - 2016-04-04
 
 - Don't ask for git credentials in non-interactive session, fixes #956 #1009
 - Prevent swallowing exceptions with programmatic api, fixes #2187
@@ -11,6 +34,8 @@
 - Update opn package to fix issues with "bower open" command on Windows
 - Update bower-config
   - Do not interpolate environment variables in script hooks, fixes bower/config#47
+- Update bower-json
+  - Validate package name more strictly and allow only latin letters, dots, dashes and underscores
 - Add support for "save" and "save-exact" in .bowerrc, #2161
 
 ## 1.7.7 - 2016-01-27
@@ -75,7 +100,7 @@ https://github.com/npm/npm/issues/11227
 - Update bower config
   - Loads the .bowerrc file from the cwd specified on the command line
   - Allow the use of environment variables in .bowerrc ([#41](https://github.com/bower/config/issues/41))
-	- Allow for array notation in ENV variables ([#44](https://github.com/bower/config/issues/44))
+  - Allow for array notation in ENV variables ([#44](https://github.com/bower/config/issues/44))
 
 ## 1.6.9 - 2015-12-04
 

CONTRIBUTING.md

@@ -18,7 +18,7 @@ Bower is a large community project with many different developers contributing a
 
 ## Team Meetings
 
-We communicate through a channel on slack: https://gitter.im/bower
+We communicate through a channel on Discord https://discord.gg/0fFM7QF0KpZRh2cY 
 
 If you'd like to attend the meetings, please fill the [support form](http://goo.gl/forms/P1ndzCNoiG), and you'll get an invite.
 
@@ -29,9 +29,9 @@ The issue tracker is the preferred channel for [bug reports](#bugs),
 requests](#pull-requests), but please respect the following restrictions:
 
 * Please **do not** use the issue tracker for personal support requests. Use
-  [Stack Overflow](http://stackoverflow.com/questions/tagged/bower)
-  [Gitter Channel](https://gitter.im/bower/bower)
-  [Mailing List](http://groups.google.com/group/twitter-bower)
+  [Stack Overflow](http://stackoverflow.com/questions/tagged/bower),
+  [Discord Channel](https://discordapp.com/channels/119103197720739842/123728452816732160),
+  [Mailing List](http://groups.google.com/group/twitter-bower),
   (twitter-bower@googlegroups.com), or
   [#bower](http://webchat.freenode.net/?channels=bower) on Freenode.
 

LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2016 Twitter and other contributors
+Copyright (c) 2013-present Twitter and other contributors
 
 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

README.md

@@ -1,13 +1,14 @@
 # Bower - A package manager for the web
 
-> Bower needs resources for its maintenance. Please fill [this form](https://docs.google.com/forms/d/1i-Opb-uPdqUBBZQSbngv3Y3bfolG1gbBvtRLfxMnzRE/viewform?c=0&w=1) if you think you can help.
+[![Backers on Open Collective](https://opencollective.com/bower/backers/badge.svg)](#backers)
+[![Sponsors on Open Collective](https://opencollective.com/bower/sponsors/badge.svg)](#sponsors)
 
-[![Build Status](https://travis-ci.org/bower/bower.svg?branch=master)](https://travis-ci.org/bower/bower)
-[![Windows Build](https://ci.appveyor.com/api/projects/status/jr6vfra8w84plh2g/branch/master?svg=true)](https://ci.appveyor.com/project/sheerun/bower/history)
+> ..psst! While Bower is maintained, we recommend [yarn](https://yarnpkg.com/) and [webpack](https://webpack.js.org/) for new front-end projects!
+
+[![Unix CI](https://img.shields.io/travis/bower/bower/master.svg?maxAge=2592000)](https://travis-ci.org/bower/bower)
+[![Windows CI](https://img.shields.io/appveyor/ci/bower/bower/master.svg)](https://ci.appveyor.com/project/bower/bower)
 [![Coverage Status](https://img.shields.io/coveralls/bower/bower.svg)](https://coveralls.io/r/bower/bower?branch=master)
 [![Discord chat](https://img.shields.io/badge/discord-join%20chat%20%E2%86%92-brightgreen.svg?style=flat)](https://discord.gg/0fFM7QF0KpZRh2cY)
-[![Issue Stats](http://issuestats.com/github/bower/bower/badge/pr?style=flat)](http://issuestats.com/github/bower/bower)
-[![Issue Stats](http://issuestats.com/github/bower/bower/badge/issue?style=flat)](http://issuestats.com/github/bower/bower)
 
 <img align="right" height="300" src="http://bower.io/img/bower-logo.png">
 
@@ -119,8 +120,81 @@ Note that on Windows for tests to pass you need to configure Git before cloning:
 git config --global core.autocrlf input
 ```
 
+
+## Backers
+
+Support us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/bower#backer)]
+
+<a href="https://opencollective.com/bower/backer/0/website" target="_blank"><img src="https://opencollective.com/bower/backer/0/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/1/website" target="_blank"><img src="https://opencollective.com/bower/backer/1/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/2/website" target="_blank"><img src="https://opencollective.com/bower/backer/2/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/3/website" target="_blank"><img src="https://opencollective.com/bower/backer/3/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/4/website" target="_blank"><img src="https://opencollective.com/bower/backer/4/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/5/website" target="_blank"><img src="https://opencollective.com/bower/backer/5/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/6/website" target="_blank"><img src="https://opencollective.com/bower/backer/6/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/7/website" target="_blank"><img src="https://opencollective.com/bower/backer/7/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/8/website" target="_blank"><img src="https://opencollective.com/bower/backer/8/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/9/website" target="_blank"><img src="https://opencollective.com/bower/backer/9/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/10/website" target="_blank"><img src="https://opencollective.com/bower/backer/10/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/11/website" target="_blank"><img src="https://opencollective.com/bower/backer/11/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/12/website" target="_blank"><img src="https://opencollective.com/bower/backer/12/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/13/website" target="_blank"><img src="https://opencollective.com/bower/backer/13/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/14/website" target="_blank"><img src="https://opencollective.com/bower/backer/14/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/15/website" target="_blank"><img src="https://opencollective.com/bower/backer/15/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/16/website" target="_blank"><img src="https://opencollective.com/bower/backer/16/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/17/website" target="_blank"><img src="https://opencollective.com/bower/backer/17/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/18/website" target="_blank"><img src="https://opencollective.com/bower/backer/18/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/19/website" target="_blank"><img src="https://opencollective.com/bower/backer/19/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/20/website" target="_blank"><img src="https://opencollective.com/bower/backer/20/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/21/website" target="_blank"><img src="https://opencollective.com/bower/backer/21/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/22/website" target="_blank"><img src="https://opencollective.com/bower/backer/22/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/23/website" target="_blank"><img src="https://opencollective.com/bower/backer/23/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/24/website" target="_blank"><img src="https://opencollective.com/bower/backer/24/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/25/website" target="_blank"><img src="https://opencollective.com/bower/backer/25/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/26/website" target="_blank"><img src="https://opencollective.com/bower/backer/26/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/27/website" target="_blank"><img src="https://opencollective.com/bower/backer/27/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/28/website" target="_blank"><img src="https://opencollective.com/bower/backer/28/avatar.svg"></a>
+<a href="https://opencollective.com/bower/backer/29/website" target="_blank"><img src="https://opencollective.com/bower/backer/29/avatar.svg"></a>
+
+
+## Sponsors
+
+Become a sponsor and get your logo on our README on Github with a link to your site. [[Become a sponsor](https://opencollective.com/bower#sponsor)]
+
+<a href="https://opencollective.com/bower/sponsor/0/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/0/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/1/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/1/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/2/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/2/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/3/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/3/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/4/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/4/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/5/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/5/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/6/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/6/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/7/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/7/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/8/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/8/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/9/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/9/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/10/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/10/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/11/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/11/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/12/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/12/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/13/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/13/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/14/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/14/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/15/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/15/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/16/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/16/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/17/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/17/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/18/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/18/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/19/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/19/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/20/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/20/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/21/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/21/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/22/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/22/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/23/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/23/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/24/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/24/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/25/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/25/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/26/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/26/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/27/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/27/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/28/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/28/avatar.svg"></a>
+<a href="https://opencollective.com/bower/sponsor/29/website" target="_blank"><img src="https://opencollective.com/bower/sponsor/29/avatar.svg"></a>
+
+
 ## License
 
-Copyright (c) 2016 Twitter and [other contributors](https://github.com/bower/bower/graphs/contributors)
+Copyright (c) 2012-present Twitter and [other contributors](https://github.com/bower/bower/graphs/contributors)
 
 Licensed under the MIT License

lib/bin/bower.js

@@ -101,7 +101,7 @@ function handleLogger(logger, renderer) {
         }
     })
     .on('error', function (err)  {
-        if (command !== 'help' && err.code === 'EREADOPTIONS') {
+        if (command !== 'help' && (err.code === 'EREADOPTIONS' || err.code === 'EINVFORMAT')) {
             logger = bower.commands.help(command);
             renderer = cli.getRenderer('help', logger.json, bower.config);
             handleLogger(logger, renderer);

lib/commands/info.js

@@ -9,6 +9,12 @@ function info(logger, endpoint, property, config) {
         return;
     }
 
+    // handle @ as version divider
+    var splitParts = endpoint.split('/');
+    splitParts[splitParts.length - 1] = splitParts[splitParts.length - 1].replace('@', '#');
+    endpoint = splitParts.join('/');
+
+
     var repository;
     var decEndpoint;
 
@@ -21,33 +27,33 @@ function info(logger, endpoint, property, config) {
         getPkgMeta(repository, decEndpoint, property),
         decEndpoint.target === '*' && !property ? repository.versions(decEndpoint.source) : null
     ])
-    .spread(function (pkgMeta, versions) {
-        if (versions) {
-            return {
-                name: decEndpoint.source,
-                versions: versions,
-                latest: pkgMeta
-            };
-        }
+        .spread(function (pkgMeta, versions) {
+            if (versions) {
+                return {
+                    name: decEndpoint.source,
+                    versions: versions,
+                    latest: pkgMeta
+                };
+            }
 
-        return pkgMeta;
-    });
+            return pkgMeta;
+        });
 }
 
 function getPkgMeta(repository, decEndpoint, property) {
     return repository.fetch(decEndpoint)
-    .spread(function (canonicalDir, pkgMeta) {
-        pkgMeta = mout.object.filter(pkgMeta, function (value, key) {
-            return key.charAt(0) !== '_';
+        .spread(function (canonicalDir, pkgMeta) {
+            pkgMeta = mout.object.filter(pkgMeta, function (value, key) {
+                return key.charAt(0) !== '_';
+            });
+
+            // Retrieve specific property
+            if (property) {
+                pkgMeta = mout.object.get(pkgMeta, property);
+            }
+
+            return pkgMeta;
         });
-
-        // Retrieve specific property
-        if (property) {
-            pkgMeta = mout.object.get(pkgMeta, property);
-        }
-
-        return pkgMeta;
-    });
 }
 
 // -------------------

lib/commands/install.js

@@ -16,6 +16,12 @@ function install(logger, endpoints, options, config) {
     // Convert endpoints to decomposed endpoints
     endpoints = endpoints || [];
     decEndpoints = endpoints.map(function (endpoint) {
+
+        // handle @ as version divider
+        var splitParts = endpoint.split('/');
+        splitParts[splitParts.length - 1] = splitParts[splitParts.length - 1].replace('@', '#');
+        endpoint = splitParts.join('/');
+
         return endpointParser.decompose(endpoint);
     });
 
@@ -28,11 +34,11 @@ install.readOptions = function (argv) {
     var cli = require('../util/cli');
 
     var options = cli.readOptions({
-        'force-latest': { type: Boolean, shorthand: 'F'},
-        'production': { type: Boolean, shorthand: 'p' },
-        'save': { type: Boolean, shorthand: 'S' },
-        'save-dev': { type: Boolean, shorthand: 'D' },
-        'save-exact': { type: Boolean, shorthand: 'E' }
+        'force-latest': {type: Boolean, shorthand: 'F'},
+        'production': {type: Boolean, shorthand: 'p'},
+        'save': {type: Boolean, shorthand: 'S'},
+        'save-dev': {type: Boolean, shorthand: 'D'},
+        'save-exact': {type: Boolean, shorthand: 'E'}
     }, argv);
 
     var packages = options.argv.remain.slice(1);

lib/commands/lookup.js

@@ -16,7 +16,7 @@ function lookup(logger, name, config) {
     .then(function (entry) {
         return !entry ? null : {
             name: name,
-            url: entry && entry.url
+            url: entry.url
         };
     });
 }

lib/commands/register.js

@@ -4,16 +4,23 @@ var PackageRepository = require('../core/PackageRepository');
 var createError = require('../util/createError');
 var defaultConfig = require('../config');
 
-function register(logger, name, url, config) {
+function register(logger, name, source, config) {
     var repository;
     var registryClient;
     var force;
+    var url;
+    var githubSourceRegex = /^\w[\w-]*\/\w[\w-]*$/;
+    var getGithubUrl = function (source) {
+        return 'git@github.com:' + source + '.git';
+    };
 
     config = defaultConfig(config);
     force = config.force;
 
     name = (name || '').trim();
-    url = (url || '').trim();
+    source = (source || '').trim();
+
+    url = source.match(githubSourceRegex) ? getGithubUrl(source) : source;
 
     // Bypass any cache
     config.offline = false;

lib/commands/version.js

@@ -4,116 +4,149 @@ var fs = require('../util/fs');
 var path = require('path');
 var Q = require('q');
 var execFile = require('child_process').execFile;
-var Project = require('../core/Project');
 var defaultConfig = require('../config');
 var createError = require('../util/createError');
 
 function version(logger, versionArg, options, config) {
-    var project;
-
     options = options || {};
+
     config = defaultConfig(config);
-    project = new Project(config, logger);
 
-    return bump(project, versionArg, options.message);
+    return bump(logger, config, versionArg, options.message);
 }
 
-function bump(project, versionArg, message) {
-    var cwd = project._config.cwd || process.cwd();
+function bump(logger, config, versionArg, message) {
+    var cwd = config.cwd || process.cwd();
     var newVersion;
-    var doGitCommit = false;
 
-    return checkGit(cwd)
-    .then(function (hasGit) {
-        doGitCommit = hasGit;
-    })
-    .then(project.getJson.bind(project))
-    .then(function (json) {
-        newVersion = getNewVersion(json.version, versionArg);
-        json.version = newVersion;
-    })
-    .then(project.saveJson.bind(project))
-    .then(function () {
-        if (doGitCommit) {
-            return gitCommitAndTag(cwd, newVersion, message);
-        }
-    })
-    .then(function () {
-        console.log('v' + newVersion);
-        return newVersion;
-    });
-}
-
-function getNewVersion(currentVersion, versionArg) {
-    var newVersion = semver.valid(versionArg);
-    if (!newVersion) {
-        newVersion = semver.inc(currentVersion, versionArg);
+    if (!versionArg) {
+        throw createError('No <version> agrument provided', 'EREADOPTIONS');
     }
-    if (!newVersion) {
-        throw createError('Invalid version argument: `' + versionArg + '`. Usage: `bower version [<newversion> | major | minor | patch]`', 'EINVALIDVERSION');
-    }
-    if (currentVersion === newVersion) {
-        throw createError('Version not changed', 'EVERSIONNOTCHANGED');
-    }
-    return newVersion;
-}
 
-function checkGit(cwd) {
-    var gitDir = path.join(cwd, '.git');
-    return Q.nfcall(fs.stat, gitDir)
-    .then(function (stat) {
-        if (stat.isDirectory()) {
-            return checkGitStatus(cwd);
+    return driver.check(cwd)
+    .then(function () {
+        return Q.all([driver.versions(cwd), driver.currentVersion(cwd)]);
+    })
+    .spread(function (versions, currentVersion) {
+        currentVersion = currentVersion || '0.0.0';
+
+        if (semver.valid(versionArg)) {
+            newVersion = semver.valid(versionArg);
+        } else {
+            newVersion = semver.inc(currentVersion, versionArg);
+
+            if (!newVersion) {
+                throw createError('Invalid <version> argument: ' + versionArg, 'EINVALIDVERSION', { version: versionArg });
+            }
         }
-        return false;
-    }, function () {
-        //Ignore not found .git directory
-        return false;
-    });
-}
 
-function checkGitStatus(cwd) {
-    return Q.nfcall(which, 'git')
-    .fail(function (err) {
-        err.code = 'ENOGIT';
-        throw err;
-    })
-    .then(function () {
-        return Q.nfcall(execFile, 'git', ['status', '--porcelain'], {env: process.env, cwd: cwd});
-    })
-    .then(function (value) {
-        var stdout = value[0];
-        var lines = filterModifiedStatusLines(stdout);
-        if (lines.length) {
-            throw createError('Git working directory not clean.\n' + lines.join('\n'), 'EWORKINGDIRECTORYDIRTY');
+        newVersion = (currentVersion[0] === 'v') ? 'v' + newVersion : newVersion;
+
+        if (versions) {
+            versions.forEach(function (version) {
+                if (semver.eq(version, newVersion)) {
+                    throw createError('Version exists: ' + newVersion, 'EVERSIONEXISTS', { versions: versions, newVersion: newVersion });
+                }
+            });
         }
-        return true;
-    });
-}
 
-function filterModifiedStatusLines(stdout) {
-    return stdout.trim().split('\n')
-    .filter(function (line) {
-        return line.trim() && !line.match(/^\?\? /);
-    }).map(function (line) {
-        return line.trim();
-    });
-}
-
-function gitCommitAndTag(cwd, newVersion, message) {
-    var tag = 'v' + newVersion;
-    message = message || tag;
-    message = message.replace(/%s/g, newVersion);
-    return Q.nfcall(execFile, 'git', ['add', 'bower.json'], {env: process.env, cwd: cwd})
-    .then(function () {
-        return Q.nfcall(execFile, 'git', ['commit', '-m', message], {env: process.env, cwd: cwd});
+        return driver.bump(cwd, newVersion, message).then(function () {
+            return {
+                oldVersion: currentVersion,
+                newVersion: newVersion
+            }
+        });
     })
-    .then(function () {
-        return Q.nfcall(execFile, 'git', ['tag', tag, '-am', message], {env: process.env, cwd: cwd});
+    .then(function (result) {
+        logger.info('version', 'Bumped package version from ' + result.oldVersion + ' to ' + result.newVersion, result);
+
+        return result.newVersion;
     });
 }
 
-// -------------------
+var driver = {
+    check: function (cwd) {
+        function checkGit(cwd) {
+            var gitDir = path.join(cwd, '.git');
+            return Q.nfcall(fs.stat, gitDir)
+            .then(function (stat) {
+                if (stat.isDirectory()) {
+                    return checkGitStatus(cwd);
+                }
+                return false;
+            }, function () {
+                //Ignore not found .git directory
+                return false;
+            });
+        }
+
+        function checkGitStatus(cwd) {
+            return Q.nfcall(which, 'git')
+            .fail(function (err) {
+                err.code = 'ENOGIT';
+                throw err;
+            })
+            .then(function () {
+                return Q.nfcall(execFile, 'git', ['status', '--porcelain'], {env: process.env, cwd: cwd});
+            })
+            .then(function (value) {
+                var stdout = value[0];
+                var lines = filterModifiedStatusLines(stdout);
+                if (lines.length) {
+                    throw createError('Version bump requires clean working directory', 'EWORKINGDIRECTORYDIRTY');
+                }
+                return true;
+            });
+        }
+
+        function filterModifiedStatusLines(stdout) {
+            return stdout.trim().split('\n')
+            .filter(function (line) {
+                return line.trim() && !line.match(/^\?\? /);
+            }).map(function (line) {
+                return line.trim();
+            });
+        }
+
+        return checkGit(cwd).then(function (hasGit) {
+            if (!hasGit) {
+                throw createError('Version bump currently supports only git repositories', 'ENOTGITREPOSITORY');
+            }
+        });
+    },
+    versions: function (cwd) {
+        return Q.nfcall(execFile, 'git', ['tag'], {env: process.env, cwd: cwd})
+        .then(function (res) {
+            var versions = res[0]
+            .split(/\r?\n/)
+            .filter(semver.valid);
+
+            return versions;
+        }, function () {
+            return [];
+        });
+    },
+    currentVersion: function (cwd) {
+        return Q.nfcall(execFile, 'git', ['describe', '--abbrev=0', '--tags'], {env: process.env, cwd: cwd})
+        .then(function (res) {
+            var version = res[0]
+            .split(/\r?\n/)
+            .filter(semver.valid)[0];
+
+            return version;
+        }, function () {
+            return undefined;
+        });
+    },
+    bump: function (cwd, tag, message) {
+        message = message || tag;
+        message = message.replace(/%s/g, tag);
+        return Q.nfcall(execFile, 'git', ['commit', '-m', message, '--allow-empty'], {env: process.env, cwd: cwd}) .then(function () {
+            return Q.nfcall(execFile, 'git', ['tag', tag, '-am', message], {env: process.env, cwd: cwd});
+        });
+    }
+}
+
 
 version.readOptions = function (argv) {
     var cli = require('../util/cli');

lib/core/Manager.js

@@ -587,6 +587,17 @@ Manager.prototype._dissect = function () {
                 }
             }
 
+            // If they are equal and one of them is an exact target,
+            // give higher priority
+            if (!result) {
+                if (first.target === first.pkgMeta.version) {
+                    return -1;
+                }
+                if (second.target === second.pkgMeta.version) {
+                    return 1;
+                }
+            }
+
             return result;
         });
 
@@ -676,8 +687,9 @@ Manager.prototype._electSuitable = function (name, semvers, nonSemvers) {
     var unresolvable;
     var dataPicks;
     var save;
-    var choices;
     var picks = [];
+    var versionRegex = /(?:[\d\w]\.){2}[\d\w](?:.)*/;
+    var picksReleases;
 
     // If there are both semver and non-semver, there's no way
     // to figure out the suitable one
@@ -832,15 +844,21 @@ Manager.prototype._electSuitable = function (name, semvers, nonSemvers) {
         picks: dataPicks
     });
 
-    choices = picks.map(function (pick, index) { return index + 1; });
+    picksReleases = picks.map(function (pick) { return pick.pkgMeta._release; });
     return Q.nfcall(this._logger.prompt.bind(this._logger), {
         type: 'input',
         message: 'Answer',
         validate: function (choice) {
+            var invalidChoice = 'Invalid choice';
+
+            if (choice.match(versionRegex)) {
+                return picksReleases.indexOf(choice) != -1 ? true : invalidChoice;
+            }
+
             choice = Number(mout.string.trim(choice.trim(), '!'));
 
             if (!choice || choice < 1 || choice > picks.length) {
-                return 'Invalid choice';
+                return invalidChoice;
             }
 
             return true;
@@ -852,8 +870,13 @@ Manager.prototype._electSuitable = function (name, semvers, nonSemvers) {
         // Sanitize choice
         choice = choice.trim();
         save = /^!/.test(choice) || /!$/.test(choice);  // Save if prefixed or suffixed with !
-        choice = Number(mout.string.trim(choice, '!'));
-        pick = picks[choice - 1];
+
+        if (choice.match(versionRegex)) {
+            pick = picks[picksReleases.indexOf(choice)];
+        } else {
+            choice = Number(mout.string.trim(choice, '!'));
+            pick = picks[choice - 1];
+        }
 
         // Save resolution
         if (save) {

lib/core/Project.js

@@ -213,6 +213,20 @@ Project.prototype.update = function (names, options) {
     });
 };
 
+function resolveUrlNames(names, flattened)
+{
+    for (var i = 0; i < names.length; i++)
+        if (! flattened[names[i]])
+    {
+            var url = names[i].trim().replace(/\/$/, '');
+            var packName;
+            for (packName in flattened)
+                if (! ( !flattened[packName].source))
+                    if (url == flattened[packName].source.trim().replace(/\/$/, ''))
+                        names[i] = packName;
+        }
+}
+
 Project.prototype.uninstall = function (names, options) {
     var that = this;
     var packages = {};
@@ -230,6 +244,7 @@ Project.prototype.uninstall = function (names, options) {
     // Fill in the packages to be uninstalled
     .spread(function (json, tree, flattened) {
         var promise = Q.resolve();
+        resolveUrlNames(names, flattened);
 
         names.forEach(function (name) {
             var decEndpoint = flattened[name];
@@ -579,7 +594,7 @@ Project.prototype._readJson = function () {
         return { name: path.basename(that._config.cwd) || 'root' };
     })
     .then(function (defaults) {
-        return that._json = readJson(that._config.cwd, { assume: defaults });
+        return that._json = readJson(that._config.cwd, { assume: defaults, logger: that._logger });
     })
     .spread(function (json, deprecated, assumed) {
         var jsonStr;
@@ -764,6 +779,9 @@ Project.prototype._removePackages = function (packages) {
     .then(function () {
         return that.saveJson();
     })
+    // Run post-uninstall hook before resolving with removed packages.
+    .then(scripts.postuninstall.bind(
+        null, that._config, that._logger, packages, that._installed, that._json))
     // Resolve with removed packages
     .then(function () {
         return mout.object.filter(packages, function (dir) {

lib/core/resolvers/GitHubResolver.js

@@ -29,9 +29,6 @@ function GitHubResolver(decEndpoint, config, logger) {
         this._source += '.git';
     }
 
-    // Check if it's public
-    this._public = mout.string.startsWith(this._source, 'git://');
-
     // Use https:// rather than git:// if on a proxy
     if (this._config.proxy || this._config.httpsProxy) {
         this._source = this._source.replace('git://', 'https://');
@@ -49,14 +46,10 @@ mout.object.mixIn(GitHubResolver, GitRemoteResolver);
 // -----------------
 
 GitHubResolver.prototype._checkout = function () {
-    // Only fully works with public repositories and tags
-    // Could work with https/ssh protocol but not with 100% certainty
-    if (!this._public || !this._resolution.tag) {
-        return GitRemoteResolver.prototype._checkout.call(this);
-    }
-
     var msg;
-    var tarballUrl = 'https://github.com/' + this._org + '/' + this._repo + '/archive/' + this._resolution.tag + '.tar.gz';
+    var name = this._resolution.tag || this._resolution.branch || this._resolution.commit;
+    var tarballUrl = 'https://github.com/' + this._org + '/' + this._repo + '/archive/' + name + '.tar.gz';
+
     var file = path.join(this._tempDir, 'archive.tar.gz');
     var reqHeaders = {};
     var that = this;
@@ -121,7 +114,6 @@ GitHubResolver.prototype._checkout = function () {
 
         return that._cleanTempDir()
         .then(GitRemoteResolver.prototype._checkout.bind(that));
-
     });
 };
 

lib/core/resolvers/GitRemoteResolver.js

@@ -19,14 +19,14 @@ function GitRemoteResolver(decEndpoint, config, logger) {
         this._name = this._name.slice(0, -4);
     }
 
-    // Get the host of this source
+    // Get the remote of this source
     if (!/:\/\//.test(this._source)) {
-        this._host = url.parse('ssh://' + this._source).host;
+        this._remote = url.parse('ssh://' + this._source);
     } else {
-        this._host = url.parse(this._source).host;
+        this._remote = url.parse(this._source);
     }
-
-    this._remote = url.parse(this._source);
+    
+    this._host = this._remote.host;
 
     // Verify whether the server supports shallow cloning
     this._shallowClone = this._supportsShallowCloning;

lib/core/resolvers/GitResolver.js

@@ -26,8 +26,18 @@ function GitResolver(decEndpoint, config, logger) {
     // anyway
     mkdirp.sync(config.storage.empty);
     process.env.GIT_TEMPLATE_DIR = config.storage.empty;
-    process.env.GIT_SSL_NO_VERIFY = (!config.strictSsl).toString();
-    process.env.GIT_TERMINAL_PROMPT = config.interactive ? '1' : '0';
+
+    if (!config.strictSsl) {
+        process.env.GIT_SSL_NO_VERIFY = 'true';
+    }
+
+    if (!config.interactive) {
+        process.env.GIT_TERMINAL_PROMPT = '0';
+
+        if (!process.env.SSH_ASKPASS) {
+            process.env.SSH_ASKPASS = 'echo';
+        }
+    }
 
     Resolver.call(this, decEndpoint, config, logger);
 
@@ -111,8 +121,6 @@ GitResolver.prototype._findResolution = function (target) {
                 version,
                 index;
 
-            versionsArr = versions.map(function (obj) { return obj.version; });
-
             // If there are no tags and target is *,
             // fallback to the latest commit on master
             if (!versions.length && target === '*') {
@@ -206,7 +214,7 @@ GitResolver.prototype._savePkgMeta = function (meta) {
         version = semver.clean(this._resolution.tag);
 
         // Warn if the package meta version is different than the resolved one
-        if (typeof meta.version === 'string' && semver.neq(meta.version, version)) {
+        if (typeof meta.version === 'string' && semver.valid(meta.version) && semver.neq(meta.version, version)) {
             this._logger.warn('mismatch', 'Version declared in the json (' + meta.version + ') is different than the resolved one (' + version + ')', {
                 resolution: this._resolution,
                 pkgMeta: meta

lib/core/resolvers/Resolver.js

@@ -178,7 +178,8 @@ Resolver.prototype._readJson = function (dir) {
 
     dir = dir || this._tempDir;
     return readJson(dir, {
-        assume: { name: this._name }
+        assume: { name: this._name },
+        logger: that._logger
     })
     .spread(function (json, deprecated) {
         if (deprecated) {
@@ -217,15 +218,6 @@ Resolver.prototype._savePkgMeta = function (meta) {
     meta._source = this._source;
     meta._target = this._target;
 
-    ['main', 'ignore'].forEach(function (attr) {
-        if (meta[attr]) return;
-
-        that._logger.log(
-            'warn', 'invalid-meta',
-            (meta.name || 'component') + ' is missing "' + attr + '" entry in bower.json'
-        );
-    });
-
     // Stringify contents
     contents = JSON.stringify(meta, null, 2);
 

lib/core/resolvers/pluginResolverFactory.js

@@ -109,7 +109,7 @@ function pluginResolverFactory(resolverFactory, bower) {
                             throw createError('Resolver did not provide releases of package.');
                         }
 
-                        var releases = this._releases = result;
+                        var releases = that._releases = result;
 
                         var versions = releases.filter(function (target) {
                             return semver.clean(target.version);
@@ -191,7 +191,8 @@ function pluginResolverFactory(resolverFactory, bower) {
         var that = this;
 
         return readJson(dir, {
-            assume: { name: that.getName() }
+            assume: { name: that.getName() },
+            logger: bower.logger
         })
         .spread(function (json, deprecated) {
             if (deprecated) {

lib/core/scripts.js

@@ -89,6 +89,7 @@ var hook = function (action, ordered, config, logger, packages, installed, json)
 
 module.exports = {
     preuninstall: mout.function.partial(hook, 'preuninstall', false),
+    postuninstall: mout.function.partial(hook, 'postuninstall', false),
     preinstall: mout.function.partial(hook, 'preinstall', true),
     postinstall: mout.function.partial(hook, 'postinstall', true),
     //only exposed for test

lib/templates/json/help-lookup.json

@@ -1,6 +1,6 @@
 {
     "command": "lookup",
-    "description": "Looks up a package URL by name.",
+    "description": "Look up a single package URL by name.",
     "usage": [
         "lookup <name> [<options>]"
     ],

lib/templates/json/help-search.json

@@ -1,6 +1,6 @@
 {
     "command": "search",
-    "description": "Finds all packages or a specific package.",
+    "description": "Search for packages by name.",
     "usage": [
         "search <name> [<options>]"
     ],

lib/templates/json/help-version.json

@@ -1,8 +1,8 @@
 {
     "command": "version",
-    "description": "Run this in a package directory to bump the version and write the new data back to the bower.json file.\n\nThe newversion argument should be a valid semver string, or a valid second argument to semver.inc (one of \"build\", \"patch\", \"minor\", or \"major\"). In the second case, the existing version will be incremented\nby 1 in the specified field.\n\nIf run in a git repo, it will also create a version commit and tag, and fail if the repo is not clean.\n\nIf supplied with --message (shorthand: -m) config option, bower will use it as a commit message when creating a version commit. If the message config contains %s then that will be replaced with the resulting\nversion number. For example:\n\n    bower version patch -m \"Upgrade to %s for reasons\"",
+    "description": "Creates an empty version commit and tag, and fail if the repo is not clean.\n\nThe <version> argument should be a valid semver string, or one of following:\nbuild, patch, minor, major.\n\nIf supplied with --message (shorthand: -m) config option, bower will use it\nas a commit message when creating a version commit. If the message config\ncontains %s then that will be replaced with the resulting version number.\n\nFor example:\n\n    bower version patch -m \"Upgrade to %s for reasons\"",
     "usage": [
-        "version [<newversion> | major | minor | patch]"
+        "version [<version> | major | minor | patch]"
     ],
     "options": [
         {

lib/templates/json/help.json

@@ -12,10 +12,10 @@
         "link":            "Symlink a package folder",
         "list":            "List local packages - and possible updates",
         "login":           "Authenticate with GitHub and store credentials",
-        "lookup":          "Look up a package URL by name",
+        "lookup":          "Look up a single package URL by name",
         "prune":           "Removes local extraneous packages",
         "register":        "Register a package",
-        "search":          "Search for a package by name",
+        "search":          "Search for packages by name",
         "update":          "Update a local package",
         "uninstall":       "Remove a local package",
         "unregister":      "Remove a package from the registry",
@@ -69,6 +69,10 @@
         {
             "flag":        "--no-color",
             "description": "Disable colors"
+        },
+        {
+            "flag":        "--config.interactive=false",
+            "description": "Disable prompts"
         }
     ]
 }

lib/templates/std/help-cache.std

@@ -11,7 +11,7 @@ Commands:
 
 {{#condense}}
 {{#each commands}}
-    {{#rpad length="23"}}{{@key}}{{/rpad}} {{.}}
+    {{#rpad minLength="23"}}{{@key}}{{/rpad}} {{.}}
 {{/each}}
 {{/condense}}
-
+{{#rpad minLength="23"}}{{/rpad}}

lib/util/readJson.js

@@ -17,6 +17,16 @@ function readJson(file, options) {
     .spread(function (json, jsonFile) {
         var deprecated;
 
+        if (options.logger) {
+            var issues = bowerJson.getIssues(json);
+            if (issues.warnings.length > 0) {
+                options.logger.warn('invalid-meta', 'for:' + jsonFile);
+            }
+            issues.warnings.forEach(function (warning) {
+                options.logger.warn('invalid-meta', warning);
+            });
+        }
+
         jsonFile = path.basename(jsonFile);
         deprecated = jsonFile === 'component.json' ? jsonFile : false;
 

lib/util/rootCheck.js

@@ -18,7 +18,7 @@ sudo, please spend a few minutes learning more about how your system should work
 make any necessary repairs.\n\n\
 http://www.joyent.com/blog/installing-node-and-npm\n\
 https://gist.github.com/isaacs/579814\n\n\
-You can however run a command with sudo using --allow-root option';
+You can however run a command with sudo using "--allow-root" option';
 
     if (isRoot()) {
         var cli = require('./cli');

package.json

@@ -1,6 +1,6 @@
 {
   "name": "bower",
-  "version": "1.7.8",
+  "version": "1.8.0",
   "description": "The browser package manager",
   "author": "Twitter",
   "license": "MIT",
@@ -17,11 +17,11 @@
   "dependencies": {
     "abbrev": "^1.0.5",
     "archy": "1.0.0",
-    "bower-config": "^1.3.1",
+    "bower-config": "^1.4.1",
     "bower-endpoint-parser": "^0.2.2",
-    "bower-json": "^0.8.0",
+    "bower-json": "^0.8.1",
     "bower-logger": "^0.2.2",
-    "bower-registry-client": "^1.0.0",
+    "bower-registry-client": "^1.0.1",
     "cardinal": "0.4.4",
     "chalk": "^1.0.0",
     "chmodr": "^1.0.2",
@@ -49,7 +49,7 @@
     "p-throttler": "0.1.1",
     "promptly": "0.2.0",
     "q": "^1.1.2",
-    "request": "2.67.0",
+    "request": "2.79.0",
     "request-progress": "0.3.1",
     "requireg": "^0.1.5",
     "resolve": "^1.1.7",
@@ -67,24 +67,24 @@
   },
   "devDependencies": {
     "arr-diff": "^2.0.0",
-    "chai": "^1.10.0",
-    "coveralls": "^2.11.2",
+    "chai": "^3.5.0",
+    "coveralls": "^2.11.9",
     "expect.js": "^0.3.1",
-    "grunt": "1.0.0-rc1",
+    "grunt": "^1.0.1",
     "grunt-cli": "^1.1.0",
     "grunt-contrib-watch": "^1.0.0",
-    "grunt-eslint": "^18.0.0",
-    "grunt-exec": "sheerun/grunt-exec",
+    "grunt-eslint": "^18.1.0",
+    "grunt-exec": "^0.4.7",
     "grunt-simple-mocha": "^0.4.1",
     "in-publish": "^2.0.0",
-    "istanbul": "^0.3.5",
-    "load-grunt-tasks": "^2.0.0",
-    "mocha": "^2.1.0",
+    "istanbul": "^0.4.3",
+    "load-grunt-tasks": "^3.5.0",
+    "mocha": "^2.5.3",
     "multiline": "^1.0.2",
-    "nock": "^3.1.0",
-    "node-uuid": "^1.4.2",
-    "proxyquire": "^1.3.0",
-    "spawn-sync": "1.0.13",
+    "nock": "^9.2.3",
+    "node-uuid": "^1.4.7",
+    "proxyquire": "^1.7.9",
+    "spawn-sync": "1.0.15",
     "wrench": "^1.5.8"
   },
   "scripts": {

packages/bower-config/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false

packages/bower-config/.gitignore

@@ -0,0 +1,7 @@
+node_modules
+npm-debug.log
+
+test/assets/github-test-package
+test/assets/github-test-package-copy
+test/assets/temp
+test/reports

packages/bower-config/.jshintrc

@@ -0,0 +1,61 @@
+{
+    "predef": [
+        "console",
+        "describe",
+        "it",
+        "after",
+        "afterEach",
+        "before",
+        "beforeEach"
+    ],
+
+    "indent": 4,
+    "node": true,
+    "devel": true,
+
+    "bitwise": false,
+    "curly": false,
+    "eqeqeq": true,
+    "forin": false,
+    "immed": true,
+    "latedef": false,
+    "newcap": true,
+    "noarg": true,
+    "noempty": false,
+    "nonew": true,
+    "plusplus": false,
+    "regexp": false,
+    "undef": true,
+    "unused": true,
+    "quotmark": "single",
+    "strict": false,
+    "trailing": true,
+
+    "asi": false,
+    "boss": true,
+    "debug": false,
+    "eqnull": true,
+    "es5": false,
+    "esnext": false,
+    "evil": false,
+    "expr": false,
+    "funcscope": false,
+    "globalstrict": false,
+    "iterator": false,
+    "lastsemic": false,
+    "laxbreak": true,
+    "laxcomma": false,
+    "loopfunc": true,
+    "multistr": false,
+    "onecase": true,
+    "regexdash": false,
+    "scripturl": false,
+    "smarttabs": false,
+    "shadow": false,
+    "sub": false,
+    "supernew": true,
+    "validthis": false,
+
+    "nomen": false,
+    "white": true
+}

packages/bower-config/.travis.yml

@@ -0,0 +1,9 @@
+sudo: false
+language: node_js
+node_js:
+  - '5'
+  - '4'
+  - '0.12'
+  - '0.10'
+script:
+  - grunt travis

packages/bower-config/CHANGELOG.md

@@ -0,0 +1,103 @@
+# Changelog
+
+## 1.4.0
+
+- Change default shorthand resolver from git:// to https://
+
+## 1.3.1
+
+- Ignore hook scripts for environment variable expansion
+
+## 1.3.0 - 2015-12-07
+
+- Allow the use of environment variables in .bowerrc. Fixes [#41](https://github.com/bower/config/issues/41)
+- Loads the .bowerrc file from the cwd specified on the command line. Fixes [bower/bower#1993](https://github.com/bower/bower/issues/1993)
+- Allwow for array notation in ENV variables [#44](https://github.com/bower/config/issues/44)
+
+## 1.2.3 - 2015-11-27
+
+- Restores env variables if they are undefined at the beginning
+- Handles default setting for config.ca. Together with [bower/bower PR #1972](https://github.com/bower/bower/pull/1972), fixes downloading with `strict-ssl` using custom CA
+- Displays an error message if .bowerrc is a directory instead of file. Fixes [bower/bower#2022](https://github.com/bower/bower/issues/2022)
+
+## 1.2.2 - 2015-10-16
+- Fixes registry configurartion expanding [bower/bower#1950](https://github.com/bower/bower/issues/1950)
+
+## 1.2.1 - 2015-10-15
+- Fixes case insenstivity HTTP_PROXY setting issue on Windows
+
+## 1.2.0 - 2015-09-28
+- Prevent defaulting cwd to process.cwd()
+
+## 1.1.2 - 2015-09-27
+- Performs only camel case normalisation before merging
+
+## 1.1.1 - 2015-09-27
+- Fix: Merge extra options after camel-case normalisation, instead of before it
+
+## 1.1.0 - 2015-09-27
+- Allow for overwriting options with .load(overwrites) / .read(cwd, overwrites)
+
+## 1.0.1 - 2015-09-27
+- Update dependencies and relax "mout" version range
+- Most significant changes:
+  - graceful-fs updated from 2.x version to 4.x
+  - osenv updated to from 0.0.x to 0.1.x, [tmp location changed](https://github.com/npm/osenv/commit/d6eddbc026538b09026b1dbd60fbc081a8c67e03)
+
+## 1.0.0 - 2015-09-27
+- Support for no-proxy configuration variable
+- Overwrite HTTP_PROXY, HTTPS_PROXY, and NO_PROXY env variables in load method
+- Normalise paths to certificates with contents of them, [#28](https://github.com/bower/config/pull/28)
+
+## 0.6.1 - 2015-04-1
+- Fixes merging .bowerrc files upward directory tree. [#25](https://github.com/bower/config/issues/25)
+
+## 0.6.0 - 2015-03-30
+- Merge .bowerrc files upward directory tree (fixes [bower/bower#1689](https://github.com/bower/bower/issues/1689)) [#24](https://github.com/bower/config/pull/24)
+- Allow NPM config variables (resolves [bower/bower#1711](https://github.com/bower/bower/issues/1711)) [#23](https://github.com/bower/config/pull/23)
+
+## 0.5.2 - 2014-06-09
+- Fixes downloading of bower modules with ignores when .bowerrc is overridden with a relative tmp path. [#17](https://github.com/bower/config/issues/17) [bower/bower#1299](https://github.com/bower/bower/issues/1299)
+
+## 0.5.1 - 2014-05-21
+- [perf] Uses the same mout version as bower
+- [perf] Uses only relevant parts of mout. Related [bower/bower#1134](https://github.com/bower/bower/pull/1134)
+
+## 0.5.0 - 2013-08-30
+- Adds a DEFAULT_REGISTRY key to the Config class that exposes the bower registry UR. [#6](https://github.com/bower/config/issues/6)
+
+## 0.4.5 - 2013-08-28
+- Fixes crashing when home is not set
+
+## 0.4.4 - 2013-08-21
+- Supports nested environment variables [#8](https://github.com/bower/config/issues/8)
+
+## 0.4.3 - 2013-08-19
+- Improvement in argv.config parsing
+
+## 0.4.2 - 2013-08-18
+- Sets interative to auto
+
+## 0.4.1 - 2013-08-18
+- Generates a fake user instead of using 'unknown'
+
+## 0.4.0 - 2013-08-16
+- Suffixes temp folder with the user and 'bower'
+
+## 0.3.5 - 2013-08-14
+- Casts buffer to string
+
+## 0.3.4 - 2013-08-11
+- Empty .bowerrc files no longer throw an error.
+
+## 0.3.3 - 2013-08-11
+- Changes git folder to empty (was not being used anyway)
+
+## 0.3.2 - 2013-08-07
+- Uses a known user agent by default when a proxy.
+
+## 0.3.1 - 2013-08-06
+- Fixes Typo
+
+## 0.3.0 - 2013-08-06
+- Appends the username when using the temporary folder.

packages/bower-config/Gruntfile.js

@@ -0,0 +1,53 @@
+'use strict';
+module.exports = function (grunt) {
+    require('load-grunt-tasks')(grunt);
+
+    grunt.initConfig({
+        jshint: {
+            options: {
+                jshintrc: '.jshintrc'
+            },
+            files: [
+                'Gruntfile.js',
+                'bin/*',
+                'lib/**/*.js',
+                'test/**/*.js',
+                '!test/assets/**/*',
+                '!test/reports/**/*',
+                '!test/tmp/**/*'
+            ]
+        },
+        simplemocha: {
+            options: {
+                reporter: 'spec',
+                timeout: '10000'
+            },
+            full: {
+                src: ['test/test.js']
+            },
+            short: {
+                options: {
+                    reporter: 'dot'
+                },
+                src: ['test/test.js']
+            }
+        },
+        exec: {
+            cover: {
+                command: 'STRICT_REQUIRE=1 node node_modules/istanbul/lib/cli.js cover --dir ./test/reports node_modules/mocha/bin/_mocha -- --timeout 30000 -R dot test/test.js'
+            },
+            coveralls: {
+                command: 'node node_modules/.bin/coveralls < test/reports/lcov.info'
+            }
+        },
+        watch: {
+            files: ['<%= jshint.files %>'],
+            tasks: ['jshint', 'simplemocha:short']
+        }
+    });
+
+    grunt.registerTask('test', ['jshint', 'simplemocha:full']);
+    grunt.registerTask('cover', 'exec:cover');
+    grunt.registerTask('travis', ['jshint', 'exec:cover', 'exec:coveralls']);
+    grunt.registerTask('default', 'test');
+};

packages/bower-config/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2012 Twitter and other contributors
+
+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.

packages/bower-config/README.md

@@ -0,0 +1,76 @@
+# bower-config [![Build Status](https://secure.travis-ci.org/bower/config.png?branch=master)](http://travis-ci.org/bower/config)[![Coverage Status](https://coveralls.io/repos/bower/config/badge.svg?branch=master&service=github)](https://coveralls.io/github/bower/config?branch=master)
+
+> The Bower config (`.bowerrc`) reader and writer.
+
+[Bower](http://bower.io/) can be configured using JSON in a `.bowerrc` file. For example:
+
+    {
+      "directory": "app/components/",
+      "timeout": 120000,
+      "registry": {
+        "search": [
+          "http://localhost:8000",
+          "https://registry.bower.io"
+        ]
+      }
+    }
+
+View the complete [.bowerrc specification](http://bower.io/docs/config/#bowerrc-specification) on the website for more details. Both the `bower.json` and `.bowerrc` specifications are maintained at [github.com/bower/spec](https://github.com/bower/spec).
+
+## Install
+
+```sh
+$ npm install --save bower-config
+```
+
+
+## Usage
+
+#### .load(overwrites)
+
+Loads the bower configuration from the configuration files.
+
+Configuration is overwritten (after camelcase normalisation) with `overwrites` argument.
+
+This method overwrites following environment variables:
+
+- `HTTP_PROXY` with `proxy` configuration variable
+- `HTTPS_PROXY` with `https-proxy` configuration variable
+- `NO_PROXY` with `no-proxy` configuration variable
+
+It also clears `http_proxy`, `https_proxy`, and `no_proxy` environment variables.
+
+To restore those variables you can use `restore` method.
+
+#### restore()
+
+Restores environment variables overwritten by `.load` method.
+
+#### .toObject()
+
+Returns a deep copy of the underlying configuration object.
+The returned configuration is normalised.
+The object keys will be camelCase.
+
+
+#### #create(cwd)
+
+Obtains a instance where `cwd` is the current working directory (defaults to `process.cwd`);
+
+```js
+var config = require('bower-config').create();
+// You can also specify a working directory
+var config2 = require('bower-config').create('./some/path');
+```
+
+#### #read(cwd, overrides)
+
+Alias for:
+
+```js
+var configObject = (new Config(cwd)).load(overrides).toJson();
+```
+
+## License
+
+Released under the [MIT License](http://www.opensource.org/licenses/mit-license.php).

packages/bower-config/lib/Config.js

@@ -0,0 +1,109 @@
+var lang = require('mout/lang');
+var object = require('mout/object');
+var rc = require('./util/rc');
+var expand = require('./util/expand');
+var EnvProxy = require('./util/proxy');
+var path = require('path');
+var fs = require('fs');
+
+function Config(cwd) {
+    this._cwd = cwd;
+    this._proxy = new EnvProxy();
+    this._config = {};
+}
+
+Config.prototype.load = function (overwrites) {
+    this._config = rc('bower', this._cwd);
+
+    this._config = object.merge(
+      expand(this._config || {}),
+      expand(overwrites || {})
+    );
+
+    this._config = normalise(this._config);
+
+    this._proxy.set(this._config);
+
+    return this;
+};
+
+Config.prototype.restore = function () {
+  this._proxy.restore();
+};
+
+function readCertFile(path) {
+    path = path || '';
+
+    var sep = '-----END CERTIFICATE-----';
+
+    var certificates;
+
+    if (path.indexOf(sep) === -1) {
+        certificates = fs.readFileSync(path, { encoding: 'utf8' });
+    } else {
+        certificates = path;
+    }
+
+    return certificates.
+      split(sep).
+      filter(function(s) { return !s.match(/^\s*$/); }).
+      map(function(s) { return s + sep; });
+}
+
+function loadCAs(caConfig) {
+    // If a ca file path has been specified, expand that here to the file's
+    // contents. As a user can specify these individually, we must load them
+    // one by one.
+    for (var p in caConfig) {
+        if (caConfig.hasOwnProperty(p)) {
+            var prop = caConfig[p];
+            if (Array.isArray(prop)) {
+                caConfig[p] = prop.map(function(s) {
+                    return readCertFile(s);
+                });
+            } else if (prop) {
+                caConfig[p] = readCertFile(prop);
+            }
+        }
+    }
+}
+
+Config.prototype.toObject = function () {
+    return lang.deepClone(this._config);
+};
+
+Config.create = function (cwd) {
+    return new Config(cwd);
+};
+
+Config.read = function (cwd, overrides) {
+    var config = Config.create(cwd);
+    return config.load(overrides).toObject();
+};
+
+function normalise(config) {
+    config = expand(config);
+
+    // Some backwards compatible things..
+    if (config.shorthandResolver) {
+      config.shorthandResolver = config.shorthandResolver
+        .replace(/\{\{\{/g, '{{')
+        .replace(/\}\}\}/g, '}}');
+    }
+
+    // Ensure that every registry endpoint does not end with /
+    config.registry.search = config.registry.search.map(function (url) {
+        return url.replace(/\/+$/, '');
+    });
+    config.registry.register = config.registry.register.replace(/\/+$/, '');
+    config.registry.publish = config.registry.publish.replace(/\/+$/, '');
+    config.tmp = path.resolve(config.tmp);
+
+    loadCAs(config.ca);
+
+    return config;
+}
+
+Config.DEFAULT_REGISTRY = require('./util/defaults').registry;
+
+module.exports = Config;

packages/bower-config/lib/util/defaults.js

@@ -0,0 +1,45 @@
+var path = require('path');
+var paths = require('./paths');
+
+// Guess proxy defined in the env
+var proxy = process.env.HTTP_PROXY
+    || process.env.http_proxy
+    || null;
+
+var httpsProxy = process.env.HTTPS_PROXY
+    || process.env.https_proxy
+    || proxy;
+
+var noProxy = process.env.NO_PROXY
+    || process.env.no_proxy;
+
+// Use a well known user agent (in this case, curl) when using a proxy,
+// to avoid potential filtering on many corporate proxies with blank or unknown agents
+var userAgent = !proxy && !httpsProxy
+    ? 'node/' + process.version + ' ' + process.platform + ' ' + process.arch
+    : 'curl/7.21.4 (universal-apple-darwin11.0) libcurl/7.21.4 OpenSSL/0.9.8r zlib/1.2.5';
+
+var defaults = {
+    'directory': 'bower_components',
+    'registry': 'https://registry.bower.io',
+    'shorthand-resolver': 'https://github.com/{{owner}}/{{package}}.git',
+    'tmp': paths.tmp,
+    'proxy': proxy,
+    'https-proxy': httpsProxy,
+    'no-proxy': noProxy,
+    'timeout': 30000,
+    'ca': { search: [] },
+    'strict-ssl': true,
+    'user-agent': userAgent,
+    'color': true,
+    'interactive': null,
+    'storage': {
+        packages: path.join(paths.cache, 'packages'),
+        links: path.join(paths.data, 'links'),
+        completion: path.join(paths.data, 'completion'),
+        registry: path.join(paths.cache, 'registry'),
+        empty: path.join(paths.data, 'empty')  // Empty dir, used in GIT_TEMPLATE_DIR among others
+    }
+};
+
+module.exports = defaults;

packages/bower-config/lib/util/expand.js

@@ -0,0 +1,132 @@
+var object = require('mout/object');
+var lang = require('mout/lang');
+var string = require('mout/string');
+
+function camelCase(config) {
+    var camelCased = {};
+
+    // Camel case
+    object.forOwn(config, function (value, key) {
+        // Ignore null values
+        if (value == null) {
+            return;
+        }
+
+        key = string.camelCase(key.replace(/_/g, '-'));
+        camelCased[key] = lang.isPlainObject(value) ? camelCase(value) : value;
+    });
+
+    return camelCased;
+}
+
+// Function to replace ${VAR} - style variables
+//  with values set in the environment
+// This function expects to be passed a string
+function doEnvReplaceStr (f) {
+
+  // Un-tildify
+  var untildify = require('untildify');
+  f = untildify(f);
+
+  // replace any ${ENV} values with the appropriate environ.
+  var envExpr = /(\\*)\$\{([^}]+)\}/g;
+  return f.replace(envExpr, function (orig, esc, name) {
+    esc = esc.length && esc.length % 2;
+    if (esc) return orig;
+    if (undefined === process.env[name]) {
+      throw new Error('Environment variable used in .bowerrc is not defined: ' + orig);
+    }
+
+    return process.env[name];
+});
+}
+
+function envReplace(config) {
+    var envReplaced = {};
+    if ( lang.isArray(config) ) {
+        envReplaced = [];
+    }
+
+    object.forOwn(config, function (value, key) {
+
+        // Ignore null values
+        if (value == null) {
+            return;
+        }
+
+        // Ignore 'scripts'
+        // These hooks run within the shell
+        // environment variable expansion is not required
+        if ( key === 'scripts' && lang.isPlainObject(value) ){
+            envReplaced[key] = value;
+            return;
+        }
+
+        // Perform variable replacements based on var type
+        if ( lang.isPlainObject(value) ) {
+            envReplaced[key] = envReplace(value);
+        }
+        else if ( lang.isArray(value) ) {
+            envReplaced[key] = envReplace(value);
+        }
+        else if ( lang.isString(value) ) {
+            envReplaced[key] = doEnvReplaceStr(value);
+        }
+        else {
+            envReplaced[key] = value;
+        }
+    });
+
+    return envReplaced;
+}
+
+function expand(config) {
+    config = camelCase(config);
+    config = envReplace(config);
+
+    if (typeof config.registry === 'string') {
+        config.registry = {
+            default: config.registry,
+            search: [config.registry],
+            register: config.registry,
+            publish: config.registry
+        };
+    } else if (typeof config.registry === 'object') {
+        config.registry.default = config.registry.default || 'https://registry.bower.io';
+
+        config.registry = {
+            default: config.registry.default,
+            search: config.registry.search || config.registry.default,
+            register: config.registry.register || config.registry.default,
+            publish: config.registry.publish || config.registry.default
+        };
+
+        if (config.registry.search && !Array.isArray(config.registry.search)) {
+            config.registry.search = [config.registry.search];
+        }
+    }
+
+    // CA
+    if (typeof config.ca === 'string') {
+        config.ca = {
+            default: config.ca,
+            search: [config.ca],
+            register: config.ca,
+            publish: config.ca
+        };
+    } else if (typeof config.ca === 'object') {
+        if (config.ca.search && !Array.isArray(config.ca.search)) {
+            config.ca.search = [config.ca.search];
+        }
+
+        if (config.ca.default) {
+            config.ca.search = config.ca.search || config.ca.default;
+            config.ca.register = config.ca.register || config.ca.default;
+            config.ca.publish = config.ca.publish || config.ca.default;
+        }
+    }
+
+    return config;
+}
+
+module.exports = expand;

packages/bower-config/lib/util/paths.js

@@ -0,0 +1,44 @@
+var os = require('os');
+var path = require('path');
+var osenv = require('osenv');
+var crypto = require('crypto');
+
+function generateFakeUser() {
+    var uid = process.pid + '-' + Date.now() + '-' + Math.floor(Math.random() * 1000000);
+    return crypto.createHash('md5').update(uid).digest('hex');
+}
+
+// Assume XDG defaults
+// See: http://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html
+var paths = {
+    config: process.env.XDG_CONFIG_HOME,
+    data: process.env.XDG_DATA_HOME,
+    cache: process.env.XDG_CACHE_HOME
+};
+
+// Guess some needed properties based on the user OS
+var user = (osenv.user() || generateFakeUser()).replace(/\\/g, '-');
+var tmp = path.join(os.tmpdir ? os.tmpdir() : os.tmpDir(), user);
+var home = osenv.home();
+var base;
+
+// Fallbacks for windows
+if (process.platform === 'win32') {
+    base = path.resolve(process.env.LOCALAPPDATA || home || tmp);
+    base = path.join(base, 'bower');
+
+    paths.config = paths.config || path.join(base, 'config');
+    paths.data = paths.data || path.join(base, 'data');
+    paths.cache = paths.cache || path.join(base, 'cache');
+// Fallbacks for other operating systems
+} else {
+    base = path.resolve(home || tmp);
+
+    paths.config = paths.config || path.join(base, '.config/bower');
+    paths.data = paths.data || path.join(base, '.local/share/bower');
+    paths.cache = paths.cache || path.join(base, '.cache/bower');
+}
+
+paths.tmp = path.resolve(path.join(tmp, 'bower'));
+
+module.exports = paths;

packages/bower-config/lib/util/proxy.js

@@ -0,0 +1,79 @@
+// EnvProxy uses the proxy vaiables passed to it in set and sets the
+// process.env uppercase proxy variables to them with the ability
+// to restore the original values later
+var EnvProxy = function() {
+  this.restoreFrom = {};
+};
+
+EnvProxy.prototype.set = function (config) {
+  this.config = config;
+
+  // Override environment defaults if proxy config options are set
+  // This will make requests.js follow the proxies in config
+  if (Object.prototype.hasOwnProperty.call(config, 'noProxy')) {
+    this.restoreFrom.NO_PROXY = process.env.NO_PROXY;
+    this.restoreFrom.no_proxy = process.env.no_proxy;
+    delete process.env.no_proxy;
+    process.env.NO_PROXY = config.noProxy;
+  }
+
+  if (Object.prototype.hasOwnProperty.call(config, 'proxy')) {
+    this.restoreFrom.HTTP_PROXY = process.env.HTTP_PROXY;
+    this.restoreFrom.http_proxy = process.env.http_proxy;
+    delete process.env.http_proxy;
+    process.env.HTTP_PROXY = config.proxy;
+  }
+
+  if (Object.prototype.hasOwnProperty.call(config, 'httpsProxy')) {
+    this.restoreFrom.HTTPS_PROXY = process.env.HTTPS_PROXY;
+    this.restoreFrom.https_proxy = process.env.https_proxy;
+    delete process.env.https_proxy;
+    process.env.HTTPS_PROXY = config.httpsProxy;
+  }
+};
+
+EnvProxy.prototype.restore = function () {
+  if (Object.prototype.hasOwnProperty.call(this.config, 'noProxy')) {
+    if (this.restoreFrom.NO_PROXY !== undefined) {
+      process.env.NO_PROXY = this.restoreFrom.NO_PROXY;
+    } else {
+      delete process.env.NO_PROXY;
+    }
+
+    if (this.restoreFrom.no_proxy !== undefined) {
+      process.env.no_proxy = this.restoreFrom.no_proxy;
+    } else {
+      delete process.env.no_proxy;
+    }
+  }
+
+  if (Object.prototype.hasOwnProperty.call(this.config, 'proxy')) {
+    if (this.restoreFrom.HTTP_PROXY !== undefined) {
+      process.env.HTTP_PROXY = this.restoreFrom.HTTP_PROXY;
+    } else {
+      delete process.env.HTTP_PROXY;
+    }
+
+    if (this.restoreFrom.http_proxy !== undefined) {
+      process.env.http_proxy = this.restoreFrom.http_proxy;
+    } else {
+      delete process.env.http_proxy;
+    }
+  }
+
+  if (Object.prototype.hasOwnProperty.call(this.config, 'httpsProxy')) {
+    if (this.restoreFrom.HTTPS_PROXY !== undefined) {
+      process.env.HTTPS_PROXY = this.restoreFrom.HTTPS_PROXY;
+    } else {
+      delete process.env.HTTPS_PROXY;
+    }
+
+    if (this.restoreFrom.https_proxy !== undefined) {
+      process.env.https_proxy = this.restoreFrom.https_proxy;
+    } else {
+      delete process.env.https_proxy;
+    }
+  }
+};
+
+module.exports = EnvProxy;

packages/bower-config/lib/util/rc.js

@@ -0,0 +1,158 @@
+var path = require('path');
+var fs = require('graceful-fs');
+var optimist = require('optimist');
+var osenv = require('osenv');
+var object = require('mout/object');
+var string = require('mout/string');
+var paths = require('./paths');
+var defaults = require('./defaults');
+
+var win = process.platform === 'win32';
+var home = osenv.home();
+
+function rc(name, cwd, argv) {
+    var argvConfig;
+
+    argv = argv || optimist.argv;
+
+    // Parse --config.foo=false
+    argvConfig = object.map(argv.config || {}, function (value) {
+        return value === 'false' ? false : value;
+    });
+
+    // If we have specified a cwd then use this as the base for getting config.
+    cwd = argvConfig.cwd ? argvConfig.cwd : cwd;
+
+    if (cwd) {
+        return object.deepMixIn.apply(null, [
+            {},
+            defaults,
+            { cwd: cwd },
+            win ? {} : json(path.join('/etc', name + 'rc')),
+            !home ? {} : json(path.join(home, '.' + name + 'rc')),
+            json(path.join(paths.config, name + 'rc')),
+            json(find('.' + name + 'rc', cwd)),
+            env('npm_package_config_' + name + '_'),
+            env(name + '_'),
+            argvConfig
+        ]);
+    } else {
+        return object.deepMixIn.apply(null, [
+            {},
+            defaults,
+            win ? {} : json(path.join('/etc', name + 'rc')),
+            !home ? {} : json(path.join(home, '.' + name + 'rc')),
+            json(path.join(paths.config, name + 'rc')),
+            env('npm_package_config_' + name + '_'),
+            env(name + '_'),
+            argvConfig
+        ]);
+    }
+}
+
+function parse(content, file) {
+    var error;
+
+    if (!content.trim().length) {
+        return {};
+    }
+
+    try {
+        return JSON.parse(content);
+    } catch (e) {
+        if (file) {
+            error = new Error('Unable to parse ' + file + ': ' + e.message);
+        } else {
+            error = new Error('Unable to parse rc config: ' + e.message);
+        }
+
+        error.details = content;
+        error.code = 'EMALFORMED';
+        throw error;
+    }
+}
+
+function json(file) {
+    var content = {};
+    if (!Array.isArray(file)) {
+        try {
+            content = fs.readFileSync(file).toString();
+        } catch (err) {
+            return null;
+        }
+
+        return parse(content, file);
+    } else {
+        // This is multiple json files
+        file.forEach(function(filename) {
+            if (fs.statSync(filename).isDirectory()) {
+                var error;
+                error = new Error(filename + ' should not be a directory');
+                error.code = 'EFILEISDIR';
+                throw error;
+            }
+            var json = fs.readFileSync(filename).toString();
+            json = parse(json, filename);
+            content = object.merge(content, json);
+        });
+
+        return content;
+    }
+}
+
+function env(prefix) {
+    var obj = {};
+    var prefixLength = prefix.length;
+
+    prefix = prefix.toLowerCase();
+
+    object.forOwn(process.env, function (value, key) {
+        key = key.toLowerCase();
+
+        if (string.startsWith(key, prefix)) {
+            var parsedKey = key
+                           .substr(prefixLength)
+                           .replace(/__/g, '.')   // __ is used for nesting
+                           .replace(/_/g, '-');   // _ is used as a - separator
+
+            //use a convention patern to accept array from process.env
+            //e.g. export bower_registry__search='["http://abc.com","http://def.com"]'
+            var match = /\[([^\]]*)\]/g.exec(value);
+            var targetValue;
+            if (!match || match.length === 0) {
+                targetValue = value;
+            } else {
+                targetValue = match[1].split(',')
+                    .map(function(m) {
+                        return m.trim();
+                    });
+            }
+            object.set(obj, parsedKey, targetValue);
+        }
+    });
+
+    return obj;
+}
+
+function find(filename, dir) {
+    var files = [];
+
+    var walk = function (filename, dir) {
+        var file = path.join(dir, filename);
+        var parent = path.dirname(dir);
+
+        if (fs.existsSync(file)) {
+            files.push(file);
+        }
+
+        if (parent !== dir) {
+            walk(filename, parent);
+        }
+    };
+
+    walk(filename, dir);
+    files.reverse();
+    return files;
+}
+
+module.exports = rc;

packages/bower-config/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "bower-config",
+  "version": "1.4.0",
+  "description": "The Bower config reader and writer.",
+  "author": "Twitter",
+  "license": "MIT",
+  "repository": "https://github.com/bower/bower/tree/master/packages/bower-config",
+  "main": "lib/Config",
+  "homepage": "http://bower.io",
+  "engines": {
+    "node": ">=0.8.0"
+  },
+  "dependencies": {
+    "graceful-fs": "^4.1.3",
+    "mout": "^1.0.0",
+    "optimist": "^0.6.1",
+    "osenv": "^0.1.3",
+    "untildify": "^2.1.0"
+  },
+  "devDependencies": {
+    "coveralls": "^2.11.4",
+    "expect.js": "^0.3.1",
+    "glob": "^4.5.3",
+    "grunt": "^0.4.5",
+    "grunt-cli": "^0.1.13",
+    "grunt-contrib-jshint": "^0.10.0",
+    "grunt-contrib-watch": "^0.6.1",
+    "grunt-coveralls": "^1.0.0",
+    "grunt-exec": "^0.4.6",
+    "grunt-simple-mocha": "^0.4.0",
+    "istanbul": "^0.4.1",
+    "load-grunt-tasks": "^2.0.0",
+    "mkdirp": "^0.5.0",
+    "mocha": "~1.12.0",
+    "node-uuid": "^1.4.3",
+    "q": "^1.2.0",
+    "rimraf": "^2.3.2"
+  },
+  "scripts": {
+    "test": "grunt test"
+  },
+  "files": [
+    "lib"
+  ]
+}

packages/bower-config/test/assets/custom-ca-embed/.bowerrc

@@ -0,0 +1,3 @@
+{
+    "ca": "Equifax Secure CA\n=================\n-----BEGIN CERTIFICATE-----\nMIIDIDCCAomgAwIBAgIENd70zzANBgkqhkiG9w0BAQUFADBOMQswCQYDVQQGEwJVUzEQMA4GA1UE\nChMHRXF1aWZheDEtMCsGA1UECxMkRXF1aWZheCBTZWN1cmUgQ2VydGlmaWNhdGUgQXV0aG9yaXR5\nMB4XDTk4MDgyMjE2NDE1MVoXDTE4MDgyMjE2NDE1MVowTjELMAkGA1UEBhMCVVMxEDAOBgNVBAoT\nB0VxdWlmYXgxLTArBgNVBAsTJEVxdWlmYXggU2VjdXJlIENlcnRpZmljYXRlIEF1dGhvcml0eTCB\nnzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAwV2xWGcIYu6gmi0fCG2RFGiYCh7+2gRvE4RiIcPR\nfM6fBeC4AfBONOziipUEZKzxa1NfBbPLZ4C/QgKO/t0BCezhABRP/PvwDN1Dulsr4R+AcJkVV5MW\n8Q+XarfCaCMczE1ZMKxRHjuvK9buY0V7xdlfUNLjUA86iOe/FP3gx7kCAwEAAaOCAQkwggEFMHAG\nA1UdHwRpMGcwZaBjoGGkXzBdMQswCQYDVQQGEwJVUzEQMA4GA1UEChMHRXF1aWZheDEtMCsGA1UE\nCxMkRXF1aWZheCBTZWN1cmUgQ2VydGlmaWNhdGUgQXV0aG9yaXR5MQ0wCwYDVQQDEwRDUkwxMBoG\nA1UdEAQTMBGBDzIwMTgwODIyMTY0MTUxWjALBgNVHQ8EBAMCAQYwHwYDVR0jBBgwFoAUSOZo+SvS\nspXXR9gjIBBPM5iQn9QwHQYDVR0OBBYEFEjmaPkr0rKV10fYIyAQTzOYkJ/UMAwGA1UdEwQFMAMB\nAf8wGgYJKoZIhvZ9B0EABA0wCxsFVjMuMGMDAgbAMA0GCSqGSIb3DQEBBQUAA4GBAFjOKer89961\nzgK5F7WF0bnj4JXMJTENAKaSbn+2kmOeUJXRmm/kEd5jhW6Y7qj/WsjTVbJmcVfewCHrPSqnI0kB\nBIZCe/zuf6IWUrVnZ9NA2zsmWLIodz2uFHdh1voqZiegDfqnc1zqcPGUIWVEX/r87yloqaKHee95\n70+sB3c4\n-----END CERTIFICATE-----\n\nGlobalSign Root CA\n==================\n-----BEGIN CERTIFICATE-----\nMIIDdTCCAl2gAwIBAgILBAAAAAABFUtaw5QwDQYJKoZIhvcNAQEFBQAwVzELMAkGA1UEBhMCQkUx\nGTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYtc2ExEDAOBgNVBAsTB1Jvb3QgQ0ExGzAZBgNVBAMTEkds\nb2JhbFNpZ24gUm9vdCBDQTAeFw05ODA5MDExMjAwMDBaFw0yODAxMjgxMjAwMDBaMFcxCzAJBgNV\nBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMRAwDgYDVQQLEwdSb290IENBMRswGQYD\nVQQDExJHbG9iYWxTaWduIFJvb3QgQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDa\nDuaZjc6j40+Kfvvxi4Mla+pIH/EqsLmVEQS98GPR4mdmzxzdzxtIK+6NiY6arymAZavpxy0Sy6sc\nTHAHoT0KMM0VjU/43dSMUBUc71DuxC73/OlS8pF94G3VNTCOXkNz8kHp1Wrjsok6Vjk4bwY8iGlb\nKk3Fp1S4bInMm/k8yuX9ifUSPJJ4ltbcdG6TRGHRjcdGsnUOhugZitVtbNV4FpWi6cgKOOvyJBNP\nc1STE4U6G7weNLWLBYy5d4ux2x8gkasJU26Qzns3dLlwR5EiUWMWea6xrkEmCMgZK9FGqkjWZCrX\ngzT/LCrBbBlDSgeF59N89iFo7+ryUp9/k5DPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV\nHRMBAf8EBTADAQH/MB0GA1UdDgQWBBRge2YaRQ2XyolQL30EzTSo//z9SzANBgkqhkiG9w0BAQUF\nAAOCAQEA1nPnfE920I2/7LqivjTFKDK1fPxsnCwrvQmeU79rXqoRSLblCKOzyj1hTdNGCbM+w6Dj\nY1Ub8rrvrTnhQ7k4o+YviiY776BQVvnGCv04zcQLcFGUl5gE38NflNUVyRRBnMRddWQVDf9VMOyG\nj/8N7yy5Y0b2qvzfvGn9LhJIZJrglfCm7ymPAbEVtQwdpf5pLGkkeB6zpxxxYu7KyJesF12KwvhH\nhm4qxFYxldBniYUr+WymXUadDKqC5JlR3XC321Y9YeRq4VzW9v493kHMB65jUr9TU/Qr6cf9tveC\nX4XSQRjbgbMEHMUfpIBvFSDJ3gyICh3WZlXi/EjJKSZp4A==\n-----END CERTIFICATE-----"
+}

packages/bower-config/test/assets/custom-ca/.bowerrc

@@ -0,0 +1,3 @@
+{
+    "ca": "test/assets/custom-ca/ca-bundle.crt"
+}

packages/bower-config/test/assets/custom-ca/ca-bundle.crt

@@ -0,0 +1,40 @@
+Equifax Secure CA
+=================
+-----BEGIN CERTIFICATE-----
+MIIDIDCCAomgAwIBAgIENd70zzANBgkqhkiG9w0BAQUFADBOMQswCQYDVQQGEwJVUzEQMA4GA1UE
+ChMHRXF1aWZheDEtMCsGA1UECxMkRXF1aWZheCBTZWN1cmUgQ2VydGlmaWNhdGUgQXV0aG9yaXR5
+MB4XDTk4MDgyMjE2NDE1MVoXDTE4MDgyMjE2NDE1MVowTjELMAkGA1UEBhMCVVMxEDAOBgNVBAoT
+B0VxdWlmYXgxLTArBgNVBAsTJEVxdWlmYXggU2VjdXJlIENlcnRpZmljYXRlIEF1dGhvcml0eTCB
+nzANBgkqhkiG9w0BAQEFAAOBjQAwgYkCgYEAwV2xWGcIYu6gmi0fCG2RFGiYCh7+2gRvE4RiIcPR
+fM6fBeC4AfBONOziipUEZKzxa1NfBbPLZ4C/QgKO/t0BCezhABRP/PvwDN1Dulsr4R+AcJkVV5MW
+8Q+XarfCaCMczE1ZMKxRHjuvK9buY0V7xdlfUNLjUA86iOe/FP3gx7kCAwEAAaOCAQkwggEFMHAG
+A1UdHwRpMGcwZaBjoGGkXzBdMQswCQYDVQQGEwJVUzEQMA4GA1UEChMHRXF1aWZheDEtMCsGA1UE
+CxMkRXF1aWZheCBTZWN1cmUgQ2VydGlmaWNhdGUgQXV0aG9yaXR5MQ0wCwYDVQQDEwRDUkwxMBoG
+A1UdEAQTMBGBDzIwMTgwODIyMTY0MTUxWjALBgNVHQ8EBAMCAQYwHwYDVR0jBBgwFoAUSOZo+SvS
+spXXR9gjIBBPM5iQn9QwHQYDVR0OBBYEFEjmaPkr0rKV10fYIyAQTzOYkJ/UMAwGA1UdEwQFMAMB
+Af8wGgYJKoZIhvZ9B0EABA0wCxsFVjMuMGMDAgbAMA0GCSqGSIb3DQEBBQUAA4GBAFjOKer89961
+zgK5F7WF0bnj4JXMJTENAKaSbn+2kmOeUJXRmm/kEd5jhW6Y7qj/WsjTVbJmcVfewCHrPSqnI0kB
+BIZCe/zuf6IWUrVnZ9NA2zsmWLIodz2uFHdh1voqZiegDfqnc1zqcPGUIWVEX/r87yloqaKHee95
+70+sB3c4
+-----END CERTIFICATE-----
+
+GlobalSign Root CA
+==================
+-----BEGIN CERTIFICATE-----
+MIIDdTCCAl2gAwIBAgILBAAAAAABFUtaw5QwDQYJKoZIhvcNAQEFBQAwVzELMAkGA1UEBhMCQkUx
+GTAXBgNVBAoTEEdsb2JhbFNpZ24gbnYtc2ExEDAOBgNVBAsTB1Jvb3QgQ0ExGzAZBgNVBAMTEkds
+b2JhbFNpZ24gUm9vdCBDQTAeFw05ODA5MDExMjAwMDBaFw0yODAxMjgxMjAwMDBaMFcxCzAJBgNV
+BAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMRAwDgYDVQQLEwdSb290IENBMRswGQYD
+VQQDExJHbG9iYWxTaWduIFJvb3QgQ0EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDa
+DuaZjc6j40+Kfvvxi4Mla+pIH/EqsLmVEQS98GPR4mdmzxzdzxtIK+6NiY6arymAZavpxy0Sy6sc
+THAHoT0KMM0VjU/43dSMUBUc71DuxC73/OlS8pF94G3VNTCOXkNz8kHp1Wrjsok6Vjk4bwY8iGlb
+Kk3Fp1S4bInMm/k8yuX9ifUSPJJ4ltbcdG6TRGHRjcdGsnUOhugZitVtbNV4FpWi6cgKOOvyJBNP
+c1STE4U6G7weNLWLBYy5d4ux2x8gkasJU26Qzns3dLlwR5EiUWMWea6xrkEmCMgZK9FGqkjWZCrX
+gzT/LCrBbBlDSgeF59N89iFo7+ryUp9/k5DPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV
+HRMBAf8EBTADAQH/MB0GA1UdDgQWBBRge2YaRQ2XyolQL30EzTSo//z9SzANBgkqhkiG9w0BAQUF
+AAOCAQEA1nPnfE920I2/7LqivjTFKDK1fPxsnCwrvQmeU79rXqoRSLblCKOzyj1hTdNGCbM+w6Dj
+Y1Ub8rrvrTnhQ7k4o+YviiY776BQVvnGCv04zcQLcFGUl5gE38NflNUVyRRBnMRddWQVDf9VMOyG
+j/8N7yy5Y0b2qvzfvGn9LhJIZJrglfCm7ymPAbEVtQwdpf5pLGkkeB6zpxxxYu7KyJesF12KwvhH
+hm4qxFYxldBniYUr+WymXUadDKqC5JlR3XC321Y9YeRq4VzW9v493kHMB65jUr9TU/Qr6cf9tveC
+X4XSQRjbgbMEHMUfpIBvFSDJ3gyICh3WZlXi/EjJKSZp4A==
+-----END CERTIFICATE-----

packages/bower-config/test/assets/env-variables-values/.bowerrc

@@ -0,0 +1,15 @@
+{
+   "scripts" : {
+      "postinstall" : "${_myshellvar}"
+   },
+   "storage" : {
+      "packages" : "${_BOWERRC_MY_PACKAGES}",
+      "registry" : {
+        "register": "~/.bower-test/registry",
+        "search": [
+          "${_BOWERRC_MY_USER}:${_BOWERRC_MY_PASS}"
+        ]
+      }
+   },
+   "tmp" : "${_BOWERRC_MY_TMP}"
+}

packages/bower-config/test/assets/env-variables/.bowerrc

@@ -0,0 +1,5 @@
+{
+  "proxy": "http://HTTP_PROXY",
+  "https-proxy": "http://HTTPS_PROXY",
+  "no-proxy": "google.com"
+}

packages/bower-config/test/helpers.js

@@ -0,0 +1,126 @@
+var Q = require('q');
+var mkdirp = require('mkdirp');
+var rimraf = require('rimraf');
+var uuid = require('node-uuid');
+var object = require('mout/object');
+var fs = require('fs');
+var glob = require('glob');
+var os = require('os');
+var path = require('path');
+
+// For better promise errors
+Q.longStackSupport = true;
+
+var tmpLocation = path.join(
+    os.tmpdir ? os.tmpdir() : os.tmpDir(),
+    'bower-config-tests',
+    uuid.v4().slice(0, 8)
+);
+
+after(function () {
+    rimraf.sync(tmpLocation);
+});
+
+exports.TempDir = (function() {
+    function TempDir (defaults) {
+        this.path = path.join(tmpLocation, uuid.v4());
+        this.defaults = defaults;
+    }
+
+    TempDir.prototype.create = function (files, defaults) {
+        var that = this;
+
+        defaults = defaults || this.defaults || {};
+        files = object.merge(files || {}, defaults);
+
+        this.meta = function(tag) {
+            if (tag) {
+                return files[tag]['bower.json'];
+            } else {
+                return files['bower.json'];
+            }
+        };
+
+        if (files) {
+            object.forOwn(files, function (contents, filepath) {
+                if (typeof contents === 'object') {
+                    contents = JSON.stringify(contents, null, ' ') + '\n';
+                }
+
+                var fullPath = path.join(that.path, filepath);
+                mkdirp.sync(path.dirname(fullPath));
+                fs.writeFileSync(fullPath, contents);
+            });
+        }
+
+        return this;
+    };
+
+    TempDir.prototype.prepare = function (files) {
+        rimraf.sync(this.path);
+        mkdirp.sync(this.path);
+        this.create(files);
+
+        return this;
+    };
+
+    // TODO: Rewrite to synchronous form
+    TempDir.prototype.prepareGit = function (revisions) {
+        var that = this;
+
+        revisions = object.merge(revisions || {}, this.defaults);
+
+        rimraf.sync(that.path);
+
+        mkdirp.sync(that.path);
+
+        var promise = new Q();
+
+        object.forOwn(revisions, function (files, tag) {
+            promise = promise.then(function () {
+                return that.git('init');
+            }).then(function () {
+                that.glob('./!(.git)').map(function (removePath) {
+                    var fullPath = path.join(that.path, removePath);
+
+                    rimraf.sync(fullPath);
+                });
+
+                that.create(files, {});
+            }).then(function () {
+                return that.git('add', '-A');
+            }).then(function () {
+                return that.git('commit', '-m"commit"');
+            }).then(function () {
+                return that.git('tag', tag);
+            });
+        });
+
+        return promise;
+    };
+
+    TempDir.prototype.glob = function (pattern) {
+        return glob.sync(pattern, {
+            cwd: this.path,
+            dot: true
+        });
+    };
+
+    TempDir.prototype.getPath = function (name) {
+        return path.join(this.path, name);
+    };
+
+    TempDir.prototype.read = function (name) {
+        return fs.readFileSync(this.getPath(name), 'utf8');
+    };
+
+    TempDir.prototype.readJson = function (name) {
+        return JSON.parse(this.read(name));
+    };
+
+    TempDir.prototype.exists = function (name) {
+        return fs.existsSync(path.join(this.path, name));
+    };
+
+    return TempDir;
+})();

packages/bower-config/test/test.js

@@ -0,0 +1,248 @@
+var assert = require('assert');
+var path = require('path');
+
+describe('NPM Config on package.json', function () {
+    beforeEach(function () {
+        delete process.env.npm_package_config_bower_directory;
+        delete process.env.npm_package_config_bower_colors;
+        delete process.env.npm_package_config_bower_resolvers;
+    });
+
+    it('defaults registry entries to default registry', function () {
+        var config = require('../lib/Config').read(null, {});
+
+        assert.deepEqual(config.registry, {
+          'default': 'https://registry.bower.io',
+          'search': [
+            'https://registry.bower.io'
+          ],
+          'register': 'https://registry.bower.io',
+          'publish': 'https://registry.bower.io'
+        });
+    });
+
+    it('can change default registry', function () {
+        var config = require('../lib/Config').read(null, { registry: 'https://foobar' });
+
+        assert.deepEqual(config.registry, {
+          'default': 'https://foobar',
+          'search': [
+            'https://foobar',
+          ],
+          'register': 'https://foobar',
+          'publish': 'https://foobar'
+        });
+    });
+
+    it('can override single entries in registry configuration', function () {
+        var config = require('../lib/Config').read(null, { registry: { search: 'https://foobar' } });
+
+        assert.deepEqual(config.registry, {
+          'default': 'https://registry.bower.io',
+          'search': [
+            'https://foobar',
+          ],
+          'register': 'https://registry.bower.io',
+          'publish': 'https://registry.bower.io'
+        });
+    });
+
+    it('can override single entries in registry configuration and defaults', function () {
+        var config = require('../lib/Config').read(null, { registry: { default: 'https://fizfuz', search: 'https://foobar' } });
+
+        assert.deepEqual(config.registry, {
+          'default': 'https://fizfuz',
+          'search': [
+            'https://foobar',
+          ],
+          'register': 'https://fizfuz',
+          'publish': 'https://fizfuz'
+        });
+    });
+
+    it('allows for not providing cwd', function () {
+        var config = require('../lib/Config').read();
+
+        config.tmp = '/foo/bar';
+        config.userAgent = 'firefox';
+        delete config.storage;
+
+        assert.deepEqual(config, {
+          'directory': 'bower_components',
+          'registry': {
+            'default': 'https://registry.bower.io',
+            'search': [
+              'https://registry.bower.io'
+            ],
+            'register': 'https://registry.bower.io',
+            'publish': 'https://registry.bower.io'
+          },
+          'shorthandResolver': 'https://github.com/{{owner}}/{{package}}.git',
+          'tmp': '/foo/bar',
+          'timeout': 30000,
+          'ca': {
+            'search': []
+          },
+          'strictSsl': true,
+          'userAgent': 'firefox',
+          'color': true
+        });
+    });
+
+    function assertCAContents(caData, name) {
+        var r = /-----BEGIN CERTIFICATE-----[a-zA-Z0-9+\/=\n\r]+-----END CERTIFICATE-----/;
+
+        assert(caData, name + ' should be set');
+        assert(Array.isArray(caData), name + ' should be an array');
+        assert.equal(2, caData.length);
+        caData.forEach(function(c, i) {
+            assert(c.match(r),
+                   name + '[' + i + '] should contain a certificate. Given: ' + JSON.stringify(c));
+        });
+    }
+
+    describe('Setting process.env.npm_package_config', function () {
+        process.env.npm_package_config_bower_directory = 'npm-path';
+        process.env.npm_package_config_bower_colors = 'false';
+        process.env.npm_package_config_bower_resolvers = '[foo,bar,baz]';
+
+        var config = require('../lib/Config').read();
+
+        it('should return "npm-path" for "bower_directory"', function () {
+            assert.equal('npm-path', config.directory);
+        });
+        it('should return "false" for "bower_colors"', function () {
+            assert.equal('false', config.colors);
+        });
+        it('should expand array "false" for "bower_resolvers"', function () {
+            assert.deepEqual(['foo', 'bar', 'baz'], config.resolvers);
+        });
+    });
+
+    describe('Specifying custom CA', function() {
+
+        it('should read the CA file', function() {
+            var config = require('../lib/Config')
+                .read(path.resolve('test/assets/custom-ca'));
+
+            ['register', 'publish', 'default'].forEach(function (p) {
+                assertCAContents(config.ca[p], 'config.ca.' + p);
+            });
+
+            assert(Array.isArray(config.ca.search),
+                    'ca property search should be an array');
+
+            config.ca.search.forEach(function(c, i) {
+                assertCAContents(c, 'config.ca.search[' + i + ']');
+            });
+        });
+
+        it('should backward-support certificate inside .bowerrc', function() {
+            var config = require('../lib/Config')
+                .read(path.resolve('test/assets/custom-ca-embed'));
+
+            ['register', 'publish', 'default'].forEach(function (p) {
+                assertCAContents(config.ca[p], 'config.ca.' + p);
+            });
+
+            assert(Array.isArray(config.ca.search),
+                    'ca property search should be an array');
+            config.ca.search.forEach(function(c, i) {
+                assertCAContents(c, 'config.ca.search[' + i + ']');
+            });
+        });
+    });
+
+    describe('setting ENV variables', function () {
+        beforeEach(function () {
+            delete process.env.no_proxy;
+            delete process.env.http_proxy;
+            delete process.env.https_proxy;
+            delete process.env.NO_PROXY;
+            delete process.env.HTTP_PROXY;
+            delete process.env.HTTPS_PROXY;
+        });
+
+        it('sets env variables', function () {
+            require('../lib/Config').read('test/assets/env-variables');
+
+            assert.equal(process.env.HTTP_PROXY, 'http://HTTP_PROXY');
+            assert.equal(process.env.HTTPS_PROXY, 'http://HTTPS_PROXY');
+            assert.equal(process.env.NO_PROXY, 'google.com');
+
+            assert.equal(process.env.http_proxy, undefined);
+            assert.equal(process.env.https_proxy, undefined);
+            assert.equal(process.env.no_proxy, undefined);
+        });
+
+        it('restores env variables', function () {
+            process.env.HTTP_PROXY = 'a';
+            process.env.HTTPS_PROXY = 'b';
+            process.env.NO_PROXY = 'c';
+            process.env.http_proxy = 'd';
+            process.env.https_proxy = 'e';
+            process.env.no_proxy = 'f';
+
+            var config = require('../lib/Config').create('test/assets/env-variables').load();
+            config.restore();
+
+            assert.equal(process.env.HTTP_PROXY, 'a');
+            assert.equal(process.env.HTTPS_PROXY, 'b');
+            assert.equal(process.env.NO_PROXY, 'c');
+
+            assert.equal(process.env.http_proxy, 'd');
+            assert.equal(process.env.https_proxy, 'e');
+            assert.equal(process.env.no_proxy, 'f');
+        });
+
+        it('restores env variables if they are undefined', function () {
+            var config = require('../lib/Config').create('test/assets/env-variables').load();
+            config.restore();
+
+            assert.equal(process.env.HTTP_PROXY, undefined);
+            assert.equal(process.env.HTTPS_PROXY, undefined);
+            assert.equal(process.env.NO_PROXY, undefined);
+
+            assert.equal(process.env.http_proxy, undefined);
+            assert.equal(process.env.https_proxy, undefined);
+            assert.equal(process.env.no_proxy, undefined);
+        });
+
+        it('allows for overriding options', function () {
+            require('../lib/Config').read('test/assets/env-variables', {
+                httpsProxy: 'http://other-proxy.local'
+            });
+
+            assert.equal(process.env.HTTP_PROXY, 'http://HTTP_PROXY');
+            assert.equal(process.env.HTTPS_PROXY, 'http://other-proxy.local');
+        });
+    });
+});
+
+describe('Allow ${ENV} variables in .bowerrc', function() {
+
+    it('sets values from process.env', function() {
+        process.env._BOWERRC_MY_PACKAGES = 'a';
+        process.env._BOWERRC_MY_TMP = '/tmp/b';
+        process.env._BOWERRC_MY_USER = 'username';
+        process.env._BOWERRC_MY_PASS = 'password';
+
+        var config = require('../lib/Config').read('test/assets/env-variables-values');
+        assert.equal('a', config.storage.packages);
+        assert.equal('/tmp/b', config.tmp);
+        assert.equal('username:password', config.storage.registry.search[0]);
+        assert.equal('${_myshellvar}', config.scripts.postinstall);
+    });
+});
+
+describe('untildify paths in .bowerrc', function() {
+
+    it('resolve ~/ in .bowerrc', function() {
+        var config = require('../lib/Config').read('test/assets/env-variables-values');
+        var untildify = require('untildify');
+
+        assert.equal(untildify('~/.bower-test/registry') , config.storage.registry.register);
+    });
+});
+
+require('./util/index');

packages/bower-config/test/util/index.js

@@ -0,0 +1,3 @@
+describe('util', function () {
+    require('./rc');
+});

packages/bower-config/test/util/rc.js

@@ -0,0 +1,84 @@
+var expect = require('expect.js');
+var helpers = require('../helpers');
+
+describe('rc', function() {
+    var tempDir = new helpers.TempDir();
+    var tempDirBowerrc = new helpers.TempDir();
+
+    var rc = require('../../lib/util/rc');
+
+    tempDir.prepare({
+        '.bowerrc': {
+            key: 'value'
+        },
+        'child/.bowerrc': {
+            key2: 'value2'
+        },
+        'child2/.bowerrc': {
+            key: 'valueShouldBeOverwriteParent'
+        },
+        'child3/bower.json': {
+            name: 'without-bowerrc'
+        },
+        'other_dir/.bowerrc': {
+            key: 'othervalue'
+        }
+    });
+
+    tempDirBowerrc.prepare({
+        '.bowerrc/foo': {
+            key: 'bar'
+        }
+
+    });
+
+    it('correctly reads .bowerrc files', function() {
+        var config = rc('bower', tempDir.path);
+
+        expect(config.key).to.eql('value');
+        expect(config.key2).to.eql(undefined);
+    });
+
+    it('correctly reads .bowerrc files from child', function() {
+        var config = rc('bower', tempDir.path + '/child/');
+
+        expect(config.key).to.eql('value');
+        expect(config.key2).to.eql('value2');
+    });
+
+    it('correctly reads .bowerrc files from child2', function() {
+        var config = rc('bower', tempDir.path + '/child2/');
+
+        expect(config.key).to.eql('valueShouldBeOverwriteParent');
+        expect(config.key2).to.eql(undefined);
+    });
+
+    it('correctly reads .bowerrc files from child3', function() {
+        var config = rc('bower', tempDir.path + '/child3/');
+
+        expect(config.key).to.eql('value');
+        expect(config.key2).to.eql(undefined);
+    });
+
+    it('loads the .bowerrc file from the cwd specified on the command line', function(){
+        var argv = {
+            'config': {
+                'cwd': tempDir.path + '/other_dir/'
+            }
+        };
+
+        var config = rc('bower', tempDir.path, argv);
+
+        expect(config.key).to.eql('othervalue');
+
+    });
+
+    it('throws an easy to understand error if .bowerrc is a dir', function() {
+        // Gotta wrap this to catch the error
+        var config = function () {
+            rc('bower', tempDirBowerrc.path);
+        };
+
+        expect(config).to.throwError(/should not be a directory/);
+    });
+});

packages/bower-endpoint-parser/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false

packages/bower-endpoint-parser/.gitignore

@@ -0,0 +1,2 @@
+/node_modules
+/npm-debug.*

packages/bower-endpoint-parser/.jshintrc

@@ -0,0 +1,61 @@
+{
+    "predef": [
+        "console",
+        "describe",
+        "it",
+        "after",
+        "afterEach",
+        "before",
+        "beforeEach"
+    ],
+
+    "indent": 4,
+    "node": true,
+    "devel": true,
+
+    "bitwise": false,
+    "curly": false,
+    "eqeqeq": true,
+    "forin": false,
+    "immed": true,
+    "latedef": false,
+    "newcap": true,
+    "noarg": true,
+    "noempty": false,
+    "nonew": true,
+    "plusplus": false,
+    "regexp": false,
+    "undef": true,
+    "unused": true,
+    "quotmark": "single",
+    "strict": false,
+    "trailing": true,
+    "camelcase": true,
+
+    "asi": false,
+    "boss": true,
+    "debug": false,
+    "eqnull": true,
+    "esnext": false,
+    "evil": false,
+    "expr": true,
+    "funcscope": false,
+    "globalstrict": false,
+    "iterator": false,
+    "lastsemic": false,
+    "laxbreak": true,
+    "laxcomma": false,
+    "loopfunc": true,
+    "multistr": false,
+    "onecase": true,
+    "regexdash": false,
+    "scripturl": false,
+    "smarttabs": false,
+    "shadow": false,
+    "sub": false,
+    "supernew": true,
+    "validthis": false,
+
+    "nomen": false,
+    "white": true
+}

packages/bower-endpoint-parser/.travis.yml

@@ -0,0 +1,4 @@
+language: node_js
+node_js:
+  - "0.10"
+  - "0.8"

packages/bower-endpoint-parser/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2012 Twitter and other contributors
+
+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.

packages/bower-endpoint-parser/README.md

@@ -0,0 +1,102 @@
+# endpoint-parser [![Build Status](https://secure.travis-ci.org/bower/endpoint-parser.png?branch=master)](http://travis-ci.org/bower/endpoint-parser)
+
+Little module that helps with endpoints parsing.
+
+
+## API
+
+### .decompose(endpoint)
+
+Decomposes a endpoint into `name`, `source` and `target`.
+
+```js
+var endpointParser = require('bower-endpoint-parser');
+
+endpointParser.decompose('jquery#~2.0.0');
+// { name: '', source: 'jquery', target: '~2.0.0' }
+
+endpointParser.decompose('backbone=backbone-amd#~1.0.0');
+// { name: 'backbone', source: 'backbone-amd', target: '~1.0.0' }
+
+endpointParser.decompose('http://twitter.github.io/bootstrap/assets/bootstrap.zip');
+// { name: '', source: 'http://twitter.github.io/bootstrap/assets/bootstrap', target: '*' }
+
+endpointParser.decompose('bootstrap=http://twitter.github.io/bootstrap/assets/bootstrap.zip');
+// { name: 'bootstrap', source: 'http://twitter.github.io/bootstrap/assets/bootstrap', target: '*' }
+```
+
+### .compose(decEndpoint)
+
+Inverse of `decompose()`.   
+Takes a decomposed endpoint and composes it back into a string.
+
+```js
+var endpointParser = require('bower-endpoint-parser');
+
+endpointParser.compose({ name: '', source: 'jquery', target: '~2.0.0' });
+// jquery#~2.0.0
+
+endpointParser.compose({ name: 'backbone', source: 'backbone-amd', target: '~1.0.0' });
+// backbone=backbone-amd#~1.0.0
+
+endpointParser.compose({ name: '', source: 'http://twitter.github.io/bootstrap/assets/bootstrap', target: '*' });
+// http://twitter.github.io/bootstrap/assets/bootstrap.zip
+
+endpointParser.compose({ name: 'bootstrap', source: 'http://twitter.github.io/bootstrap/assets/bootstrap', target: '*' });
+// bootstrap=http://twitter.github.io/bootstrap/assets/bootstrap.zip
+```
+
+### .json2decomposed(key, value)
+
+Similar to `decompose()` but specially designed to be used when parsing `bower.json` dependencies.
+For instance, in a `bower.json` like this:
+
+```js
+{
+    "name": "foo",
+    "version": "0.1.0",
+    "dependencies": {
+        "jquery": "~1.9.1",
+        "backbone": "backbone-amd#~1.0.0",
+        "bootstrap": "http://twitter.github.io/bootstrap/assets/bootstrap"
+    }
+}
+```
+
+You would call `json2decomposed` like so:
+
+```js
+endpointParser.json2decomposed('jquery', '~1.9.1');
+// { name: 'jquery', source: 'jquery', target: '~1.9.1' }
+
+endpointParser.json2decomposed('backbone', 'backbone-amd#~1.0.0');
+// { name: 'backbone', source: 'backbone-amd', target: '~1.0.0' }
+
+endpointParser.json2decomposed('bootstrap', 'http://twitter.github.io/bootstrap/assets/bootstrap');
+// { name: 'bootstrap', source: 'http://twitter.github.io/bootstrap/assets/bootstrap', target: '*' }
+```
+
+### .decomposed2json(decEndpoint)
+
+Inverse of `json2decomposed()`.   
+Takes a decomposed endpoint and composes it to be saved to `bower.json`.
+
+```js
+var endpointParser = require('bower-endpoint-parser');
+
+endpointParser.decomposed2json({ name: 'jquery', source: 'jquery', target: '~2.0.0' });
+// { jquery: '~2.0.0' }
+
+endpointParser.decomposed2json({ name: 'backbone', source: 'backbone-amd', target: '~1.0.0' });
+// { backbone: 'backbone-amd#~2.0.0' }
+
+endpointParser.decomposed2json({ name: 'bootstrap', source: 'http://twitter.github.io/bootstrap/assets/bootstrap', target: '*' });
+// { bootstrap: 'http://twitter.github.io/bootstrap/assets/bootstrap' }
+```
+
+This function throws an exception if the `name` from the decomposed endpoint is empty.
+
+
+## License
+
+Released under the [MIT License](http://www.opensource.org/licenses/mit-license.php).

packages/bower-endpoint-parser/index.js

@@ -0,0 +1,128 @@
+function decompose(endpoint) {
+    // Note that we allow spaces in targets and sources but they are trimmed
+    var regExp = /^(?:([\w\-]|(?:[\w\.\-]+[\w\-])?)=)?([^\|#]+)(?:#(.*))?$/;
+    var matches = endpoint.match(regExp);
+    var target;
+    var error;
+
+    if (!matches) {
+        error = new Error('Invalid endpoint: ' + endpoint);
+        error.code = 'EINVEND';
+        throw error;
+    }
+
+    target = trim(matches[3]);
+
+    return {
+        name: trim(matches[1]),
+        source: trim(matches[2]),
+        target: isWildcard(target) ? '*' : target
+    };
+}
+
+function compose(decEndpoint) {
+    var name = trim(decEndpoint.name);
+    var source = trim(decEndpoint.source);
+    var target = trim(decEndpoint.target);
+    var composed = '';
+
+    if (name) {
+        composed += name + '=';
+    }
+
+    composed += source;
+
+    if (!isWildcard(target)) {
+        composed += '#' + target;
+    }
+
+    return composed;
+}
+
+function json2decomposed(key, value) {
+    var endpoint;
+    var split;
+    var error;
+
+    key = trim(key);
+    value = trim(value);
+
+    if (!key) {
+        error = new Error('The key must be specified');
+        error.code = 'EINVEND';
+        throw error;
+    }
+
+    endpoint = key + '=';
+    split = value.split('#').map(trim);
+
+    // If # was found, the source was specified
+    if (split.length > 1) {
+        endpoint += (split[0] || key) + '#' + split[1];
+    // Check if value looks like a source
+    } else if (isSource(value)) {
+        endpoint += value + '#*';
+    // Otherwise use the key as the source
+    } else {
+        endpoint += key + '#' + split[0];
+    }
+
+    return decompose(endpoint);
+}
+
+function decomposed2json(decEndpoint) {
+    var error;
+    var name = trim(decEndpoint.name);
+    var source = trim(decEndpoint.source);
+    var target = trim(decEndpoint.target);
+    var value = '';
+    var ret = {};
+
+    if (!name) {
+        error = new Error('Decomposed endpoint must have a name');
+        error.code = 'EINVEND';
+        throw error;
+    }
+
+    // Add source only if different than the name
+    if  (source !== name) {
+        value += source;
+    }
+
+    // If value is empty, we append the target always
+    if (!value) {
+        if (isWildcard(target)) {
+            value += '*';
+        } else {
+            if (target.indexOf('/') !== -1) {
+                value += '#' + target;
+            } else {
+                value += target;
+            }
+        }
+    // Otherwise append only if not a wildcard or source does not look like a source
+    } else if (!isWildcard(target) || !isSource(source)) {
+        value += '#' + (target || '*');
+    }
+
+    ret[name] = value;
+
+    return ret;
+}
+
+function trim(str) {
+    return str ? str.trim() : '';
+}
+
+function isWildcard(target) {
+    return !target || target === '*' || target === 'latest';
+}
+
+function isSource(value) {
+    return (/[\/\\@]/).test(value);
+}
+
+module.exports.decompose = decompose;
+module.exports.compose = compose;
+module.exports.json2decomposed = json2decomposed;
+module.exports.decomposed2json = decomposed2json;

packages/bower-endpoint-parser/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "bower-endpoint-parser",
+  "version": "0.2.2",
+  "description": "Little module that helps with endpoints parsing.",
+  "author": "Twitter",
+  "licenses": [
+    {
+      "type": "MIT",
+      "url": "https://github.com/bower/endpoint-parser/blob/master/LICENSE"
+    }
+  ],
+  "repository": "https://github.com/bower/bower/tree/master/packages/bower-endpoint-parser",
+  "main": "index.js",
+  "engines": {
+    "node": ">=0.8.0"
+  },
+  "devDependencies": {
+    "expect.js": "~0.2.0",
+    "mocha": "~1.12.0",
+    "mout": "~0.9.0"
+  },
+  "scripts": {
+    "test": "mocha -R spec"
+  }
+}

packages/bower-endpoint-parser/test/test.js

@@ -0,0 +1,263 @@
+var expect = require('expect.js');
+var lang = require('mout/lang');
+var object = require('mout/object');
+var endpointParser = require('../');
+
+describe('endpoint-parser', function () {
+    describe('.decompose', function () {
+        it('should decompose endpoints correctly', function () {
+            var suite = {
+                'jquery#~2.0.0': { name: '', source: 'jquery', target: '~2.0.0' },
+                'jquery#*': { name: '', source: 'jquery', target: '*' },
+                'jquery#latest': { name: '', source: 'jquery', target: '*' },
+                'jquery#3dc50c62fe2d2d01afc58e7ad42236a35acff4d8': { name: '', source: 'jquery', target: '3dc50c62fe2d2d01afc58e7ad42236a35acff4d8' },
+                'jquery#master': { name: '', source: 'jquery', target: 'master' },
+                'backbone=backbone-amd#~1.0.0': { name: 'backbone', source: 'backbone-amd', target: '~1.0.0' },
+                'backbone=backbone-amd#latest': { name: 'backbone', source: 'backbone-amd', target: '*' },
+                'backbone=backbone-amd#*': { name: 'backbone', source: 'backbone-amd', target: '*' },
+                'http://twitter.github.io/bootstrap/assets/bootstrap.zip': { name: '', source: 'http://twitter.github.io/bootstrap/assets/bootstrap.zip', target: '*' },
+                'bootstrap=http://twitter.github.io/bootstrap/assets/bootstrap.zip': { name: 'bootstrap', source: 'http://twitter.github.io/bootstrap/assets/bootstrap.zip', target: '*' },
+                'bootstrap=http://twitter.github.io/bootstrap/assets/bootstrap.zip#latest': { name: 'bootstrap', source: 'http://twitter.github.io/bootstrap/assets/bootstrap.zip', target: '*' }
+            };
+
+            object.forOwn(suite, function (decEndpoint, endpoint) {
+                expect(endpointParser.decompose(endpoint)).to.eql(decEndpoint);
+            });
+        });
+
+        it('should trim sources and targets', function () {
+            var decEndpoint = endpointParser.decompose('foo= source # ~1.0.2 ');
+            expect(decEndpoint.source).to.equal('source');
+            expect(decEndpoint.target).to.equal('~1.0.2');
+
+            decEndpoint = endpointParser.decompose('foo= source # latest');
+            expect(decEndpoint.source).to.equal('source');
+            expect(decEndpoint.target).to.equal('*');
+
+            decEndpoint = endpointParser.decompose('foo= source # *');
+            expect(decEndpoint.source).to.equal('source');
+            expect(decEndpoint.target).to.equal('*');
+        });
+    });
+
+    describe('.compose', function () {
+        it('should compose endpoints correctly', function () {
+            var suite = {
+                'jquery#~2.0.0': { name: '', source: 'jquery', target: '~2.0.0' },
+                'jquery': [{ name: '', source: 'jquery', target: '*' }, { name: '', source: 'jquery', target: 'latest' }, { name: '', source: 'jquery', target: '' }],
+                'jquery#3dc50c62fe2d2d01afc58e7ad42236a35acff4d8': { name: '', source: 'jquery', target: '3dc50c62fe2d2d01afc58e7ad42236a35acff4d8' },
+                'jquery#master': { name: '', source: 'jquery', target: 'master' },
+                'backbone=backbone-amd#~1.0.0': { name: 'backbone', source: 'backbone-amd', target: '~1.0.0' },
+                'backbone=backbone-amd': [{ name: 'backbone', source: 'backbone-amd', target: '*' }, { name: 'backbone', source: 'backbone-amd', target: '*' }, { name: 'backbone', source: 'backbone-amd', target: '' }],
+                'http://twitter.github.io/bootstrap/assets/bootstrap.zip': { name: '', source: 'http://twitter.github.io/bootstrap/assets/bootstrap.zip', target: '*' },
+                'bootstrap=http://twitter.github.io/bootstrap/assets/bootstrap.zip': { name: 'bootstrap', source: 'http://twitter.github.io/bootstrap/assets/bootstrap.zip', target: '*' }
+            };
+
+            object.forOwn(suite, function (decEndpoints, endpoint) {
+                decEndpoints = lang.toArray(decEndpoints);
+                decEndpoints.forEach(function (decEndpoint) {
+                    expect(endpointParser.compose(decEndpoint)).to.equal(endpoint);
+                });
+            });
+        });
+
+        it('should trim values', function () {
+            expect(endpointParser.compose({
+                name: ' foo ',
+                source: ' bar ',
+                target: ' ~1.0.2 '
+            })).to.equal('foo=bar#~1.0.2');
+
+            expect(endpointParser.compose({
+                name: ' foo ',
+                source: ' foo ',
+                target: ' ~1.0.2 '
+            })).to.equal('foo=foo#~1.0.2');
+
+            expect(endpointParser.compose({
+                name: ' foo ',
+                source: ' foo ',
+                target: ' * '
+            })).to.equal('foo=foo');
+
+            expect(endpointParser.compose({
+                name: ' foo ',
+                source: ' foo ',
+                target: ' * '
+            })).to.equal('foo=foo');
+
+            expect(endpointParser.compose({
+                name: ' ',
+                source: ' foo ',
+                target: ''
+            })).to.equal('foo');
+        });
+    });
+
+    describe('.json2decomposed', function () {
+        var expected = [
+            { name: 'jquery', source: 'jquery', target: '~1.9.1' },
+            { name: 'foo', source: 'foo', target: '*' },
+            { name: 'bar', source: 'bar', target: '*' },
+            { name: 'baz', source: 'baz', target: '~0.2.0' },
+            { name: 'backbone', source: 'backbone-amd', target: '~1.0.0' },
+            { name: 'backbone2', source: 'backbone=backbone-amd', target: '~1.0.0' },
+            { name: 'bootstrap', source: 'http://twitter.github.io/bootstrap/assets/bootstrap', target: '*' },
+            { name: 'bootstrap2', source: 'http://twitter.github.io/bootstrap/assets/bootstrap', target: '*' },
+            { name: 'ssh', source: 'git@example.com', target: '*' },
+            { name: 'git', source: 'git://example.com', target: '*' },
+            { name: 'path', source: '/foo', target: '*' },
+            { name: 'winpath', source: 'c:\\foo', target: '*' }
+        ];
+
+        it('should decompose json endpoints correctly', function () {
+            var dependencies = {
+                jquery: '~1.9.1',
+                foo: 'latest',
+                bar: '*',
+                baz: '#~0.2.0',
+                backbone: 'backbone-amd#~1.0.0',
+                backbone2: 'backbone=backbone-amd#~1.0.0',
+                bootstrap: 'http://twitter.github.io/bootstrap/assets/bootstrap',
+                bootstrap2: 'http://twitter.github.io/bootstrap/assets/bootstrap#*',
+                ssh: 'git@example.com',
+                git: 'git://example.com',
+                path: '/foo',
+                winpath: 'c:\\foo'
+            };
+            var x = 0;
+
+            object.forOwn(dependencies, function (value, key) {
+                expect(endpointParser.json2decomposed(key, value)).to.eql(expected[x]);
+                x += 1;
+            });
+        });
+
+        it('should trim values', function () {
+            var dependencies = {
+                ' jquery ': ' ~1.9.1 ',
+                ' foo ': ' latest ',
+                ' bar ': ' * ',
+                ' baz ': '# ~0.2.0 ',
+                ' backbone ': ' backbone-amd#~1.0.0 ',
+                ' backbone2 ': ' backbone=backbone-amd # ~1.0.0 ',
+                ' bootstrap ': ' http://twitter.github.io/bootstrap/assets/bootstrap',
+                ' bootstrap2 ': ' http://twitter.github.io/bootstrap/assets/bootstrap # *',
+                ' ssh ': ' git@example.com ',
+                ' git ': ' git://example.com ',
+                ' path ': ' /foo ',
+                ' winpath ': ' c:\\foo '
+            };
+            var x = 0;
+
+            object.forOwn(dependencies, function (value, key) {
+                expect(endpointParser.json2decomposed(key, value)).to.eql(expected[x]);
+                x += 1;
+            });
+        });
+
+        it('should error out if key is not specified', function () {
+            try {
+                endpointParser.json2decomposed(null);
+                throw new Error('Should have failed');
+            } catch (e) {
+                expect(e.code).to.equal('EINVEND');
+                expect(e.message).to.contain('key must be specified');
+            }
+
+            try {
+                endpointParser.json2decomposed('');
+                throw new Error('Should have failed');
+            } catch (e) {
+                expect(e.code).to.equal('EINVEND');
+                expect(e.message).to.contain('key must be specified');
+            }
+        });
+    });
+
+    describe('.decomposed2json', function () {
+        var expected = [
+            { jquery: '~1.9.1' },
+            { foo: '*' },
+            { bar: '*' },
+            { baz: '*' },
+            { jqueryx: 'jquery#~1.9.1' },
+            { jqueryy: 'jquery-x#*' },
+            { jqueryy: 'jquery-x#*' },
+            { backbone: 'backbone-amd#~1.0.0' },
+            { backbone : 'backbone=backbone-amd#~1.0.0' },
+            { bootstrap: 'http://twitter.github.io/bootstrap/assets/bootstrap' },
+            { bootstrap: 'http://twitter.github.io/bootstrap/assets/bootstrap' },
+            { ssh: 'git@example.com' },
+            { git: 'git://example.com' },
+            { ckeditor: '#full/4.3.3' }
+        ];
+
+        it('should compose endpoints to json correctly', function () {
+            var decEndpoints = [
+                { name: 'jquery', source: 'jquery', target: '~1.9.1' },
+                { name: 'foo', source: 'foo', target: 'latest' },
+                { name: 'bar', source: 'bar', target: '*' },
+                { name: 'baz', source: 'baz', target: '' },
+                { name: 'jqueryx', source: 'jquery', target: '~1.9.1' },
+                { name: 'jqueryy', source: 'jquery-x', target: '' },
+                { name: 'jqueryy', source: 'jquery-x', target: '*' },
+                { name: 'backbone', source: 'backbone-amd', target: '~1.0.0' },
+                { name: 'backbone', source: 'backbone=backbone-amd', target: '~1.0.0' },
+                { name: 'bootstrap', source: 'http://twitter.github.io/bootstrap/assets/bootstrap', target: '' },
+                { name: 'bootstrap', source: 'http://twitter.github.io/bootstrap/assets/bootstrap', target: '*' },
+                { name: 'ssh', source: 'git@example.com', target: '*' },
+                { name: 'git', source: 'git://example.com', target: '*' },
+                { name: 'ckeditor', source: 'ckeditor', target: 'full/4.3.3' }
+            ];
+            var x = 0;
+
+            decEndpoints.forEach(function (decEndpoint) {
+                expect(endpointParser.decomposed2json(decEndpoint)).to.eql(expected[x]);
+                x += 1;
+            });
+        });
+
+        it('should trim values', function () {
+            var decEndpoints = [
+                { name: ' jquery ', source: ' jquery ', target: ' ~1.9.1 ' },
+                { name: 'foo', source: ' foo', target: ' latest ' },
+                { name: 'bar', source: 'bar ', target: ' * ' },
+                { name: 'baz ', source: 'baz', target: ' ' },
+                { name: ' jqueryx ', source: ' jquery ', target: ' ~1.9.1 ' },
+                { name: ' jqueryy ', source: ' jquery-x ', target: ' ' },
+                { name: ' jqueryy ', source: ' jquery-x ', target: ' * ' },
+                { name: ' backbone ', source: ' backbone-amd ', target: ' ~1.0.0 ' },
+                { name: ' backbone ', source: ' backbone=backbone-amd ', target: ' ~1.0.0 ' },
+                { name: ' bootstrap ', source: ' http://twitter.github.io/bootstrap/assets/bootstrap ', target: ' ' },
+                { name: ' bootstrap ', source: ' http://twitter.github.io/bootstrap/assets/bootstrap ', target: ' * ' },
+                { name: ' ssh ', source: ' git@example.com ', target: ' * ' },
+                { name: ' git ', source: ' git://example.com ', target: ' * ' }
+            ];
+            var x = 0;
+
+            decEndpoints.forEach(function (decEndpoint) {
+                expect(endpointParser.decomposed2json(decEndpoint)).to.eql(expected[x]);
+                x += 1;
+            });
+        });
+
+        it('should throw an error if name is empty', function () {
+            try {
+                endpointParser.decomposed2json({ name: '', source: 'jquery', target: '*' });
+                throw new Error('Should have failed');
+            } catch (e) {
+                expect(e.code).to.equal('EINVEND');
+                expect(e.message).to.contain('must have a name');
+            }
+
+            try {
+                endpointParser.decomposed2json({ name: ' ', source: 'jquery', target: '*' });
+                throw new Error('Should have failed');
+            } catch (e) {
+                expect(e.code).to.equal('EINVEND');
+                expect(e.message).to.contain('must have a name');
+            }
+        });
+    });
+});

packages/bower-json/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false

packages/bower-json/.gitignore

@@ -0,0 +1,4 @@
+/node_modules
+/npm-debug.*
+
+/test/reports

packages/bower-json/.jshintrc

@@ -0,0 +1,48 @@
+{
+    "indent": 4,
+    "node": true,
+    "devel": true,
+    "mocha": true,
+
+    "bitwise": false,
+    "curly": false,
+    "eqeqeq": true,
+    "forin": false,
+    "immed": true,
+    "latedef": false,
+    "newcap": true,
+    "noarg": true,
+    "noempty": false,
+    "nonew": true,
+    "plusplus": false,
+    "regexp": false,
+    "undef": true,
+    "unused": true,
+    "quotmark": "single",
+    "strict": false,
+    "camelcase": true,
+
+    "asi": false,
+    "boss": true,
+    "debug": false,
+    "eqnull": true,
+    "es5": false,
+    "esnext": false,
+    "evil": false,
+    "expr": false,
+    "funcscope": false,
+    "globalstrict": false,
+    "iterator": false,
+    "lastsemic": false,
+    "laxbreak": true,
+    "laxcomma": false,
+    "loopfunc": true,
+    "multistr": false,
+    "onecase": true,
+    "regexdash": false,
+    "scripturl": false,
+    "shadow": false,
+    "sub": false,
+    "supernew": true,
+    "validthis": false
+}

packages/bower-json/.travis.yml

@@ -0,0 +1,10 @@
+sudo: false
+language: node_js
+node_js:
+  - '5'
+  - '4'
+  - '0.12'
+  - '0.10'
+
+script:
+  - grunt travis

packages/bower-json/CHANGELOG.md

@@ -0,0 +1,17 @@
+# 0.8.1
+
+- Revert strict name validations and allow @, spaces and slashes
+
+# 0.8.0
+
+- Update graceful-fs to 4.x
+- Add name validations that reflect what's happening in registry
+
+# 0.7.1
+
+- Unpublished
+
+# 0.7.0
+
+- Add getIssues function to retrieve all errors and warnings
+- Add readSync and findSync functions for synchronous read

packages/bower-json/Gruntfile.js

@@ -0,0 +1,60 @@
+'use strict';
+
+module.exports = function (grunt) {
+    require('load-grunt-tasks')(grunt);
+    // Project configuration.
+    grunt.initConfig({
+
+        jshint: {
+            files: [
+                'Gruntfile.js',
+                'lib/**/*.js',
+                'test/**/*.js',
+                '!test/reports/**/*'
+            ],
+            options: {
+                jshintrc: '.jshintrc'
+            }
+        },
+
+        simplemocha: {
+            options: {
+                reporter: 'spec'
+            },
+            full: { src: ['test/test.js'] },
+            short: {
+                options: {
+                    reporter: 'dot'
+                },
+                src: ['test/test.js']
+            },
+            build: {
+                options: {
+                    reporter: 'tap'
+                },
+                src: ['test/test.js']
+            }
+        },
+
+        exec: {
+            cover: {
+                command: 'STRICT_REQUIRE=1 node node_modules/istanbul/lib/cli.js cover --dir ./test/reports node_modules/mocha/bin/_mocha -- --timeout 30000 -R dot test/test.js'
+            },
+            coveralls: {
+                command: 'node node_modules/.bin/coveralls < test/reports/lcov.info'
+            }
+        },
+
+
+        watch: {
+            files: ['<%= jshint.files %>'],
+            tasks: ['jshint', 'simplemocha:short']
+        }
+
+    });
+
+    // Default task.
+    grunt.registerTask('test', ['simplemocha:full']);
+    grunt.registerTask('default', ['jshint', 'test']);
+    grunt.registerTask('travis', ['jshint', 'exec:cover', 'exec:coveralls']);
+};

packages/bower-json/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2012-present Twitter and other contributors
+
+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.

packages/bower-json/README.md

@@ -0,0 +1,159 @@
+# bower-json [![Build Status](https://secure.travis-ci.org/bower/json.png?branch=master)](http://travis-ci.org/bower/json) [![Coverage Status](https://coveralls.io/repos/bower/json/badge.svg?branch=master&service=github)](https://coveralls.io/github/bower/json?branch=master)
+
+Read `bower.json` files with semantics, normalisation, defaults and validation.
+
+Install via [npm](https://www.npmjs.org/package/bower-json): `npm install --save bower-json`
+
+## Usage
+
+#### .read(file, options, callback)
+#### .readSync(file, options)
+
+Reads `file` and applies normalisation, defaults and validation according to the `bower.json` spec.
+If the passed `file` does not exist, the callback is called with `error.code` equal to `ENOENT`.
+If the passed `file` contents are not valid JSON, the callback is called with `error.code` equal to `EMALFORMED`.
+If the `json` does not comply with the `bower.json` spec, the callback is called with `error.code` equal to `EINVALID`.
+
+If `file` is a directory, `find()` will be used to search for the json file.
+The `options` argument is optional and can be omitted. These options will be passed to `parse` method.
+
+
+```js
+var bowerJson = require('bower-json');
+
+// Can also be used by simply calling bowerJson()
+bowerJson.read('/path/to/bower.json', function (err, json) {
+    if (err) {
+        console.error('There was an error reading the file');
+        console.error(err.message);
+        return;
+    }
+
+    console.log('JSON: ', json);
+});
+```
+
+
+#### .parse(json, options)
+
+Parses an object. Useful when you want to apply normalisation and validation directly to an object.
+If the `json` does not comply with the `bower.json` spec, an error is thrown with `error.code` equal to `EINVALID`.
+
+The `options` arguments is optional and can be omitted. Available options:
+
+- validate: Apply validation, defaults to `true`
+- normalize: Apply normalisation, defaults to `false`
+- clone: clone, use and return the passed in `json` object instead of using it directly, defaults to `false`
+
+
+```js
+var bowerJson = require('bower-json');
+
+var json = {
+    name: 'my-package',
+    version: '0.0.1'
+};
+
+try {
+    bowerJson.parse(json);
+} catch (err) {
+    console.error('There was an error parsing the object');
+    console.error(err.message);
+}
+```
+
+#### .getIssues(json) - DEPRECATED
+
+Validates the passed `json` object.
+
+Returns an object with errors and warnings of this bower.json contents.
+
+```js
+var bowerJson = require('bower-json');
+
+var json = {
+    name: 'myPackage',
+    version: '0.0.1',
+    main: {}
+};
+
+var issues = bowerJson.getIssues(json);
+
+expect(issues).toEqual({
+  errors: ['The "main" field has to be either an Array or a String'],
+  warnings: ['The "name" must be lowercase']
+});
+
+#### .validate(json)
+
+Validates the passed `json` object.
+
+Throws an error with `error.code` equal to `EINVALID` if it does not comply with the spec.
+
+```js
+var bowerJson = require('bower-json');
+
+var json = {
+    name: 'myPackage',
+    version: '0.0.1'
+};
+
+try {
+    bowerJson.validate(json);
+} catch (err) {
+    console.error('There was an error validating the object');
+    console.error(err.message);
+}
+```
+
+#### .normalize(json)
+
+```js
+var bowerJson = require('bower-json');
+
+var json = {
+    name: 'my-package',
+    version: '0.0.1',
+    main: 'foo.js,bar.js'
+};
+
+bowerJson.normalize(json);
+json.main // ['foo.js', 'bar.js']
+```
+
+
+#### .find(folder, callback)
+#### .findSync(folder)
+
+Finds the `json` filename inside a folder.
+Checks if a `bower.json` exists, falling back to `component.json` (deprecated) and `.bower.json`.
+If no file was found, the callback is called with a `error.code` of `ENOENT`.
+
+```js
+var bowerJson = require('bower-json');
+
+bowerJson.find('/path/to/folder', function (err, filename) {
+    if (err) {
+        console.error('There is no json file in the folder');
+        return;
+    }
+
+    console.log('Filename: ', filename);
+
+    // Now that we got the filename, we can read its contents
+    bowerJson.read(filename, function (err, json) {
+        if (err) {
+            console.error('There was an error reading the file');
+            console.error(err.message);
+            return;
+        }
+
+        console.log('JSON: ', json);
+    });
+});
+```
+
+
+## License
+
+Released under the [MIT License](http://www.opensource.org/licenses/mit-license.php).

packages/bower-json/lib/json.js

@@ -0,0 +1,297 @@
+var fs = require('graceful-fs');
+var path = require('path');
+var deepExtend = require('deep-extend');
+var isAsset = require('./util/isAsset');
+var isComponent = require('./util/isComponent');
+var createError = require('./util/createError');
+
+var possibleJsons = ['bower.json', 'component.json', '.bower.json'];
+
+function read(file, options, callback) {
+    if (typeof options === 'function') {
+        callback = options;
+        options = {};
+    }
+
+    // Check if file is a directory
+    fs.stat(file, function (err, stat) {
+        if (err) {
+            return callback(err);
+        }
+
+        // It's a directory, so we find the json inside it
+        if (stat.isDirectory()) {
+            return find(file, function (err, file) {
+                if (err) {
+                    return callback(err);
+                }
+
+                read(file, options, callback);
+            });
+        }
+
+        // Otherwise read it
+        fs.readFile(file, function (err, contents) {
+            var json;
+
+            if (err) {
+                return callback(err);
+            }
+
+            try {
+                json = JSON.parse(contents.toString());
+            } catch (err) {
+                err.file = path.resolve(file);
+                err.code = 'EMALFORMED';
+                return callback(err);
+            }
+
+            // Parse it
+            try {
+                json = parse(json, options);
+            } catch (err) {
+                err.file = path.resolve(file);
+                return callback(err);
+            }
+
+            callback(null, json, file);
+        });
+    });
+}
+
+function readSync(file, options) {
+    var stat;
+    var filename;
+    var contents;
+    var json;
+
+    if (!options) {
+        options = {};
+    }
+    try {
+        stat = fs.statSync(file);
+    } catch (err) {
+        return err;
+    }
+    if (stat.isDirectory()) {
+        filename = findSync(file);
+        return readSync(filename);
+    }
+
+    contents = fs.readFileSync(file);
+
+    try {
+        json = JSON.parse(contents.toString());
+    } catch (err) {
+        err.file = path.resolve(file);
+        err.code = 'EMALFORMED';
+        return err;
+    }
+
+    try {
+        json = parse(json, options);
+    } catch (err) {
+        err.file = path.resolve(file);
+        return err;
+    }
+
+    return json;
+}
+
+function parse(json, options) {
+    options = deepExtend({
+        normalize: false,
+        validate: true,
+        clone: false
+    }, options || {});
+
+    // Clone
+    if (options.clone) {
+        json = deepExtend({}, json);
+    }
+
+    // Validate
+    if (options.validate) {
+        validate(json);
+    }
+
+    // Normalize
+    if (options.normalize) {
+        normalize(json);
+    }
+
+    return json;
+}
+
+// This function implements:
+//
+// https://github.com/bower/bower.json-spec
+function getIssues(json) {
+    // For things that shouldn't happen
+    var errors = [];
+
+    // For things that happen but they shoudn't
+    var warnings = [];
+
+    if (!json.name) {
+        errors.push('No "name" property set');
+    } else {
+        if (!/^[a-zA-Z0-9_@][a-zA-Z0-9_@\.\- \/]*$/.test(json.name)) {
+            errors.push('Name must be lowercase, can contain digits, dots, dashes, "@" or spaces');
+        }
+
+        if (json.name.length > 50) {
+            warnings.push('The "name" is too long, the limit is 50 characters');
+        }
+
+        if (!/^[a-z0-9_][a-z0-9_\.\-]*$/.test(json.name)) {
+            warnings.push('The "name" is recommended to be lowercase, can contain digits, dots, dashes');
+        }
+
+        if (/^[\.-]/.test(json.name)) {
+            warnings.push('The "name" cannot start with dot or dash');
+        }
+
+        if (/[\.-]$/.test(json.name)) {
+            warnings.push('The "name" cannot end with dot or dash');
+        }
+    }
+
+    if (json.description && json.description.length > 140) {
+        warnings.push('The "description" is too long, the limit is 140 characters');
+    }
+
+    if (json.main !== undefined) {
+        var main = json.main;
+        if (typeof main === 'string') {
+            main = [main];
+        }
+        if (!(main instanceof Array)) {
+            errors.push('The "main" field has to be either an Array or a String');
+        } else {
+            var ext2files = {};
+            main.forEach(function (filename) {
+                if (typeof filename !== 'string') {
+                    errors.push('The "main" Array has to contain only Strings');
+                }
+                if (/[*]/.test(filename)) {
+                    warnings.push('The "main" field cannot contain globs (example: "*.js")');
+                }
+                if (/[.]min[.][^/]+$/.test(filename)) {
+                    warnings.push('The "main" field cannot contain minified files');
+                }
+                if (isAsset(filename)) {
+                    warnings.push('The "main" field cannot contain font, image, audio, or video files');
+                }
+                var ext = path.extname(filename);
+                if (ext.length >= 2) {
+                    var files = ext2files[ext];
+                    if (!files) {
+                        files = ext2files[ext] = [];
+                    }
+                    files.push(filename);
+                }
+            });
+            Object.keys(ext2files).forEach(function (ext) {
+                var files = ext2files[ext];
+                if (files.length > 1) {
+                    warnings.push('The "main" field has to contain only 1 file per filetype; found multiple ' + ext + ' files: ' + JSON.stringify(files));
+                }
+            });
+        }
+    }
+
+    return {
+        errors: errors,
+        warnings: warnings
+    };
+}
+
+// For backward compatibility, it throws first error
+function validate(json) {
+    var issues = getIssues(json);
+
+    if (issues.errors && issues.errors.length > 0) {
+        throw createError(issues.errors[0], 'EINVALID');
+    }
+}
+
+function normalize(json) {
+    if (typeof json.main === 'string') {
+        json.main = [json.main];
+    }
+
+    return json;
+}
+
+function find(folder, files, callback) {
+    var err;
+    var file;
+
+    if (typeof files === 'function') {
+        callback = files;
+        files = possibleJsons;
+    }
+
+    if (!files.length) {
+        err = createError('None of ' + possibleJsons.join(', ') + ' were found in ' + folder, 'ENOENT');
+        return callback(err);
+    }
+
+    file = path.resolve(path.join(folder, files[0]));
+    fs.exists(file, function (exists) {
+        if (!exists) {
+            return find(folder, files.slice(1), callback);
+        }
+
+        if (files[0] !== 'component.json') {
+            return callback(null, file);
+        }
+
+        // If the file is component.json, check it it's a component(1) file
+        // If it is, we ignore it and keep searching
+        isComponent(file, function (is) {
+            if (is) {
+                return find(folder, files.slice(1), callback);
+            }
+
+            callback(null, file);
+        });
+    });
+}
+
+function findSync(folder, files) {
+    var file;
+    var exists;
+
+    if (files === undefined) {
+        files = possibleJsons;
+    }
+
+    if (!files.length) {
+        return createError('None of ' + possibleJsons.join(', ') + ' were found in ' + folder, 'ENOENT');
+    }
+
+    file = path.resolve(path.join(folder, files[0]));
+    try{
+        exists = fs.statSync(file);
+    }
+    catch (err) {
+        exists = false;
+    }
+    if (exists && exists.isFile()) {
+        return file;
+    } else {
+        return findSync(folder, files.slice(1));
+    }
+}
+
+module.exports = read;
+module.exports.read = read;
+module.exports.readSync = readSync;
+module.exports.parse = parse;
+module.exports.getIssues = getIssues;
+module.exports.validate = validate;
+module.exports.normalize = normalize;
+module.exports.find = find;
+module.exports.findSync = findSync;

packages/bower-json/lib/util/createError.js

@@ -0,0 +1,8 @@
+function createError(msg, code) {
+    var err = new Error(msg);
+    err.code = code;
+
+    return err;
+}
+
+module.exports = createError;

packages/bower-json/lib/util/isAsset.js

@@ -0,0 +1,12 @@
+var extName = require('ext-name');
+
+function isAsset(filename) {
+    var info = extName(filename);
+    
+    return info && info.mime && (
+        /^((image)|(audio)|(video)|(font))\//.test(info.mime) ||
+        /application\/((x[-]font[-])|(font[-]woff(\d?))|(vnd[.]ms[-]fontobject))/.test(info.mime)
+    );
+}
+
+module.exports = isAsset;

packages/bower-json/lib/util/isComponent.js

@@ -0,0 +1,41 @@
+var fs = require('graceful-fs');
+var intersect = require('intersect');
+
+// Function to check if a file is a component(1) file
+function isComponent(file, callback) {
+    fs.readFile(file, function (err, contents) {
+        var json;
+        var keys;
+        var common;
+
+        // If an error occurs while reading the file, we ignore it
+        if (err) {
+            return callback(false);
+        }
+
+        try {
+            json = JSON.parse(contents.toString());
+        } catch (err) {
+            return callback(false);
+        }
+
+        // Attempt to find specific things from the component(1) spec
+        // Note that we don't parse the dependencies property because at any point
+        // we can allow / to specify directories
+        // Bellow only some clearly not ambiguous properties are checked
+        keys = Object.keys(json);
+        common = intersect(keys, [
+            'repo',
+            'development',
+            'local',
+            'remotes',
+            'paths',
+            'demo'
+        ]);
+
+        // If none were found, than it's a valid component.json bower file
+        callback(common.length ? true : false);
+    });
+}
+
+module.exports = isComponent;

packages/bower-json/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "bower-json",
+  "version": "0.8.1",
+  "description": "Read bower.json files with semantics, normalisation, defaults and validation",
+  "author": "Twitter",
+  "license": "MIT",
+  "repository": "https://github.com/bower/bower/tree/master/packages/bower-json",
+  "main": "lib/json",
+  "engines": {
+    "node": ">=0.10.0"
+  },
+  "dependencies": {
+    "deep-extend": "^0.4.0",
+    "ext-name": "^3.0.0",
+    "graceful-fs": "^4.1.3",
+    "intersect": "^1.0.1"
+  },
+  "devDependencies": {
+    "coveralls": "^2.11.2",
+    "expect.js": "^0.3.1",
+    "grunt": "^0.4.4",
+    "grunt-cli": "^0.1.13",
+    "grunt-contrib-jshint": "^0.11.2",
+    "grunt-contrib-watch": "^0.6.1",
+    "grunt-coveralls": "^1.0.0",
+    "grunt-exec": "^0.4.6",
+    "grunt-simple-mocha": "^0.4.0",
+    "istanbul": "^0.3.5",
+    "load-grunt-tasks": "^3.3.0",
+    "mocha": "*",
+    "request": "^2.64.0",
+    "underscore.string": "^3.0.3"
+  },
+  "scripts": {
+    "test": "grunt test"
+  },
+  "files": [
+    "lib"
+  ]
+}

packages/bower-json/test/pkg-bower-json-invalid/bower.json

@@ -0,0 +1 @@
+{}

packages/bower-json/test/pkg-bower-json-malformed/bower.json

@@ -0,0 +1 @@
+{

packages/bower-json/test/pkg-bower-json/bower.json

@@ -0,0 +1,5 @@
+{
+    "name": "some-pkg",
+    "version": "0.0.0",
+    "main": "foo.js"
+}

packages/bower-json/test/pkg-component(1)-json/component.json

@@ -0,0 +1,14 @@
+{
+  "name": "route",
+  "repo": "apily/route",
+  "version": "0.0.1",
+  "description": "Route component",
+  "keywords": ["router", "route"],
+  "scripts": ["index.js"],
+  "dependencies": {},
+  "development": {
+    "component/assert": "*",
+    "visionmedia/mocha": "*"
+  },
+  "license": "MIT"
+}

packages/bower-json/test/pkg-component-json/component.json

@@ -0,0 +1,4 @@
+{
+    "name": "some-pkg",
+    "version": "0.0.0"
+}

packages/bower-json/test/pkg-dot-bower-json/.bower.json

@@ -0,0 +1,5 @@
+{
+    "name": "some-installed-pkg",
+    "version": "0.0.1",
+    "main": "bar.js"
+}

packages/bower-json/test/test.js

@@ -0,0 +1,497 @@
+var path = require('path');
+var expect = require('expect.js');
+var _s = require('underscore.string');
+var bowerJson = require('../lib/json');
+var request = require('request');
+
+describe('.find', function () {
+    it('should find the bower.json file', function (done) {
+        bowerJson.find(__dirname + '/pkg-bower-json', function (err, file) {
+            if (err) {
+                return done(err);
+            }
+
+            expect(file).to.equal(path.resolve(__dirname + '/pkg-bower-json/bower.json'));
+            done();
+        });
+    });
+
+    it('should fallback to the component.json file', function (done) {
+        bowerJson.find(__dirname + '/pkg-component-json', function (err, file) {
+            if (err) {
+                return done(err);
+            }
+
+            expect(file).to.equal(path.resolve(__dirname + '/pkg-component-json/component.json'));
+            done();
+        });
+    });
+
+    it('should not fallback to the component.json file if it\'s a component(1) file', function (done) {
+        bowerJson.find(__dirname + '/pkg-component(1)-json', function (err) {
+            expect(err).to.be.an(Error);
+            expect(err.code).to.equal('ENOENT');
+            expect(err.message).to.equal('None of bower.json, component.json, .bower.json were found in ' + __dirname + '/pkg-component(1)-json');
+            done();
+        });
+    });
+
+    it('should fallback to the .bower.json file', function (done) {
+        bowerJson.find(__dirname + '/pkg-dot-bower-json', function (err, file) {
+            if (err) {
+                return done(err);
+            }
+
+            expect(file).to.equal(path.resolve(__dirname + '/pkg-dot-bower-json/.bower.json'));
+            done();
+        });
+    });
+
+    it('should error if no component.json / bower.json / .bower.json is found', function (done) {
+        bowerJson.find(__dirname, function (err) {
+            expect(err).to.be.an(Error);
+            expect(err.code).to.equal('ENOENT');
+            expect(err.message).to.equal('None of bower.json, component.json, .bower.json were found in ' + __dirname);
+            done();
+        });
+    });
+});
+
+describe('.findSync', function () {
+
+    it('should find the bower.json file', function (done) {
+        var file = bowerJson.findSync(__dirname + '/pkg-bower-json');
+
+        expect(file).to.equal(path.resolve(__dirname + '/pkg-bower-json/bower.json'));
+        done();
+    });
+
+    it('should fallback to the component.json file', function (done) {
+        var file = bowerJson.findSync(__dirname + '/pkg-component-json');
+
+        expect(file).to.equal(path.resolve(__dirname + '/pkg-component-json/component.json'));
+        done();
+    });
+
+    it('should fallback to the .bower.json file', function (done) {
+        var file = bowerJson.findSync(__dirname + '/pkg-dot-bower-json');
+
+        expect(file).to.equal(path.resolve(__dirname + '/pkg-dot-bower-json/.bower.json'));
+        done();
+    });
+
+    it('should error if no component.json / bower.json / .bower.json is found', function (done) {
+        var err = bowerJson.findSync(__dirname);
+        expect(err).to.be.an(Error);
+        expect(err.code).to.equal('ENOENT');
+        expect(err.message).to.equal('None of bower.json, component.json, .bower.json were found in ' + __dirname);
+        done();
+    });
+
+
+
+});
+
+describe('.read', function () {
+    it('should give error if file does not exists', function (done) {
+        bowerJson.read(__dirname + '/willneverexist', function (err) {
+            expect(err).to.be.an(Error);
+            expect(err.code).to.equal('ENOENT');
+            done();
+        });
+    });
+
+    it('should give error if when reading an invalid json', function (done) {
+        bowerJson.read(__dirname + '/pkg-bower-json-malformed/bower.json', function (err) {
+            expect(err).to.be.an(Error);
+            expect(err.code).to.equal('EMALFORMED');
+            expect(err.file).to.equal(path.resolve(__dirname + '/pkg-bower-json-malformed/bower.json'));
+            done();
+        });
+    });
+
+    it('should read the file and give an object', function (done) {
+        bowerJson.read(__dirname + '/pkg-bower-json/bower.json', function (err, json) {
+            if (err) {
+                return done(err);
+            }
+
+            expect(json).to.be.an('object');
+            expect(json.name).to.equal('some-pkg');
+            expect(json.version).to.equal('0.0.0');
+
+            done();
+        });
+    });
+
+    it('should give the json file that was read', function (done) {
+        bowerJson.read(__dirname + '/pkg-bower-json', function (err, json, file) {
+            if (err) {
+                return done(err);
+            }
+
+
+            expect(file).to.equal(__dirname + '/pkg-bower-json/bower.json');
+            done();
+        });
+    });
+
+    it('should find for a json file if a directory is given', function (done) {
+        bowerJson.read(__dirname + '/pkg-component-json', function (err, json, file) {
+            if (err) {
+                return done(err);
+            }
+
+            expect(json).to.be.an('object');
+            expect(json.name).to.equal('some-pkg');
+            expect(json.version).to.equal('0.0.0');
+            expect(file).to.equal(path.resolve(__dirname + '/pkg-component-json/component.json'));
+            done();
+        });
+    });
+
+    it('should validate the returned object unless validate is false', function (done) {
+        bowerJson.read(__dirname + '/pkg-bower-json-invalid/bower.json', function (err) {
+            expect(err).to.be.an(Error);
+            expect(err.message).to.contain('name');
+            expect(err.file).to.equal(path.resolve(__dirname + '/pkg-bower-json-invalid/bower.json'));
+
+            bowerJson.read(__dirname + '/pkg-bower-json-invalid/bower.json', { validate: false }, function (err) {
+                done(err);
+            });
+        });
+    });
+
+    it('should normalize the returned object if normalize is true', function (done) {
+        bowerJson.read(__dirname + '/pkg-bower-json/bower.json', function (err, json) {
+            if (err) {
+                return done(err);
+            }
+
+            expect(json.main).to.equal('foo.js');
+
+            bowerJson.read(__dirname + '/pkg-bower-json/bower.json', { normalize: true }, function (err, json) {
+                if (err) {
+                    return done(err);
+                }
+
+                expect(json.main).to.eql(['foo.js']);
+                done();
+            });
+        });
+    });
+});
+
+describe('.readSync', function () {
+    it('should give error if file does not exists', function (done) {
+        var err = bowerJson.readSync(__dirname + '/willneverexist');
+        expect(err).to.be.an(Error);
+        expect(err.code).to.equal('ENOENT');
+        done();
+    });
+
+    it('should give error if when reading an invalid json', function (done) {
+        var err =  bowerJson.readSync(__dirname + '/pkg-bower-json-malformed/bower.json');
+        expect(err).to.be.an(Error);
+        expect(err.code).to.equal('EMALFORMED');
+        expect(err.file).to.equal(path.resolve(__dirname + '/pkg-bower-json-malformed/bower.json'));
+        done();
+    });
+
+    it('should read the file and give an object', function (done) {
+        var json = bowerJson.readSync(__dirname + '/pkg-bower-json/bower.json');
+
+        expect(json).to.be.an('object');
+        expect(json.name).to.equal('some-pkg');
+        expect(json.version).to.equal('0.0.0');
+
+        done();
+    });
+
+    it('should find for a json file if a directory is given', function (done) {
+        var json = bowerJson.readSync(__dirname + '/pkg-component-json');
+
+        expect(json).to.be.an('object');
+        expect(json.name).to.equal('some-pkg');
+        expect(json.version).to.equal('0.0.0');
+        done();
+    });
+
+    it('should validate the returned object unless validate is false', function (done) {
+        var err = bowerJson.readSync(__dirname + '/pkg-bower-json-invalid/bower.json');
+        expect(err).to.be.an(Error);
+        expect(err.message).to.contain('name');
+        expect(err.file).to.equal(path.resolve(__dirname + '/pkg-bower-json-invalid/bower.json'));
+
+        err = bowerJson.readSync(__dirname + '/pkg-bower-json-invalid/bower.json', { validate: false });
+        expect(err).to.not.be.an(Error);
+        done();
+    });
+
+    it('should normalize the returned object if normalize is true', function (done) {
+        var json =  bowerJson.readSync(__dirname + '/pkg-bower-json/bower.json');
+        expect(json.main).to.equal('foo.js');
+
+        json = bowerJson.readSync(__dirname + '/pkg-bower-json/bower.json', { normalize: true });
+
+        expect(json.main).to.eql(['foo.js']);
+        done();
+    });
+
+
+});
+
+describe('.parse', function () {
+    it('should return the same object, unless clone is true', function () {
+        var json = { name: 'foo' };
+
+        expect(bowerJson.parse(json)).to.equal(json);
+        expect(bowerJson.parse(json, { clone: true })).to.not.equal(json);
+        expect(bowerJson.parse(json, { clone: true })).to.eql(json);
+    });
+
+    it('should validate the passed object, unless validate is false', function () {
+        expect(function () {
+            bowerJson.parse({});
+        }).to.throwException(/name/);
+
+        expect(function () {
+            bowerJson.parse({}, { validate: false });
+        }).to.not.throwException();
+    });
+
+    it('should not normalize the passed object unless normalize is true', function () {
+        var json = { name: 'foo', main: 'foo.js' };
+
+        bowerJson.parse(json);
+        expect(json.main).to.eql('foo.js');
+
+        bowerJson.parse(json, { normalize: true });
+        expect(json.main).to.eql(['foo.js']);
+    });
+});
+
+describe('.getIssues', function () {
+    it('should print no errors even for weird package names', function () {
+        var json = { name: '@gruNt/my dependency' };
+
+        expect(bowerJson.getIssues(json).errors).to.be.empty();
+    });
+
+    it('should validate the name length', function () {
+        var json = { name: 'a_123456789_123456789_123456789_123456789_123456789_z' };
+
+        expect(bowerJson.getIssues(json).warnings).to.contain(
+            'The "name" is too long, the limit is 50 characters'
+        );
+    });
+
+    it('should validate the name is lowercase', function () {
+        var json = { name: 'gruNt' };
+
+        expect(bowerJson.getIssues(json).warnings).to.contain(
+            'The "name" is recommended to be lowercase, can contain digits, dots, dashes'
+        );
+    });
+
+    it('should validate the name starts with lowercase', function () {
+        var json = { name: '-runt' };
+
+        expect(bowerJson.getIssues(json).warnings).to.contain(
+            'The "name" cannot start with dot or dash'
+        );
+    });
+
+    it('should validate the name starts with lowercase', function () {
+        var json = { name: '.grunt' };
+
+        expect(bowerJson.getIssues(json).warnings).to.contain(
+            'The "name" cannot start with dot or dash'
+        );
+    });
+
+    it('should validate the name ends with lowercase', function () {
+        var json = { name: 'grun-' };
+
+        expect(bowerJson.getIssues(json).warnings).to.contain(
+            'The "name" cannot end with dot or dash'
+        );
+    });
+
+    it('should validate the name ends with lowercase', function () {
+        var json = { name: 'grun.' };
+
+        expect(bowerJson.getIssues(json).warnings).to.contain(
+            'The "name" cannot end with dot or dash'
+        );
+    });
+
+    it('should validate the name is valid', function () {
+        var json = { name: 'gru.n-t' };
+
+        expect(bowerJson.getIssues(json).warnings).to.eql([]);
+    });
+
+    it('should validate the description length', function () {
+        var json = {
+            name: 'foo',
+            description: _s.repeat('æ', 141)
+        };
+
+        expect(bowerJson.getIssues(json).warnings).to.contain(
+            'The "description" is too long, the limit is 140 characters'
+        );
+    });
+
+    it('should validate the description is valid', function () {
+        var json = {
+            name: 'foo',
+            description: _s.repeat('æ', 140)
+        };
+
+        expect(bowerJson.getIssues(json).warnings).to.eql([]);
+    });
+
+    it('should validate that main does not contain globs', function () {
+        var json = {
+            name: 'foo',
+            main: ['js/*.js']
+        };
+
+        expect(bowerJson.getIssues(json).warnings).to.contain(
+            'The "main" field cannot contain globs (example: "*.js")'
+        );
+    });
+
+    it('should validate that main does not contain minified files', function () {
+        var json = {
+            name: 'foo',
+            main: ['foo.min.css']
+        };
+
+        expect(bowerJson.getIssues(json).warnings).to.contain(
+            'The "main" field cannot contain minified files'
+        );
+    });
+
+    it('should validate that main does not contain fonts', function () {
+        var json = {
+            name: 'foo',
+            main: ['foo.woff']
+        };
+
+        expect(bowerJson.getIssues(json).warnings).to.contain(
+            'The "main" field cannot contain font, image, audio, or video files'
+        );
+    });
+
+    it('should validate that main does not contain images', function () {
+        var json = {
+            name: 'foo',
+            main: ['foo.png']
+        };
+
+        expect(bowerJson.getIssues(json).warnings).to.contain(
+            'The "main" field cannot contain font, image, audio, or video files'
+        );
+    });
+
+    it('should validate that main does not contain multiple files of the same filetype', function () {
+        var json = {
+            name: 'foo',
+            main: ['foo.js', 'bar.js']
+        };
+
+        expect(bowerJson.getIssues(json).warnings).to.contain(
+            'The "main" field has to contain only 1 file per filetype; found multiple .js files: ["foo.js","bar.js"]'
+        );
+    });
+});
+
+describe('.validate', function () {
+    it('should validate the name property', function () {
+        expect(function () {
+            bowerJson.validate({});
+        }).to.throwException(/name/);
+    });
+
+    it('should validate the type of main', function () {
+        var json = {
+            name: 'foo',
+            main: {}
+        };
+        expect(function () {
+            bowerJson.validate(json);
+        }).to.throwException();
+    });
+    it('should validate the type of items of an Array main', function () {
+        var json = {
+            name: 'foo',
+            main: [{}]
+        };
+        expect(function () {
+            bowerJson.validate(json);
+        }).to.throwException();
+    });
+});
+
+describe('.normalize', function () {
+    it('should normalize the main property', function () {
+        var json = { name: 'foo', main: 'foo.js' };
+
+        bowerJson.normalize(json);
+        expect(json.main).to.eql(['foo.js']);
+    });
+});
+
+describe('packages from bower registry', function () {
+
+    var packageList,
+        packageListUrl = 'http://registry.bower.io/packages';
+
+    this.timeout(60000);
+
+    it('can be downloaded from online source ' + packageListUrl, function(done) {
+        request({
+            url: packageListUrl,
+            json: true
+        }, function(error, response, body) {
+
+            if(error) {
+                throw error;
+            }
+
+            expect(body).to.be.an('array');
+            expect(body).to.not.be.empty();
+            packageList = body;
+
+            done();
+
+        });
+    });
+
+    it('should validate each listed package', function (done) {
+
+        expect(packageList).to.be.an('array');
+
+        var invalidPackageCount = 0;
+
+        packageList.forEach(function(package) {
+            try {
+                bowerJson.validate(package);
+            } catch(e) {
+                invalidPackageCount++;
+                console.error('validation of "' + package.name + '" failed: ' + e.message);
+            }
+
+        });
+
+        if(invalidPackageCount) {
+            throw new Error(invalidPackageCount + '/' + packageList.length + ' package names do not validate');
+        }
+
+        done();
+
+    });
+});
+

packages/bower-logger/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false

packages/bower-logger/.gitignore

@@ -0,0 +1,2 @@
+/node_modules
+/npm-debug.*

packages/bower-logger/.jshintrc

@@ -0,0 +1,62 @@
+{
+    "predef": [
+        "console",
+        "describe",
+        "it",
+        "after",
+        "afterEach",
+        "before",
+        "beforeEach"
+    ],
+
+    "indent": 4,
+    "node": true,
+    "devel": true,
+
+    "bitwise": false,
+    "curly": false,
+    "eqeqeq": true,
+    "forin": false,
+    "immed": true,
+    "latedef": false,
+    "newcap": true,
+    "noarg": true,
+    "noempty": false,
+    "nonew": true,
+    "plusplus": false,
+    "regexp": false,
+    "undef": true,
+    "unused": true,
+    "quotmark": "single",
+    "strict": false,
+    "trailing": true,
+    "camelcase": true,
+
+    "asi": false,
+    "boss": true,
+    "debug": false,
+    "eqnull": true,
+    "es5": false,
+    "esnext": false,
+    "evil": false,
+    "expr": false,
+    "funcscope": false,
+    "globalstrict": false,
+    "iterator": false,
+    "lastsemic": false,
+    "laxbreak": true,
+    "laxcomma": false,
+    "loopfunc": true,
+    "multistr": false,
+    "onecase": true,
+    "regexdash": false,
+    "scripturl": false,
+    "smarttabs": false,
+    "shadow": false,
+    "sub": false,
+    "supernew": true,
+    "validthis": false,
+
+    "nomen": false,
+    "white": true
+}

packages/bower-logger/.travis.yml

@@ -0,0 +1,6 @@
+sudo: false
+language: node_js
+node_js:
+  - 'iojs'
+  - '0.12'
+  - '0.10'

packages/bower-logger/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2012 Twitter and other contributors
+
+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.

packages/bower-logger/README.md

@@ -0,0 +1,126 @@
+# bower-logger [![Build Status](https://secure.travis-ci.org/bower/logger.png?branch=master)](http://travis-ci.org/bower/logger)
+
+The logger used in the various architecture components of Bower.
+
+Install
+
+```sh
+npm install --save bower-logger
+```
+
+
+## Usage
+
+### .error(id, message, data)
+
+Alias to `.log('error', id, message, data)`
+
+
+### .conflict(id, message, data)
+
+Alias to `.log('conflict', id, message, data)`
+
+
+### .warn(id, message, data)
+
+Alias to `.log('warn', id, message, data)`
+
+
+### .action(id, message, data)
+
+Alias to `.log('action', id, message, data)`
+
+
+### .info(id, message, data)
+
+Alias to `.log('info', id, message, data)`
+
+
+### .debug(id, message, data)
+
+Alias to `.log('debug', id, message, data)`
+
+
+### .log(level, id, message, data)
+
+Emits a `log` event, with an object like so:
+
+```js
+logger.log('warn', 'foo', 'bar', { dog: 'loves cat' })
+{
+    level: 'warn',
+    id: 'foo',
+    message: 'bar',
+    data: {
+        dog: 'loves cat'
+    }
+}
+```
+
+
+### .prompt(prompts, callback)
+
+Emits a `prompt` event with an array of `prompts` with a `callback`.   
+`prompts` can be an object or an array of objects. The `callback` will be called with an
+the answer or an object of answers (if prompts was only one or an array respectively).
+The `callback` is guaranteed to run only once.
+
+```js
+logger.on('prompt', function (prompts, callback) {
+    // "prompts" is always an array of prompts
+    // Call "callback" with an object of answers when done
+
+    // In this example, we will use the inquirer module to do the
+    // prompting for us
+    inquirer(prompts, callback);
+})
+
+logger.prompt({
+    type: 'input'  // Can be 'input', 'confirm' or 'password'
+    message: 'Type something',
+    validate: function (value) {
+        if (value !== 'I am awesome') {
+            return 'You must type "I am awesome"'
+        }
+
+        return true;
+    }
+}, function (err, answer) {
+    // Error will only happen on unsupported 'type'
+    if (err) {
+        return console.error(err.message);
+    }
+
+    console.log(answer);
+});
+
+
+```
+
+
+### .pipe(logger)
+
+Pipes all logger events to another logger.   
+Basically all events emitted with `.emit()` will get piped.
+
+
+### .geminate()
+
+Creates a new logger that pipes events to the parent logger.   
+Alias for `(new Logger()).pipe(logger)`.
+
+
+### .intercept(fn)
+
+Intercepts `log` events, calling `fn` before listeners of the instance.
+
+
+### #LEVELS
+
+A static property that contains an object where keys are the recognized log levels and values their importance.   
+The higher the importance, the more important the level is.
+
+
+## License
+
+Released under the [MIT License](http://www.opensource.org/licenses/mit-license.php).

packages/bower-logger/lib/Logger.js

@@ -0,0 +1,150 @@
+var EventEmitter = require('events').EventEmitter;
+var util = require('util');
+
+var slice = Array.prototype.slice;
+
+function Logger() {
+    this._interceptors = [];
+    this._piped = [];
+}
+
+util.inherits(Logger, EventEmitter);
+
+Logger.prototype.intercept = function (fn) {
+    this._interceptors.push(fn);
+    return this;
+};
+
+Logger.prototype.emit = function () {
+    var ret;
+    var args = slice.call(arguments);
+
+    // Run interceptors before
+    if (args[0] === 'log') {
+        this._interceptors.forEach(function (interceptor) {
+            interceptor.apply(this, args.slice(1));
+        });
+    }
+
+    ret = EventEmitter.prototype.emit.apply(this, args);
+
+    // Pipe
+    this._piped.forEach(function (emitter) {
+        emitter.emit.apply(emitter, args);
+    });
+
+    return ret;
+};
+
+Logger.prototype.pipe = function (emitter) {
+    this._piped.push(emitter);
+
+    return emitter;
+};
+
+Logger.prototype.geminate = function () {
+    var logger = new Logger();
+
+    logger.pipe(this);
+    return logger;
+};
+
+Logger.prototype.log = function (level, id, message, data) {
+    var log = {
+        level: level,
+        id: id,
+        message: message,
+        data: data || {}
+    };
+
+    // Emit log
+    this.emit('log', log);
+
+    return this;
+};
+
+Logger.prototype.prompt = function (prompts, callback) {
+    var fn;
+    var one;
+    var invalid;
+    var runned;
+    var error;
+    var validPrompts = Logger._validPrompts;
+
+    if (!Array.isArray(prompts)) {
+        prompts.name = 'prompt';
+        prompts = [prompts];
+        one = true;
+    }
+
+    // Validate prompt types
+    invalid = prompts.some(function (prompt) {
+        return validPrompts.indexOf(prompt.type) === -1;
+    });
+
+    if (invalid) {
+        error = new Error('Unknown prompt type');
+        error.code = 'ENOTSUP';
+        return callback(error);
+    }
+
+    fn = function (answers) {
+        // Run callback only once
+        if (runned) {
+            return;
+        }
+
+        // Trim answers automatically
+        Object.keys(answers).forEach(function (key) {
+            var value = answers[key];
+
+            if (typeof value === 'string') {
+                answers[key] = value.trim();
+            } else if (Array.isArray(value)) {
+                answers[key] = value.map(function (item) {
+                    if (typeof item === 'string') {
+                        return item.trim();
+                    }
+                });
+            }
+        });
+
+        runned = true;
+
+        // If only one prompt was requested, resolve with its answer
+        if (one) {
+            answers = answers.prompt;
+        }
+
+        callback(null, answers);
+    };
+
+    this.emit('prompt', prompts, fn);
+};
+
+// ------------------
+
+Logger._validPrompts = [
+    'input',
+    'confirm',
+    'password',
+    'checkbox'
+];
+
+Logger.LEVELS = {
+    'error': 5,
+    'conflict': 4,
+    'warn': 3,
+    'action': 2,
+    'info': 1,
+    'debug': 0
+};
+
+// Add helpful log methods
+Object.keys(Logger.LEVELS).forEach(function (level) {
+    Logger.prototype[level] = function (id, message, data) {
+        this.log(level, id, message, data);
+    };
+});
+
+module.exports = Logger;

packages/bower-logger/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "bower-logger",
+  "version": "0.2.1",
+  "description": "The logger used in the various architecture components of Bower.",
+  "author": "Bower",
+  "licenses": [
+    {
+      "type": "MIT",
+      "url": "https://github.com/bower/logger/blob/master/LICENSE"
+    }
+  ],
+  "repository": "https://github.com/bower/bower/tree/master/packages/bower-logger",
+  "main": "lib/Logger",
+  "engines": {
+    "node": ">=0.10.0"
+  },
+  "devDependencies": {
+    "expect.js": "~0.2.0",
+    "mocha": "~1.12.0"
+  },
+  "scripts": {
+    "test": "mocha -R spec"
+  },
+  "files": [
+    "lib"  
+  ]
+}

packages/bower-logger/test/test.js

@@ -0,0 +1,389 @@
+var expect = require('expect.js');
+var EventEmitter = require('events').EventEmitter;
+var Logger = require('../');
+
+describe('Logger', function () {
+    var logger;
+
+    beforeEach(function () {
+        logger = new Logger();
+    });
+
+    describe('.constructor', function () {
+        it('should provide an instance of Logger', function () {
+            expect(logger instanceof Logger).to.be(true);
+        });
+
+        it('should provide an instance of EventEmitter', function () {
+            expect(logger instanceof EventEmitter).to.be(true);
+        });
+
+        it('should have prototype methods', function () {
+            var methods = [
+                    'intercept', 'pipe', 'geminate', 'log'
+                ];
+
+            methods.forEach(function (method) {
+                expect(logger).to.have.property(method);
+            });
+        });
+    });
+
+    describe('events', function () {
+        var logData = {
+            foo: 'bar',
+            baz: 'string'
+        };
+
+        it('should pass through {}', function (next) {
+            logger.on('log', function (log) {
+                expect(log.data).to.eql({});
+                next();
+            });
+            logger.info();
+        });
+
+        it('should pass through logData', function (next) {
+            logger.on('log', function (log) {
+                expect(log.data).to.eql(logData);
+                next();
+            });
+            logger.info('foo', 'message', logData);
+        });
+
+        it('should emit error event', function (next) {
+            logger.on('log', function (log) {
+                expect(log.level).to.eql('error');
+                expect(log.id).to.eql('foo');
+                expect(log.message).to.eql('error message');
+                expect(log.data).to.eql({});
+                next();
+            });
+            logger.error('foo', 'error message');
+        });
+
+        it('should emit conflict event', function (next) {
+            logger.on('log', function (log) {
+                expect(log.level).to.eql('conflict');
+                expect(log.id).to.eql('foo');
+                expect(log.message).to.eql('conflict message');
+                expect(log.data).to.eql({});
+                next();
+            });
+            logger.conflict('foo', 'conflict message');
+        });
+
+        it('should emit warn event', function (next) {
+            logger.on('log', function (log) {
+                expect(log.level).to.eql('warn');
+                expect(log.id).to.eql('foo');
+                expect(log.message).to.eql('warn message');
+                expect(log.data).to.eql({});
+                next();
+            });
+            logger.warn('foo', 'warn message');
+        });
+
+        it('should emit action event', function (next) {
+            logger.on('log', function (log) {
+                expect(log.level).to.eql('action');
+                expect(log.id).to.eql('foo');
+                expect(log.message).to.eql('action message');
+                expect(log.data).to.eql({});
+                next();
+            });
+            logger.action('foo', 'action message');
+        });
+
+        it('should emit info event', function (next) {
+            logger.on('log', function (log) {
+                expect(log.level).to.eql('info');
+                expect(log.id).to.eql('foo');
+                expect(log.message).to.eql('info message');
+                expect(log.data).to.eql({});
+                next();
+            });
+            logger.info('foo', 'info message');
+        });
+
+        it('should emit debug event', function (next) {
+            logger.on('log', function (log) {
+                expect(log.level).to.eql('debug');
+                expect(log.id).to.eql('foo');
+                expect(log.message).to.eql('debug message');
+                expect(log.data).to.eql({});
+                next();
+            });
+            logger.debug('foo', 'debug message');
+        });
+    });
+
+    describe('.intercept', function () {
+        it('should add the function and call it when a log occurs', function (next) {
+            var called;
+            var data = {
+                'some': 'thing'
+            };
+
+            logger.intercept(function (log) {
+                called = true;
+
+                expect(log).to.eql({
+                    level: 'warn',
+                    id: 'foo',
+                    message: 'bar',
+                    data: data
+                });
+                expect(log.data).to.equal(data);
+            });
+
+            logger.log('warn', 'foo', 'bar', data);
+
+            expect(called).to.be(true);
+            next();
+        });
+
+        it('should call the interceptors by order before emitting the event', function (next) {
+            var called = [];
+
+            logger.intercept(function () {
+                called.push(1);
+            });
+            logger.intercept(function () {
+                called.push(2);
+            });
+
+            logger.log('warn', 'foo', 'bar');
+
+            expect(called).to.eql([1, 2]);
+            next();
+        });
+
+        it('should call the interceptors along the chain', function (next) {
+            var called = [];
+            var childLogger = logger.geminate();
+
+            childLogger.intercept(function () {
+                called.push(1);
+            });
+            logger.intercept(function () {
+                called.push(3);
+            });
+
+            childLogger.on('log', function () {
+                called.push(2);
+            });
+            logger.on('log', function () {
+                called.push(4);
+            });
+
+            childLogger.log('warn', 'foo', 'bar');
+
+            expect(called).to.eql([1, 2, 3, 4]);
+            next();
+        });
+    });
+
+    describe('.pipe', function () {
+        it('should return the passed emitter', function () {
+            var otherEmitter = new EventEmitter();
+            expect(logger.pipe(otherEmitter)).to.equal(otherEmitter);
+        });
+
+        it('should pipe log events to another emitter', function (next) {
+            var otherEmitter = new EventEmitter();
+            var data = {
+                'some': 'thing'
+            };
+            var piped;
+
+            logger.pipe(otherEmitter);
+
+            otherEmitter.on('log', function (log) {
+                piped = true;
+                expect(log).to.eql({
+                    level: 'warn',
+                    id: 'foo',
+                    message: 'bar',
+                    data: data
+                });
+            });
+
+            logger.log('warn', 'foo', 'bar', data);
+
+            expect(piped).to.be(true);
+            next();
+        });
+    });
+
+    describe('.geminate', function () {
+        it('should return a new logger instance', function () {
+            var newLogger = logger.geminate();
+
+            expect(newLogger).to.be.an(Logger);
+            expect(newLogger).to.be.an(EventEmitter);
+            expect(newLogger).to.not.be.equal(logger);
+        });
+
+        it('should pipe the new logger events to the original logger', function (next) {
+            var piped = [];
+            var childLogger = logger.geminate();
+            var data = {
+                'some': 'thing'
+            };
+
+            childLogger.on('log', function (log) {
+                piped.push(1);
+                expect(log).to.eql({
+                    level: 'warn',
+                    id: 'foo',
+                    message: 'bar',
+                    data: data
+                });
+                expect(log.data).to.equal(data);
+            });
+
+            logger.on('log', function (log) {
+                piped.push(2);
+                expect(log).to.eql({
+                    level: 'warn',
+                    id: 'foo',
+                    message: 'bar',
+                    data: data
+                });
+                expect(log.data).to.equal(data);
+            });
+
+            childLogger.log('warn', 'foo', 'bar', data);
+            expect(piped).to.eql([1, 2]);
+            next();
+        });
+    });
+
+    describe('.prompt', function () {
+        it('should only allow calling the callback once', function () {
+            var calls = 0;
+
+            logger
+            .once('prompt', function (prompts, callback) {
+                callback({ prompt: 'bar' });
+                callback({ prompt: 'foo' });
+            })
+            .prompt({
+                type: 'input',
+                message: 'foo'
+            }, function () {
+                calls += 1;
+            });
+
+            expect(calls).to.equal(1);
+        });
+
+        it('should accept a prompt', function (next) {
+            logger
+            .once('prompt', function (prompts, callback) {
+                callback({
+                    prompt: 'bar'
+                });
+            })
+            .prompt({
+                type: 'input',
+                message: 'foo'
+            }, function (err, answer) {
+                expect(err).to.not.be.ok();
+                expect(answer).to.equal('bar');
+                next();
+            });
+        });
+
+        it('should accept several prompts', function (next) {
+            logger
+            .once('prompt', function (prompts, callback) {
+                callback({
+                    foo: 'bar',
+                    foz: 'baz'
+                });
+            })
+            .prompt([
+                {
+                    name: 'foo',
+                    type: 'input',
+                    message: 'foo'
+                },
+                {
+                    name: 'foz',
+                    type: 'confirm',
+                    message: 'foz'
+                }
+            ], function (err, answer) {
+                expect(err).to.not.be.ok();
+                expect(answer.foo).to.equal('bar');
+                expect(answer.foz).to.equal('baz');
+
+                logger
+                .once('prompt', function (prompts, callback) {
+                    callback({
+                        foo: 'bar'
+                    });
+                })
+                .prompt([
+                    {
+                        name: 'foo',
+                        type: 'input',
+                        message: 'foo'
+                    }
+                ], function (err, answer) {
+                    expect(err).to.not.be.ok();
+                    expect(answer.foo).to.equal('bar');
+                    next();
+                });
+            });
+        });
+
+        it('should error on invalid prompt type', function (next) {
+            logger.prompt({
+                type: 'xxx',
+                message: 'foo'
+            }, function (err) {
+                expect(err).to.be.an(Error);
+                expect(err.code).to.be('ENOTSUP');
+                next();
+            });
+        });
+
+        it('should trim the answers', function (next) {
+            logger
+            .once('prompt', function (prompts, callback) {
+                callback({
+                    prompt: ' bar '
+                });
+            })
+            .prompt({
+                type: 'input',
+                message: 'foo'
+            }, function (err, answer) {
+                expect(err).to.not.be.ok();
+                expect(answer).to.equal('bar');
+                next();
+            });
+        });
+
+        it('should trim multiple response answers', function (next) {
+            logger
+            .once('prompt', function (prompts, callback) {
+                callback({
+                    prompt: [' bar ', ' foo', 'baz ']
+                });
+            })
+            .prompt({
+                type: 'checkbox',
+                message: 'foo'
+            }, function (err, answer) {
+                expect(err).to.not.be.ok();
+                expect(answer).to.eql(['bar', 'foo', 'baz']);
+                next();
+            });
+        });
+
+    });
+});

packages/bower-registry-client/.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false

packages/bower-registry-client/.gitignore

@@ -0,0 +1,2 @@
+/node_modules
+/npm-debug.*

packages/bower-registry-client/.jshintrc

@@ -0,0 +1,61 @@
+{
+    "predef": [
+        "console",
+        "describe",
+        "it",
+        "after",
+        "afterEach",
+        "before",
+        "beforeEach"
+    ],
+
+    "indent": 4,
+    "node": true,
+    "devel": true,
+
+    "bitwise": false,
+    "curly": false,
+    "eqeqeq": true,
+    "forin": false,
+    "immed": true,
+    "latedef": false,
+    "newcap": true,
+    "noarg": true,
+    "noempty": false,
+    "nonew": true,
+    "plusplus": false,
+    "regexp": false,
+    "undef": true,
+    "unused": "vars",
+    "quotmark": "single",
+    "strict": false,
+    "trailing": true,
+    "camelcase": true,
+
+    "asi": false,
+    "boss": true,
+    "debug": false,
+    "eqnull": true,
+    "esnext": false,
+    "evil": false,
+    "expr": true,
+    "funcscope": false,
+    "globalstrict": false,
+    "iterator": false,
+    "lastsemic": false,
+    "laxbreak": true,
+    "laxcomma": false,
+    "loopfunc": true,
+    "multistr": false,
+    "onecase": true,
+    "regexdash": false,
+    "scripturl": false,
+    "smarttabs": false,
+    "shadow": false,
+    "sub": false,
+    "supernew": true,
+    "validthis": false,
+
+    "nomen": false,
+    "white": true
+}

packages/bower-registry-client/.travis.yml

@@ -0,0 +1,6 @@
+sudo: false
+language: node_js
+node_js:
+  - 'iojs'
+  - '0.12'
+  - '0.10'

packages/bower-registry-client/Client.js

@@ -0,0 +1,70 @@
+var async = require('async');
+var methods = require('./lib');
+var Cache = require('./lib/util/Cache');
+
+function RegistryClient(config, logger) {
+    this._logger = logger;
+    this._config = config;
+
+    if (!this._config.registry) {
+        throw new Error("You need to pass config as read by bower-config module. Registry field is missing.");
+    }
+
+    // Cache defaults to storage registry
+    if (!Object.prototype.hasOwnProperty.call(this._config, 'cache')) {
+        this._config.cache = this._config.storage ? this._config.storage.registry : null;
+    }
+
+    // Init the cache
+    this._initCache();
+}
+
+// Add every method to the prototype
+RegistryClient.prototype.lookup = methods.lookup;
+RegistryClient.prototype.search = methods.search;
+RegistryClient.prototype.list = methods.list;
+RegistryClient.prototype.register = methods.register;
+RegistryClient.prototype.unregister = methods.unregister;
+
+RegistryClient.prototype.clearCache = function (name, callback) {
+    if (typeof name === 'function') {
+        callback = name;
+        name = null;
+    }
+
+    async.parallel([
+        this.lookup.clearCache.bind(this, name),
+        this.search.clearCache.bind(this, name),
+        this.list.clearCache.bind(this)
+    ], callback);
+};
+
+RegistryClient.prototype.resetCache = function (name) {
+    this.lookup.resetCache.call(this, name);
+    this.search.resetCache.call(this, name);
+    this.list.resetCache.call(this);
+
+    return this;
+};
+
+RegistryClient.clearRuntimeCache = function () {
+    Cache.clearRuntimeCache();
+};
+
+// -----------------------------
+
+RegistryClient.prototype._initCache = function () {
+    var cache;
+    var dir = this._config.cache;
+
+    // Cache is stored/retrieved statically to ensure singularity
+    // among instances
+    cache = this.constructor._cache = this.constructor._cache || {};
+    this._cache = cache[dir] = cache[dir] || {};
+
+    this.lookup.initCache.call(this);
+    this.search.initCache.call(this);
+    this.list.initCache.call(this);
+};
+
+module.exports = RegistryClient;

packages/bower-registry-client/Gruntfile.js

@@ -0,0 +1,47 @@
+'use strict';
+module.exports = function (grunt) {
+    grunt.loadNpmTasks('grunt-contrib-jshint');
+    grunt.loadNpmTasks('grunt-contrib-watch');
+    grunt.loadNpmTasks('grunt-simple-mocha');
+
+    grunt.initConfig({
+        jshint: {
+            files: [
+                'Gruntfile.js',
+                'lib/**/*.js',
+                'test/**/*.js'
+            ],
+            options: {
+                jshintrc: '.jshintrc'
+            }
+        },
+        simplemocha: {
+            options: {
+                reporter: 'spec',
+                timeout: 20000
+            },
+            full: {
+                src: ['test/runner.js']
+            },
+            short: {
+                options: {
+                    reporter: 'dot'
+                },
+                src: ['test/runner.js']
+            },
+            build: {
+                options: {
+                    reporter: 'tap'
+                },
+                src: ['test/runner.js']
+            }
+        },
+        watch: {
+            files: ['<%= jshint.files %>'],
+            tasks: ['jshint', 'simplemocha:short']
+        }
+    });
+
+    grunt.registerTask('test', ['simplemocha:full']);
+    grunt.registerTask('default', ['jshint', 'test']);
+};

packages/bower-registry-client/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2012 Twitter and other contributors
+
+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.

packages/bower-registry-client/README.md

@@ -0,0 +1,155 @@
+# bower-registry-client [![Build Status](https://travis-ci.org/bower/registry-client.png?branch=master)](https://travis-ci.org/bower/registry-client)
+
+> Provides easy interaction with the Bower registry
+
+
+## Install
+
+```
+$ npm install --save bower-registry-client
+```
+
+
+## Usage
+
+```js
+var RegistryClient = require('bower-registry-client');
+var Config = require('bower-config');
+var config = Config.read(process.cwd(), options);
+var registry = new RegistryClient(config, logger);
+```
+
+The `logger` is optional and is expected to be an instance of the bower [logger](https://github.com/bower/logger).   
+Available constructor options:
+
+- `cache`: the cache folder to use for some operations; using null will disable persistent cache (defaults to bower registry cache folder)
+- `registry.search`: an array of registry search endpoints (defaults to the Bower server)
+- `registry.register`: the endpoint to use when registering packages (defaults to the Bower server)
+- `registry.publish`: the endpoint to use when publishing packages (defaults to the Bower server)
+- `ca.search`: an array of CA certificates for each registry.search (defaults to null).
+- `ca.register`: the CA certificate for registry.register
+- `ca.publish`: the CA certificate for registry.publish
+- `proxy`: the proxy to use for http requests (defaults to null)
+- `httpsProxy`: the proxy to use for https requests (defaults to null)
+- `strictSsl`: whether or not to do SSL key validation when making requests via https (defaults to true).
+- `userAgent`: the user agent to use for the requests (defaults to null)
+- `timeout`: the timeout for the requests to finish (defaults to 60000)
+- `force`: If set to true, cache will be bypassed and remotes will always be hit (defaults to false).
+- `offline`: If set to true, only the cache will be used (defaults to false).
+
+
+Note that `force` and `offline` are mutually exclusive.
+The cache will speedup operations such as `list`, `lookup` and `search`.
+Different operations may have different cache expiration times.
+
+
+#### .lookup(name, callback)
+
+Looks the registry for the package `name`,
+
+```js
+registry.lookup('jquery', function (err, entry) {
+    if (err) {
+        console.error(err.message);
+        return;
+    }
+
+    // For now resp.type is always 'alias'
+    console.log('type', entry.type);
+    console.log('url', entry.url);
+});
+```
+
+#### .register(name, url, callback)
+
+Registers a package in the registry.
+
+```js
+registry.register('my-package', 'git://github.com/my-org/my-package.git', function (err, pkg) {
+    if (err) {
+        console.error(err.message);
+        return;
+    }
+
+    console.log('name', pkg.name);
+    console.log('url: ', pkg.url);
+});
+```
+
+#### .search(str, callback)
+
+Searches the registry.
+
+```js
+registry.search('jquery', function (err, results) {
+    if (err) {
+        console.error(err.message);
+        return;
+    }
+
+    results.forEach(function (pkg) {
+        console.log('name', pkg.name);
+        console.log('url', pkg.url);
+    });
+});
+```
+
+#### .clearCache(name, callback)
+
+Clears the persistent and runtime cache associated with the `name` package.   
+If `name` is null, clears the cache for every package.
+
+Note that in most cases, you don't need to clear the cache since it has
+self expiration times.
+
+```js
+// Clear jquery cache
+registry.clearCache('jquery', function (err) {
+    if (err) {
+        console.error(err.message);
+        return;
+    }
+
+    console.log('Done');
+});
+
+// Clear all cache
+registry.clearCache(function (err) {
+    if (err) {
+        console.error(err.message);
+        return;
+    }
+
+    console.log('Done');
+});
+```
+
+
+#### .resetCache()
+
+Clears the in-memory cache used to speed up the instance.
+
+Note that in most cases, you don't need to clear the runtime cache since it has
+self expiration times.
+Might be useful if you use this module in long-living programs.
+
+```js
+registry.resetCache();
+```
+
+#### #clearRuntimeCache()
+
+Clears the in-memory cache used to speed up the whole module.
+This clears the static in-memory cache as well as in-memory cache used by instances.
+
+Note that in edge cases, some instance's in-memory cache might be skipped.
+If that's a problem, you should create fresh instances instead.
+
+```js
+RegistryClient.clearRuntimeCache();
+```
+
+
+## License
+
+Released under the [MIT License](http://www.opensource.org/licenses/mit-license.php).