07.05.2023 - FIX: Support for android platforms (experimental) 05.05.2023 - FIX: /etc/os-release to determine linux distro - fix by: @qihangnet 20.03.2023 - FIX: fails to return info on CentOS: fix by: @DonJayamanne
19.05.2022 - Added support for Kali Linux.
02.04.2022 - Added github workflows and now works also with MacOS.
15.01.2022 Upgrade - Now works also with import as module.
NOTE: 1.x USERS: Also 1.x Users can still move to this version but they will need to change the way to load @nexssp/os plugin from require("@nexssp/os") to require("@nexssp/os/legacy")
- NEW: FreeBSD and Gentoo supported.
- NEW: terminal functions eg.
nexssp-os env
nexssp-os get # displays information about any system (etc/os-release)
nexssp-os install nodejs --dry # displays install command for your os
nexssp-os uninstall nodejs --json # uninstalls and shows result as json data
nexssp-os search nodejs
nexssp-os update nodejs- NEW: Functions
.where()- finds program and return path. Option to find multiple files at once with --all option - NEW API: Example
const nexssOS = require('@nexssp/os')
const nexssOS1 = nexssOS()
// in terminal nexssp-os install nodejs
// 2.0.7+ you can also pass string like .install('nodejs')
const result1 = nexssOS1.install(['nodejs'], { dry: true }) // dry will return the install command for the OS the command is run
//eg for Ubuntu it will be apt-get update, for gentoo emerge, ...etc. Without dry it will execute the command displayed with dry.
const result2 = nexssOS1.uninstall(['nodejs'], { json: true }) // uninstall package - json will return json data
nexssOS1.search(['nodejs']) // search for packages
nexssOS1.update(['nodejs']) // update- NEW 1.0.30+ -
os.pathWinToLinux(path)- converts windows path to linux -> handy with WSL automations (Windows Subsystem for Linux).
Note: This function is used in the Nexss Programmer to implement Crystal Language for Windows through WSL.
npm i @nexssp/os// For legacy functions 1.x as this. See above for 2.x
const os = require('@nexssp/os/legacy')
console.log(os.name()) // shows distro nameDetect Linux distro name and version, check if user is root, and some other info. Also works for Windows showing name as Windows and version like 10.0.19041
Recognize different distros and Windows versions by tags. Example:
// With no parameters it shows tags for the current os
console.log(nexssOS1.getTags('Ubuntu', '20.10')) // [ 'UBUNTU', 'UBUNTU20', 'UBUNTU2010' ]
console.log(nexssOS1.getTags('Ubuntu', 20.1)) // [ 'UBUNTU', 'UBUNTU20', 'UBUNTU201' ]
console.log(nexssOS1.getTags()) // [ 'WINDOWS', 'WINDOWS10', 'WINDOWS100' ] current OS tags
console.log(nexssOS1.getTags('Ubuntu', '20.10').first()) // UBUNTU
console.log(nexssOS1.getTags('Ubuntu', 20.1).second()) // UBUNTU20
console.log(nexssOS1.getTags().third()) // WINDOWS100// LEGACY Tags - still works!
// For Ubuntu 18
console.log('tags(prefix)', os.tags('prFX:')) // [ 'prFX:UBUNTU18', 'prFX:UBUNTU' ]
// For Windows
console.log('tags(prefix)', os.tags('prFX:')) // [ 'prFX:WINDOWS10', 'prFX:WINDOWS' ]- Added Amazon Linux AMI distro and package manager setup.
- function
sudo()which contain sudo where user is not admin and nothing if it is. It helps writing installers so automatically will add sudo if needed and for example docker containers will leave it blank. eg${sudo()}apt-get install -y somepackage - function
replacePMByDistro()which replaces default (apt-get install -y) to the host distribution. For example${os.replacePMByDistro('apt-get install -y nexss')}, will on Fedora replace with dnf install, on Ubuntu will not replace it as it is default, on Alpine it will be apk, on Oracle Linux yum install or dns install depends on your linux distribution...
module.exports.distros = {
ALPINE: 'Alpine Linux',
AMAZON: 'Amazon Linux',
AMAZON_AMI: 'Amazon Linux AMI',
ARCH: 'Arch Linux',
CENTOS: 'CentOS Linux',
DEBIAN: 'Debian GNU/Linux',
FREEBSD: 'FreeBSD',
FEDORA: 'Fedora',
GENTOO: 'Gentoo',
MINT: 'Linux Mint',
NIXOS: 'NixOS',
ORACLE: 'Oracle Linux Server',
RHEL: 'RHEL Linux',
SUSE_LEAP: 'openSUSE Leap',
SUSE_TUMBLEWEED: 'openSUSE Tumbleweed',
UBUNTU: 'Ubuntu',
WINDOWS: 'Windows',
MACOS: 'MacOS',
}const os = require('@nexssp/os/legacy')
// Distros
console.log('distrosList', os.distros)
console.log('isRoot: ', os.isRoot())
console.log('name: ', os.name())
console.log('get("name"): ', os.get('NAME'))
console.log('v: ', os.v())
console.log('get("VERSION_ID"): ', os.get('VERSION_ID'))
console.log('get("VERSION_IDxxx"): ', os.get('VERSION_IDxxx')) // does not exist so nothing is return
console.log('get()', os.get()) // display all available data - different for each distros
// Example
// DISTRIB_ID: 'Ubuntu',
// DISTRIB_RELEASE: '18.04',
// DISTRIB_CODENAME: 'bionic',
// DISTRIB_DESCRIPTION: 'Ubuntu 18.04.5 LTS',
// NAME: 'Ubuntu',
// VERSION: '18.04.5 LTS (Bionic Beaver)',
// ID: 'ubuntu',
// ID_LIKE: 'debian',
// PRETTY_NAME: 'Ubuntu 18.04.5 LTS',
// VERSION_ID: '18.04',
// HOME_URL: 'https://www.ubuntu.com/',
// SUPPORT_URL: 'https://help.ubuntu.com/',
// BUG_REPORT_URL: 'https://bugs.launchpad.net/ubuntu/',
// PRIVACY_POLICY_URL: 'https://www.ubuntu.com/legal/terms-and-policies/privacy-policy',
// VERSION_CODENAME: 'bionic',
// UBUNTU_CODENAME: 'bionic'
console.log('getShell() - your OS Shell', os.getShell()) // display current OS
console.log('getShell(ALPINE)', os.getShell(os.distros.ALPINE)) // defined OS Shell
console.log('getShell(MACOS)', os.getShell(os.distros.MACOS)) // defined OS Shell
// Package managers
console.log('getPM(install):', os.getPM()) // Displays install command
console.log('getPM(update):', os.getPM('update')) // Displays update command
console.log('getPM(uninstall):', os.getPM('uninstall')) // Displays update command
console.log('getPM(search):', os.getPM('search')) // Displays search command
console.log('tags(prefix)', os.tags('prFX:')) // [ 'prFX:WINDOWS10', 'prFX:WINDOWS' ]
// Sudo - shows when there is no admin, handy to write automations on eg. docker containers
console.log(`${os.sudo()}apt-get install -y mypackage`)
console.log(
`Replaces apt install/update/uninstall to the right for distribution: ${os.replacePMByDistro(
'apt-get install -y mypackage'
)}`
)
console.log('getShell() - your OS Shell', os.getShell()) // display current OS eg /bin/bash
console.log(
`pathWinToLinux("C:\\Users\\mapoart\\testok"):`,
os.pathWinToLinux('C:\\Users\\mapoart\\testok')
) // /mnt/c/Users/mapoart/testok