pwuid

> getpwuid() for Node.js - returns username, name, home directory, shell, gid from uid

If you're creating a reusable module you should probably use passwd-user instead, as it shells out rather than using a native binding.

Install

``sh
npm install pwuid
`

This is a native binding and expects you to have the required toolchain. (ignore the node-gyp install)

Windows

getpwuid() is a POSIX function and won't work on Windows.

Use optionalDependencies if you need to include it in a cross-platform environment.

Usage

`js
import pwuid from 'pwuid';

console.log(pwuid());
/*
{
name: 'sindresorhus',
uid: 501,
gid: 20,
gecos: 'Sindre Sorhus',
dir: '/Users/sindresorhus',
shell: '/bin/zsh'
}
*/
`

API

Accepts a uid number and returns an object with:

- name: username
- uid: user ID, same as supplied
- gid: group ID
- gecos: user information, usually the users full name
- dir: home directory
- shell: default shell

It will use the current user process.getuid() if no uid` is given.