Line 1: |
Line 1: |
| // License: GPL | | // License: GPL |
− | // Wikibase Instance/Entity Gadget | + | // Wikibase Processor |
− | console.log('Wbprocessor loading'); | + | console.log('wbprocessor loading'); |
| | | |
− | function wbContainer(universe, location) { | + | function WikibaseProcessorContainer(universe, location) { |
| | | |
− | // the list of private helper functions, could not be accessed from outside | + | Debug_switch = false; |
− | function indexinterpolate(obj,i) { return (obj[i] != undefined) ? obj[i] : obj};
| + | |
− | // helper function for checking a part of an array exists
| + | this.main = interjson(checkdive(universe, location)); |
− | function indexcheck(obj,i) { return (obj[i] != undefined) ? obj[i] : undefined };
| + | var the = this.main; |
− | // dive selects matrix.a.b.c.d from the array called matrix and 'a.b.c.d' as string
| + | |
− | // if a.b.c.d does not exists, it returns the substructure until the substructure exists, if d does not exist, it returns matrix.a.b.c e.g.
| + | /* The following is the main exposed function of the current Wb Processing class |
− | function dive(array, read){
| + | usage cases |
− | return read.split('.').reduce(indexinterpolate, array);
| + | |
| + | to check the last value in a location given by a preceding array of internal paths to find, with the possibility of array layers between elements of array of paths: |
| + | wbproc.checkentity( [ wbEStruct['instanceOfRelations'], wbEStruct['IDPropLoc'], wbEStruct['IDName'], 96 ] ); |
| + | |
| + | to return for example content of default value given by array of location paths, or check for existence of |
| + | wbproc.checkentity( { default_value: [ wbEStruct['defaultValRelation'], wbEStruct['IDPropLoc'] ] } ) |
| + | |
| + | |
| + | */ |
| + | |
| + | this.checkentity = function(paths) { |
| + | if ((the !== undefined) && (paths !== undefined)) { |
| + | return proceed(the, paths); |
| + | } |
| + | } |
| + | |
| + | // Exposed general wrapper for proceed for object other than what the class is originally instanced on, currently unused |
| + | // Could be used to create a further function to cross check current object with another object 'universe' with another for example |
| + | |
| + | this.xcontains = function(unv, angle) { |
| + | if ((unv !== undefined) && (angle !== undefined)) { |
| + | return proceed(unv, angle); |
| + | }; |
| + | } |
| + | |
| + | /* Exposed helper function to get Entity object of alien entity, if ever needed */ |
| + | |
| + | this.EnqueueWB = async function(idk) { |
| + | var k = await wbqueue(idk); |
| + | return k; |
| + | } |
| + | |
| + | /* Private part of wb Entity getter */ |
| + | |
| + | async function wbqueue(id) { |
| + | return new Promise( |
| + | function(resolve, reject) { |
| + | $.getJSON('/w/api.php?action=wbgetentities&format=json&ids=' + id, function(json) { |
| + | var h = json.entities; |
| + | resolve(h); |
| + | }) |
| + | }).then(function(result) { |
| + | debuglog(result); |
| + | return result; |
| + | }); |
| + | } |
| + | |
| + | |
| + | // the list of private helper functions, could not be accessed from outside |
| + | // helper function for descend into an object if key exists, otherwise stay at current level of object |
| + | function indexinterpolate(obj, i) { |
| + | return (obj[i] !== undefined) ? obj[i] : obj |
| + | }; |
| + | |
| + | // helper function for checking a part of an array exists, if it doesn't, go undefined |
| + | function indexcheck(obj, i) { |
| + | if (obj !== undefined) { |
| + | return (obj[i] !== undefined) ? obj[i] : undefined |
| + | } |
| + | }; |
| + | |
| + | // dive selects matrix.a.b.c.d from the array called matrix and 'a.b.c.d' as string |
| + | // if a.b.c.d does not exists, it returns the substructure until the substructure exists, if d does not exist, it returns matrix.a.b.c e.g. |
| + | function dive(array, read) { |
| + | if (array !== undefined) { |
| + | return (read + '').split('.').reduce(indexinterpolate, array); |
| } | | } |
− | function check(array, read){
| + | } |
− | return read.split('.').reduce(indexcheck, array);
| + | // Check returns matrix.a.b.c.d from 'array' ~ 'matrix' and 'read' ~ 'a.b.c.d' only if it exists all the way, otherwise go undefined |
| + | function check(array, read) { |
| + | if (array !== undefined) { |
| + | return (read + '').split('.').reduce(indexcheck, array); |
| } | | } |
− | function interjson( obj ) {
| + | } |
− | try {
| + | |
− | return JSON.parse( obj )
| + | // Main object / array processing instrument |
− | } catch (e) {
| + | // Array can be a composition of objects and arrays |
− | // if not JSON, do silly things | + | // Read is the instructions, could be an array, or a single path, but for now it should be an object based on our inner convention, example: |
− | console.log('not a json ¯\_(ツ)_/¯');
| + | /* |
− | }; | + | relational_id_list = { |
− | }
| + | controller_id: [ wbEStructure['instanceOfRelations'], wbEStructure['IDPropLoc'], wbEStructure['IDName'], 96 ], |
− | // Get Y from X whether its a single object or an arrayish object | + | personal_data_id: [ wbEStructure['subclassOfRelations'], wbEStructure['IDPropLoc'], wbEStructure['IDName'], 421 ], |
− | function get_Y_from_X( obj, B ){ | + | interface_button_id: [ wbEStructure ['instanceOfRelations'], wbEStructure['IDPropLoc'], wbEStructure['IDName'], 487 ] |
− | if ( check(obj, B) !== undefined ) {
| + | } |
− | console.log( "entity is defined" )
| + | */ |
− | return dive(obj, B);
| + | |
− | } else {
| + | function proceed(array, read) { |
− | for (var i = 0; i < obj.length; i++ ){
| + | var ret_obj = {}, |
− | if ( check(obj[i], B) !== undefined ) {
| + | temp_obj = array, |
− | console.log( "entity is defined within index " + i );
| + | |
− | return dive(obj[i], B);
| + | // If we encounter something seriously wrong we will just raise a red flag by setting this false, will check before returning this. |
− | };
| + | success_o_meter = true, |
− | Object.keys(obj).forEach( function(item) {
| + | |
− | if ( check(obj[item], B) !== undefined ) {
| + | // If all goes well, for each path checked, we will have a member in this |
− | console.log( "entity is defined within associative element" + item )
| + | future_instructional_return = []; |
− | return dive(obj[item], B);
| + | |
− | };
| + | //|||||||||||||||||||||||||||||||||||||||||||||||||||||[ I N S T R U C T I O N S C O N T R O L ]|||||||||||||||||||||||||||||||||||||||||||||||||||||| |
− | });
| + | |
| + | // Init program, check if instructions are an object (not an array but has multiple keys) : |
| + | // This is the main path of the function. Could be improved to have it for simple array of instructions |
| + | if ((!Array.isArray(read)) && (Object.keys(read).length > 0)) { |
| + | |
| + | Object.keys(read).forEach(function(path) { |
| + | debuglog("instructions are an object, in path " + path); |
| + | |
| + | //||||||||||||||||||||||||||[ Check if elements of instruction object are arrays themselves ]|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| |
| + | |
| + | if (Array.isArray(read[path])) { |
| + | |
| + | // for each path, future_instructional_return will be filled with the future_return_partition after proceeding through that path |
| + | var future_return_partition = temp_obj; |
| + | |
| + | Object.keys(read[path]).forEach(function(path2) { |
| + | |
| + | debuglog("instructions are an array of arrays, going through " + read[path][path2]); |
| + | // for each step, see if it led anywhere other than where we were. |
| + | if (data_function(future_return_partition, read[path][path2]) != future_return_partition) { |
| + | // if it did, proceed; |
| + | future_return_partition = data_function(future_return_partition, read[path][path2]); |
| + | } else { |
| + | // if it didn, raise flag |
| + | success_o_meter = false; |
| } | | } |
| + | |
| + | //|||||||||||||||||||||||||||||||||||||||||||||||||||[ I N S T R U C T I O N S C O N T R O L ||||||||||||||||||||||||||||||||||||||||||||||||||||||||| |
| + | |
| + | }); |
| + | //Now that we went through the path, lets see if everything was ok. |
| + | if (success_o_meter === true) { |
| + | // If yes, put the result of the travel 'future_return_partition' into 'future_instructional_return' |
| + | |
| + | debuglog("arrived at") |
| + | debuglog(future_return_partition); |
| + | future_instructional_return[path] = future_return_partition; |
| + | } else { |
| + | |
| + | // Otherwise let's put an undefined in there |
| + | debuglog("seeking derailed"); |
| + | success_o_meter = true; |
| + | future_instructional_return[path] = undefined; |
| + | } |
| + | |
| + | } |
| + | |
| + | //|||||||||||||||||| If instruction object element is not an array, lets just try to do that one step |||||||||||||||||||||||||||||||||||||||||||||||||||||||| |
| + | // Unused |
| + | else { |
| + | |
| + | // INCLUDE step block with read[path] |
| + | if (data_function(temp_obj, read[path]) !== temp_obj) { |
| + | future_instructional_return[path] = data_function(temp_obj, read[path]); |
| + | } else { |
| + | // future_instructional_return.push( undefined ); |
| + | } |
| + | |
| } | | } |
| + | }); |
| + | |
| + | // Now that we have gone through all paths, make future return object into what we got |
| + | temp_obj = future_instructional_return; |
| + | } |
| + | |
| + | //||||||||||||[ If we are not in instruction object, let's see if we have an instruction array ]|||||||||||||||||||||||||||||||||||||||||||||||||||||||||| |
| + | //Unused, this part could be improved |
| + | else if (Array.isArray(read)) { |
| + | // If so let's follow the array of instructions |
| + | Object.keys(read).forEach(function(ect) { |
| + | if (data_function(temp_obj, read[ect]) !== temp_obj) { |
| + | |
| + | temp_obj = data_function(temp_obj, read[ect]); |
| + | |
| + | } else { |
| + | |
| + | success_o_meter = false; |
| | | |
− | // Check if Y can be found in X whether X is a single value, an indexed array, or an associative array
| |
− | function check_Y_in_X(obj, to_check){
| |
− | if (obj === to_check) {
| |
− | console.log( "entity is confirmed");
| |
− | return true
| |
− | };
| |
− | for (var i = 0; i < obj.length; i++ ){
| |
− | if (obj[i] === to_check) {
| |
− | console.log( "entity is confirmed within index " + i );
| |
− | return true
| |
− | };
| |
| } | | } |
− | Object.keys(obj).forEach( function(item) {
| + | }); |
− | if (obj[item] === to_check) {
| |
− | console.log( "entity is confirmed within associative element" + item )
| |
− | return true
| |
− | };
| |
− | });
| |
− | return false;
| |
| } | | } |
| | | |
− | this.main = interjson( get_Y_from_X( universe, location )); | + | //||||||||||||[ If we have a single instruction, let's try following that ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| |
| + | //Unused, this part could be improved |
| + | else { |
| | | |
− | this.checkentity = function ( rel_id_list, inner_location, property ) { | + | if (data_function(temp_obj, read) !== temp_obj) { |
− | var return_obj = {}; | + | |
− | Object.keys(rel_id_list).forEach( function(item){ | + | temp_obj = data_function(temp_obj, read); |
− | if ( check( main, rel_id_list[item][0] ) != undefined ) {
| + | |
− | var primary_part = get_Y_from_X( main, rel_id_list[item][0] );
| + | } else { |
− | if ( check_Y_in_X ( primary_part, inner_location + '.' + property ) ) {
| + | |
− | return_obj[item] = rel_id_list[item];
| + | success_o_meter = false; |
− | }
| + | |
− | }
| + | } |
− | });
| + | } |
− | return return_obj;
| + | |
| + | // If we haven't got a not found signal along the way, let's try returning the object |
| + | |
| + | if (success_o_meter === true) { |
| + | return temp_obj; |
| + | } else { |
| + | return undefined; |
| + | } |
| + | } |
| + | |
| + | //|||||||||||||||||||||||||||||||||||||||||||||||||||||[ S T E P B L O C K ]|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| |
| + | |
| + | // Function that takes 1 step. Proceed (along a path) uses this for each step. |
| + | |
| + | function data_function(temp_obj, moving) { |
| + | |
| + | // we will return an array |
| + | var future_temp_obj = []; |
| + | |
| + | // Check if we are on an array level, |
| + | if (Array.isArray(temp_obj)) { |
| + | debuglog("data is on an array level"); |
| + | Object.keys(temp_obj).forEach(function(ect) { |
| + | |
| + | // if so, try proceeding in all directions. |
| + | debuglog("Within partition: " + ect); |
| + | if (checkdive(temp_obj[ect], moving) !== undefined) { |
| + | future_temp_obj.push(checkdive(temp_obj[ect], moving)); |
| + | } |
| + | // Put an element into the return array for each direction we could move into |
| + | |
| + | }); |
| + | |
| + | temp_obj = future_temp_obj; |
| + | |
| + | } else { |
| + | |
| + | // if we are not on an array level, proceed with the path |
| + | |
| + | debuglog("data is on an objective level"); |
| + | |
| + | if (checkdive(temp_obj, moving) !== temp_obj) { |
| + | future_temp_obj = checkdive(temp_obj, moving); |
| + | } |
| + | |
| + | if (future_temp_obj !== undefined) { |
| + | temp_obj = future_temp_obj; |
| + | } else { |
| + | debuglog('nothing to see here') |
| + | } |
| + | } |
| + | |
| + | // NOTE this function works now but shows syntactic variance between the else branches |
| + | // Rigorous testing recommended |
| + | |
| + | return temp_obj; |
| + | } |
| + | |
| + | //|||||||||||||||||||||||||||||||||||||||||||||||||||||[ E N D O F S T E P B L O C K ]||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| |
| + | |
| + | // This function substitutes a bunch of try catches and also tries to dive into 'array' in different ways |
| + | |
| + | function checkdive(array, read) { |
| + | |
| + | // simple case, array is an object containing property 'read' |
| + | |
| + | if (check(array, read) !== undefined) { |
| + | return dive(array, read); |
| + | } |
| + | |
| + | // array case, 'array' is an actual array, lets return an array of successful trials to dive into each direction |
| + | |
| + | if (Array.isArray(array)) { |
| + | var potential_return = []; |
| + | Object.keys(array).forEach(function(item) { |
| + | if (check(array[item], read) !== undefined) { |
| + | potential_return.push(dive(array[item], read)); |
| + | } |
| + | }); |
| + | return potential_return; |
| + | } |
| + | |
| + | // mystical case, 'what you have been seeking you had it all along... or at least you have it now' |
| + | // This is for when you already at a value level, and are looking for that value. |
| + | // Or when on an object level, and looking for that object |
| + | // or when on an array level, and looking for that array :O |
| + | |
| + | if (array === read) { |
| + | return read; |
| + | } |
| + | |
| + | /* If we did this, it would probably open up a wormhole or a segfault, or that strange error message browsers give when they are maxed out |
| + | |
| + | if (Object.keys( array ).length > 0 ){ |
| + | Object.keys( array ).forEach( function ( piece ) { |
| + | if ( array[ piece ] === read ) { return read }; |
| + | }); |
| + | } |
| + | */ |
| + | } |
| + | |
| + | // Try parsing json. If not a json, go void. |
| + | this.rxjson = function(rx) { |
| + | return interjson(rx); |
| + | } |
| + | |
| + | function interjson(obj) { |
| + | try { |
| + | return JSON.parse(obj) |
| + | } catch (e) { |
| + | // if not JSON, do silly things |
| + | debuglog('not a json ¯\_(ツ)_/¯'); |
| + | }; |
| + | } |
| + | |
| + | // Heavyweight solution to suppress error messages. |
| + | |
| + | function debuglog(l0g) { |
| + | if (Debug_switch) { |
| + | console.log(l0g); |
| } | | } |
| + | } |
| } | | } |