@adaas/a-concept 0.1.18 → 0.1.19

package/tests/A-StepManager.test.ts

@@ -0,0 +1,346 @@
+import { A_Component } from "@adaas/a-concept/global/A-Component/A-Component.class";
+import { A_StepsManager } from "@adaas/a-concept/global/A-StepManager/A-StepManager.class";
+
+describe('A-StepManager tests', () => {
+    it('Should Allow to create a step manager', async () => {
+        const sm = new A_StepsManager([]);
+
+        expect(sm).toBeInstanceOf(A_StepsManager);
+    });
+    it('Should not change original sort if no other rules provided', async () => {
+        class ComponentA extends A_Component {
+            async step1() { }
+            async step2() { }
+            async step3() { }
+            async step4() { }
+            async step5() { }
+            async step6() { }
+        }
+
+        const sm = new A_StepsManager([
+            {
+                name: 'step1',
+                component: ComponentA,
+                handler: 'step1',
+            },
+            {
+                name: 'step2',
+                component: ComponentA,
+                handler: 'step2',
+            },
+            {
+                name: 'step3',
+                component: ComponentA,
+                handler: 'step3',
+            },
+            {
+                name: 'step4',
+                component: ComponentA,
+                handler: 'step4',
+            },
+            {
+                name: 'step5',
+                component: ComponentA,
+                handler: 'step5',
+            },
+            {
+                name: 'step6',
+                component: ComponentA,
+                handler: 'step6',
+            },
+        ]);
+
+
+        const result = sm.toSortedArray();
+
+        expect(result).toEqual([
+            'ComponentA.step1',
+            'ComponentA.step2',
+            'ComponentA.step3',
+            'ComponentA.step4',
+            'ComponentA.step5',
+            'ComponentA.step6'
+        ]);
+    });
+
+    it('Should change order depending on the before and after dependencies', async () => {
+        class ComponentA extends A_Component {
+            async step1() { }
+            async step2() { }
+            async step3() { }
+            async step4() { }
+            async step5() { }
+            async step6() { }
+        }
+
+        const sm = new A_StepsManager([
+            {
+                name: 'step1',
+                component: ComponentA,
+                handler: 'step1',
+            },
+            {
+                name: 'step2',
+                component: ComponentA,
+                handler: 'step2',
+            },
+            {
+                name: 'step3',
+                component: ComponentA,
+                handler: 'step3',
+            },
+            {
+                name: 'step4',
+                component: ComponentA,
+                handler: 'step4',
+            },
+            {
+                name: 'step5',
+                component: ComponentA,
+                handler: 'step5',
+                before: ['step2'],
+                after: ['step6']
+            },
+            {
+                name: 'step6',
+                component: ComponentA,
+                handler: 'step6',
+                before: ['ComponentA.step2']
+            },
+        ]);
+
+
+        const result = sm.toSortedArray();
+
+        expect(result).toEqual([
+            'ComponentA.step1',
+            'ComponentA.step6',
+            'ComponentA.step5',
+            'ComponentA.step2',
+            'ComponentA.step3',
+            'ComponentA.step4'
+        ]);
+    });
+
+    it('Should execute first step with * regexp', async () => {
+        class ComponentA extends A_Component {
+            async step1() { }
+            async step2() { }
+            async step3() { }
+            async step4() { }
+            async step5() { }
+            async step6() { }
+        }
+
+        const sm = new A_StepsManager([
+            {
+                name: 'step1',
+                component: ComponentA,
+                handler: 'step1',
+            },
+            {
+                name: 'step2',
+                component: ComponentA,
+                handler: 'step2',
+            },
+            {
+                name: 'step3',
+                component: ComponentA,
+                handler: 'step3',
+            },
+            {
+                name: 'step4',
+                component: ComponentA,
+                handler: 'step4',
+            },
+            {
+                name: 'step5',
+                component: ComponentA,
+                handler: 'step5',
+            },
+            {
+                name: 'step6',
+                component: ComponentA,
+                handler: 'step6',
+                before: [new RegExp('.*').source],
+            },
+        ]);
+
+
+        const result = sm.toSortedArray();
+
+        expect(result).toEqual([
+            'ComponentA.step6',
+            'ComponentA.step1',
+            'ComponentA.step2',
+            'ComponentA.step3',
+            'ComponentA.step4',
+            'ComponentA.step5'
+        ]);
+    });
+    it('Should execute with multiple * regexps', async () => {
+        class ComponentA extends A_Component {
+            async step1() { }
+            async step2() { }
+            async step3() { }
+            async step4() { }
+            async step5() { }
+            async step6() { }
+        }
+
+        const sm = new A_StepsManager([
+            {
+                name: 'step1',
+                component: ComponentA,
+                handler: 'step1',
+            },
+            {
+                name: 'step2',
+                component: ComponentA,
+                handler: 'step2',
+            },
+            {
+                name: 'step3',
+                component: ComponentA,
+                handler: 'step3',
+            },
+            {
+                name: 'step4',
+                component: ComponentA,
+                handler: 'step4',
+            },
+            {
+                name: 'step5',
+                component: ComponentA,
+                handler: 'step5',
+                before: [new RegExp('.*').source],
+            },
+            {
+                name: 'step6',
+                component: ComponentA,
+                handler: 'step6',
+                before: [new RegExp('.*').source],
+            },
+        ]);
+
+
+        const result = sm.toSortedArray();
+
+        expect(result).toEqual([
+            'ComponentA.step6',
+            'ComponentA.step5',
+            'ComponentA.step1',
+            'ComponentA.step2',
+            'ComponentA.step3',
+            'ComponentA.step4'
+        ]);
+    });
+
+    it('Should regexp for correct ordering ', async () => {
+        class ComponentA extends A_Component {
+            async step1() { }
+            async step2() { }
+            async step3() { }
+            async step4() { }
+            async step5() { }
+            async test() { }
+        }
+
+        const sm = new A_StepsManager([
+            {
+                name: 'step1',
+                component: ComponentA,
+                handler: 'step1',
+            },
+            {
+                name: 'step2',
+                component: ComponentA,
+                handler: 'step2',
+            },
+            {
+                name: 'step3',
+                component: ComponentA,
+                handler: 'step3',
+            },
+            {
+                name: 'step4',
+                component: ComponentA,
+                handler: 'step4',
+            },
+            {
+                name: 'step5',
+                component: ComponentA,
+                handler: 'step5',
+            },
+            {
+                name: 'test',
+                component: ComponentA,
+                handler: 'test',
+                before: [new RegExp('step(4|5)').source],
+                after: [new RegExp('step(1|2)').source],
+            },
+        ]);
+
+
+        const result = sm.toSortedArray();
+
+        expect(result).toEqual([
+            "ComponentA.step1",
+            "ComponentA.step2",
+            "ComponentA.step3",
+            "ComponentA.test",
+            "ComponentA.step4",
+            "ComponentA.step5",
+        ]);
+    });
+
+    it('Should do proper ordering across multiple components ', async () => {
+        class ComponentA extends A_Component {
+            async initialize() { }
+            async inject() { }
+
+        }
+
+        class ComponentB extends A_Component {
+            async readFromEnv() { }
+            async readFromFile() { }
+        }
+
+        const sm = new A_StepsManager([
+            {
+                name: 'readFromEnv',
+                component: ComponentB,
+                handler: 'readFromEnv',
+            },
+            {
+                name: 'readFromFile',
+                component: ComponentB,
+                handler: 'readFromFile',
+            },
+            {
+                name: 'initialize',
+                component: ComponentA,
+                handler: 'initialize',
+            },
+            {
+                name: 'inject',
+                component: ComponentA,
+                handler: 'inject',
+                before: [/ComponentB\.read.+/.source],
+                after: ['ComponentA.initialize']
+            },
+        ]);
+
+
+        const result = sm.toSortedArray();
+
+        expect(result).toEqual([
+            "ComponentA.initialize",
+            "ComponentA.inject",
+            "ComponentB.readFromEnv",
+            "ComponentB.readFromFile",
+        ]);
+    });
+
+    
+});

package/dist/src/helpers/A_StepsManager.class.d.ts

@@ -1,35 +0,0 @@
-import { A_Feature } from "../global/A-Feature/A-Feature.class";
-import { A_TYPES__FeatureDefineDecoratorTemplateItem } from "../global/A-Feature/A-Feature.types";
-import { A_Stage } from "../global/A-Stage/A-Stage.class";
-import { A_TYPES__A_StageStep } from "../global/A-Stage/A-Stage.types";
-export declare class A_StepsManager {
-    entities: A_TYPES__A_StageStep[];
-    graph: Map<string, Set<string>>;
-    visited: Set<string>;
-    tempMark: Set<string>;
-    sortedEntities: string[];
-    constructor(entities: Array<A_TYPES__FeatureDefineDecoratorTemplateItem>);
-    private prepareSteps;
-    private ID;
-    private buildGraph;
-    private matchEntities;
-    private visit;
-    toStages(feature: A_Feature): Array<A_Stage>;
-}
-export declare class A_TmpStage {
-    readonly name: string;
-    private readonly _steps;
-    constructor(_steps?: A_TYPES__A_StageStep[]);
-    get before(): string[];
-    get after(): string[];
-    get steps(): A_TYPES__A_StageStep[];
-    get asyncSteps(): A_TYPES__A_StageStep[];
-    get syncSteps(): A_TYPES__A_StageStep[];
-    /**
-     * Adds a step to the stage
-     *
-     * @param step
-     * @returns
-     */
-    add(step: A_TYPES__A_StageStep): this;
-}

package/dist/src/helpers/A_StepsManager.class.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"A_StepsManager.class.js","sourceRoot":"","sources":["../../../src/helpers/A_StepsManager.class.ts"],"names":[],"mappings":"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"}