source: Dev/trunk/src/client/util/buildscripts/cldr/arrayInherit.js

/**
 *  The CLDR represents some lists, like month names, as separate entries, and our JSON uses arrays to express them.
 *  For some variants, the best our XSLT can do is translate this to a sparse array with 'undefined' entries.
 *  These entries need to be picked up from the parent locale(s) and copied into the array as necessary(only when the item
 *  is not the source of a locale alias mapping, like 'months-format-abbr' should be ignored if it is the source of
 *  locale alias mapping like 'months-format-abbr@localeAlias' :{'target':"months-format-wide",'bundle':"gregorian"}).
 *  So, this script is responsible for taking all the generated JSON files, and for values which are of type
 *  array and not the source of locale alias mapping, mixing in the parent values with the undefined ones, recursing
 *  all the way to the 'root' locale,and replacing the contents of the file.
 *
 *  this script traverses all locales dir in the given root dir
 *
 *   E.g.(Just for example, the contents are not applicable)
 *   parent locale - "en":
 *    // generated from ldml/main/ *.xml, xpath: ldml/calendars/calendar-ethiopic
 *    ({
 *      'months-format-abbr':["1","2","3","4","5","6","7","8","9","10","11","12"],
 *      'dateFormat-long': "yyyy MMMM d",
 *      'dateTimeFormat': "{1} {0}"
 *    })
 *
 *   child locale - "en-us":
 *    // generated from ldml/main/ *.xml, xpath: ldml/calendars/calendar-ethiopic
 *    ({
 *      'months-format-abbr':[undefined,undefined,"March",undefined,undefined,"June"],
 *      'dateFormat-long': "yyyy-MMMM-d"
 *    })
 *
 *   After process, the result will be:
 *    child locale - "en-us":
 *    // generated from ldml/main/ *.xml, xpath: ldml/calendars/calendar-ethiopic
 *    ({
 *      'months-format-abbr':["1","2","March","4","5","June","7","8","9","10","11","12"],
 *      'dateFormat-long': "yyyy-MMMM-d"
 *    })
 */

djConfig={baseUrl: "../../../dojo/", paths: {"dojo/_base/xhr": "../util/buildscripts/cldr/xhr"}};

load("../../../dojo/dojo.js");
load("../jslib/logger.js");
load("../jslib/fileUtil.js");
load("cldrUtil.js");

dojo.require("dojo.i18n");

var _searchLocalePath = function(/*String*/locale, /*Boolean*/down, /*Function*/searchFunc){
    // summary:
    //          A helper method to assist in searching for locale-based resources.
    //          Will iterate through the variants of a particular locale, either up
    //          or down, executing a callback function.  For example, "en-us" and
    //          true will try "en-us" followed by "en" and finally "ROOT".

    locale = dojo.i18n.normalizeLocale(locale);

    var elements = locale.split('-');
    var searchlist = [];
    for(var i = elements.length; i > 0; i--){
        searchlist.push(elements.slice(0, i).join('-'));
    }
    searchlist.push(false);
    if(down){searchlist.reverse();}

    for(var j = searchlist.length - 1; j >= 0; j--){
        var loc = searchlist[j] || "ROOT";
        var stop = searchFunc(loc);
        if(stop){ break; }
    }
};

var dir = arguments[0];
var logDir = arguments[1];
var logStr = "";

print('arrayInherit.js...');

// limit search to gregorian.js files, which are the only ones to use Array as data type
var fileList = fileUtil.getFilteredFileList(dir, /\/gregorian\.js$/, true);

for(var i= 0; i < fileList.length; i++){
        //Use new String so we get a JS string and not a Java string.
        var jsFileName = new String(fileList[i]);
        var data = null;
        var jsPath = jsFileName.split("/");
        var localeIndex = jsPath.length-2;
        var locale = jsPath[localeIndex];
        if(locale=="nls"){continue;} // don't run on ROOT resource
        var hasChanged = false;
        
        try{
//              dojo.i18n._requireLocalization('dojo.cldr', 'gregorian', locale);
                var bundle = dojo.i18n.getLocalization('dojo.cldr', 'gregorian', locale); //flattened bundle
        }catch(e){/* logStr += "arrayInherit: an exception occurred: "+e;/* simply ignore if no bundle found*/}
        
        _searchLocalePath(locale, true, function(variant){
                var isComplete = false;
                var path = jsPath;
                if(variant=="ROOT"){
                        path = path.slice(0, localeIndex);
                        path.push(jsPath[localeIndex+1]);
                }else{
                        path[localeIndex] = variant;
                }
                var contents;
                try{
                        contents = new String(readFile(path.join("/"), "utf-8"));
                }catch(e){
                        print(e); //TODO: should we be catching this?
                        return false;
                }
                var variantData = dojo.fromJson(contents);
                if(!data){
                        data = variantData;
                }else{
                        isComplete = true;
                        //logStr += locale + "===============================================\n";
                        for(prop in data){
                                if(dojo.isArray(data[prop])){
                                        //ignore if the property is an alias source, for alias.js and specialLocale.js
                                        if(isLocaleAliasSrc(prop, bundle)){
                                                //logStr += prop + " is alias, ignored\n";
                                                continue;
                                        }

                                        var variantArray = variantData[prop];
                                        dojo.forEach(data[prop], function(element, index, list){
                                                if(element === undefined && dojo.isArray(variantArray)){
                                                        list[index] = variantArray[index];
                                                        //logStr += prop + "[" + index + "] undefined, is replaced with " + list[index] + "\n";
                                                        hasChanged = true;
                                                        if(!("index" in list)){
                                                                isComplete = false;
                                                        }
                                                }
                                        });
                                        if(dojo.isArray(variantArray) && variantArray.length > data[prop].length){
                                                data[prop] = data[prop].concat(variantArray.slice(data[prop].length));
                                                hasChanged = true;
                                        }
                                }
                        }
                        //logStr += "\n";
                }
                return isComplete;
        });
        if(hasChanged){
                fileUtil.saveUtf8File(jsFileName, "(" + dojo.toJson(data, true) + ")");
        }
}

//fileUtil.saveUtf8File(logDir + '/arrayInherit.log',logStr+'\n');