virtualenv
v0.3.1
Published
install and use Python dependencies in node with virtualenv
Downloads
136
Readme
node-virtualenv
node-virtualenv enables Python dependencies in your node projects, without cluttering up the system environment.
For example, let's add Skype4Py as a dependency to a project. In the package.json, add 2 things:
- Dependency on
virtualenv
(this library) - Postinstall to prepare the virtualenv every time your module is npm installed.
{
"dependencies": {
"virtualenv": "*"
},
"scripts": {
"postinstall": "virtualenv-postinstall"
}
}
Next, make a requirements.txt in the same directory as package.json, containing this line:
Skype4Py==1.0.35
When you run npm install
, the Skype4Py dependency will be isolated
in a virtualenv located under .node-virtualenv.
Next, spawn your isolated Python virtualenv from node:
var virtualenv = require("virtualenv");
var packagePath = require.resolve("./package.json")
var env = virtualenv(packagePath);
// This is a child_process running Python using your virtualenv. You can
// communicate with it over stdin/stdout, etc.
var child = env.spawnPython(["./my_python_helper.py"]);
You can also spawn
any of the other commands in the virtualenv. For example,
if you added a Python tool like fabric as
a dependency, you can access the command fab
that it installs:
var virtualenv = require("virtualenv");
var packagePath = require.resolve("./package.json")
var env = virtualenv(packagePath);
// This is a child_process running fabric using your virtualenv.
var child = env.spawn("fab", ["deploy", "-H", "example1.net,example2.net"]);
Advanced usage
You can modify the way the virtualenv is created during postinstall. For example, if your node module still functions without the Python extras, you can make virtualenv optional (in case the user doesn't have Python). Do this by adding a "virtualenv" key to your package.json:
"virtualenv": {
"optional": true
}
Depend on a specific version of virtualenv:
"virtualenv": {
"version": "15.0.x"
}
Send flags to the virtualenv creation command:
"virtualenv": {
"flags": [
"--system-site-packages"
]
}
Launch virtualenv.py using a specific python interpreter
"virtualenv": {
"python": "/path/to/my/python"
}
References
- Official virtualenv documentation
- Official pip documentation
- Heroku pip article
Contributing
Just make a pull request :)