@itee/tasks 1.0.12

package/sources/tests/bundlings/check-bundling-from-esm-files-direct.task.mjs

@@ -0,0 +1,94 @@
+import colors     from 'ansi-colors'
+import log        from 'fancy-log'
+import {
+    existsSync,
+    rmSync
+}                 from 'fs'
+import { glob }   from 'glob'
+import {
+    basename,
+    dirname,
+    extname,
+    join,
+    normalize
+}                 from 'path'
+import { rollup } from 'rollup'
+import {
+    getTaskConfigurationFor,
+    logLoadingTask,
+    packageSourcesDirectory,
+    packageTestsBundlesDirectory
+}                 from '../../_utils.mjs'
+
+logLoadingTask( import.meta.filename )
+
+const {
+          red,
+          green,
+          magenta,
+      } = colors
+
+/**
+ * @description In view to detect bundling side effects this task will
+ * create intermediary file for each individual export from this package
+ * and then create rollup config for each of them and bundle
+ * Todo: Check for different target env like next task below this one
+ */
+const checkBundlingFromEsmFilesDirectTask       = async ( done ) => {
+
+    const outputDir = join( packageTestsBundlesDirectory, 'from_files_direct' )
+    if ( existsSync( outputDir ) ) {
+        log( 'Clean up', magenta( outputDir ) )
+        rmSync( outputDir, { recursive: true } )
+    }
+
+    const configuration = await getTaskConfigurationFor( import.meta.filename )
+
+    // Get source files to process
+    const pattern     = join( packageSourcesDirectory, '**' )
+    const sourceFiles = glob.sync( pattern )
+                            .map( filePath => normalize( filePath ) )
+                            .filter( filePath => {
+                                const fileName         = basename( filePath )
+                                const isJsFile         = fileName.endsWith( '.js' )
+                                const isNotPrivateFile = !fileName.startsWith( '_' )
+                                const isNotIgnoredFile = !configuration.ignoredFiles.includes( fileName )
+                                return isJsFile && isNotPrivateFile && isNotIgnoredFile
+                            } )
+
+    for ( let sourceFile of sourceFiles ) {
+
+        const specificFilePath = sourceFile.replace( packageSourcesDirectory, '' )
+        const specificDir      = dirname( specificFilePath )
+        const fileName         = basename( sourceFile, extname( sourceFile ) )
+
+        const bundleFileName = `${ fileName }.bundle.js`
+        const bundleFilePath = join( outputDir, specificDir, bundleFileName )
+
+        configuration.buildOptions.input       = sourceFile
+        configuration.buildOptions.output.file = bundleFilePath
+
+        try {
+
+            log( 'Bundling', green( configuration.buildOptions.output.file ) )
+
+            const bundle = await rollup( configuration.buildOptions )
+            await bundle.generate( configuration.buildOptions.output )
+            await bundle.write( configuration.buildOptions.output )
+
+        } catch ( error ) {
+
+            log( red( error.message ) )
+
+        }
+
+    }
+
+    done()
+
+}
+checkBundlingFromEsmFilesDirectTask.displayName = basename( import.meta.filename, '.task.mjs' )
+checkBundlingFromEsmFilesDirectTask.description = 'In view to detect bundling side effects this task will create intermediary file for each individual export from this package and then create rollup config for each of them and bundle'
+checkBundlingFromEsmFilesDirectTask.flags       = null
+
+export { checkBundlingFromEsmFilesDirectTask }

package/sources/tests/bundlings/check-bundling-from-esm-files-import.task.mjs

@@ -0,0 +1,113 @@
+import colors     from 'ansi-colors'
+import log        from 'fancy-log'
+import {
+    existsSync,
+    mkdirSync,
+    rmSync,
+    writeFileSync
+}                 from 'fs'
+import { glob }   from 'glob'
+import {
+    basename,
+    dirname,
+    join,
+    normalize,
+    parse,
+    relative
+}                 from 'path'
+import { rollup } from 'rollup'
+import {
+    getTaskConfigurationFor,
+    logLoadingTask,
+    packageSourcesDirectory,
+    packageTestsBundlesDirectory
+}                 from '../../_utils.mjs'
+
+const {
+          red,
+          green,
+          magenta,
+      } = colors
+
+const checkBundlingFromEsmFilesImportTask       = async ( done ) => {
+
+    const outputDir      = join( packageTestsBundlesDirectory, 'from_files_import' )
+    const temporariesDir = join( outputDir, '.tmp' )
+
+    if ( existsSync( outputDir ) ) {
+        log( 'Clean up', magenta( outputDir ) )
+        rmSync( outputDir, { recursive: true } )
+    }
+
+    const configuration = await getTaskConfigurationFor( import.meta.filename )
+
+    // Get source files to process
+    const pattern     = join( packageSourcesDirectory, '**' )
+    const sourceFiles = glob.sync( pattern )
+                            .map( filePath => normalize( filePath ) )
+                            .filter( filePath => {
+                                const fileName         = basename( filePath )
+                                const isJsFile         = fileName.endsWith( '.js' )
+                                const isNotPrivateFile = !fileName.startsWith( '_' )
+                                const isNotIgnoredFile = !configuration.ignoredFiles.includes( fileName )
+                                return isJsFile && isNotPrivateFile && isNotIgnoredFile
+                            } )
+
+    for ( let sourceFile of sourceFiles ) {
+
+        const {
+                  dir:  sourceDir,
+                  base: sourceBase,
+                  name: sourceName
+              }                = parse( sourceFile )
+        const specificFilePath = sourceFile.replace( packageSourcesDirectory, '' )
+        const specificDir      = dirname( specificFilePath )
+
+        // Create temp import file per file in package
+        const temporaryFileName = `${ sourceName }.import.js`
+        const temporaryDir      = join( temporariesDir, specificDir )
+        const temporaryFile     = join( temporaryDir, temporaryFileName )
+        const importDir         = relative( temporaryDir, sourceDir )
+        const importFile        = join( importDir, sourceBase )
+        const temporaryFileData = `import '${ importFile.replace( /\\/g, '/' ) }'`
+
+        // Bundle tmp file and check content for side effects
+        const bundleFileName = `${ sourceName }.bundle.js`
+        const bundleFilePath = join( outputDir, specificDir, bundleFileName )
+
+        configuration.buildOptions.input       = temporaryFile
+        configuration.buildOptions.output.file = bundleFilePath
+
+        // create tmp file
+        try {
+
+            mkdirSync( temporaryDir, { recursive: true } )
+            writeFileSync( temporaryFile, temporaryFileData )
+
+            const bundle     = await rollup( configuration.buildOptions )
+            const { output } = await bundle.generate( configuration.buildOptions.output )
+
+            let code = output[ 0 ].code
+            if ( code.length > 1 ) {
+                log( red( `[${ specificFilePath }] contain side-effects !` ) )
+                await bundle.write( configuration.buildOptions.output )
+            } else {
+                log( green( `[${ specificFilePath }] is side-effect free.` ) )
+            }
+
+        } catch ( error ) {
+            log( red( error.message ) )
+        }
+
+    }
+
+    done()
+
+}
+checkBundlingFromEsmFilesImportTask.displayName = basename( import.meta.filename, '.task.mjs' )
+checkBundlingFromEsmFilesImportTask.description = 'In view to detect bundling side effects this task will create intermediary file for each individual export from this package and then create rollup config for each of them and bundle'
+checkBundlingFromEsmFilesImportTask.flags       = null
+
+logLoadingTask( import.meta.filename )
+
+export { checkBundlingFromEsmFilesImportTask }

package/sources/tests/bundlings/check-bundling.task.mjs

@@ -0,0 +1,24 @@
+import { series }                              from 'gulp'
+import { basename }                            from 'node:path'
+import { logLoadingTask }                      from '../../_utils.mjs'
+import { checkBundlingFromEsmBuildImportTask } from './check-bundling-from-esm-build-import.task.mjs'
+import { checkBundlingFromEsmFilesDirectTask } from './check-bundling-from-esm-files-direct.task.mjs'
+import { checkBundlingFromEsmFilesImportTask } from './check-bundling-from-esm-files-import.task.mjs'
+
+logLoadingTask( import.meta.filename )
+
+/**
+ * @description In view to detect bundling side effects this task will
+ * create intermediary file for each individual export from this package
+ * and then create rollup config for each of them and bundle
+ * Todo: Check for different targets env like next task below this one
+ */
+const checkBundlingTask       = series(
+    checkBundlingFromEsmFilesImportTask,
+    checkBundlingFromEsmBuildImportTask,
+    checkBundlingFromEsmFilesDirectTask
+)
+checkBundlingTask.displayName = basename( import.meta.filename, '.task.mjs' )
+checkBundlingTask.description = 'In view to detect bundling side effects this task will create intermediary file for each individual export and then try to bundle them.'
+
+export { checkBundlingTask }

package/sources/tests/run-tests.task.mjs

@@ -0,0 +1,22 @@
+import { series }                 from 'gulp'
+import { basename }               from 'node:path'
+import { logLoadingTask }         from '../_utils.mjs'
+import { runBenchmarksTestsTask } from './benchmarks/run-benchmarks.task.mjs'
+import { runUnitTestsTask }       from './units/run-unit-tests.task.mjs'
+
+logLoadingTask( import.meta.filename )
+
+/**
+ * @method npm run test
+ * @global
+ * @description Will run unit tests and benchmarks for backend (node) and frontend (web-test-runner) environments
+ */
+const runTestsTask       = series(
+    runBenchmarksTestsTask,
+    runUnitTestsTask,
+)
+runTestsTask.displayName = basename( import.meta.filename, '.task.mjs' )
+runTestsTask.description = 'Will run unit tests and benchmarks for backend (node) and frontend (web-test-runner) environments.'
+runTestsTask.flags       = null
+
+export { runTestsTask }