Utility for defining then downloading and preprocessing external static files.
Copyright (C) 2013-2017 Samuel Colvin
Kind of like bower, but in Python, and simpler, and with some more features.
- download files from urls, including extracting selectively from zip files.
- create .grablib.lock which retains hashes of all downloaded files meaning assets can’t change unexpectedly.
- compile sass/scss/css using libsass.
Definition files can either be JSON or YAML (see examples).
grablib requires python 3.6+.
pip install grablib[build]
(You can also use simply pip install grablib to install without build requirements, this is useful when you’re not using grablib for building as it avoids installing jsmin and libsass which can be slow.)
Define your static files thus: (grablib.yml)
download_root: 'static/libs' download: 'http://code.jquery.com/jquery-1.11.3.js': 'js/jquery.js' 'https://github.com/twbs/bootstrap-sass/archive/v3.3.6.zip': 'bootstrap-sass-3.3.6/assets/(.+)$': 'bootstrap-sass/' 'GITHUB/codemirror/CodeMirror/5.8.0/lib/codemirror.js': 'codemirror/' # simple scss file to import and compile bootstrap from above, # generally this would be in your code # this file just reads "@import 'bootstrap-sass/stylesheets/bootstrap';" 'https://git.io/v1Z5J': 'build_bootstrap.scss' debug: true build_root: 'static/prod' build: # delete the entire static/prod directory before building, this is required for sass, # and generally safer wipe: '.*' cat: # concatenate jquery and codemirror into "libraries.js" # it won't get minified as debug is true, but without that it would 'libraries.js': - 'DL/js/jquery.js' - 'DL/codemirror/codemirror.js' sass: # compile all css, scss and sass files which don't start with _ from the "download_root" # into the "css" directory, here that will just be build_bootstrap.scss which will # build the whole of bootstrap. # debug: true means you'll get map files and a copy of sass files so maps work properly. 'css': 'DL/'
Then download and build you static files with just:
You can also call grablib from python:
from grablib import Grab grab = Grab('path/to/definitions.json|yml') grab.download() grab.build()
Release history Release notifications
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size & hash SHA256 hash help||File type||Python version||Upload date|
|grablib-0.7.4-py36-none-any.whl (14.2 kB) Copy SHA256 hash SHA256||Wheel||py36|
|grablib-0.7.4.tar.gz (13.8 kB) Copy SHA256 hash SHA256||Source||None|