Python-only static file (js, css) bundler for `edwh`
Project description
edwh-bundler-plugin
EDWH Python-only bundler for static assets (JS and CSS).
Try it out with an example:
edwh bundle.build --input example.yaml -v
Table of Contents
Installation
pip install edwh-bundler-plugin
But probably you want to install the whole edwh package:
pipx install edwh[bundler]
# or
pipx install edwh[plugins,omgeving]
Usage
JS
Since this package is Python-only, it can't do any of the more fancy stuff that nodejs-based bundlers can.
For simplistic purposes however, where the bundler is embedded in some other Python workflow, this package could be
useful.
It can combine JS files (in a naive way) and minify them using rjsmin.
In addition to this, it can also add _hyperscript to the bundle and 'minify' it (by removing
comments and newlines).
These JS and _hs files can be fetched from a remote URL or loaded from a file path.
CSS files can be also included in the bundle, and will be inlined as <style>s in the page's head.
The same goes for HTML files, which will be appended to the end of the <body> (useful for <template>s).
CSS
(S)CSS can also be bundled (naively) and minified (using libsass) and can also be loaded from either remote or local files. A scope can also be defined and using sass all styles in the file will be prefixed with the provided selector.
Configuration
A bundle with a specific configuration can be built with: furl build --input some.yaml.
If no --input is defined, furl.yaml in the current directory will be used.
This yaml can contain these keys:
js:
- ...
css:
- ...
config:
minify: bool
cache: bool
output_css: path/to/output.css
output_js: /path/to/bundled.js
js contains input files for the JS bundle, css input files for the CSS bundle and config contains general
configuration options.
JS
The JS part of the configuration has the following options:
js:
- https://some.cdn/mypackage.js
- ./path/to/file.js
- https://some.cdn/mypackage._hs
- /path/to/file._hs
- console.log("inline js")
- >
console.log("inline multiline js")
- _hyperscript("log 'inline hyperscript'") # if you've included hyperscript from a file or cdn above! Tip: alias `_ = _hyperscript` for ease of use)
- https://some.cdn/mystyles.css
- path/to/styles.css
- path/to/template.html
SCSS is not supported in this section.
CSS
css:
- https://some.cdn/mystyles.scss
- https://some.cdn/mystyles.css
- path/to/styles.scss
- path/to/styles.css
- file: url_or_path.css
scope: '#my-style-scope'
- file: url_or_path.css
scss: 1
- |
// inline scss or css
SCSS will be applied if the file extension is sass or scss or if the scss option is true.
SCSS will be disabled for files with that extension if the config option is set to false.
The scope selector can be any CSS selector (e.g. #id, .class, element etc.)
The scope and scss options do not work together, as scope always uses scss to add the parent selector.
Config
The config options from the config file can be overridden on the command line with the corresponding flags (
see edwh bundle.build -h).
Booleans such as minify and cache can start with 1, 'y' or 't' (e.g. be 1, 'y', 'Y', 'Yes', 'yup', 'true' or
something similar) to be truthy.
Anything else is considered falsey. The flag --stdout can only be used from the commandline, and will yield the result
to stdout instead of an output file (overrides --output)
Other commands
edwh bundle.build-js or edwh bundle.build-css can be used to only build one output file (.js or .css respectively).
These commands can be used with multiple --files as arguments. The rest of the options are the same as the
regular build.
Integrated use as an API
Instead of using the cli, this package can also be integrated in other Python scripts.
# individual helpers
from edwh_bundler_plugin import extract_contents_for_js
from edwh_bundler_plugin import extract_contents_for_css
extract_contents_for_css("https://some.cdn/mystyles.css") # a {color: red}
extract_contents_for_js("https://some.cdn/mystyles.css") # document.head.innerHTML += `<style>a {color: red}</style>`
extract_contents_for_css(
{'file': "https://some.cdn/assets/css/mystyles.css", 'scope': '#mydiv'}) # #mydiv a {color: red}
# bundling multiple files
from edwh_bundler_plugin import bundle_js, bundle_css
inline_js = """// should start with a comment
_ = _hyperscript
"""
bundle_js(["https://unpkg.com/hyperscript.org", inline_js, "_(`log 'inline _hs'`)"]) # returns a string by default
bundle_css(
["https://some.cdn/package.css", {'file': "./mystyles.css", 'scope': '#mydiv'}]) # returns a string by default
License
edwh-bundler-plugin is distributed under the terms of the MIT license.
Changelog
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for edwh_bundler_plugin-0.2.5.tar.gz
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e843b090cc6f7f1865bf0fd627f6010833b41b145cf91e43f36f7af28857b142 |
|
| MD5 | cda9508d35bf9518831f02872156c9b8 |
|
| BLAKE2b-256 | 8642a43ba9d8353eb68b93e7d131c5ee8d2500b0efdc967a4affb401d8f81676 |
Hashes for edwh_bundler_plugin-0.2.5-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 6818d0798849a55ef7237c804ac7f700fdf6d2f5e0f6e4f4a86b26c678c559b4 |
|
| MD5 | f2930fb7d378f55706d9168946cd1414 |
|
| BLAKE2b-256 | bd6ff017eca0e80ea16e89977e369df7f48ee48d6d9e974cd79407b0f1c32bae |
