init

Author: jonathanong

.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

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,21 @@
+# 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`
+- All 5 different ways you could download a freaking tarball/zipball
+
+## 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.

index.js

@@ -0,0 +1,49 @@
+
+var parse = require('url').parse
+
+module.exports = function (string) {
+  // user/repo#version
+  var m = /^([\w-]+)\/([\w-.]+)((?:#|@).+)?$/.exec(string)
+  if (m) return format(m)
+
+  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,19 @@
+{
+  "name": "parse-github-repo-url",
+  "description": "Parse a GitHub URL for user/project@version",
+  "version": "1.0.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"
+  },
+  "scripts": {
+    "test": "mocha --reporter spec --bail"
+  }
+}

test.js

@@ -0,0 +1,39 @@
+
+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))
+    })
+  })
+})
+
+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))
+    })
+  })
+})