use invoke instead of fabric

it's the descendant of the part of fabric we actually use,
it doesn't have complex compiled dependencies like fabric,
and it works on Python 3.

Dockerfile

@@ -29,7 +29,8 b' RUN apt-get install -y -q build-essential make gcc zlib1g-dev git && \\'
 # In order to build from source, need less
 RUN npm install -g less
 
-RUN apt-get install -y -q fabric python-sphinx python3-sphinx
+RUN apt-get install -y -q python-sphinx python3-sphinx
+RUN pip install invoke
 
 RUN mkdir -p /srv/
 WORKDIR /srv/

IPython/html/README.md

@@ -4,10 +4,9 b''
 
 Developers of the IPython Notebook will need to install the following tools:
 
-* fabric
+* invoke
 * node.js
 * less (`npm install -g less`)
-* bower (`npm install -g bower`)
 
 ## Components
 
@@ -15,14 +14,13 b' We are moving to a model where our JavaScript dependencies are managed using'
 [bower](http://bower.io/). These packages are installed in `static/components`
 and committed into a separate git repo [ipython/ipython-components](ipython/ipython-components).
 Our dependencies are described in the file
-`static/components/bower.json`. To update our bower packages, run `fab update`
+`static/components/bower.json`. To update our bower packages, run `bower install`
 in this directory.
 
 ## less
 
 If you edit our `.less` files you will need to run the less compiler to build
-our minified css files.  This can be done by running `fab css` from this directory,
-or `python setup.py css` from the root of the repository. 
+our minified css files.  This can be done by running `python setup.py css` from the root of the repository. 
 If you are working frequently with `.less` files please consider installing git hooks that
 rebuild the css files and corresponding maps in `${RepoRoot}/git-hooks/install-hooks.sh`.
 

IPython/html/tasks.py

@@ -1,7 +1,6 b''
-""" fabfile to prepare the notebook """
+"""invoke task file to build CSS"""
 
-from fabric.api import local,lcd
-from fabric.utils import abort
+from invoke import task, run
 import os
 from distutils.version import LooseVersion as V
 from subprocess import check_output
@@ -40,11 +39,9 b' def _need_css_update():'
     
     return False
 
+@task
 def css(minify=False, verbose=False, force=False):
     """generate the css from less files"""
-    minify = _to_bool(minify)
-    verbose = _to_bool(verbose)
-    force = _to_bool(force)
     # minify implies force because it's not the default behavior
     if not force and not minify and not _need_css_update():
         print("css up-to-date")
@@ -56,15 +53,10 b' def css(minify=False, verbose=False, force=False):'
         sourcemap = pjoin('style', "%s.min.css.map" % name)
         _compile_less(source, target, sourcemap, minify, verbose)
 
-def _to_bool(b):
-    if not b in ['True', 'False', True, False]:
-        abort('boolean expected, got: %s' % b)
-    return (b in ['True', True])
-
 def _compile_less(source, target, sourcemap, minify=True, verbose=False):
     """Compile a less file by source and target relative to static_dir"""
-    min_flag = '-x' if minify is True else ''
-    ver_flag = '--verbose' if verbose is True else ''
+    min_flag = '-x' if minify else ''
+    ver_flag = '--verbose' if verbose else ''
     
     # pin less to version number from above
     try:
@@ -80,6 +72,12 b' def _compile_less(source, target, sourcemap, minify=True, verbose=False):'
         raise ValueError("lessc too new: %s >= %s. Use `$ npm install lesscss@X.Y.Z` to install a specific version of less" % (less_version, max_less_version))
     
     static_path = pjoin(here, static_dir)
-    with lcd(static_dir):
-        local('lessc {min_flag} {ver_flag} --source-map={sourcemap} --source-map-basepath={static_path} --source-map-rootpath="../" {source} {target}'.format(**locals()))
+    cwd = os.getcwd()
+    try:
+        os.chdir(static_dir)
+        run('lessc {min_flag} {ver_flag} --source-map={sourcemap} --source-map-basepath={static_path} --source-map-rootpath="../" {source} {target}'.format(**locals()),
+            echo=True,
+        )
+    finally:
+        os.chdir(cwd)
 

IPython/testing/iptest.py

@@ -259,7 +259,7 b" sec.requires('zmq', 'tornado', 'requests', 'sqlite3', 'jsonschema')"
 # file in there (MathJax ships a conf.py), so we might as
 # well play it safe and skip the whole thing.
 sec.exclude('static')
-sec.exclude('fabfile')
+sec.exclude('tasks')
 if not have['jinja2']:
     sec.exclude('notebookapp')
 if not have['pygments'] or not have['jinja2']:

docs/autogen_api.py

@@ -46,7 +46,7 b" if __name__ == '__main__':"
                                         r'\.core\.display',
                                         r'\.lib\.display',
                                         # This isn't actually a module
-                                        r'\.html\.fabfile',
+                                        r'\.html\.tasks',
                                         ]
 
     # These modules import functions and classes from other places to expose

git-hooks/post-checkout

@@ -9,12 +9,12 b' else'
   PREVIOUS_HEAD=$1
 fi
 
-# if style changed (and less/fabric available), rebuild sourcemaps
+# if style changed (and less/invoke available), rebuild sourcemaps
 if [[
   ! -z "$(git diff $PREVIOUS_HEAD IPython/html/static/style/ipython.min.css)"
   && ! -z "$(git diff $PREVIOUS_HEAD IPython/html/static/style/style.min.css)"
   && ! -z $(which 2>/dev/null lessc)
-  && ! -z $(which 2>/dev/null fab)
+  && ! -z $(which 2>/dev/null invoke)
 ]]; then
   echo "rebuilding sourcemaps"
   cd IPython/html

setupbase.py

@@ -669,7 +669,7 b' class CompileCSS(Command):'
     
     Regenerate the compiled CSS from LESS sources.
     
-    Requires various dev dependencies, such as fabric and lessc.
+    Requires various dev dependencies, such as invoke and lessc.
     """
     description = "Recompile Notebook CSS"
     user_options = [
@@ -686,11 +686,12 b' class CompileCSS(Command):'
         self.force = bool(self.force)
     
     def run(self):
-        check_call([
-                "fab",
-                "css:minify=%s,force=%s" % (self.minify, self.force),
-            ], cwd=pjoin(repo_root, "IPython", "html"),
-        )
+        cmd = ['invoke', 'css']
+        if self.minify:
+            cmd.append('--minify')
+        if self.force:
+            cmd.append('--force')
+        check_call(cmd, cwd=pjoin(repo_root, "IPython", "html"))
 
 
 class JavascriptVersion(Command):

tox.ini

@@ -3,10 +3,8 b''
 # test suite on all supported python versions. To use it, "pip install tox"
 # and then run "tox" from this directory.
 
-# Building the source distribution requires both fabric's fab binary
-# (http://www.fabfile.org/) and the lessc binary of the css preprocessor
-# less (http://lesscss.org/) in the PATH.
-# "pip install fabric" will install fabric. Less can be installed by
+# Building the source distribution requires `invoke` and `lessc` to be on your PATH.
+# "pip install invoke" will install invoke. Less can be installed by
 # node.js' (http://nodejs.org/) package manager npm:
 # "npm install -g less".