Add @Package tag and tests

Author: garrettreed

.gitignore

@@ -0,0 +1 @@
+node_modules

bit-docs.js

@@ -0,0 +1,7 @@
+var pkg = require("./package");
+
+module.exports =  function(bitDocs) {
+    bitDocs.register("tags",{
+    	package: pkg
+    });
+};

package.js

@@ -0,0 +1,21 @@
+var path = require("path");
+var fs = require("fs");
+
+var typeConverters = {
+  stache: 'html',
+  mustache: 'html',
+  component: 'html'
+};
+
+var convertType = function(type) {
+  return typeConverters[type] || type;
+};
+
+module.exports = {
+    add: function(line, curData, scope, objects, currentWrite) {
+		var sourcePath = path.join(path.dirname(this.src.path));
+		var pkgPath = line.split(' ')[1];
+		var pkg = require(path.join(sourcePath, pkgPath));
+		curData.package = pkg;
+    }
+};

package.json

@@ -0,0 +1,33 @@
+{
+  "name": "bit-docs-tag-package",
+  "version": "0.0.1",
+  "description": "Reference package's package.json",
+  "main": "package.js",
+  "scripts": {
+    "test": "mocha test/test.js --reporter spec",
+    "postversion": "git push --tags && git push",
+    "preversion": "npm test",
+    "release:pre": "npm version prerelease && npm publish",
+    "release:patch": "npm version patch && npm publish",
+    "release:minor": "npm version minor && npm publish",
+    "release:major": "npm version major && npm publish"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bit-docs/bit-docs-tag-package.git"
+  },
+  "keywords": [
+    "bit-docs",
+    "donejs"
+  ],
+  "author": "Bitovi",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/bit-docs/bit-docs-tag-package/issues"
+  },
+  "homepage": "https://github.com/bit-docs/bit-docs-tag-package#readme",
+  "devDependencies": {
+    "bit-docs-process-tags": "0.0.5",
+    "mocha": ">= 1.18.0"
+  }
+}

readme.md

@@ -0,0 +1,7 @@
+# bit-docs `@package`
+
+Adds a `@package` tag for use in `bit-docs`
+
+`@package` will add the package's `package.json` info to the `docObject`.
+
+Use: `@pacakge ../../package.json`

test/code/js/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "package-test",
+  "version": "0.0.1",
+  "description": "A test for bit-docs @package tag",
+  "main": "foo.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "",
+  "license": "ISC"
+}

test/test.js

@@ -0,0 +1,33 @@
+var processTags = require("bit-docs-process-tags");
+var pkg = require("../package");
+var path = require("path");
+var assert = require("assert");
+
+describe("sourceref", function() {
+    it("adds the package.json info", function() {
+		var docMap = {};
+
+		processTags({
+			comment: "@constructor\n@package ./js/package.json",
+			scope: {},
+			docMap: docMap,
+			docObject: {
+                src: {
+                    path: path.join(__dirname, "code","test.js")
+                }
+            },
+			tags: {
+                package: pkg,
+                constructor: {
+    				add : function() {
+    					this.name = "constructed";
+    					this.type = "constructor";
+    					return ["scope", this];
+    				}
+    			}
+            }
+		}, function(newDoc, newScope) {
+            assert.ok(newDoc.package.version === '0.0.1');
+		});
+	});
+});