dt-toolbox 5.0.0 → 6.0.0

package/src/mainLib.js

@@ -0,0 +1,105 @@
+'use strict'
+
+
+
+import walk from '@peter.naydenov/walk'
+
+import flatObject from './flatObject/index.js'             // Flat data api.
+import flatData from './flatData/index.js'            // Query data api. Used in model functions 
+import convert  from './convertors/index.js'          // Convertors
+
+
+
+const INIT_DATA_TYPES = [
+                  'std', 'standard'
+                , 'tuple', 'tuples'
+                , 'breadcrumb', 'breadcrumbs'
+                , 'file', 'files'
+                , 'midFlat'
+                , 'flat'
+            ]
+    ;
+
+
+
+const mainLib = {
+
+    dependencies () {
+                    return {
+                              walk
+                            , flatData
+                            , flatObject
+                            , convert
+                            , INIT_DATA_TYPES
+                            , main : () => ({ load : mainLib.load })
+                        }
+            } // dependencies func.
+
+
+
+    , init ( inData, options={} ) {
+                    let 
+                          defaultOptions = { model : 'std' }
+                        , { model } = Object.assign ( {}, defaultOptions, options )
+                        , dependencies = mainLib.dependencies
+                        ;
+                    if ( !INIT_DATA_TYPES.includes(model) ) {
+                            console.error ( `Can't understand your data-model: ${model}. Please, find what is possible on https://github.com/PeterNaydenov/dt-toolbox` )
+                            return null
+                        }
+                    const 
+                          d  = convert.from(model).toFlat ( dependencies, inData )
+                        , flat =  flatObject ( dependencies, d )
+                        ;
+                    return flat
+            } // init func.
+
+
+
+    , load ( inData ) {
+                const index = {};
+                inData.forEach ( line => {
+                                        const [ , ,breadcrumbs ] = line;
+                                        index[breadcrumbs] = line
+                                })
+                const copy = walk ({data: inData });
+                return flatObject ( mainLib.dependencies, [copy, index, inData ] )
+            } // load func.
+
+
+
+    , flating ( inData, options={} ) {
+                let 
+                       defaultOptions = { model : 'std' }
+                    ,  { model } = Object.assign ( {}, defaultOptions, options )
+                    ;
+                    if ( !INIT_DATA_TYPES.includes(model) )   return null
+                    let [,,dt] = convert.from ('std').toFlat ( mainLib.dependencies, inData );
+                    return dt
+            } // flating func.
+
+
+
+    , converting ( inData, options={} ) {
+                let 
+                       defaultOptions = { model : 'std', as: 'std' }
+                    ,  { model, as } = Object.assign ( {}, defaultOptions, options )
+                    ;
+                    if ( !INIT_DATA_TYPES.includes(model) )   return null
+                    if ( !INIT_DATA_TYPES.includes(as)    )   return null
+                    let [,,dt] = convert.from ('std').toFlat ( mainLib.dependencies, inData );
+
+                    return convert.to ( as, mainLib.dependencies, dt )
+            } // flating func.
+
+
+            
+    , getWalk : () => walk
+
+} // mainLib
+
+
+
+export default mainLib
+
+

package/src/compareMethod/change.js

@@ -1,21 +0,0 @@
-function change ( mainData, checkData ) {
- // *** Compare values. Reduce to key/value pairs with different values.
-    let
-          result     = {}
-        , mainKeys   = Object.keys ( mainData )
-        ;
-    mainKeys.forEach ( k => {
-                let
-                      HAS_KEY = ( checkData.hasOwnProperty(k)   )
-                    , EQUAL_VALUES = HAS_KEY && ( mainData[k] === checkData[k]   )
-                    ;
-                if ( !EQUAL_VALUES )   result[k] = checkData[k]
-            })
-    return result
-} // change func.
-
-
-
-export default change
-
-

package/src/compareMethod/different.js

@@ -1,18 +0,0 @@
-function different ( mainData, checkData ) {
- // *** Key compare. Returns key/value pairs where key does not exist.
-    let
-          result   = {}
-        , checkKeys = Object.keys ( checkData )
-        ;
-    checkKeys.forEach ( k => {
-                    let HAS_KEY = mainData.hasOwnProperty(k);
-                    if ( !HAS_KEY )   result[k] = checkData[k]
-            })
-    return result
-} // different func.
-
-
-
-export default different
-
-

package/src/compareMethod/identical.js

@@ -1,21 +0,0 @@
-function identical ( mainData, checkData ) {
-  // *** Compare values. Reduce data to identical key/value pairs.
-    let
-          result     = {}
-        , mainKeys   = Object.keys ( mainData )
-        ;
-    mainKeys.forEach ( k => {
-            let
-                  HAS_KEY = ( checkData.hasOwnProperty(k) )
-                , EQUAL_VALUES = HAS_KEY && ( mainData[k] === checkData[k] )
-                ;
-                if ( EQUAL_VALUES )   result[k] = mainData[k]
-        })
-    return result
-} // identical func.
-
-
-
-export default identical
-
-

package/src/compareMethod/index.js

@@ -1,13 +0,0 @@
-import identical from './identical.js'
-import change    from './change.js'
-import same      from './same.js'
-import different from './different.js'
-import missing   from './missing.js'
-
-export default {
-              identical
-            , change
-            , same
-            , different
-            , missing
-        }

package/src/compareMethod/missing.js

@@ -1,18 +0,0 @@
-function missing ( mainData, checkData ) {
- // *** Key compare. Returns key/value pairs that are missing
-    let
-          result   = {}
-        , mainKeys = Object.keys ( mainData )
-        ;
-    mainKeys.forEach ( k => {
-                    let HAS_KEY = checkData.hasOwnProperty(k);
-                    if ( !HAS_KEY )   result[k] = mainData[k]
-            })
-    return result
-} // missing func.
-
-
-
-export default missing
-
-

package/src/compareMethod/same.js

@@ -1,18 +0,0 @@
-function same ( mainData, checkData ) {
- // *** Compare keys. Returns key/value pairs where keys are the same.
-    let
-          result   = {}
-        , mainKeys = Object.keys ( mainData )
-        ;
-    mainKeys.forEach ( k => {
-                    let HAS_KEY = checkData.hasOwnProperty(k);
-                    if ( HAS_KEY )   result[k] = checkData[k]
-            })
-    return result
-} // same func.
-
-
-
-export default same
-
-

package/src/convertors/breadcrumbs.js

@@ -1,148 +0,0 @@
-'use strict'
-
-
-
-/**
- *  File data structure example:
- *      [
-        'rootFolder/profile/name/Peter',
-        'rootFolder/profile/age/42',
-        'rootFolder/profile/gender/male',
-        'rootFolder/logs/log.txt',
-        'rootFolder/friends/Dimitar',
-        'rootFolder/friends/Stefan',
-        'rootFolder/friends/Ivan',
-        'rootFolder/friends/Grigor'
-        ]
- * 
- *   Looks like breadcrumbs but last element is the value. Key and value together.
- * 
- */
-
-function toFlat ( dependencies, rawValue ) {
-          if ( Object.keys(rawValue).length === 0 ) {
-                    let 
-                          structure = [ [ 'object', 0 ]   ]
-                        , value = {}
-                        ;
-                    return [ structure, value ]
-              }
-          let
-                { help }   = dependencies
-              , structure  = []
-              , value      = {}
-              , keyList    = Object               // Provides keys in order: from larger to shorter 
-                                .keys ( rawValue )
-                                .map ( x => x.split('/')   )
-                                .sort ( (a,b) => b.length - a.length   )
-            ,  tProps   = {}   // { objectLocation<string> : childObjectNames<set> }
-            , structRaw = []   // objectLocation strings
-            , propDone  = []
-            ;
-
-          keyList.forEach ( keyArr => {   // Setup our temp structures: tProps and structRaw
-                    keyArr.forEach ( (k,i) => {
-                                    let parent = keyArr.slice( 0, i ).join ( '/' );
-                                    if ( !parent         )   return
-                                    if ( !tProps[parent] ) { 
-                                            tProps[parent] = new Set()
-                                            structRaw.push ( parent )
-                                        }
-                                    tProps[parent].add ( k )
-                            })
-                })
-           structRaw.forEach ( (el,i) => {   // Build the structure rows
-                                let elChildren = false;
-                                if ( !structure[i]    )   structure[i] = [ 'object', i ]
-                                if ( propDone[i]      )   el = propDone[i]
-                                elChildren = Array.from ( tProps[el] )
-                                if ( el === 'root' ) {
-                                          const mainType = help.hasNumbers ( elChildren ) ? 'array' : 'object';
-                                          structure[i][0] = mainType
-                                    }
-                                elChildren.forEach ( name => {   // Setup connections between object
-                                                        let test = tProps[`${el}/${name}`];
-                                                        if ( !test )   return
-                                                        let 
-                                                              childProps = Array.from (test)
-                                                            , type = help.hasNumbers ( childProps ) ? 'array' : 'object'
-                                                            , lastIndex = structure.length
-                                                            ;
-                                                        propDone[lastIndex] = `${el}/${name}`
-                                                        structure.push ([type, lastIndex])
-                                                        structure[i].push ( [lastIndex, name])
-                                                })
-                        })
-
-        keyList.forEach ( k => {   // Create flat keys and write values 
-                        let 
-                              name      = k.pop()
-                            , keySearch = k.join ( '/' )
-                            , objNumber = null
-                            , theKey    = ''
-                            ;
-                        objNumber = propDone.indexOf ( keySearch )
-
-                        if ( objNumber < 0 )  objNumber = structRaw.indexOf(keySearch)
-                        theKey = `root/${objNumber}/${name}`
-                        value[theKey] = rawValue[`${keySearch}/${name}`]
-                })
-        return [ structure, value ]
-  } // toFlat func.
-
-
-
-
-
-
-
-
-
-
-function toType ( dependencies, [ structure, value ]) {
-            let 
-                keys = Object.keys ( value )
-              , breadcrumbObject = {}
-              , flatNames = {}
-              ;
-            structure.forEach ( ([type, id, ...items]) => {   // Create data-structures
-                                    items.forEach ( item => { 
-                                                let 
-                                                      [num,name] = item
-                                                    , breadcrumbName = name
-                                                    , checkID = id
-                                                    ;
-                                                for (let i=id; i >= 0; i-- ) {
-                                                        let [type,x,...items] = structure[i];
-                                                        items.forEach ( ([n,name]) => {
-                                                                      if ( n === checkID ) {
-                                                                                  breadcrumbName = `${name}/${breadcrumbName}`
-                                                                                  checkID = x
-                                                                          }
-                                                                })
-                                                    }
-                                                flatNames[num] = breadcrumbName
-                                        })
-                            })
-            keys.forEach ( key => {  // Conect data-structures
-                                let  
-                                      keyArray = key.split('/')
-                                    , breadcrumbKey = keyArray[1]
-                                    , breadcrumb = flatNames [ breadcrumbKey ]
-                                    ;
-                                if ( breadcrumbKey == '0' ) {
-                                        keyArray = keyArray.filter ( (segment,i) => i!=1   )  
-                                    }
-                                else {
-                                        keyArray[1] = breadcrumb
-                                    }
-                                breadcrumbObject [ keyArray.join('/') ] = value [key]    
-                            })
-            return breadcrumbObject
-    } // toType func.
-
-
-
-export default { toFlat, toType }
-
-

package/src/help/extractSelection.js

@@ -1,12 +0,0 @@
-function extractSelection ( data ) {
-    let selectionKeys = data._select.value;
-    return selectionKeys.reduce ( (res,key) => {
-                            res[key] = data.value[key]
-                            return res     
-                },{})
-} // extractSelection func.
-
-
-export default extractSelection
-
-

package/src/help/filterObject.js

@@ -1,25 +0,0 @@
-function filterObject ( id, keySelection, value={} ) {
-    // *** Filter object with by id
-            let 
-                  local = {}            // Filtered object
-                , localSelection = []   // List of filtered object props
-                ;
-            keySelection.forEach ( key => {
-                        let 
-                              splited = key.split ( '/' )
-                            , num     = splited [ 1 ]
-                            , prop    = splited.pop()
-                            ;
-                        if ( num == id ) {  
-                                    local[prop] = value[key]
-                                    localSelection.push ( key )
-                            }
-                })
-            return [ local, localSelection ]
-} // filterObject
-
-
-
-export default filterObject
-    
-

package/src/help/hasNumbers.js

@@ -1,14 +0,0 @@
-function hasNumbers ( arr ) {
-    return !arr.every ( el => {
-                    const r = Number(el);
-                    if ( r === 0 )   return false
-                    if ( r       )   return false
-                    return true
-                })
-} // hasNumbers func.
-
-
-
-export default hasNumbers
-
-

package/src/help/index.js

@@ -1,35 +0,0 @@
-'use strict'
-
-import isItPrimitive       from './isItPrimitive.js'
-import hasNumbers          from './hasNumbers.js'
-import sanitizeFlatKeys    from './sanitizeFlatKeys.js'
-import objectsByLevel      from './objectsByLevel.js'
-import filterObject         from './filterObject.js'
-import toBreadcrumbKeys    from './toBreadcrumbsKeys.js'
-import updateSelection     from './updateSelection.js'
-import zipObject           from './zipObject.js'
-import extractSelection    from './extractSelection.js'
-import reduceTuples        from './reduceTuples.js'
-import tuplesToBradcrumbs from './tuplesToBreadcrumbs.js'
-
-const findType =  d =>  ( d instanceof Array ) ? 'array' : 'object'
-
-
-
-export default { 
-                      findType            // Is it array or object. Returns strings: 'array' | 'object'
-                    , hasNumbers         // Check if array contain number members. Returns boolean
-                    , isItPrimitive      // Returns boolean
-                    , sanitizeFlatKeys   // Sanitize 'file' format keys
-                    , objectsByLevel     // Object IDs organized by levels
-                    , filterObject        // Find object and object props in a value
-                    , toBreadcrumbKeys   // Breadcrumbs keys
-                    , updateSelection    // Updates selection list. Checks if element is already selected
-                    , zipObject          // Conect two arrays in a single object
-                    , extractSelection   // Creates 'value' object with selected keys only
-                    , reduceTuples
-                    , tuplesToBradcrumbs
-                }
-
-
-                

package/src/help/isItPrimitive.js

@@ -1,10 +0,0 @@
-function isItPrimitive (d) {
-    if     ( typeof d == 'function' )     return true // it's not really primitive but we want function to be treated as primitive
-    return ( typeof d != 'object'   )  ?  true : false
-} // isItPrimitive func.
-
-
-
-export default isItPrimitive
-
-

package/src/help/objectsByLevel.js

@@ -1,16 +0,0 @@
-function objectsByLevel ( structure ) {
-    return structure.reduce ( (res,row) => {
-                        let level = [];
-                        row.forEach ( (item,i) => {
-                                    if ( i > 1 )   level.push ( item[0] )
-                                })
-                        if ( level.length > 0  )   res.push ( level )
-                        return res
-                },[[0]] );
-} // objectsByLevel func.
-
-
-
-export default objectsByLevel
-
-

package/src/help/reduceTuples.js

@@ -1,29 +0,0 @@
-'use strict'
-
-function reduceTuples ( dependencies, breadcrumbData ) {
-  // *** Converts breadcrumbs to array of tuples
-    const 
-          { help, walk } = dependencies
-        , result = []
-        ;
-    walk ({ 
-              data : breadcrumbData, 
-              keyCallback : ({ value:v, key:k }) => {
-                        let 
-                              arr = k.substr(5).split('/')
-                            , ln = arr.length
-                            , lastEl = arr[ln-1]
-                            ;
-                        if ( help.hasNumbers([lastEl]) )   arr.pop ()    
-                        result.push ( [ arr.join('/'), v])
-                        return v
-                    }
-        })
-    return result
-} // reduceTuples func.
-
-
-
-export default reduceTuples
-
-

package/src/help/sanitizeFlatKeys.js

@@ -1,30 +0,0 @@
-function sanitizeFlatKeys ( list ) {   // fn(string[]) -> string[]
-    // *** Sanitize 'file' and 'breadcrumb' data-type keys. Adds 'root/' and indexes where it is needed
-            let keys = list.map ( x => {  // Keys should start with 'root/'
-                            let key = x.split ( '/' )
-                            if ( key[0] != 'root' )   return [ 'root', ...key].join('/')
-                            else                      return key.join ( '/' )
-                    })
-            let 
-                  usedKeys = []
-                , duplicatedKeys = new Set()
-                ;
-            keys.forEach ( k => {
-                            if ( usedKeys.includes(k) )    duplicatedKeys.add(k)
-                            else                           usedKeys.push ( k )
-                    })
-            for (const marker of duplicatedKeys ) {
-                            let counter = 0;
-                            keys = keys.map ( k => {
-                                                if ( k == marker )   return `${k}/${counter++}`
-                                                else                 return k
-                                        })
-                    }
-            return keys
-} // sanitizeFlatKeys func.
-
-
-
-export default sanitizeFlatKeys
-
-

package/src/help/toBreadcrumbsKeys.js

@@ -1,28 +0,0 @@
-function toBreadcrumbKeys ( keys, structure ) {   // (flatKey[], structure ) => breadcrumbKeys[]
-    // *** Map convertion of flat keys to breadcrumb keys.
-           let containerNames = [ 'root' ];
-           structure.forEach ( level => { 
-           level.forEach ( (obj,i) => {   // Find container names
-                           let 
-                                 objectID = level[1]
-                               , container = containerNames[objectID]
-                               ;
-                           if ( i > 1 )   containerNames.push ( `${container}/${obj[1]}`)
-                   })
-                   })
-           return keys.map ( k => {
-                                   let 
-                                         splited     = k.split ( '/' )
-                                       , containerID = splited [ 1 ]
-                                       , prop        = splited [ 2 ]
-                                       , long        = containerNames [ containerID ]
-                                       ;
-                                   return `${long}/${prop}`
-                           })
-} // toBreadcrumbKeys func.
-
-
-
-export default toBreadcrumbKeys
-
-

package/src/help/tuplesToBreadcrumbs.js

@@ -1,25 +0,0 @@
-'use strict'
-
-function tuplesToBreadcrumbs ( dependencies, data ) {
-    const { walk } = dependencies;
-    let result = {};
-
-    function objectCalls ({ value:obj, breadcrumbs }) {
-                    if ( breadcrumbs === 'root' )   return obj;   // ignore root object
-                    let [ key, val ] = obj;
-                    result[key] = val
-                    return obj
-       } // objectCalls func.
-
-    walk ({ 
-            data, 
-            objectCallback : objectCalls 
-        })
-    return result
-} // tuplesToBradcrumbs func.
-
-
-
-export default tuplesToBreadcrumbs
-
-

package/src/help/updateSelection.js

@@ -1,12 +0,0 @@
-function updateSelection ( [...selection], updates ) {
-    updates.forEach ( key => {
-                if ( !selection.includes(key) )   selection.push ( key )
-            })
-    return selection
-} // updateSelection
-
-
-
-export default updateSelection
-
-

package/src/help/zipObject.js

@@ -1,24 +0,0 @@
-function zipObject ( keys, values ) {   // (string[], string[] ) -> object
-    // *** Conect two arrays in a single object
-        return keys.reduce ( (res,k,i)  => {
-                                let 
-                                      income = values[i]
-                                    , val
-                                    ;
-                                switch ( typeof income ) {
-                                            case 'string' :
-                                                    val = Number(income) || income
-                                                    break
-                                            default:
-                                                    val = income
-                                    }
-                                res[k] = val
-                                return res
-                    }, {} )
-} // zipObject func.
-
-
-
-export default zipObject
-
-