Skip to content

runesoeknudsen/node-userid

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

188 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

userid

Simple nodejs library with native bindings for getting uid and gid information.

Coverage Status

Installation

$ npm install userid
# Or, alternatively, directly from github:
$ npm install cinderblock/node-userid

This relies on GNU getgrname and getgrid. Works on POSIX systems only. This package is not useful on Windows.

Usage

Example

var userid = require("userid");

// get user id
console.log("root's uid is:", userid.uid("root"));

// get group id
console.log("wheel's gid is:", userid.gid("wheel"));

// get user name
console.log("uid 0 name is:", userid.username(0));

// get group name
console.log("gid 0 name is:", userid.groupname(0));

History

This package was originally created by Jen Andre jandre@gmail.com.

In 2019, it was, unfortunately, missing updates that are required to run on the latest versions of Node.js.

Since Jen has not responded to any attempts at contact, I requested that Npm transfer the package so that I might keep it maintained.

Version 1.0.0 switched to N-API, the forward compatible interface that should be, all around, much nicer moving forward. It also signals the change to using Github Actions to run all our full coverage tests on all supported platforms.

License

The license, when the package was created, had some mix of GLPv3 and Public Domain.

Since the main source code has always been Public Domain, I'm going to keep it that way. I've also explicitly extended it to the rest of the main (published) source code.

Event though Jen's before last commit (ba665c45d958982ff5aa0d482741a2955a4de8c4) changed the license in one location to MIT, the tests, build files, and other scripts (especially those by other contributors) were added under the GPLv3. I'm therefore inclined to think it's better to not hold to that final license change.

Going forward, all published source code (the part that you use as a user of this package) will be all Public Domain. The rest of this package will stay GPLv3.

© 2019 Cameron Tacklind cameron@tacklind.com

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

About

A small native module to lookup uid and gid information in node.js

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • C++ 67.6%
  • JavaScript 25.2%
  • Python 7.2%