reinit

Author: bahmutov

.gitignore

@@ -0,0 +1,66 @@
+# Compiled source #
+###################
+*.com
+*.class
+*.dll
+*.exe
+*.o
+*.so
+
+# Packages #
+############
+# it's better to unpack these files and commit the raw source
+# git has its own built in compression methods
+*.7z
+*.dmg
+*.gz
+*.iso
+*.jar
+*.rar
+*.tar
+*.zip
+
+# Logs and databases #
+######################
+*.log
+*.sql
+*.sqlite
+
+# OS generated files #
+######################
+.DS_Store*
+ehthumbs.db
+Icon?
+Thumbs.db
+
+# Node.js #
+###########
+lib-cov
+*.seed
+*.log
+*.csv
+*.dat
+*.out
+*.pid
+*.gz
+
+pids
+logs
+results
+
+node_modules
+npm-debug.log
+
+# Git #
+#######
+*.orig
+*.BASE.*
+*.BACKUP.*
+*.LOCAL.*
+*.REMOTE.*
+
+# Components #
+##############
+
+/build
+/components

.travis.yml

@@ -0,0 +1,10 @@
+language: node_js
+node_js:
+  - "0.10"
+  - "0.12"
+  - "4"
+branches:
+  only:
+    - master
+script:
+  - npm test

LICENSE

@@ -0,0 +1,22 @@
+
+The MIT License (MIT)
+
+Copyright (c) 2014 Jonathan Ong [email protected]
+
+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.

README.md

@@ -0,0 +1,28 @@
+# Parse GitHub Repo URL
+
+Parse all the stupid ways you could write a GitHub URL in your damn `package.json`.
+Supports:
+
+- `<user>/<repo#<commit>`
+- `git://` and `.git` w/ `#commit` or `@version`
+- `git@` and `https:git@`
+- `www.github.com`
+- All 5 different ways you could download a freaking tarball/zipball
+
+[![Build status][ci-image] ][ci-url]
+
+## API
+
+### [user, repo, version] = parse(url)
+
+`version` could be `false`y, a semantic version, a commit, or a branch, etc.
+
+```js
+var parse = require('parse-github-repo-url')
+parse('component/emitter#1') // => ['component', 'emitter', '1']
+```
+
+See the tests for all the different types of supported URLs.
+
+[ci-image]: https://travis-ci.org/repo-utils/parse-github-repo-url.png?branch=master
+[ci-url]: https://travis-ci.org/repo-utils/parse-github-repo-url

index.js

@@ -0,0 +1,57 @@
+
+var parse = require('url').parse
+
+module.exports = function (string) {
+  // user/repo#version
+  var m = /^([\w-]+)\/([\w-.]+)((?:#|@).+)?$/.exec(string)
+  if (m) return format(m)
+
+  string = string.replace('//www.', '//')
+  // normalize git@ and https:git@ urls
+  string = string.replace(/^git@/, 'https://')
+  string = string.replace(/^https:git@/, 'https://')
+  string = string.replace('.com:', '.com/')
+
+  if (!~string.indexOf('://')) {
+    return false
+  }
+  var url = parse(string)
+
+  switch (url.hostname) {
+  case 'github.com':
+  case 'api.github.com':
+  case 'codeload.github.com':
+    break
+  default:
+    return false
+  }
+
+  var path = url.pathname.replace(/\.git$/, '')
+
+  // https://www.npmjs.org/doc/json.html#Git-URLs-as-Dependencies
+  var m = /^\/([\w-]+)\/([\w-.]+)$/.exec(path)
+  if (m) return m.slice(1, 3).concat((url.hash || '').slice(1))
+
+  // archive link
+  // https://developer.github.com/v3/repos/contents/#get-archive-link
+  var m = /^\/repos\/([\w-]+)\/([\w-.]+)\/(?:tarball|zipball)(\/.+)?$/.exec(path)
+  if (m) return format(m)
+
+  // codeload link
+  // https://developer.github.com/v3/repos/contents/#response-4
+  var m = /^\/([\w-]+)\/([\w-.]+)\/(?:legacy\.(?:zip|tar\.gz))(\/.+)?$/.exec(path)
+  if (m) return format(m)
+
+  // tarball link
+  // https://github.com/LearnBoost/socket.io-client/blob/master/package.json#L14
+  var m = /^\/([\w-]+)\/([\w-.]+)\/archive\/(.+)\.tar\.gz?$/.exec(path)
+  if (m) return m.slice(1, 4)
+
+  return false
+}
+
+function format(m) {
+  var version = (m[3] || '').slice(1)
+  if (/^['"]/.test(version)) version = version.slice(1, -1)
+  return [m[1], m[2], version]
+}

package.json

@@ -0,0 +1,20 @@
+{
+  "name": "parse-github-repo-url",
+  "description": "Parse a GitHub URL for user/project@version",
+  "version": "1.1.0",
+  "author": {
+    "name": "Jonathan Ong",
+    "email": "[email protected]",
+    "url": "http://jongleberry.com",
+    "twitter": "https://twitter.com/jongleberry"
+  },
+  "license": "MIT",
+  "repository": "repo-utils/parse-github-repo-url",
+  "devDependencies": {
+    "mocha": "1"
+  },
+  "main": "index.js",
+  "scripts": {
+    "test": "mocha --reporter spec --bail"
+  }
+}

test.js

@@ -0,0 +1,81 @@
+
+var assert = require('assert')
+
+var parse = require('./')
+
+describe('versionless', function () {
+  [
+    'component/emitter',
+    'https://github.com/component/emitter',
+    'git://github.com/component/emitter.git',
+    'https://github.com/repos/component/emitter/tarball',
+    'https://github.com/repos/component/emitter/zipball',
+    'https://codeload.github.com/component/emitter/legacy.zip',
+    'https://codeload.github.com/component/emitter/legacy.tar.gz',
+  ].forEach(function (url) {
+    it(url, function () {
+      assert.deepEqual(['component', 'emitter', ''], parse(url))
+    })
+  })
+
+  it('works for www.github.com', function () {
+    var url = 'https://www.github.com/component/emitter'
+    var parsed = parse(url)
+    assert.deepEqual(['component', 'emitter', ''], parsed)
+  })
+
+  it('works for http://www.github.com', function () {
+    var url = 'http://www.github.com/component/emitter'
+    var parsed = parse(url)
+    assert.deepEqual(['component', 'emitter', ''], parsed)
+  })
+})
+
+describe('versioned', function () {
+  [
+    'component/emitter#1',
+    'component/emitter@1',
+    'component/emitter#"1"',
+    'component/emitter@"1"',
+    'git://github.com/component/emitter.git#1',
+    'https://github.com/repos/component/emitter/tarball/1',
+    'https://github.com/repos/component/emitter/zipball/1',
+    'https://codeload.github.com/component/emitter/legacy.zip/1',
+    'https://codeload.github.com/component/emitter/legacy.tar.gz/1',
+    'https://github.com/component/emitter/archive/1.tar.gz',
+  ].forEach(function (url) {
+    it(url, function () {
+      assert.deepEqual(['component', 'emitter', '1'], parse(url))
+    })
+  })
+})
+
+describe('url parse', function () {
+  var builtinUrlParse = require('url').parse
+
+  it('handles https:// url', function () {
+    var url = 'https://foo.com/bar'
+    var parsed = builtinUrlParse(url)
+    assert.equal('foo.com', parsed.hostname)
+  })
+
+  it('does not handle emails', function () {
+    var url = '[email protected]/bar'
+    var parsed = builtinUrlParse(url)
+    assert.equal(null, parsed.hostname, JSON.stringify(parsed))
+  })
+})
+
+describe('git @ syntax', function () {
+  it('works for git url', function () {
+    var url = '[email protected]:bahmutov/lazy-ass.git'
+    var parsed = parse(url)
+    assert.deepEqual(['bahmutov', 'lazy-ass', ''], parsed)
+  });
+
+  it('works for https:git url', function () {
+    var url = 'https:[email protected]:bahmutov/lazy-ass.git'
+    var parsed = parse(url)
+    assert.deepEqual(['bahmutov', 'lazy-ass', ''], parsed)
+  });
+})