Metadata-Version: 2.4
Name: jsautobuild
Version: 0.3
Summary: Auto build JS files using Pyinotify to help during development of JS in projects
Home-page: 
Author: Rick Harding
Author-email: rharding@canonical.com
License: BSD
Keywords: javascript yui build minify development
Description-Content-Type: text/markdown
Requires-Dist: pyinotify
Requires-Dist: lpjsmin
Requires-Dist: convoy
Requires-Dist: wheel
Requires-Dist: pyasyncore; python_version >= "3.12"
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: keywords
Dynamic: license
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: summary

jsautobuild documentation
==========================

This is meant to be used to help you write your own watching js builder
script. It provides the hooks and the pyinotify inclusion. You can tweak it to
your own specific application as required.

Usage
------
You need to build a simple script to use the builder. Below is an example
script that helps copy changed JS files to a build directory.

::

    import os

    from jsautobuild import YUIBuilder


    def lp_path_builder(changed_path, **builder_props):
        """The custom bit of LP code that determines where files get moved to"""
        # to start out let's assume your CWD is where we're referencing things from
        CWD = os.getcwd()
        JSDIR = os.path.join(CWD, builder_props['build_dir'])
        RENAME = re.compile("^.*lib/lp/(.*)/javascript")

        match = RENAME.search(changed_path)
        js_dir = match.groups()[0]
        return os.path.join(JSDIR, RENAME.sub(js_dir, changed_path))


    if __name__ == "__main__":
        build_dir = 'build/js/lp'
        meta_name = 'LP_MODULES'
        watch_dir = 'lib'

        builder = YUIBuilder(lp_path_builder,
                build_dir,
                watch_dir=watch_dir,
                meta_jsmodule=meta_name)

        builder.run()

Options
-------
:build_callable:
You need a function that will accept the filename of the JS file that has
changed, and then return back the proper location of that file in the build
directory.

:build_dir:
What is the root directory all build files are heading to. This is also used
for the meta.js generate code. It'll build a list of all modules in this build
directory.

:meta_jsmodule:
What is the Javascript global variable name you want the meta file to be
generated to. You'll use this in your own application to feed the module list
to the YUI combo loader.

:update_metajs:
**default True**
Should we rebuild the meta.js whenever a new .js file is created.

:watch_dir:
**default .**
This is the directory that is watched for all file changes and triggers the
build of js files. By default it'll watch the current working directory and
anything below that.


.. This is your project NEWS file which will contain the release notes.
.. Example: http://www.python.org/download/releases/2.6/NEWS.txt
.. The content of this file, along with README.rst, will appear in your
.. project's PyPI page.

News
====

0.3
---
*Release date: 29-Jun-2026*

* Add pyasyncore dependency for Python 3.12+ (asyncore removed from stdlib)
* Add test suite
* Upgrade jsautobuild to support python >= 3.8
* Removed buildout config files


0.2
---
*Release date: 28-Feb-2012

* Fix the requirements in setup.py


0.1
---

*Release date: 27-Feb-2012*

* Start the project to help build a JS auto building watcher.

