Metadata-Version: 2.0
Name: pyramid-assetmutator
Version: 0.4
Summary: Dynamic asset mutation for Pyramid. Easily adds support for popular asset metalanguages such as CoffeeScript, SASS, SCSS, LESS, Dart, TypeScript, etc.
Home-page: http://github.com/seedifferently/pyramid_assetmutator
Author: Seth Davis
Author-email: seth@curiasolutions.com
License: MIT
Keywords: pyramid assets coffeescript sass scss less dart typescript css3
Platform: Posix; MacOS X; Windows
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Framework :: Pyramid
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Dist: pyramid (>=1.3)

================================================================================
Pyramid AssetMutator v0.4
================================================================================

.. image:: https://travis-ci.org/seedifferently/pyramid_assetmutator.svg?branch=master
  :target: https://travis-ci.org/seedifferently/pyramid_assetmutator

| Copyright: (c) 2016 Seth Davis
| http://github.com/seedifferently/pyramid_assetmutator


Synopsis
================================================================================

Pyramid AssetMutator provides simple and dynamic asset mutation (also known as
compiling or piping) for your Pyramid_ applications.

Inspired by other more powerful asset management packages, its goal is to
provide a basic and straightforward mechanism for asset *compilation* (e.g.
CoffeeScript/LESS), *minification* (e.g. jsmin), and *optimization* (e.g.
pngcrush).

As of version 0.3, it also adds experimental support for template language
parsing (e.g. you could use view helpers like `request.route_url()` in your
CoffeeScript by installing the `pyramid_jinja2` package and using
application.coffee.jinja2 as the asset source filename).

.. _Pyramid: http://www.pylonsproject.org/


Installation
================================================================================

To install, simply::

    pip install pyramid_assetmutator

* You'll need to have `Python`_ 2.6+ and `pip`_ installed.

.. _Python: http://www.python.org
.. _pip: http://www.pip-installer.org


Documentation
================================================================================

You can read the documentation at: https://pyramid-assetmutator.readthedocs.io/


Known Issues and Limitations
================================================================================

* Experimental support for Py3k/pypy.
* Doesn't clean up after itself (compiled/mutated assets aren't removed
  automatically).
* Mutator "commands" must print to stdout (see the documentation for more info).
* Hopefully obvious, but you have to actually have the specified compiler
  command installed and accessible from your working path in order for it to
  work.


Disclaimers and Warnings
================================================================================

This is Alpha software--use at your own risk!

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHOR BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


Latest Changes
================================================================================


v0.4 -- 09/16/2016
--------------------------------------------------------------------------------

* Fixed a bug where mutated files could be created with incorrect filenames if
  the ``each_boot`` setting was enabled with a ``remutate_check`` value of
  ``mtime`` or ``checksum``.
* Fixed a Windows bug due to ``shlex.split`` usage (thanks @tdamsma).
* Added a ``purge_mutated_path`` setting which can be used to remove all files
  from a specified ``mutated_path`` upon application boot.


