summaryrefslogtreecommitdiff
path: root/includes/search/node_modules/github-from-package/readme.markdown
diff options
context:
space:
mode:
Diffstat (limited to 'includes/search/node_modules/github-from-package/readme.markdown')
-rw-r--r--includes/search/node_modules/github-from-package/readme.markdown53
1 files changed, 53 insertions, 0 deletions
diff --git a/includes/search/node_modules/github-from-package/readme.markdown b/includes/search/node_modules/github-from-package/readme.markdown
new file mode 100644
index 0000000..5ba397d
--- /dev/null
+++ b/includes/search/node_modules/github-from-package/readme.markdown
@@ -0,0 +1,53 @@
+# github-from-package
+
+return the github url from a package.json file
+
+[![build status](https://secure.travis-ci.org/substack/github-from-package.png)](http://travis-ci.org/substack/github-from-package)
+
+# example
+
+For the `./package.json` file:
+
+``` json
+{
+ "name": "beep-boop",
+ "version": "1.2.3",
+ "repository" : {
+ "type" : "git",
+ "url": "git@github.com:substack/beep-boop.git"
+ }
+}
+```
+
+``` js
+var github = require('github-from-package');
+var url = github(require('./package.json'));
+console.log(url);
+```
+
+```
+https://github.com/substack/beep-boop
+```
+
+# methods
+
+``` js
+var github = require('github-from-package')
+```
+
+## var url = github(pkg)
+
+Return the most likely github url from the package.json contents `pkg`. If no
+github url can be determined, return `undefined`.
+
+# install
+
+With [npm](https://npmjs.org) do:
+
+```
+npm install github-from-package
+```
+
+# license
+
+MIT