Skip to main content

Setuptools extensions for working with node

Project description

setuptools extensions for working with Node.js

The setuptools_node package contains a number of useful setuptools extensions for working with Node.js, many useful web development tools can be found in the npm ecosystem.

General Use

In general custom setuptools command are used by registering the custom command in the cmdclass argument to the setup() function

setup(cmdclass={ 'my_command': MyCommand })

General options

By default all paths are relative to the directory containing Node will be in the node directory and node modules in node_modules

  • --node-dir Specify an alternate directory where node may be found
  • --node-modules-dir Specify an alternate directory for node modules


The InstallNode command is used to fetch a copy of node.js and install it in the project directory. The download will be cached in the cache directory to facilitate a quick reinstall.

InstallNode Options

  • --node-dist-url Specify the URL from which to fetch node
  • --node-version Specify the version of node to fetch
  • --cache-dir Specify the directory in which to store the node download

from setuptools_node import InstallNode

setup(cmdclass={ 'install_node': InstallNode })


user@host $ python install_node


The NpmInstall command is used to install modules from npm. By default npm install is used, npm ci may be specified with --use-ci

NpmInstall Options

  • --use-ci Use npm ci to install modules instead of npm install

from setuptools_node import NpmInstall

setup(cmdclass={ 'npm_install': NpmInstall })


user@host $ python npm_install  # or
user@host $ python npm_install --use-ci


The Gulp command runs the gulp build tool

Gulp Options

  • --task Specify the task to run insteaed of the default. Multiple tasks may be specified as a comma separated list.

from setuptools_node import Gulp

setup(cmdclass={ 'gulp': Gulp })


user@host $ python gulp  # run default task
user@host $ python gulp --task foo  # run the 'foo' task
user@host $ python gupl --task clean,foo # run 'clean' and 'foo' tasks


The GulpBuild command provides a version of build_py that executes gulp before proceeding with the normal build_py process, this allows you to build/transform static files for a web application before they are included in the package built by build_py.

Node will be installed if it is not found, and modules will be installed/updated.

GulpBuild Options

  • --task Specify the task to run insteaed of the default. Multiple tasks may be specified as a comma separated list.

Since you don't generally run build_py directly, you will need to add any arguments to the setup.cfg:


from setuptools_node import GulpBuild

setup(cmdclass={ 'build_py': GulpBuild })


user@host $ python bdist_wheel

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

setuptools_node-0.3.0.tar.gz (6.3 kB view hashes)

Uploaded source

Built Distribution

setuptools_node-0.3.0-py3-none-any.whl (7.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page