From 26a029d407be480d791972afb5975cf62c9360a6 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Fri, 19 Apr 2024 02:47:55 +0200 Subject: Adding upstream version 124.0.1. Signed-off-by: Daniel Baumann --- third_party/python/jsmin/README.rst | 95 +++++++++++++++++++++++++++++++++++++ 1 file changed, 95 insertions(+) create mode 100644 third_party/python/jsmin/README.rst (limited to 'third_party/python/jsmin/README.rst') diff --git a/third_party/python/jsmin/README.rst b/third_party/python/jsmin/README.rst new file mode 100644 index 0000000000..8f6a9bdec5 --- /dev/null +++ b/third_party/python/jsmin/README.rst @@ -0,0 +1,95 @@ +===== +jsmin +===== + +JavaScript minifier. + +Usage +===== + +.. code:: python + + from jsmin import jsmin + with open('myfile.js') as js_file: + minified = jsmin(js_file.read()) + +You can run it as a commandline tool also:: + + python -m jsmin myfile.js + +NB: ``jsmin`` makes no attempt to be compatible with +`ECMAScript 6 / ES.next / Harmony `_. +The current maintainer does not intend to add ES6-compatibility. If you would +like to take over maintenance and update ``jsmin`` for ES6, please contact +`Tikitu de Jager `_. Pull requests are also +welcome, of course, but my time to review them is somewhat limited these days. + +If you're using ``jsmin`` on ES6 code, though, you might find the ``quote_chars`` +parameter useful: + +.. code:: python + + from jsmin import jsmin + with open('myfile.js') as js_file: + minified = jsmin(js_file.read(), quote_chars="'\"`") + + +Where to get it +=============== + +* install the package `from pypi `_ +* get the latest release `from latest-release on github `_ +* get the development version `from master on github `_ + + +Python 2 support removed +======================== + +Python 2 support was removed in version 3.0.0. If you need to support Python 2, please use version 2.2.2 with setuptools<58. + +Contributing +============ + +`Issues `_ and `Pull requests `_ +will be gratefully received on Github. The project used to be hosted +`on bitbucket `_ and old issues can still be +found there. + +If possible, please make separate pull requests for tests and for code: tests will be added to the `latest-release` branch while code will go to `master`. + +Unless you request otherwise, your Github identity will be added to the contributor's list below; if you prefer a +different name feel free to add it in your pull request instead. (If you prefer not to be mentioned you'll have to let +the maintainer know somehow.) + +Build/test status +================= + +Both branches are tested with Travis: https://travis-ci.org/tikitu/jsmin + +The `latest-release` branch (the version on PyPI plus any new tests) is tested against CPython 3. +Currently: + +.. image:: https://travis-ci.org/tikitu/jsmin.png?branch=latest-release + +If that branch is failing that means there's a new test that fails on *the latest released version on pypi*, with no fix yet +released. + +The `master` branch (development version, might be ahead of latest released version) is tested against CPython 3. +Currently: + +.. image:: https://travis-ci.org/tikitu/jsmin.png?branch=master + +If `master` is failing don't use it, but as long as `latest-release` is passing the pypi release should be ok. + +Contributors (chronological commit order) +========================================= + +* `Dave St.Germain `_ (original author) +* `Hans weltar `_ +* `Tikitu de Jager `_ (current maintainer) +* https://bitbucket.org/rennat +* `Nick Alexander `_ +* `Gennady Kovshenin `_ +* `Matt Molyneaux `_ +* `Albert Wang `_ +* `Ben Bradshaw `_ -- cgit v1.2.3