Changes between Initial Version and Version 1 of GenshiRecipes/SconsXIncludeScanner

Timestamp:

Aug 19, 2006, 4:14:02 PM (17 years ago)

Author:

robinbryce@…

Comment:

minimal scons integration for markup

GenshiRecipes/SconsXIncludeScanner

@@ +1 @@
+{{{
+#!rst
+
+**why would you want this recipe ?** You need to integrate markup sources into a `scons <http://www.scons.org/>`_ based build system and you would like implicit dependencies for ``xi:include`` directives.
+
+file SConscript::
+
+    import sys
+    from markup.filters import IncludeFilter
+    from markup.template import Template,TemplateLoader
+
+    def markup_xinclude_scan(node, env, path, arg):
+        t=Template(node.get_contents())
+        loader=TemplateLoader('.'.split())
+        t.filters.insert(0, IncludeFilter(loader))
+        t.generate().render()
+        return loader._cache.keys()
+
+    markup_scanner = Scanner(
+        name='markup',
+        function=markup_xinclude_scan,
+        argument=None,
+        skeys = '.xhtml .html .xml'.split())
+    scanners = Environment().Dictionary('SCANNERS')
+    env = Environment(SCANNERS = scanners + [markup_scanner])
+
+    env.Command('page-out', 'page.html', './render $SOURCES $TARGET')
+
+So, assuming page.html references another file, say ``base.html``, using the Xinclude recipe, any edit to base.html will cause scons to consider ``page-out`` to be out of date. After an edit of either page.html or base.html ``scons -f SConscript`` will be sufficient to bring ``page-out`` up to date.
+
+render is a trivial wrapper script that renders the final output using markup for a single source file. Mine looks like this::
+
+    #!/usr/bin/python
+    import sys
+    try: import wingdbstub
+    except ImportError: pass
+    from markup.filters import IncludeFilter
+    from markup.template import Template,TemplateLoader
+    t=Template(file(sys.argv[1]).read())
+    t.filters.insert(0, IncludeFilter(TemplateLoader('.'.split())))
+    outf = sys.stdout
+    if len(sys.argv) > 2:
+        outf=file(sys.argv[2], 'w')
+    print >> outf, t.generate().render()
+
+There may be slicker ways of doing this. If you know them then please update this recipe.
+
+
+}}}