Skip to content
A Node.js module that returns the OS/Distribution name of the environment you are working on
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
imgs
logic
tests
.gitignore
.travis.yml
Dockerfile
LICENSE
README.md
index.js
os.json
package.json
test.js

README.md

getos

Greenkeeper badge

getos

Build Status

NPMNPM

JavaScript Style Guide

Get the OS/Distribution name of the environment you are working on

Problem

os.platform() returns linux. If you want the distrubtion name, you're out of luck.

Solution

This. Simply call:

var getos = require('getos')

getos(function(e,os) {
  if(e) return console.log(e)
  console.log("Your OS is:" +JSON.stringify(os))
})

The os object conforms to:

{
  os: [OS NAME],
  dist:[DIST NAME],
  codename:[CODENAME],
  release:[VERSION]
}

For example:

{
  os: "linux",
  dist: "Ubuntu Linux",
  codename: "precise",
  release: "12.04"
}

Disclaimer

Check os.json in this repo. Any distribution that shares a common resource file with another distrubtion is currently untested. These are the arrays of distrubitons with more than 1 member. If you are using one of these distrubtions, please submit an issue letting me know if it works. If it fails, please post the content of the file.

If you have a distrubtion not in os.json, please identify your resource file and submit it's name and content along with your distrbution/version in an issue.

Thanks for helping make this tool great.

Unit Tests

Unit tests stub out the behaviour of the OS files and libraries we depend on to ensure the behaviour of the application is sound. You can run these simply by running npm test

Authors and Contributors

getos has been made possible by these fantastic contributors:

Benjamin E. CoeGitHub/bcoeTwitter/@benjamincoe
Eugene SharyginGitHub/eush77Twitter/@eush77
David RouthieauGitHub/root-iounknown
LawrenceGitHub/mindmeltingTwitter/@mindmelting
Roman JurkovGitHub/winfinitTwitter/@winfinit
Rod VaggGitHub/rvaggTwitter/@rvagg
Zeke SikelianosGitHub/zekeTwitter/@zeke
AlexanderGitHub/alex4ZeroTwitter/@alex4Zero
You can’t perform that action at this time.