Skip to main content

Utility for defining then downloading and preprocessing external static files.

Project description

Build Status codecov.io PyPI Status license

Copyright (C) 2013-2020 Samuel Colvin

Kind of like bower, but in Python, and simpler, and with some more features.

grablib can:

  • 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.

  • concatenate and minify javascript using jsmin.

Definition files can either be JSON or YAML (see examples).

Installation

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.)

CLI Usage

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:

grablib

Library Usage

You can also call grablib from python:

from grablib import Grab

grab = Grab('path/to/definitions.json|yml')
grab.download()
grab.build()

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

grablib-0.8.tar.gz (14.3 kB view details)

Uploaded Source

Built Distribution

grablib-0.8-py3-none-any.whl (14.8 kB view details)

Uploaded Python 3

File details

Details for the file grablib-0.8.tar.gz.

File metadata

  • Download URL: grablib-0.8.tar.gz
  • Upload date:
  • Size: 14.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.8.2

File hashes

Hashes for grablib-0.8.tar.gz
Algorithm Hash digest
SHA256 bcb94d9ffef4227ab5e5e79398d3a7ca6c7e072c72e5a42665c3869a64695b6e
MD5 5489ce0a9149151d3adebd174a4bdbda
BLAKE2b-256 0e11947fcb2d3d1464cb7c45d3d55583072229136784fdb7f8b5a9cb183ad7f8

See more details on using hashes here.

File details

Details for the file grablib-0.8-py3-none-any.whl.

File metadata

  • Download URL: grablib-0.8-py3-none-any.whl
  • Upload date:
  • Size: 14.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.8.2

File hashes

Hashes for grablib-0.8-py3-none-any.whl
Algorithm Hash digest
SHA256 5f746735df47e9a21884767a57ac73a84dc1382d977d59333cabb4d53f568e16
MD5 e2adf2ee6a050c4f6aa652b66ae02467
BLAKE2b-256 305565db621d67969fef8bcc816ed6bd372b334e103c525eb86e9a58e5ad8809

See more details on using hashes here.

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