First version of the newly restructured repository

8 files changed, 1155 insertions, 0 deletions

diff --git a/scripts/build b/scripts/build
new file mode 100755
index 0000000..b17a18f
--- a/dev/null
+++ b/scripts/build
@@ -0,0 +1,5 @@
+#!/bin/bash
+
+readonly CURR_DIR=$(cd "$(dirname "$0")"; pwd -P)
+
+${CURR_DIR}/builder/main.py $@
\ No newline at end of file
diff --git a/scripts/builder/backendBuilder.py b/scripts/builder/backendBuilder.py
new file mode 100644
index 0000000..f5dc7b2
--- a/dev/null
+++ b/scripts/builder/backendBuilder.py
@@ -0,0 +1,89 @@
+#!/usr/bin/python
+# -*- coding: UTF-8 -*-
+
+import sys, os, json
+import shutil
+import main
+import hashlib
+
+class BackendBuilder:
+        
+        def __init__ (self, projectTargetDir, frontends, versions, settings):
+                self.projectTargetDir = projectTargetDir
+                self.frontends = frontends
+                self.versions = versions
+                self.settings = settings
+        
+        def name (self):
+                raise NotImplementedError()
+        
+        def relativePath (self):
+                raise NotImplementedError()
+        
+        def compileCode (self):
+                pass
+        
+        def copyCompiledCodeToTargetDir (self):
+                src = self.sourceFolder()
+                dst = self.targetFolder()
+                main.createFolder(os.path.dirname(dst))
+                shutil.copytree(src, dst)
+
+        def sourceFolder (self):
+                return main.projectBaseDir() + '/backend/' + self.relativePath() + '/src'
+        
+
+        def targetFolder (self):
+                return self.projectTargetDir + self.relativePath()
+        
+        def createTargetFolder (self):
+                main.createFolder(self.targetFolder())
+        
+
+        #def copyFrontendResources (self, frontend):
+        #       print "copying resources for frontend: " + frontend
+        #       print "SETTINGS: " + str(self.settings)
+        
+
+        def writeToTargetFolder (self, filename, content):
+                file = open(self.targetFolder() + '/' + filename, 'w')
+                file.write(content.encode('utf-8'))
+                file.close()
+                
+
+        def configureIndexContent (self, indexContent):
+                result = indexContent
+                result = result.replace( '@request.path@',    self.settings['request.path']    )
+                result = result.replace( '@should.pay.toll@', self.settings['should.pay.toll'] )
+
+                return result
+        
+
+        def logChecksums (self, content, message):
+                        md5Digest       = hashlib.md5(content.encode('utf-8')).hexdigest()
+                        shaDigest       = hashlib.sha1(content.encode('utf-8')).hexdigest()
+                        sha256Digest= hashlib.sha256(content.encode('utf-8')).hexdigest()
+                print message + ": " + md5Digest + " (md5)"
+                print message + ": " + shaDigest + " (sha1)"
+                print message + ": " + sha256Digest + " (sha256)"
+                
+        
+
+        def run (self):
+                print self.name() + " - RUN"
+
+                self.compileCode()
+                self.copyCompiledCodeToTargetDir()
+                
+                for frontend in self.frontends:
+                        frontendPath = frontend.module + '/'
+                        if 'debug' in self.versions:
+                                frontend.copyResourcesToTargetFolder(self.targetFolder())
+                                #self.writeToTargetFolder(frontendPath + 'index_debug.html', self.configureIndexContent(frontend.assembleDebugVersion()))
+                                self.writeToTargetFolder(frontendPath + 'index_debug.html', self.configureIndexContent(frontend.assemble(assemblyMode='DEBUG', versionType='DEBUG')))
+                        
+                        if 'install' in self.versions:
+                                index = self.configureIndexContent(frontend.assemble())
+                                self.writeToTargetFolder(frontendPath + 'index.html', index)
+                                self.logChecksums(index, "[" + self.name() + " - " + frontend.module + "] index.html checksum")
+        
diff --git a/scripts/builder/cssmin.py b/scripts/builder/cssmin.py
new file mode 100644
index 0000000..32ddf77
--- a/dev/null
+++ b/scripts/builder/cssmin.py
@@ -0,0 +1,223 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""`cssmin` - A Python port of the YUI CSS compressor."""
+
+
+from StringIO import StringIO # The pure-Python StringIO supports unicode.
+import re
+
+
+__version__ = '0.1.4'
+
+
+def remove_comments(css):
+    """Remove all CSS comment blocks."""
+    
+    iemac = False
+    preserve = False
+    comment_start = css.find("/*")
+    while comment_start >= 0:
+        # Preserve comments that look like `/*!...*/`.
+        # Slicing is used to make sure we don"t get an IndexError.
+        preserve = css[comment_start + 2:comment_start + 3] == "!"
+        
+        comment_end = css.find("*/", comment_start + 2)
+        if comment_end < 0:
+            if not preserve:
+                css = css[:comment_start]
+                break
+        elif comment_end >= (comment_start + 2):
+            if css[comment_end - 1] == "\\":
+                # This is an IE Mac-specific comment; leave this one and the
+                # following one alone.
+                comment_start = comment_end + 2
+                iemac = True
+            elif iemac:
+                comment_start = comment_end + 2
+                iemac = False
+            elif not preserve:
+                css = css[:comment_start] + css[comment_end + 2:]
+            else:
+                comment_start = comment_end + 2
+        comment_start = css.find("/*", comment_start)
+    
+    return css
+
+
+def remove_unnecessary_whitespace(css):
+    """Remove unnecessary whitespace characters."""
+    
+    def pseudoclasscolon(css):
+        
+        """
+        Prevents 'p :link' from becoming 'p:link'.
+        
+        Translates 'p :link' into 'p ___PSEUDOCLASSCOLON___link'; this is
+        translated back again later.
+        """
+        
+        regex = re.compile(r"(^|\})(([^\{\:])+\:)+([^\{]*\{)")
+        match = regex.search(css)
+        while match:
+            css = ''.join([
+                css[:match.start()],
+                match.group().replace(":", "___PSEUDOCLASSCOLON___"),
+                css[match.end():]])
+            match = regex.search(css)
+        return css
+    
+    css = pseudoclasscolon(css)
+    # Remove spaces from before things.
+    css = re.sub(r"\s+([!{};:>+\(\)\],])", r"\1", css)
+    
+    # If there is a `@charset`, then only allow one, and move to the beginning.
+    css = re.sub(r"^(.*)(@charset \"[^\"]*\";)", r"\2\1", css)
+    css = re.sub(r"^(\s*@charset [^;]+;\s*)+", r"\1", css)
+    
+    # Put the space back in for a few cases, such as `@media screen` and
+    # `(-webkit-min-device-pixel-ratio:0)`.
+    css = re.sub(r"\band\(", "and (", css)
+    
+    # Put the colons back.
+    css = css.replace('___PSEUDOCLASSCOLON___', ':')
+    
+    # Remove spaces from after things.
+    css = re.sub(r"([!{}:;>+\(\[,])\s+", r"\1", css)
+    
+    return css
+
+
+def remove_unnecessary_semicolons(css):
+    """Remove unnecessary semicolons."""
+    
+    return re.sub(r";+\}", "}", css)
+
+
+def remove_empty_rules(css):
+    """Remove empty rules."""
+    
+    return re.sub(r"[^\}\{]+\{\}", "", css)
+
+
+def normalize_rgb_colors_to_hex(css):
+    """Convert `rgb(51,102,153)` to `#336699`."""
+    
+    regex = re.compile(r"rgb\s*\(\s*([0-9,\s]+)\s*\)")
+    match = regex.search(css)
+    while match:
+        colors = map(lambda s: s.strip(), match.group(1).split(","))
+        hexcolor = '#%.2x%.2x%.2x' % tuple(map(int, colors))
+        css = css.replace(match.group(), hexcolor)
+        match = regex.search(css)
+    return css
+
+
+def condense_zero_units(css):
+    """Replace `0(px, em, %, etc)` with `0`."""
+    
+    return re.sub(r"([\s:])(0)(px|em|%|in|cm|mm|pc|pt|ex)", r"\1\2", css)
+
+
+def condense_multidimensional_zeros(css):
+    """Replace `:0 0 0 0;`, `:0 0 0;` etc. with `:0;`."""
+    
+    css = css.replace(":0 0 0 0;", ":0;")
+    css = css.replace(":0 0 0;", ":0;")
+    css = css.replace(":0 0;", ":0;")
+    
+    # Revert `background-position:0;` to the valid `background-position:0 0;`.
+    css = css.replace("background-position:0;", "background-position:0 0;")
+    
+    return css
+
+
+def condense_floating_points(css):
+    """Replace `0.6` with `.6` where possible."""
+    
+    return re.sub(r"(:|\s)0+\.(\d+)", r"\1.\2", css)
+
+
+def condense_hex_colors(css):
+    """Shorten colors from #AABBCC to #ABC where possible."""
+    
+    regex = re.compile(r"([^\"'=\s])(\s*)#([0-9a-fA-F])([0-9a-fA-F])([0-9a-fA-F])([0-9a-fA-F])([0-9a-fA-F])([0-9a-fA-F])")
+    match = regex.search(css)
+    while match:
+        first = match.group(3) + match.group(5) + match.group(7)
+        second = match.group(4) + match.group(6) + match.group(8)
+        if first.lower() == second.lower():
+            css = css.replace(match.group(), match.group(1) + match.group(2) + '#' + first)
+            match = regex.search(css, match.end() - 3)
+        else:
+            match = regex.search(css, match.end())
+    return css
+
+
+def condense_whitespace(css):
+    """Condense multiple adjacent whitespace characters into one."""
+    
+    return re.sub(r"\s+", " ", css)
+
+
+def condense_semicolons(css):
+    """Condense multiple adjacent semicolon characters into one."""
+    
+    return re.sub(r";;+", ";", css)
+
+
+def wrap_css_lines(css, line_length):
+    """Wrap the lines of the given CSS to an approximate length."""
+    
+    lines = []
+    line_start = 0
+    for i, char in enumerate(css):
+        # It's safe to break after `}` characters.
+        if char == '}' and (i - line_start >= line_length):
+            lines.append(css[line_start:i + 1])
+            line_start = i + 1
+    
+    if line_start < len(css):
+        lines.append(css[line_start:])
+    return '\n'.join(lines)
+
+
+def cssmin(css, wrap=None):
+    css = remove_comments(css)
+    css = condense_whitespace(css)
+    # A pseudo class for the Box Model Hack
+    # (see http://tantek.com/CSS/Examples/boxmodelhack.html)
+    css = css.replace('"\\"}\\""', "___PSEUDOCLASSBMH___")
+    css = remove_unnecessary_whitespace(css)
+    css = remove_unnecessary_semicolons(css)
+    css = condense_zero_units(css)
+    css = condense_multidimensional_zeros(css)
+    css = condense_floating_points(css)
+    css = normalize_rgb_colors_to_hex(css)
+    css = condense_hex_colors(css)
+    if wrap is not None:
+        css = wrap_css_lines(css, wrap)
+    css = css.replace("___PSEUDOCLASSBMH___", '"\\"}\\""')
+    css = condense_semicolons(css)
+    return css.strip()
+
+
+def main():
+    import optparse
+    import sys
+    
+    p = optparse.OptionParser(
+        prog="cssmin", version=__version__,
+        usage="%prog [--wrap N]",
+        description="""Reads raw CSS from stdin, and writes compressed CSS to stdout.""")
+    
+    p.add_option(
+        '-w', '--wrap', type='int', default=None, metavar='N',
+        help="Wrap output to approximately N chars per line.")
+    
+    options, args = p.parse_args()
+    sys.stdout.write(cssmin(sys.stdin.read(), wrap=options.wrap))
+
+
+if __name__ == '__main__':
+    main()
diff --git a/scripts/builder/frontendBuilder.py b/scripts/builder/frontendBuilder.py
new file mode 100644
index 0000000..b796438
--- a/dev/null
+++ b/scripts/builder/frontendBuilder.py
@@ -0,0 +1,398 @@
+#!/usr/bin/python
+# -*- coding: UTF-8 -*-
+
+import sys, os, re
+import cssmin
+import jsmin
+import codecs
+import shutil
+import StringIO
+import urllib
+
+#from mercurial import ui, hg
+#from mercurial.node import hex
+from dulwich.repo import Repo
+
+import main
+
+
+
+class FrontendBuilder:
+
+        def __init__ (self, frontend, settings):
+                if '.' in frontend:
+                        moduleComponents = frontend.split('.')
+                        self.module = moduleComponents[0]
+                        self.submodule = moduleComponents[1]
+                else:
+                        self.module = frontend
+                        self.submodule = frontend
+
+                self.settings = settings
+                self.projectDir = main.projectBaseDir()
+                self.processedFiles = {}
+                
+
+        def mercurialRepositoryVersion (self):
+                repo = hg.repository(ui.ui(), self.projectDir)
+                context = repo['tip']
+                result = str(context)
+                
+                return result
+        
+
+        def gitRepositoryVersion (self):
+                repo = Repo(self.projectDir)
+                #if repo.is_dirty():
+                        #print "WARNING: build run with dirty repository"
+                result = repo.refs['HEAD']
+                
+                return result
+        
+
+                
+        def repositoryVersion (self): 
+                cacheKey = 'repositoryVersion'
+                if not self.processedFiles.has_key(cacheKey):
+                        #result = self.mercurialRepositoryVersion()
+                        result = self.gitRepositoryVersion()
+                        self.processedFiles[cacheKey] = result
+                else:
+                        result = self.processedFiles[cacheKey]
+                
+                return result
+        
+
+        #def relativePath (self):
+                #return self.module
+        #
+
+        def log (self, message):
+                print "frontend [" + self.module + "]: " + message
+        
+
+        def absolutePathForSourceFile (self, folder, basePath, file):
+                return folder + '/frontend/' + self.module + '/' + basePath + '/' + file
+        
+
+        def absolutePathForTargetFile (self, folder, basePath, file):
+                return folder + '/' + self.module + '/' + basePath + '/' + file
+
+        def filterFiles (self, files):
+                result = []
+                
+                for file in files:
+                        if file.startswith('--'):
+                                pass
+                        else:
+                                result.append(file)
+                        
+                return result
+        
+
+        def copyResources (self, sourceFolder, destinationFolder, fileType):
+                for file in self.filterFiles(self.settings[fileType]):
+                        src = self.absolutePathForSourceFile(sourceFolder,      fileType, file)
+                        dst = self.absolutePathForTargetFile(destinationFolder, fileType, file)
+                        main.createFolder(os.path.dirname(dst))
+                        shutil.copy2(src, dst)
+                
+
+        def copyResourcesToTargetFolder (self, targetFolder):
+                self.copyResources(self.projectDir, targetFolder, 'css')
+                self.copyResources(self.projectDir, targetFolder, 'js')
+        
+
+        def loadFilesContent (self, basePath, files):
+                result = ""
+                
+                for file in self.filterFiles(files):
+                        try:
+                                fileHandler = codecs.open(self.absolutePathForSourceFile(self.projectDir, basePath, file), 'r', 'utf-8')
+                        except:
+                                print "FILE: " + file
+
+                        result += fileHandler.read() + '\n'
+                        fileHandler.close()
+                        
+                return result
+        
+
+        def template (self):
+                processedFile = 'html_template'
+                if not self.processedFiles.has_key(processedFile):
+                        self.processedFiles[processedFile] = self.loadFilesContent('html', ['index_template.html'])
+                        
+                return self.processedFiles[processedFile]
+        
+
+        def cssminCompressor (self, css):
+                # package found here:
+                # - http://stackoverflow.com/questions/222581/python-script-for-minifying-css/2396777#2396777
+                # actual downloaded version: http://pypi.python.org/pypi/cssmin/0.1.4
+                return cssmin.cssmin(css)
+        
+
+        def regexCssCompressor (self, css):
+                # http://stackoverflow.com/questions/222581/python-script-for-minifying-css/223689#223689
+                
+                # remove comments - this will break a lot of hacks :-P
+                css = re.sub( r'\s*/\*\s*\*/', "$$HACK1$$", css ) # preserve IE<6 comment hack
+                css = re.sub( r'/\*[\s\S]*?\*/', "", css )
+                css = css.replace( "$$HACK1$$", '/**/' ) # preserve IE<6 comment hack
+
+                # url() doesn't need quotes
+                css = re.sub( r'url\((["\'])([^)]*)\1\)', r'url(\2)', css )
+
+                # spaces may be safely collapsed as generated content will collapse them anyway
+                css = re.sub( r'\s+', ' ', css )
+
+                # shorten collapsable colors: #aabbcc to #abc
+                css = re.sub( r'#([0-9a-f])\1([0-9a-f])\2([0-9a-f])\3(\s|;)', r'#\1\2\3\4', css )
+
+                # fragment values can loose zeros
+                css = re.sub( r':\s*0(\.\d+([cm]m|e[mx]|in|p[ctx]))\s*;', r':\1;', css )
+
+                for rule in re.findall( r'([^{]+){([^}]*)}', css ):
+
+                    # we don't need spaces around operators
+                    selectors = [re.sub( r'(?<=[\[\(>+=])\s+|\s+(?=[=~^$*|>+\]\)])', r'', selector.strip() ) for selector in rule[0].split( ',' )]
+
+                    # order is important, but we still want to discard repetitions
+                    properties = {}
+                    porder = []
+                    for prop in re.findall( '(.*?):(.*?)(;|$)', rule[1] ):
+                        key = prop[0].strip().lower()
+                        if key not in porder: porder.append( key )
+                        properties[ key ] = prop[1].strip()
+                
+                    # output rule if it contains any declarations
+                    if properties:
+                        print "%s{%s}" % ( ','.join( selectors ), ''.join(['%s:%s;' % (key, properties[key]) for key in porder])[:-1] )
+                
+                return css
+        
+
+        def compressCSS (self, css):
+                self.log("compressing CSS")
+                #return self.regexCssCompressor(css)
+                return self.cssminCompressor(css)
+        
+
+        #==========================================================================
+
+        def compressJS_jsmin (self, js):
+                self.log("compressing JS code")
+                original = StringIO.StringIO(js)
+                output = StringIO.StringIO()
+                
+                jsMinifier = jsmin.JavascriptMinify()
+                jsMinifier.minify(original, output)
+                
+                result = output.getvalue()
+                
+                original.close()
+                output.close()
+                
+                return result
+
+        def compressJS_closureCompiler (self, js):
+                        #Googles Closure compiler
+                        #java -jar compiler.jar --js=in1.js --js=in2.js ... --js_output_file=out.js
+                
+                result = js
+                
+                return result
+        
+
+        def compressJS (self, js):
+                return self.compressJS_jsmin(js)
+                #return self.compressJS_closureCompiler(js)
+        
+
+        #==========================================================================
+
+        def packBookmarklet (self, bookmakeletCode):
+                replacers = [
+                                ('isLoginForm',                         'ilf'),
+                                ('findLoginForm',               'flf'),
+                                ('findLoginForm',               'flf'),
+                                ('formParameters',              'fp' ),
+                                ('pageParameters',              'pp' ),
+                                ('serializeJSON',               'sj' ),
+                                ('reprString',                  'rs' ),
+                                ('logFormParameters',   'lfp'),
+                                ('loadClipperzBookmarklet','lcb'),
+                                ('loginForm',                   'lf' ),
+                                ('parameters',                  'p'  ),
+                                ('inputElementValues',  'iev'),
+                ]
+                result = self.compressJS(bookmakeletCode)
+                
+                        result = re.sub('\n', ' ', result)      #Fit all in a single line
+                        # result = re.sub('\s+', ' ', result)   #Collapse "redundant" spaces. WARNING: this could have some evil side effects on constant strings used inside to code!!
+                # result = re.sub('\s?([,\+=\(\)\{\};])\s?', '\\1', result)
+                
+                for replacer in replacers:
+                        result = re.sub(replacer[0], replacer[1], result)
+                
+        #               <!--    escaping required to handle the bookmarklet code within the javascript code     -->
+                        result = re.sub('\://',                 '%3a%2f%2f',result)
+                        result = re.sub('/',            '%2f',          result)
+        #               result = re.sub('"',            '%22',          result)
+                        result = re.sub('"',            '\\"',          result)
+                        result = re.sub('\"',           '%22',          result)
+                        result = re.sub('\'',           '%22',          result)
+                        result = re.sub('\\\\',                 '%5c',          result)
+                result = result.strip()
+                result = 'javascript:' + result
+
+        #       replacers = [
+        #                       ('aForm',                       '_1' ),
+        #                       ('inputFields',                 '_2' ),
+        #                       ('passwordFieldsFound','_3' ),
+        #                       ('aDocument',           '_6' ),
+        #                       ('aLevel',                      '_7' ),
+        #               #       ('result',                      '_8' ),
+        #                       ('documentForms',       '_9' ),
+        #                       ('iFrames',                     '_c' ),
+        #                       ('anInputElement',      '_d' ),
+        #                       ('options',                     '_f' ),
+        #                       ('option',                      '_12'),
+        #                       ('aLoginForm',          '_13'),
+        #               #       ('action',                      '_17'),
+        #                       ('radioValues',                 '_18'),
+        #                       ('radioValueName',      '_19'),
+        #                       ('inputElement',        '_1a'),
+        #                       ('elementValues',       '_1b'),
+        #                       ('radioValue',          '_1c'),
+        #                       ('values',                      '_1d'),
+        #                       ('objtype',                     '_21'),
+        #                       ('useKey',                      '_27'),
+        #                       ('bookmarkletDiv',      '_28'),
+        #                       ('someParameters',      '_29'),
+        #                       ('anException',                 '_2a'),
+        #                       ('newDiv',                      '_2b'),
+        #                       ('base_url',            '_2c'),
+        #                       ('help_url',            '_2d'),
+        #                       ('logo_image_url',      '_2e'),
+        #               ('background_image_url','_2f'),
+        #                       ('close_image_url',     '_30'),
+        #               #('bookmarklet_textarea','_31'),
+        #                       ('innerHTML',           '_32'),
+        #       ]
+        #       for replacer in replacers:
+        #               result = re.sub('([^\.])' + replacer[0], '\\1' + replacer[1], result)
+
+        #       replacers = [
+        #                       ('headNode',            '_1' ),
+        #                       ('clipperzScriptNode','_2' ),
+        #       ]
+        #       for replacer in replacers:
+        #               result = re.sub('([^\.])' + replacer[0], '\\1' + replacer[1], result)
+
+        #       result = re.sub(';', ';\n', result)
+                
+                return result
+                
+        
+
+        def bookmarklet (self):
+                cacheKey = 'bookmarklet'
+                if not self.processedFiles.has_key(cacheKey):
+                        result = 'bookmarklet="' + self.packBookmarklet(self.loadFilesContent('js', ['Bookmarklet.js'])) + '";bookmarklet_ie="' + self.packBookmarklet(self.loadFilesContent('js', ['Bookmarklet_IE.js'])) + '";'
+                        self.processedFiles[cacheKey] = result
+                else:
+                        result = self.processedFiles[cacheKey]
+                
+                return result
+        
+
+        def replaceTemplatePlaceholders (self, assemblyMode, pageTitle, copyright, css, code, version, versionType):
+                result = self.template()
+                
+                        result = result.replace('@page.title@',                                         pageTitle,      1)
+                        result = result.replace('@copyright@',                                  copyright,      1)
+                        result = result.replace('@css@',                                                css,            1)
+                        #result = result.replace('@bookmarklet@',                               bookmarklet,1)
+                        result = result.replace('@application.version@',                version,        1)
+                        result = result.replace('@application.version.type@',   versionType,1)
+                        result = result.replace('@js_' + assemblyMode + '@',    code,           1)
+
+                result = re.sub('@js_[^@]+@', '', result)
+
+                return result
+        
+
+        def assembleCopyrightHeader (self):
+                processedFile = 'copyright'
+                if not self.processedFiles.has_key(processedFile):
+                        #self.log("assembling copyright header")
+                        copyrightValues = self.settings['copyright.values']
+                        license = self.loadFilesContent('../../properties', ['license.txt'])
+                        result  = self.loadFilesContent('properties', ['creditsAndCopyrights.txt'])
+                        
+                        result = re.sub('@clipperz.license@', license, result)
+                        for key in copyrightValues:
+                                result = re.sub('@'+key+'@', copyrightValues[key], result)
+                        
+                        self.processedFiles[processedFile] = result
+                        
+                return self.processedFiles[processedFile]
+        
+
+        def cssTagsForFiles (self, basePath, files):
+                #<link rel="stylesheet" type="text/css" href="./css/reset-min.css" />
+                return '\n'.join(map(lambda file: '<link rel="stylesheet" type="text/css" href="./' + basePath + '/' + file + '" />', files))
+        
+
+        def cssTagForContent (self, content):
+                return '<style type="text/css">' + content + '</style>'
+        
+
+        def scriptTagsForFiles (self, basePath, files):
+                #<script type='text/javascript' src='./js/src/bookmarklet.js'></script>
+                return '\n'.join(map(lambda file: '<script type="text/javascript" src="./' + basePath + '/' + file + '"></script>', files))
+        
+
+        def scriptTagForContent (self, content):
+                return '<script>' + content + '</script>'
+        
+
+        def assembleVersion (self, assemblyMode, pageTitle, copyright, css, js, version, versionType):
+                cacheKey = version + "-" + versionType
+                if not self.processedFiles.has_key(cacheKey):
+                        result = self.replaceTemplatePlaceholders(assemblyMode, pageTitle, copyright, css, js, version, versionType)
+                        self.processedFiles[cacheKey] = result
+                else:
+                        result = self.processedFiles[cacheKey]
+                
+                #self.log("# cacheKey:\n" + result)
+                return result
+        
+
+        def assemble (self, assemblyMode='INSTALL', versionType='LIVE'):
+                pageTitle = "Clipperz - " + self.module
+                if versionType != 'LIVE':
+                        pageTitle += " [" + versionType + " - " + assemblyMode +"]"
+                
+                if assemblyMode == 'INSTALL':
+                                css= self.cssTagForContent(self.compressCSS(self.loadFilesContent('css', self.settings['css'])))
+                                js= self.scriptTagForContent(self.bookmarklet() + '\n' + self.compressJS(self.loadFilesContent('js', self.settings['js'])))
+                else:
+                                css= self.cssTagsForFiles('css', self.filterFiles(self.settings['css']))
+                                js= self.scriptTagForContent(self.bookmarklet()) + '\n' + self.scriptTagsForFiles('js', self.filterFiles(self.settings['js']))
+                
+                return self.assembleVersion(
+                                assemblyMode= assemblyMode,
+                                pageTitle       = pageTitle,
+                                copyright       = self.assembleCopyrightHeader(),
+                                css                     = css,
+                                js                      = js,
+                                version                 = self.repositoryVersion(),
+                                versionType     = versionType
+                )
+
+
+
+
diff --git a/scripts/builder/jsmin.py b/scripts/builder/jsmin.py
new file mode 100644
index 0000000..91d6307
--- a/dev/null
+++ b/scripts/builder/jsmin.py
@@ -0,0 +1,246 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+import os, os.path, shutil
+
+# This code is original from jsmin by Douglas Crockford, it was translated to
+# Python by Baruch Even. The original code had the following copyright and
+# license.
+#
+# /* jsmin.c
+#    2007-05-22
+#
+# Copyright (c) 2002 Douglas Crockford  (www.crockford.com)
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy of
+# this software and associated documentation files (the "Software"), to deal in
+# the Software without restriction, including without limitation the rights to
+# use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+# of the Software, and to permit persons to whom the Software is furnished to do
+# so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# The Software shall be used for Good, not Evil.
+#
+# 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
+# AUTHORS OR COPYRIGHT HOLDERS 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.
+# */
+
+from StringIO import StringIO
+
+def jsmin(js):
+    ins = StringIO(js)
+    outs = StringIO()
+    JavascriptMinify().minify(ins, outs)
+    str = outs.getvalue()
+    if len(str) > 0 and str[0] == '\n':
+        str = str[1:]
+    return str
+
+def isAlphanum(c):
+    """return true if the character is a letter, digit, underscore,
+           dollar sign, or non-ASCII character.
+    """
+    return ((c >= 'a' and c <= 'z') or (c >= '0' and c <= '9') or
+            (c >= 'A' and c <= 'Z') or c == '_' or c == '$' or c == '\\' or (c is not None and ord(c) > 126));
+
+class UnterminatedComment(Exception):
+    pass
+
+class UnterminatedStringLiteral(Exception):
+    pass
+
+class UnterminatedRegularExpression(Exception):
+    pass
+
+class JavascriptMinify(object):
+
+    def _outA(self):
+        self.outstream.write(self.theA)
+    def _outB(self):
+        self.outstream.write(self.theB)
+
+    def _get(self):
+        """return the next character from stdin. Watch out for lookahead. If
+           the character is a control character, translate it to a space or
+           linefeed.
+        """
+        c = self.theLookahead
+        self.theLookahead = None
+        if c == None:
+            c = self.instream.read(1)
+        if c >= ' ' or c == '\n':
+            return c
+        if c == '': # EOF
+            return '\000'
+        if c == '\r':
+            return '\n'
+        return ' '
+
+    def _peek(self):
+        self.theLookahead = self._get()
+        return self.theLookahead
+
+    def _next(self):
+        """get the next character, excluding comments. peek() is used to see
+           if an unescaped '/' is followed by a '/' or '*'.
+        """
+        c = self._get()
+        if c == '/' and self.theA != '\\':
+            p = self._peek()
+            if p == '/':
+                c = self._get()
+                while c > '\n':
+                    c = self._get()
+                return c
+            if p == '*':
+                c = self._get()
+                while 1:
+                    c = self._get()
+                    if c == '*':
+                        if self._peek() == '/':
+                            self._get()
+                            return ' '
+                    if c == '\000':
+                        raise UnterminatedComment()
+
+        return c
+
+    def _action(self, action):
+        """do something! What you do is determined by the argument:
+           1   Output A. Copy B to A. Get the next B.
+           2   Copy B to A. Get the next B. (Delete A).
+           3   Get the next B. (Delete B).
+           action treats a string as a single character. Wow!
+           action recognizes a regular expression if it is preceded by ( or , or =.
+        """
+        if action <= 1:
+            self._outA()
+
+        if action <= 2:
+            self.theA = self.theB
+            if self.theA == "'" or self.theA == '"':
+                while 1:
+                    self._outA()
+                    self.theA = self._get()
+                    if self.theA == self.theB:
+                        break
+                    if self.theA <= '\n':
+                        raise UnterminatedStringLiteral()
+                    if self.theA == '\\':
+                        self._outA()
+                        self.theA = self._get()
+
+
+        if action <= 3:
+            self.theB = self._next()
+            if self.theB == '/' and (self.theA == '(' or self.theA == ',' or
+                                     self.theA == '=' or self.theA == ':' or
+                                     self.theA == '[' or self.theA == '?' or
+                                     self.theA == '!' or self.theA == '&' or
+                                     self.theA == '|' or self.theA == ';' or
+                                     self.theA == '{' or self.theA == '}' or
+                                     self.theA == '\n'):
+                self._outA()
+                self._outB()
+                while 1:
+                    self.theA = self._get()
+                    if self.theA == '/':
+                        break
+                    elif self.theA == '\\':
+                        self._outA()
+                        self.theA = self._get()
+                    elif self.theA <= '\n':
+                        raise UnterminatedRegularExpression()
+                    self._outA()
+                self.theB = self._next()
+
+
+    def _jsmin(self):
+        """Copy the input to the output, deleting the characters which are
+           insignificant to JavaScript. Comments will be removed. Tabs will be
+           replaced with spaces. Carriage returns will be replaced with linefeeds.
+           Most spaces and linefeeds will be removed.
+        """
+        self.theA = '\n'
+        self._action(3)
+
+        while self.theA != '\000':
+            if self.theA == ' ':
+                if isAlphanum(self.theB):
+                    self._action(1)
+                else:
+                    self._action(2)
+            elif self.theA == '\n':
+                if self.theB in ['{', '[', '(', '+', '-']:
+                    self._action(1)
+                elif self.theB == ' ':
+                    self._action(3)
+                else:
+                    if isAlphanum(self.theB):
+                        self._action(1)
+                    else:
+                        self._action(2)
+            else:
+                if self.theB == ' ':
+                    if isAlphanum(self.theA):
+                        self._action(1)
+                    else:
+                        self._action(3)
+                elif self.theB == '\n':
+                    if self.theA in ['}', ']', ')', '+', '-', '"', '\'']:
+                        self._action(1)
+                    else:
+                        if isAlphanum(self.theA):
+                            self._action(1)
+                        else:
+                            self._action(3)
+                else:
+                    self._action(1)
+
+    def minify(self, instream, outstream):
+        self.instream = instream
+        self.outstream = outstream
+        self.theA = '\n'
+        self.theB = None
+        self.theLookahead = None
+
+        self._jsmin()
+        self.instream.close()
+
+def compress(in_files, out_file, in_type='js', verbose=False, temp_file='.temp'):
+    temp = open(temp_file, 'w')
+    for f in in_files:
+        fh = open(f)
+        data = fh.read() + '\n'
+        fh.close()
+
+        temp.write(data)
+
+        print ' + %s' % f
+    temp.close()
+
+    out = open(out_file, 'w')
+
+    jsm = JavascriptMinify()
+    jsm.minify(open(temp_file,'r'), out)
+
+    out.close()
+
+    org_size = os.path.getsize(temp_file)
+    new_size = os.path.getsize(out_file)
+
+    print '=> %s' % out_file
+    print 'Original: %.2f kB' % (org_size / 1024.0)
+    print 'Compressed: %.2f kB' % (new_size / 1024.0)
+    print 'Reduction: %.1f%%' % (float(org_size - new_size) / org_size * 100)
+    print ''
+
+    os.remove(temp_file)
\ No newline at end of file
diff --git a/scripts/builder/main.py b/scripts/builder/main.py
new file mode 100755
index 0000000..ba0c72a
--- a/dev/null
+++ b/scripts/builder/main.py
@@ -0,0 +1,166 @@
+#!/usr/bin/python
+# -*- coding: UTF-8 -*-
+
+import sys, os, json
+import shutil
+import pprint
+import frontendBuilder
+import codecs
+import itertools
+
+from collections   import deque
+from phpBuilder    import PhpBuilder
+from pythonBuilder import PythonBuilder
+
+pp = pprint.PrettyPrinter(indent=4, depth=4)
+
+#--------------------------------------------------------------------
+
+def scriptDir ():
+        return  os.path.dirname(sys.argv[0])
+
+def projectBaseDir ():
+        return os.path.abspath(scriptDir() + '/../..')
+
+def projectTargetDir(): 
+        return projectBaseDir() + '/target/'
+
+#--------------------------------------------------------------------
+
+def createFolder (path):
+        if not os.path.exists(path):
+                os.makedirs(path)
+
+#--------------------------------------------------------------------
+
+def loadSettings (component, module):
+        print "MODULE: " + module
+
+        if '.' in module:
+                moduleComponents = module.split('.')
+                module = moduleComponents[0]
+                submodule = moduleComponents[1]
+        else:
+                submodule = module
+
+        settings = codecs.open(projectBaseDir() + '/' + component + '/' + module + '/properties/' + submodule + '.properties.json', 'r', 'utf-8')
+        result = json.load(settings)
+        settings.close
+
+        return result
+
+#====================================================================
+# 
+# def assembleFrontend (frontend, versions):
+        # result = {}
+        # settings = loadSettings('frontend', frontend)
+        # builder = frontendBuilder.FrontendBuilder(frontend, settings, projectBaseDir())
+        # 
+        # for version in versions:
+        #       if version == 'install':
+        #               result[version] = builder.assembleInstallVersion()
+        #       elif version == 'debug':
+        #               result[version] = builder.assembleDebugVersion()
+        #       else:
+        #               raise Exception('unrecognized version: ' + version)
+        # 
+        # return result
+# 
+#====================================================================
+
+def assembleBackend (backend, frontends, versions):
+        settings = loadSettings('backend', backend)
+        
+        if backend == 'php':
+                backendBuilder = PhpBuilder(projectTargetDir(), frontends, versions, settings)
+        elif backend == 'python':
+                backendBuilder = PythonBuilder(projectTargetDir(), frontends, versions, settings)
+        #elif backend == 'java':
+                #buildJavaBackend (frontends, versions, settings)
+        else:
+                raise Exception('unrecognized backend: ' + backend)
+                
+                backendBuilder.run()
+
+#====================================================================
+
+def build (settings):
+        frontends = []
+        
+        for frontend in settings['frontends']:
+                frontends.append(frontendBuilder.FrontendBuilder(frontend, loadSettings('frontend', frontend)))
+
+        for backend in settings['backends']:
+                assembleBackend(backend, frontends, settings['versions'])
+
+#--------------------------------------------------------------------
+
+def clean ():
+        print "cleaning up …"
+        if os.path.exists(projectTargetDir()):
+                shutil.rmtree(projectTargetDir())
+
+#--------------------------------------------------------------------
+
+def usage (message):
+        if message != None:
+                print "ERROR: " + message
+        
+        print
+        print "build.py clean"
+        print "build.py clean install"
+        print "build.py install --ALL"
+        print "build.py install debug --ALL"
+        print "build.py clean install debug --ALL"
+        print "build.ph install, debug --backends php java --frontends beta gamma"
+        print "build.ph install, debug --backends php java --frontends beta gamma gamma.mobile"
+        exit(1)
+
+#--------------------------------------------------------------------
+
+def main ():
+        settings = {}
+        parameters = list(itertools.islice(sys.argv, 1, None))
+        
+        shouldClean = len(filter(lambda x: x == 'clean', parameters)) > 0
+        if (shouldClean):
+                clean ()
+        
+        parameters = filter(lambda x: x != 'clean', parameters)
+        versions = list(itertools.takewhile(lambda x: not x.startswith('--'), parameters))
+                settings['versions']  = versions;       #['debug',  'install']
+        parameters = deque(itertools.dropwhile(lambda x: not x.startswith('--'), parameters))
+        
+        if len(parameters) > 0:
+                parameter = parameters.popleft()
+                if parameter == "--ALL":
+                        settings['frontends'] = ['beta', 'gamma',  'mobile']
+                        settings['backends']  = ['php',  'python', 'java']
+                else:
+                        while parameter != None:
+                                values = list(itertools.takewhile(lambda x: not x.startswith('--'), parameters))
+                        
+                                if parameter == "--backends":
+                                        settings['backends'] = values
+                                elif parameter == "--frontends":
+                                        settings['frontends'] = values
+                        
+                                parameters = deque(itertools.dropwhile(lambda x: not x.startswith('--'), parameters))
+                                if parameters:
+                                        parameter = parameters.popleft()
+                                else:
+                                        parameter = None
+        
+                if (not settings.has_key('versions')):
+                        usage("missing 'versions'")
+                if (not settings.has_key('frontends')):
+                        usage("missing 'frontends'")
+                if (not settings.has_key('backends')):
+                        usage("missing 'backends'")
+                
+                build (settings)
+        
+
+
+if __name__ == "__main__":
+    main()
\ No newline at end of file
diff --git a/scripts/builder/phpBuilder.py b/scripts/builder/phpBuilder.py
new file mode 100644
index 0000000..9512192
--- a/dev/null
+++ b/scripts/builder/phpBuilder.py
@@ -0,0 +1,14 @@
+#!/usr/bin/python
+# -*- coding: UTF-8 -*-
+
+from backendBuilder import BackendBuilder
+
+class PhpBuilder(BackendBuilder):
+        
+        def name(self):
+                return "PHP builder"
+        
+        def relativePath(self):
+                return 'php'
+        
+
diff --git a/scripts/builder/pythonBuilder.py b/scripts/builder/pythonBuilder.py
new file mode 100644
index 0000000..44c62a8
--- a/dev/null
+++ b/scripts/builder/pythonBuilder.py
@@ -0,0 +1,14 @@
+#!/usr/bin/python
+# -*- coding: UTF-8 -*-
+
+from backendBuilder import BackendBuilder
+
+class PythonBuilder(BackendBuilder):
+        
+        def name(self):
+                return "Python builder"
+        
+        def relativePath(self):
+                return 'python'
+        
+