NPM Platform Dependencies (Cactusoft fork)

Small script that allows you to specify OS-specific dependencies in your package.json and install them only in that OS.

Install via:

npm install npm-platform-dependencies

Specify your packages inside package.json

Specify the specific dependencies for each platform, like:

"darwinDependencies": {
    "nodobjc": "latest"
},
"win32Dependencies": {
    "edge": "latest"
}

Then run:

npmpd

And that's it! Depending the platform where you run the command, it will install one or the other (or nothing if linux).

Use with npm install

To use it just after npm install, put this script on the scripts section of package.json

"postinstall": "npmpd"

Append your own arguments to the install process

Simply add any arguments to the npmpd call to have them appended to the npm install process. The example below shows how you could append the --ignore-scripts argument to the install process.

npmpd --ignore-scripts

Or append the arguments at the scripts section of package.json

"postinstall": "npmpd --ignore-scripts"

Inside the code

Be sure to make your code detect the platform you are running on, or you will end up requiring things you don't have installed!

Motivation

I came across a problem where it would be useful to specify platform specific dependencies. For instance, when trying to deal with addons that connect to specific os frameworks (Cocoa, .NET...). This is an easy solution if you don't want to deal with building a native addon with node-gyp, if the functionalities you need are already in different os specific packages.

Another use case would be when dealing with wrappers of os specific programs, and you want to link to one or the other depending the platform you run your program with.

What's different in this forked version?

We needed a way to manually specify the platform, so we implemented two different ways to go about it.

Specify platform with environment variable

Set the "NPMPD_PLATFORM" environment variable to the desired platform. Ex.: export NPMPD_PLATFORM="win32"

Specify platform with arguments

Pass the --platform argument. Ex.: npmpd --platform=win32

Priorities?

From the highest priority to the lowest:

1. Argument
2. Environment variable
3. Auto-detected

License

MIT License Copyright (c) 2016 Alberto Fernandez