jovyan/jupyter-devinstall

Name: jupyter-devinstall

Owner: jovyan

Description: Utility for setting up a Jupyter developer environment.

Created: 2015-09-11 01:34:07.0

Updated: 2018-03-07 20:25:40.0

Pushed: 2017-01-06 21:34:07.0

Homepage: null

Size: 1189

Language: JavaScript

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Jupyter devinstall tool

Utility designed to simplify the installation of a Jupyter/IPython development environment.

Demo screen cast

Installation

Make sure you have iojs (and npm, which is included) installed on your machine, then run:

install -g jupyter-devinstall

(you may need to prefix the line with sudo)

Usage
e: jupyter-devinstall [options] <githubName> <installdir>

ons:

, --help               output usage information
, --skip-pip           skip pip projects
, --skip-npm           skip npm projects
, --reinstall          reinstall existing repositories, without recloning
python [string]        path of the python executable [python]
, --overwrite          overwrite existing directories
, --upstream [string]  name of the non-origin git remote [upstream]
, --global             global install
, --no-install         don't install
, --upstream-origin    set the origin to point to upstream
, --ssh                use SSH (git protocol) when setting up remotes
, --silent             don't prompt the user for anything
, --version            output the version number

Example for GitHub username jdfreder installed to the HOME directory:

ter-devinstall jdfreder ~/
Notes

If you have not specified the --silent (-s for short) flag, part way through the tool will behave like a wizard, prompting you for input.

The tool will ask you if you want to install locally, globally, or not at all:

Default workflow

The default workflow installed by this tool is that origin points to your fork of the upstream repository. You can change this behavior by using the -U flag, to force origin to point to the upstream repo. For example,

ter-devinstall jdfreder ~/ -U -u me

will setup the clones so origin points to the upstream repo and me points to the forked repo (in the example this is in jdfreder).


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.