Add test filtering

.vscode/launch.json

@@ -4,7 +4,7 @@
         {
             "type": "node",
             "request": "launch",
-            "name": "Run Tests",
+            "name": "example: debug main process",
             "runtimeExecutable": "npm",
             "runtimeArgs": [
                 "run",
@@ -15,7 +15,35 @@
             ],
             "cwd": "${workspaceFolder}/example",
             "console": "integratedTerminal",
-            "internalConsoleOptions": "neverOpen"
+            "internalConsoleOptions": "neverOpen",
+            "presentation": {
+                "hidden": true
+            },
+        },
+        {
+            "type": "node",
+            "request": "attach",
+            "name": "try debug child process",
+            "port": 12016,
+            "skipFiles": [
+                "<node_internals>/**"
+            ],
+            "timeout": 5000,
+            "restart": false,
+            "presentation": {
+                "hidden": true
+            },
+        },
+    ],
+    "compounds": [
+        {
+            "name": "(example) debug tests",
+            "configurations": ["example: debug main process", "try debug child process"],
+            "presentation": {
+                "hidden": false,
+                "group": "",
+                "order": 1
+            },
         }
     ]
-}
+}

@bellatrix/core/package.build.json

@@ -1,5 +1,5 @@
 {
-  "USE THIS REGEX TO SELECT THE EXPORTS, THEN CHANGE THEM WITH JS OR STH": "YOU ARE AN IDIOT, JUST IMPORT, MODIFY THE JS OBJECT AND STRINGIFY",
+  "USE THIS REGEX TO SELECT THE EXPORTS, THEN CHANGE THEM WITH JS OR STH": "JUST IMPORT, MODIFY THE JS OBJECT AND STRINGIFY",
   "######": ".*\"exports\": (?=\\{((?:[^{}]++)++)\\})",
   "name": "@bellatrix/core",
   "version": "0.0.1",
@@ -44,7 +44,7 @@
     "jasmine-core": "^5.1.1",
     "mocha": "^10.2.0",
     "reflect-metadata": "^0.2.1",
-    "vitest": "^1.2.1"
+    "vitest": "^3.0.5"
   },
   "devDependencies": {
     "fix-esm-import-path": "^1.5.0"

@bellatrix/core/package.json

@@ -12,7 +12,8 @@
     "./test": "./src/test/index.ts",
     "./test/props": "./src/test/props.ts",
     "./settings": "./src/settings/index.ts",
-    "./assertions": "./src/assertions/index.ts"
+    "./assertions": "./src/assertions/index.ts",
+    "./decorators": "./src/decorators/index.ts"
   },
   "peerDependencies": {
     "typescript": "^5.0.0"
@@ -24,7 +25,7 @@
     "jasmine-core": "^5.1.1",
     "mocha": "^10.2.0",
     "reflect-metadata": "^0.2.1",
-    "vitest": "^1.2.1"
+    "vitest": "^3.0.5"
   },
   "devDependencies": {
     "c8": "^9.1.0",

@bellatrix/core/src/decorators/Category.ts

@@ -0,0 +1,43 @@
+import { Symbols } from '@bellatrix/core/constants';
+import { BellatrixTest } from '@bellatrix/core/infrastructure';
+import { getTestMetadata } from '@bellatrix/core/test/props';
+import { ParameterlessCtor } from '@bellatrix/core/types';
+
+export function Category<T extends BellatrixTest>(name: string): (target: ParameterlessCtor<T>) => void {
+    return (target: ParameterlessCtor<T>) => {
+        const testClass = target.prototype;
+        const testMethods = Object.getOwnPropertyNames(testClass).filter(method => typeof testClass[method] === 'function' && Reflect.hasMetadata(Symbols.TEST, testClass[method]));
+
+        for (const testMethod of testMethods) {
+            const metadata = getTestMetadata(testClass[testMethod], testClass);
+
+            if (metadata.customData.has('category')) {
+                const categories = metadata.customData.get('category');
+                if (!Array.isArray(categories)) {
+                    metadata.customData.set('category', [categories, name]);
+                } else {
+                    categories.push(name);
+                }
+            } else {
+                metadata.customData.set('category', name);
+            }
+        }
+    };
+}
+
+export function TestCategory<T extends BellatrixTest>(name: string): (testClass: T, methodName: string) => void {
+    return (testClass: T, methodName: string) => {
+        const metadata = getTestMetadata(testClass[methodName as keyof T] as (...args: unknown[]) => (Promise<void> | void), testClass.constructor as ParameterlessCtor<T>);
+
+        if (metadata.customData.has('category')) {
+            const categories = metadata.customData.get('category');
+            if (!Array.isArray(categories)) {
+                metadata.customData.set('category', [categories, name]);
+            } else {
+                categories.push(name);
+            }
+        } else {
+            metadata.customData.set('category', name);
+        }
+    };
+}

@bellatrix/core/src/decorators/Debug.ts

@@ -0,0 +1,8 @@
+import { BellatrixTest } from '@bellatrix/core/infrastructure';
+import { getTestMetadata } from '@bellatrix/core/test/props';
+import { ParameterlessCtor } from '@bellatrix/core/types';
+
+export function Debug<T extends BellatrixTest>(target: T, methodName?: string): void {
+    const metadata = getTestMetadata(target[methodName as keyof T] as (...args: unknown[]) => (Promise<void> | void), target.constructor as ParameterlessCtor<T>);
+    metadata.only = true;
+}

@bellatrix/core/src/decorators/Ignore.ts

@@ -0,0 +1,21 @@
+import { Symbols } from '@bellatrix/core/constants';
+import { BellatrixTest } from '@bellatrix/core/infrastructure';
+import { getTestMetadata } from '@bellatrix/core/test/props';
+import { ParameterlessCtor } from '@bellatrix/core/types';
+
+export function Ignore<T extends BellatrixTest>(target: T, methodName: string): void;
+export function Ignore<T extends BellatrixTest>(target: ParameterlessCtor<T>): void;
+export function Ignore<T extends BellatrixTest>(target: T | ParameterlessCtor<T>, methodName?: string): void {
+    if (typeof target === 'function') {
+        const testClass = target.prototype;
+        const testMethods = Object.getOwnPropertyNames(testClass).filter(method => typeof testClass[method] === 'function' && Reflect.hasMetadata(Symbols.TEST, testClass[method]));
+
+        for (const testMethod of testMethods) {
+            const metadata = getTestMetadata(testClass[testMethod], testClass);
+            metadata.shouldSkip = true;
+        }
+    } else {
+        const metadata = getTestMetadata(target[methodName as keyof T] as (...args: unknown[]) => (Promise<void> | void), target.constructor as ParameterlessCtor<T>);
+        metadata.shouldSkip = true;
+    }
+}

@bellatrix/core/src/decorators/index.ts

@@ -0,0 +1,3 @@
+export * from './Category';
+export * from './Debug';
+export * from './Ignore';

@bellatrix/core/src/infrastructure/PluginExecutionEngine.ts

@@ -1,4 +1,4 @@
-import { TestMetadata, getCurrentTest, getSuiteMetadata, getTestMetadata } from '@bellatrix/core/test/props';
+import { getCurrentTest, getSuiteMetadata, getTestMetadata } from '@bellatrix/core/test/props';
 import { ServiceLocator } from '@bellatrix/core/utilities';
 import { BellatrixTest, Plugin } from '.';
 
@@ -27,7 +27,7 @@ export class PluginExecutionEngine {
     }
 
     static async executeBeforeTestHook<T>(beforeTestFn: Function | undefined, testClass: typeof BellatrixTest): Promise<T> {
-        const testMetadata = getTestMetadata(getCurrentTest(testClass).method);
+        const testMetadata = getTestMetadata(getCurrentTest(testClass).method, testClass);
         try {
             await PluginExecutionEngine.executeAll(plugin => plugin.preBeforeTest(testMetadata));
             const result = await beforeTestFn?.();
@@ -40,7 +40,7 @@ export class PluginExecutionEngine {
     }
 
     static async executeAfterTestHook<T>(afterTestFn: Function | undefined, testClass: typeof BellatrixTest): Promise<T> {
-        const testMetadata = getTestMetadata(getCurrentTest(testClass).method);
+        const testMetadata = getTestMetadata(getCurrentTest(testClass).method, testClass);
         try {
             await PluginExecutionEngine.executeAll(plugin => plugin.preAfterTest(testMetadata));
             const result = await afterTestFn?.();