{"maintainers":[{"name":"doowb","email":"brian.woodward@gmail.com"}],"keywords":["home","homedir","homedirectory","os","os-homedir","polyfill","userhome"],"dist-tags":{"latest":"1.0.1"},"author":{"name":"Brian Woodward","url":"https://github.com/doowb"},"description":"Node.js os.homedir polyfill for older versions of node.js.","readme":"# homedir-polyfill [![NPM version](https://img.shields.io/npm/v/homedir-polyfill.svg?style=flat)](https://www.npmjs.com/package/homedir-polyfill) [![NPM downloads](https://img.shields.io/npm/dm/homedir-polyfill.svg?style=flat)](https://npmjs.org/package/homedir-polyfill) [![Linux Build Status](https://img.shields.io/travis/doowb/homedir-polyfill.svg?style=flat&label=Travis)](https://travis-ci.org/doowb/homedir-polyfill) [![Windows Build Status](https://img.shields.io/appveyor/ci/doowb/homedir-polyfill.svg?style=flat&label=AppVeyor)](https://ci.appveyor.com/project/doowb/homedir-polyfill)\n\n> Node.js os.homedir polyfill for older versions of node.js.\n\n## Install\n\nInstall with [npm](https://www.npmjs.com/):\n\n```sh\n$ npm install --save homedir-polyfill\n```\n\n## Usage\n\n```js\nvar homedir = require('homedir-polyfill');\nconsole.log(homedir());\n//=> /Users/doowb\n```\n\n## Reasoning\n\nThis library is a polyfill for the [node.js os.homedir](https://nodejs.org/api/os.html#os_os_homedir) method found in modern versions of node.js.\n\nThis implementation tries to follow the implementation found in `libuv` by finding the current user using the `process.geteuid()` method and the `/etc/passwd` file. This should usually work in a linux environment, but will also fallback to looking at user specific environment variables to build the user's home directory if neccessary.\n\nSince `/etc/passwd` is not available on windows platforms, this implementation will use environment variables to find the home directory.\n\nIn modern versions of node.js, [os.homedir](https://nodejs.org/api/os.html#os_os_homedir) is used.\n\n## About\n\n### Related projects\n\n[parse-passwd](https://www.npmjs.com/package/parse-passwd): Parse a passwd file into a list of users. | [homepage](https://github.com/doowb/parse-passwd \"Parse a passwd file into a list of users.\")\n\n### Contributing\n\nPull requests and stars are always welcome. For bugs and feature requests, [please create an issue](../../issues/new).\n\nPlease read the [contributing guide](contributing.md) for avice on opening issues, pull requests, and coding standards.\n\n### Building docs\n\n_(This document was generated by [verb-generate-readme](https://github.com/verbose/verb-generate-readme) (a [verb](https://github.com/verbose/verb) generator), please don't edit the readme directly. Any changes to the readme must be made in [.verb.md](.verb.md).)_\n\nTo generate the readme and API documentation with [verb](https://github.com/verbose/verb):\n\n```sh\n$ npm install -g verb verb-generate-readme && verb\n```\n\n### Running tests\n\nInstall dev dependencies:\n\n```sh\n$ npm install -d && npm test\n```\n\n### Author\n\n**Brian Woodward**\n\n* [github/doowb](https://github.com/doowb)\n* [twitter/doowb](http://twitter.com/doowb)\n\n### License\n\nCopyright © 2016, [Brian Woodward](https://github.com/doowb).\nReleased under the [MIT license](LICENSE).\n\n***\n\n_This file was generated by [verb-generate-readme](https://github.com/verbose/verb-generate-readme), v0.2.0, on October 19, 2016._","repository":{"type":"git","url":"git+https://github.com/doowb/homedir-polyfill.git"},"bugs":{"url":"https://github.com/doowb/homedir-polyfill/issues"},"license":"MIT","versions":{"1.0.0":{"name":"homedir-polyfill","description":"Node.js os.homedir polyfill for node versions 0.10 and before.","version":"1.0.0","homepage":"https://github.com/doowb/homedir-polyfill","author":{"name":"Brian Woodward","url":"https://github.com/doowb"},"repository":{"type":"git","url":"git+https://github.com/doowb/homedir-polyfill.git"},"bugs":{"url":"https://github.com/doowb/homedir-polyfill/issues"},"license":"MIT","files":["index.js","LICENSE"],"main":"index.js","engines":{"node":">=0.10.0"},"scripts":{"test":"mocha"},"devDependencies":{"gulp-format-md":"^0.1.11","mocha":"^3.1.2"},"keywords":["home","homedir","homedirectory","os","os-homedir","polyfill","userhome"],"verb":{"toc":false,"layout":"default","tasks":["readme"],"plugins":["gulp-format-md"],"lint":{"reflinks":true},"related":{"list":["parse-passwd"]},"reflinks":["verb","verb-generate-readme"]},"dependencies":{"parse-passwd":"^1.0.0"},"gitHead":"47a504df1ace0a66b8e0eea535f8f8c6fd38ff9c","_id":"homedir-polyfill@1.0.0","_shasum":"2f07f0dc32bd6f0384cd8c2a103824917fc6e321","_from":".","_npmVersion":"3.7.5","_nodeVersion":"5.1.1","_npmUser":{"name":"doowb","email":"brian.woodward@gmail.com"},"dist":{"shasum":"2f07f0dc32bd6f0384cd8c2a103824917fc6e321","tarball":"http://nexus.dui88.com:8081/nexus/content/groups/npm-all/homedir-polyfill/-/homedir-polyfill-1.0.0.tgz"},"maintainers":[{"name":"doowb","email":"brian.woodward@gmail.com"}],"_npmOperationalInternal":{"host":"packages-12-west.internal.npmjs.com","tmp":"tmp/homedir-polyfill-1.0.0.tgz_1476899249450_0.5684890684206039"},"directories":{}},"1.0.1":{"name":"homedir-polyfill","description":"Node.js os.homedir polyfill for older versions of node.js.","version":"1.0.1","homepage":"https://github.com/doowb/homedir-polyfill","author":{"name":"Brian Woodward","url":"https://github.com/doowb"},"repository":{"type":"git","url":"git+https://github.com/doowb/homedir-polyfill.git"},"bugs":{"url":"https://github.com/doowb/homedir-polyfill/issues"},"license":"MIT","files":["index.js","LICENSE"],"main":"index.js","engines":{"node":">=0.10.0"},"scripts":{"test":"mocha"},"devDependencies":{"gulp-format-md":"^0.1.11","mocha":"^3.1.2"},"keywords":["home","homedir","homedirectory","os","os-homedir","polyfill","userhome"],"verb":{"toc":false,"layout":"default","tasks":["readme"],"plugins":["gulp-format-md"],"lint":{"reflinks":true},"related":{"list":["parse-passwd"]},"reflinks":["verb","verb-generate-readme"]},"dependencies":{"parse-passwd":"^1.0.0"},"gitHead":"e052b447041d10f4eb4140ab1569a9c8f5f78cd7","_id":"homedir-polyfill@1.0.1","_shasum":"4c2bbc8a758998feebf5ed68580f76d46768b4bc","_from":".","_npmVersion":"3.7.5","_nodeVersion":"5.1.1","_npmUser":{"name":"doowb","email":"brian.woodward@gmail.com"},"dist":{"shasum":"4c2bbc8a758998feebf5ed68580f76d46768b4bc","tarball":"http://nexus.dui88.com:8081/nexus/content/groups/npm-all/homedir-polyfill/-/homedir-polyfill-1.0.1.tgz"},"maintainers":[{"name":"doowb","email":"brian.woodward@gmail.com"}],"_npmOperationalInternal":{"host":"packages-12-west.internal.npmjs.com","tmp":"tmp/homedir-polyfill-1.0.1.tgz_1480604864152_0.3404128428082913"},"directories":{}}},"name":"homedir-polyfill","time":{"modified":"2016-12-01T15:07:46.123Z","created":"2016-10-19T17:47:31.386Z","1.0.0":"2016-10-19T17:47:31.386Z","1.0.1":"2016-12-01T15:07:46.123Z"},"readmeFilename":"README.md","homepage":"https://github.com/doowb/homedir-polyfill"}