@nutin/cli 1.1.0 → 1.2.1

package/templates/features/testinNutin/testin-nutin/core/src/globals/spyon.js.hbs

@@ -0,0 +1,59 @@
+global.spyOn = (obj, methodName) => {
+  if (!obj || typeof methodName !== 'string') {
+    throw new Error('spyOn requires an object and a method name');
+  }
+
+  const originalFn = obj[methodName];
+
+  if (typeof originalFn !== 'function') {
+    throw new Error(`Cannot spy on ${methodName} – not a function`);
+  }
+
+  const calls = [];
+
+  function spyFunction(...args) {
+    calls.push(args.slice());
+    if (spyFunction._fake) {
+      return spyFunction._fake.apply(this, args);
+    }
+    if (spyFunction._hasReturn) {
+      return spyFunction._returnValue;
+    }
+    return originalFn.apply(this, args);
+  }
+
+  spyFunction._isSpy = true;
+  spyFunction._fake = null;
+  spyFunction._hasReturn = false;
+  spyFunction._returnValue = undefined;
+
+  obj[methodName] = spyFunction;
+
+  const handle = {
+    restore() {
+      if (obj[methodName] === spyFunction) {
+        obj[methodName] = originalFn;
+      }
+    },
+    get calls() {
+      return calls;
+    },
+    get callCount() {
+      return calls.length;
+    },
+    get lastCall() {
+      return calls.length ? calls[calls.length - 1] : undefined;
+    },
+    andCallFake(fn) {
+      spyFunction._fake = fn;
+      spyFunction._hasReturn = false;
+    },
+    andReturn(value) {
+      spyFunction._returnValue = value;
+      spyFunction._hasReturn = true;
+      spyFunction._fake = null;
+    }
+  };
+
+  return handle;
+};

package/templates/features/testinNutin/{test → testin-nutin}/core/src/utils/print.js.hbs

@@ -1,3 +1,5 @@
+import config from '#root/testin-nutin.config.js';
+
 export function printSummary(passed, failed, time) {
   const totalTime = time.toFixed(2);
   const total = passed + failed;
@@ -17,7 +19,7 @@ export function printResults(results) {
 
   sortedResults.forEach(result => {
     if (result.status === 'passed') {
-      console.log(`${chalk.green('✓')} ${chalk.cyan(`${result.suiteName}`)} - ${chalk.green(`${result.name}`)}`);
+      if (config.verbose ) console.log(`${chalk.green('✓')} ${chalk.cyan(`${result.suiteName}`)} - ${chalk.green(`${result.name}`)}`);
     } else {
       print.error(`✗ ${result.suiteName} - ${result.name}`);
       print.grayError(result.error);

package/templates/features/testinNutin/{test → testin-nutin}/core/src/utils/test-discovery.js.hbs

@@ -3,9 +3,13 @@ import path from 'path';
 import { fileURLToPath } from 'url';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const relativeToCwd = path.relative(process.cwd(), __dirname);
+const levelsUp = relativeToCwd.split(path.sep).length-1;
+const projectRoot = path.resolve(__dirname, ...Array(levelsUp).fill('..'));
 
 export function getTestFiles(dir) {
-  const fullDir = path.resolve(__dirname,'../', '../', '../', dir);
+  const fullDir = path.join(projectRoot, dir);
+  
   if (!fs.existsSync(fullDir)) return [];
   
   function findTestFilesRecursively(currentDir) {

package/templates/features/testinNutin/{test → testin-nutin}/core/src/utils/test-queue.js.hbs

@@ -34,9 +34,11 @@ export async function runQueuedTests() {
         previousSuiteAfterAll = test.afterAll;
       }
 
+      setupJsdom();
       if (test.beforeEach) await test.beforeEach();
       await test.testFn();
       if (test.afterEach) await test.afterEach();
+      teardownJsdom();
 
       passed++;
       results.push({ 
@@ -50,7 +52,7 @@ export async function runQueuedTests() {
         suiteName: test.suiteName, 
         status: 'failed', 
         name: test.testName, 
-        error: err.stack 
+        error: err.stack
       });
     }
   }

package/templates/features/testinNutin/{test → testin-nutin}/core/tests/assertions.test.js.hbs

@@ -8,11 +8,17 @@ describe('assertions', () => {
   it('should check if value matches expected', () => {
     const five = obj.add(2,3);
     const ten = obj.add(3,7);
+    const object = { five: five, ten: ten };
+    const arr = [ five, ten ];
 
     expect(five).toEqual(5);
-    expect(five).toBe('5');
+    expect(five).toBe(5);
     expect(ten).not.toEqual(11);
-    expect(ten).not.toBe('11');
+    expect(ten).not.toBe(11);
+    expect(object).toEqual({ five: five, ten: ten });
+    expect(object).not.toBe({ five: five, ten: ten });
+    expect(arr).toEqual([five, ten]);
+    expect(arr).not.toBe([five, ten]);
   });
   it('should check if function has been called', () => {
     const spy = spyOn(obj, 'add');
@@ -29,6 +35,12 @@ describe('assertions', () => {
     expect(null).toBeUndefined();
     expect(null).not.toBeDefined();
   });
+  it('should check for if an element is true / false', () => {
+    const isTrue = 1 == '1';
+    const isFalse = 1 === '1';
+    expect(isTrue).toBeTruthy();
+    expect(isFalse).toBeFalsy();
+  });
   it('should check if substring is contained within string', () => {
     const str1 = 'Creativity is allowing yourself to make mistakes.';
     const str2 = 'Art is knowing which ones to keep.';
@@ -40,7 +52,19 @@ describe('assertions', () => {
   });
   it('should check for instance', () => {
     const date = new Date();
+    const fn = () => {};
     expect(date).toBeInstanceOf(Date);
+    expect(fn).toBeInstanceOf(Function);
     expect(date).not.toBeInstanceOf(Function);
+    expect(fn).not.toBeInstanceOf(Date);
+  });
+  it('should check for error throw', () => {
+    const err = () => { throw new Error('message'); };
+    const notErr = () => {};
+    expect(err).toThrow();
+    expect(err).toThrow('message');
+    expect(err).not.toThrow('another message');
+    expect(notErr).not.toThrow();
+    expect(notErr).not.toThrow('messsage');
   });
 });

package/templates/features/testinNutin/testin-nutin/runner.js.hbs

@@ -0,0 +1,35 @@
+import { registerTestGlobals, getTestFiles, runQueuedTests, print } from './core/index.js';
+import config from '#root/testin-nutin.config.js';
+
+registerTestGlobals();
+
+let testFiles = config.origins.flatMap(
+  origin => getTestFiles(`../${origin}`)
+);
+
+const args = process.argv.slice(2);
+if (args.length) {
+  testFiles = testFiles.filter(file => args.some(f => file.includes(f)));
+}
+
+async function loadTestFile(file) {
+  setupJsdom();
+  await import(file);
+  teardownJsdom();
+}
+
+async function runTests() {
+  if (config.verbose) print.head('Test suites :');
+  for (const file of testFiles) {
+    try {
+      await loadTestFile(file);
+    } catch (error) {
+      print.boldError(`✗ ${file} failed to load:`);
+      print.grayError(error.stack);
+    }
+  }
+
+  await runQueuedTests();
+}
+
+runTests();

package/templates/features/testinNutin/{test → testin-nutin}/watch-tests.js.hbs

@@ -14,7 +14,7 @@ watcher.on('change', (filePath) => {
   console.clear();
   print.boldInfo(`\n🔄 File changed: ${path.relative(process.cwd(), filePath)}\n`);
 
-  exec('node --experimental-modules test/runner.js', (err, stdout, stderr) => {
+  exec('node --experimental-modules testin-nutin/runner.js', (err, stdout, stderr) => {
     if (stdout) process.stdout.write(stdout);
     if (stderr) process.stderr.write(stderr);
   });

package/templates/features/testinNutin/testin-nutin.config.js.hbs

@@ -0,0 +1,14 @@
+export default {
+	origins: [
+		'src/app', // actual app code
+		// 'src/core', // toolkit core logic
+		// 'testin-nutin/core/tests', // test globals
+	],
+	verbose: false,
+	jsdomOptions: {
+    runScripts: false,     // or true ("dangerously") if needed
+    resources: false,      // or true ("usable") if needed
+    freezeGlobals: false,
+    pretendToBeVisual: true,
+  }
+}

package/templates/base/Dockerfile.hbs

@@ -1,13 +0,0 @@
-FROM node:22.3.0 AS builder
-WORKDIR /usr/src/app
-COPY . .
-RUN	npm ci && \
-	npm run build
-
-FROM nginx:1.21-alpine
-RUN sed -i 's/listen  .*/listen 9090;/' /etc/nginx/conf.d/default.conf  && \
-    sed -i 's|index  index.html index.htm;|index  index.html index.htm;\n    try_files \$uri /index.html;|' /etc/nginx/conf.d/default.conf && \
-		mkdir -p /usr/share/nginx/html
-COPY --from=builder /usr/src/app/dist/src /usr/share/nginx/html
-
-CMD ["nginx", "-g", "daemon off;"]

package/templates/base/tools/builder/core/sass.config.js.hbs

@@ -1,17 +0,0 @@
-import * as sass from 'sass';
-import * as fs from 'fs';
-import { print } from '../../utils/index.js';
-{{#if template}}
-const stylesOutput = 'dist-build/src'
-{{else}}
-const stylesOutput = 'dist/src';
-{{/if}}
-if (!fs.existsSync(stylesOutput)) fs.mkdirSync(stylesOutput);
-
-sass.compileAsync('src/styles/main.scss', {
-  loadPaths: ['src/styles/base', 'src/styles/core'],
-  style: 'compressed'
-}).then(result => {
-  print.info('Global styles compiled.');
-  fs.writeFileSync(`${stylesOutput}/main.css`, result.css);
-});

package/templates/base/tools/builder/docs.md.hbs

@@ -1,9 +0,0 @@
-- Adding additnal file formats to the build
-Default file formats are `"html" "json" "ttf" "avif" "png" "jpg"`.          
-Only the files in src/ that match one of the format are copied.
-In `tools/builder/variables/file-types.js`, add desired format to existing list. Adding a file extension with no match in src/ will have no effect.            
-                                 
-- Build Sequence
-
-
-[**Back to index**](../../README.md)

package/templates/features/testinNutin/test/core/src/globals/assertion-lib.js.hbs

@@ -1,118 +0,0 @@
-global.expect = (actual) => {
-  const expectObj = {
-    toBe(expected) {
-      if (actual != expected) {
-        throw new Error(`Expected ${actual} to be ${expected}`);
-      }
-    },
-    toEqual(expected) {
-      if (actual !== expected) {
-        throw new Error(`Expected ${actual} to be ${expected}`);
-      }
-    },
-    toContain(substring) {
-      if (!actual.includes(substring)) {
-        throw new Error(`Expected '${actual}' to contain '${substring}'`);
-      }
-    },
-    toBeDefined() {
-      if (actual === null || actual === undefined) {
-        throw new Error(`Expected value to be defined, but got ${actual}`);
-      }
-    },
-    toBeUndefined() {
-      if (actual !== null && actual !== undefined) {
-        throw new Error(`Expected value to be undefined, but got ${actual}`);
-      }
-    },
-    toBeInstanceOf(constructor) {
-      if (!(actual instanceof constructor)) {
-        throw new Error(`Expected ${actual} to be instance of ${constructor.name}`);
-      }
-    },
-    toHaveBeenCalled() {
-      if (!actual?.calls || actual.calls.length === 0) {
-        throw new Error(`Expected function to have been called, but it was not`);
-      }
-    },
-    toHaveBeenCalledWith(...expectedArgs) {
-      const matched = actual?.calls?.some(args =>
-        args.length === expectedArgs.length &&
-        args.every((arg, i) => arg === expectedArgs[i])
-      );
-      if (!matched) {
-        throw new Error(`Expected function to have been called with ${JSON.stringify(expectedArgs)}, but it was not`);
-      }
-    },
-    toBeLessThan(expected) {
-      if (actual > expected) {
-        throw new Error(`Expected ${actual} to be less than ${expected}`)
-      }
-    },
-    toBeGreaterThan(expected) {
-      if (actual < expected) {
-        throw new Error(`Expected ${actual} to be greater than ${expected}`)
-      }
-    }
-  };
-
-  // 'not' variants
-  expectObj.not = {
-    toBe(expected) {
-      if (actual == expected) {
-        throw new Error(`Expected ${actual} not to be ${expected}`);
-      }
-    },
-    toEqual(expected) {
-      if (actual === expected) {
-        throw new Error(`Expected ${actual} not to be ${expected}`);
-      }
-    },
-    toContain(substring) {
-      if (actual.includes(substring)) {
-        throw new Error(`Expected '${actual}' not to contain '${substring}'`);
-      }
-    },
-    toBeDefined() {
-      if (actual !== null && actual !== undefined) {
-        throw new Error(`Expected value to be undefined, but got ${actual}`);
-      }
-    },
-    toBeUndefined() {
-      if (actual === null || actual === undefined) {
-        throw new Error(`Expected value to be defined, but got ${actual}`);
-      }
-    },
-    toBeInstanceOf(constructor) {
-      if (actual instanceof constructor) {
-        throw new Error(`Expected ${actual} not to be instance of ${constructor.name}`);
-      }
-    },
-    toHaveBeenCalled() {
-      if (actual?.calls && actual.calls.length > 0) {
-        throw new Error(`Expected function not to have been called, but it was`);
-      }
-    },
-    toHaveBeenCalledWith(...expectedArgs) {
-      const matched = actual?.calls?.some(args =>
-        args.length === expectedArgs.length &&
-        args.every((arg, i) => arg === expectedArgs[i])
-      );
-      if (matched) {
-        throw new Error(`Expected function not to have been called with ${JSON.stringify(expectedArgs)}, but it was`);
-      }
-    },
-    toBeLessThan(expected) {
-      if (actual < expected) {
-        throw new Error(`Expected ${actual} not to be less than ${expected}`)
-      }
-    },
-    toBeGreaterThan(expected) {
-      if (actual > expected) {
-        throw new Error(`Expected ${actual} not to be greater than ${expected}`)
-      }
-    }
-  };
-
-  return expectObj;
-};

package/templates/features/testinNutin/test/core/src/globals/spyon.js.hbs

@@ -1,22 +0,0 @@
-global.spyOn = (obj, methodName) => {
-  const originalFn = obj[methodName];
-
-  const calls = [];
-  const spy = function (...args) {
-    calls.push(args);
-    return originalFn.apply(this, args);
-  };
-
-  spy.calls = calls;
-
-  obj[methodName] = spy;
-
-  return {
-    restore() {
-      obj[methodName] = originalFn;
-    },
-    get calls() {
-      return calls;
-    }
-  };
-};

package/templates/features/testinNutin/test/core/src/jsdom-setup.js.hbs

@@ -1,12 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-import { JSDOM } from 'jsdom';
-
-export function setupJsdomEnvironment(htmlPath = 'dist/src/index.html') {
-  const html = fs.readFileSync(path.resolve(process.cwd(), htmlPath), 'utf8');
-  const dom = new JSDOM(html, { url: 'http://localhost' });
-
-  global.window = dom.window;
-  global.document = dom.window.document;
-  global.localStorage = dom.window.localStorage;
-}

package/templates/features/testinNutin/test/docs.md.hbs

@@ -1,39 +0,0 @@
-# testin-nutin
-
-***The test runner uses a Queue data structure, for which all credit goes to               ThePrimeagen and his [amazing Data Structures and Algorithms course on frontendmasters.com](https://frontendmasters.com/courses/algorithms/)*** 
-
-## Run tests
-
-The code needs to be compiled for the tests to run.
-
-```sh
-npm run test
-npm run test:watch # NOTE: will rerun all tests on change.
-npm run test--rebuild # = npm run build && npm run test 
-``` 
-Accepts a filter argument *ex: e2e, unit, file-name*.     
-
-## Built-in features (minimalistic)
-
-- *Test globals* : describe, it, beforeEach/All, afterEach/All.
-
-- *Assertions library* : toBe(), toContain(string), toBeDefined, toBeUndefined, toBeInstanceOf(instance).                
-All assertions can be used with `not.` prefix.
-
-- *JSDOM initial setup for DOM testing*.
-
-- *HTTP client mock* (In progress)
-
-- *Automated tests discovery* : Recursively scans e2e/ unit/ and utils/ folders for .test.js files.                              
-                             
-It is always possible to add new paths in test/runner.js `testFiles` array (`...getTestFiles('path/to/folder')`) or remove one to disable its tests.           
-
-- *mini-chalk* to color console outputs.
-
-## How to use
-
-Syntax is very similar to Jest, only with way less features.               
-Import statements from 'dist' folder can be simplified by using `#root/dist/src` and by regrouping exports in indexes.                   
-Please refer to examples in utils/\*.test.js and unit/i18n.test.js.
-                      
-[**Back to index**](../README.md)

package/templates/features/testinNutin/test/runner.js.hbs

@@ -1,36 +0,0 @@
-import { setupJsdomEnvironment, registerTestGlobals, getTestFiles, runQueuedTests, print } from './core/index.js';
-
-setupJsdomEnvironment();
-registerTestGlobals();
-
-let testFiles = [
-  // globals & assertions
-  // ...getTestFiles('core/tests'),
-  // toolkit core logic
-  // ...getTestFiles('../src/core'),
-  // built-in libs
-  // ...getTestFiles('../src/libs'),
-  // actual application code
-  ...getTestFiles('../src/app')
-];
-
-const args = process.argv.slice(2);
-if (args.length) {
-  testFiles = testFiles.filter(file => args.some(f => file.includes(f)));
-}
-
-async function runTests() {
-  print.head('Test suites :');
-  for (const file of testFiles) {
-    try {
-      await import(file);
-    } catch (error) {
-      print.boldError(`✗ ${file} failed to load:`);
-      print.grayError(error.stack);
-    }
-  }
-
-  await runQueuedTests();
-}
-
-runTests();