Adding utility functions for the ULS langdb

* More functions for making useful queries to the langdb.
* Tests.

Change-Id: I29a3a25ef1b15d5925df2aa3d06f9221f8e5231e

resources/ext.uls.core.js

@@ -48,6 +48,8 @@
 			// Register all event listeners to the ULS here.
 			that.$element.on( 'click', $.proxy( that.click, that ) );
 			$( ".icon-close" ).on( 'click', $.proxy( that.click, that ) );
+
+			// The search input box
 			$( "#languagefilter" ).languagefilter( {
 				$target: $( 'ul.uls-language-filter-result' ),
 				clickhandler: function( langCode ) {
@@ -55,6 +57,7 @@
 				},
 				languages: that.languages
 			} );
+
 			// Create region selectors, one per region
 			$( '.uls-region' ).regionselector( {
 				$target: $( 'ul.uls-language-filter-result' ),

resources/ext.uls.data.utils.js

@@ -1,6 +1,6 @@
 /*
  * @author Amir E. Aharoni
- * Utilities for querying the language db.
+ * Utilities for querying language data.
  */
 (function ( $ ) {
 	"use strict";
@@ -9,6 +9,103 @@
 	var scriptIndex = 0,
 		regionsIndex = 1;
 
+	/*
+	 * Returns all languages written in script.
+	 * @param script string
+	 * @return array of strings (languages codes)
+	 */
+	$.uls.data.languagesInScript = function( script ) {
+		return $.uls.data.languagesInScripts( [ script ] );
+	}
+
+	/*
+	 * Returns all languages written in the given scripts.
+	 * @param scripts array of strings
+	 * @return array of strings (languages codes)
+	 */
+	$.uls.data.languagesInScripts = function( scripts ) {
+		var languagesInScripts = [];
+
+		for ( var language in $.uls.data.languages ) {
+			for ( var i = 0; i < scripts.length; i++ ) {
+				if ( scripts[i] === $.uls.data.languages[language][scriptIndex] ) {
+					languagesInScripts.push( language );
+					break;
+				}
+			}
+		}
+
+		return languagesInScripts;
+	}
+
+	/*
+	 * Returns all languages in a given region.
+	 * @param region string
+	 * @return array of strings (languages codes)
+	 */
+	$.uls.data.languagesInRegion = function( region ) {
+		return $.uls.data.languagesInRegions( [ region ] );
+	}
+
+	/*
+	 * Returns all languages in given regions.
+	 * @param region array of strings.
+	 * @return array of strings (languages codes)
+	 */
+	$.uls.data.languagesInRegions = function( regions ) {
+		var languagesInRegions = [];
+
+		for ( var language in $.uls.data.languages ) {
+			for ( var i = 0; i < regions.length; i++ ) {
+				if ( $.inArray( regions[i], $.uls.data.languages[language][regionsIndex] ) != -1 ) {
+					languagesInRegions.push( language );
+					break;
+				}
+			}
+		}
+
+		return languagesInRegions;
+	}
+
+	/*
+	 * Returns an associative array of languages in a region,
+	 * grouped by script.
+	 * @param string region code
+	 * @return associative array
+	 */
+	$.uls.data.languagesByScriptInRegion = function( region ) {
+		var languagesByScriptInRegion = {};
+
+		for ( var language in $.uls.data.languages ) {
+			if ( $.inArray( region, $.uls.data.languages[language][regionsIndex] ) != -1 ) {
+				var script = $.uls.data.languages[language][scriptIndex];
+				if ( languagesByScriptInRegion[script] === undefined ) {
+					languagesByScriptInRegion[script] = [];
+				}
+				languagesByScriptInRegion[script].push( language );
+			}
+		}
+
+		return languagesByScriptInRegion;
+	}
+
+	/*
+	 * Returns all regions in a region group.
+	 * @param number groupNum
+	 * @return array of strings
+	 */
+	$.uls.data.regionsInGroup = function( groupNum ) {
+		var regionsInGroup = [];
+
+		for ( var region in $.uls.data.regiongroups ) {
+			if ( $.uls.data.regiongroups[region] === groupNum ) {
+				regionsInGroup.push( region );
+			}
+		}
+
+		return regionsInGroup;
+	}
+
 	/*
 	 * Returns the script group of a script or 'Other' if it doesn't
 	 * belong to any group.