✨ (tasks) update default tasks to latest itee standards

Author: Itee

.tasks/.tests/benchmarks/run-benchmarks.task.mjs

@@ -1,16 +1,7 @@
-import { series }                      from 'gulp'
-import { runBenchmarksForBackendTask }  from './run-benchmarks-for-backend.task.mjs'
-import { runBenchmarksForFrontendTask } from './run-benchmarks-for-frontend.task.mjs'
+import { serializeTasksFrom }                 from '../../_utils.mjs'
+import { runBenchmarksTaskFiles as taskFiles } from '../../configs/run-benchmarks.conf.mjs'
 
-/**
- * @method npm run build-test
- * @global
- * @description Will run benchmarks in back and front environments
- */
-const runBenchmarksTestsTask       = series(
-    runBenchmarksForBackendTask,
-    runBenchmarksForFrontendTask,
-)
+const runBenchmarksTestsTask       = await serializeTasksFrom( taskFiles )
 runBenchmarksTestsTask.displayName = 'run-benchmarks'
 runBenchmarksTestsTask.description = 'Will run benchmarks in back and front environments.'
 runBenchmarksTestsTask.flags       = null

.tasks/.tests/unit-tests/run-unit-tests.task.mjs

@@ -1,16 +1,7 @@
-import { series }                      from 'gulp'
-import { runUnitTestsForBackendTask }  from './run-unit-tests-for-backend.task.mjs'
-import { runUnitTestsForFrontendTask } from './run-unit-tests-for-frontend.task.mjs'
+import { serializeTasksFrom }                 from '../../_utils.mjs'
+import { runUnitTestsTaskFiles as taskFiles } from '../../configs/run-unit-tests.conf.mjs'
 
-/**
- * @method npm run build-test
- * @global
- * @description Will run unit tests in back and front environments
- */
-const runUnitTestsTask       = series(
-    runUnitTestsForBackendTask,
-    runUnitTestsForFrontendTask,
-)
+const runUnitTestsTask       = await serializeTasksFrom( taskFiles )
 runUnitTestsTask.displayName = 'run-unit-tests'
 runUnitTestsTask.description = 'Will run unit tests in back and front environments.'
 runUnitTestsTask.flags       = null

.tasks/_refresh.mjs

@@ -1,50 +1,53 @@
-import colors                   from 'ansi-colors'
-import log                      from 'fancy-log'
-import { writeFileSync }        from 'fs'
-import { glob }                 from 'glob'
+import colors            from 'ansi-colors'
+import log               from 'fancy-log'
+import { writeFileSync } from 'fs'
 import {
+    basename,
     join,
-    normalize,
     relative
-}                               from 'path'
-import { packageRootDirectory } from './_utils.mjs'
+}                        from 'path'
+import {
+    getFilesFrom,
+    packageRootDirectory
+}                        from './_utils.mjs'
+import { tasksToIgnore } from './configs/refresh.conf.mjs'
 
 const {
-          blue,
           green,
-          magenta,
-          cyan
+          yellow,
       } = colors
 
+// Get and filter tasks to expose
+const taskFiles = getFilesFrom(
+    join( packageRootDirectory, '.tasks/{.*.task.mjs,*.task.mjs,.**/*.task.mjs,.**/**/*.task.mjs}' ),
+    filePath => {
+        const relativeFilepath = relative( packageRootDirectory, filePath )
+        const filename         = basename( filePath )
+        const included         = !tasksToIgnore.includes( filename )
+
+        included
+        ? log( 'Include', green( relativeFilepath ) )
+        : log( 'Exclude', yellow( relativeFilepath ) )
+
+        return included
+    }
+)
+
+// Prepare gulpfile content with header
 let gulpfileContent = '' +
     '/**\n' +
     ' * This file is auto-generated by internal gulp command.\n' +
     ' * If you want to customize the available gulp tasks, create your own in .tasks folder\n' +
     ' * and run "gulp refresh"\n' +
     ' */\n\n'
 
-const taskFiles = glob.sync( join( packageRootDirectory, '.tasks/{.*.task.mjs,*.task.mjs,.**/*.task.mjs,.**/**/*.task.mjs}' ) )
-                      .map( filePath => normalize( filePath ) )
-
+// Generate tasks exports and append to gulpfile content
 for ( const taskFile of taskFiles ) {
-    const module = await import(taskFile)
-
-    const exportStrings = []
-    for ( const moduleKey in module ) {
-        const task         = module[ moduleKey ]
-        const name         = task.name ?? null
-        const displayName  = task.displayName ?? null
-        const fullName     = ( moduleKey !== name ) ? `${ blue( moduleKey ) }( ${ magenta( name ) } )` : `${ blue( name ) }`
-        const exportAs     = ( displayName ) ? ` as ${ cyan( displayName ) }` : ''
-        const exportString = fullName + exportAs
-        exportStrings.push( exportString )
-    }
-
     const relativeTaskFile = relative( packageRootDirectory, taskFile )
-    log( 'Found', green( relativeTaskFile ), 'with', exportStrings.join( ', ' ) )
     gulpfileContent += `export * from './${ relativeTaskFile }'\n`
 }
 
+// Create gulpfile file
 const gulpfilePath = join( packageRootDirectory, 'gulpfile.mjs' )
-log( 'Refreshing', green( gulpfilePath ) )
+log( 'Refresh', green( gulpfilePath ) )
 writeFileSync( gulpfilePath, gulpfileContent )

.tasks/_utils.mjs

@@ -7,16 +7,26 @@ import {
     readFileSync,
     writeFileSync
 }                        from 'fs'
+import { glob }          from 'glob'
+import {
+    parallel,
+    series
+}                        from 'gulp'
 import {
     dirname,
-    join
+    join,
+    normalize,
+    relative
 }                        from 'path'
 import { fileURLToPath } from 'url'
 
 const {
           red,
           green,
-          yellow
+          yellow,
+          blue,
+          magenta,
+          cyan
       } = colors
 
 ///
@@ -154,6 +164,67 @@ function createFile( filePath, fileContent ) {
 
 }
 
+function getFilesFrom( globPattern, filter = ( any ) => true ) {
+
+    return glob.sync( globPattern )
+               .map( filePath => normalize( filePath ) )
+               .filter( filter )
+
+}
+
+///
+
+async function getTasksFrom( taskFiles = [] ) {
+
+    const tasks = []
+    for ( const taskFile of taskFiles ) {
+        const relativeTaskFile = relative( packageRootDirectory, taskFile )
+
+        try {
+
+            const module = await import(taskFile)
+
+            const exportStrings = []
+            for ( const moduleKey in module ) {
+                const task = module[ moduleKey ]
+                tasks.push( task )
+
+                const name         = task.name ?? null
+                const displayName  = task.displayName ?? null
+                const fullName     = ( moduleKey !== name ) ? `${ blue( moduleKey ) }( ${ magenta( name ) } )` : `${ blue( name ) }`
+                const exportAs     = ( displayName ) ? ` as ${ cyan( displayName ) }` : ''
+                const exportString = fullName + exportAs
+                exportStrings.push( exportString )
+            }
+
+            log( 'Process', green( relativeTaskFile ), `with task${ ( exportStrings.length > 1 ) ? 's' : '' }`, exportStrings.join( ', ' ) )
+
+        } catch ( error ) {
+
+            log( 'Error  ', red( relativeTaskFile ), error.message )
+
+        }
+
+    }
+
+    return tasks
+
+}
+
+async function serializeTasksFrom( taskFiles = [] ) {
+
+    const tasks = await getTasksFrom( taskFiles )
+    return series( ...tasks )
+
+}
+
+async function parallelizeTasksFrom( taskFiles = [] ) {
+
+    const tasks = await getTasksFrom( taskFiles )
+    return parallel( ...tasks )
+
+}
+
 ///
 
 function IndenterFactory( indentationChar = '\t', indentationLevel = 5 ) {
@@ -224,6 +295,11 @@ export {
 
     createDirectoryIfNotExist,
     createFile,
+    getFilesFrom,
+
+    getTasksFrom,
+    serializeTasksFrom,
+    parallelizeTasksFrom,
 
     IndenterFactory as Indenter
 }

.tasks/configs/refresh.conf.mjs

@@ -0,0 +1,3 @@
+const tasksToIgnore = []
+
+export { tasksToIgnore }

.tasks/configs/run-benchmarks.conf.mjs

@@ -0,0 +1,9 @@
+import { join }                 from 'path'
+import { packageRootDirectory } from '../_utils.mjs'
+
+const runBenchmarksTaskFiles = [
+    join( packageRootDirectory, '.tasks/.tests/benchmarks/run-benchmarks-for-backend.task.mjs' ),
+    join( packageRootDirectory, '.tasks/.tests/benchmarks/run-benchmarks-for-frontend.task.mjs' )
+]
+
+export { runBenchmarksTaskFiles }

.tasks/configs/run-unit-tests.conf.mjs

@@ -0,0 +1,9 @@
+import { join }                 from 'path'
+import { packageRootDirectory } from '../_utils.mjs'
+
+const runUnitTestsTaskFiles = [
+    join( packageRootDirectory, '.tasks/.tests/unit-tests/run-unit-tests-for-backend.task.mjs' ),
+    join( packageRootDirectory, '.tasks/.tests/unit-tests/run-unit-tests-for-frontend.task.mjs' )
+]
+
+export { runUnitTestsTaskFiles }