introduced BeforeExecution and AfterExecution hooks (#252)

* introduced `BeforeExecution` and `AfterExecution` hooks

Author: AlexGalichenko

CHANGELOG.MD

@@ -10,10 +10,35 @@ Check [Keep a Changelog](http://keepachangelog.com/) for recommendations on how
 :pencil: - chore  
 :microscope: - experimental
 
-## [Unreleased]
+## [2.4.0]
+- :microscope: introduced `BeforeExecution` and `AfterExecution` hooks
+
+```typescript
+import { BeforeExecution, AfterExecution } from '@qavajs/core';
+import { Server } from './server';
+
+const server = new Server();
+
+BeforeExecution(async function () {
+    await server.start();
+});
+
+AfterExecution(async function () {
+    await server.stop();
+});
+```
 - :microscope: added capability to define `Template`
 
-## 2.3.0
+```typescript
+import { When, Template } from '@qavajs/core';
+
+When('I click {string} and verify {string}', Template((locator, expected) => `
+    I click '${locator}'
+    I expect '${locator} > Value' to equal '${expected}'
+`));
+```
+
+## [2.3.0]
 - :microscope: added capability to define `Fixture`
 ```typescript
 import { Fixture } from '@qavajs/core';

README.MD

@@ -22,42 +22,6 @@ example
 
 it will override $url memory value
 
-### Service
-Services is an entities that can execute logic before and after whole test run.
-
-```typescript
-import externalService from './externalService';
-
-export default {
-    service: [
-        {
-            options: {
-                data: 42
-            },
-            before() {
-                console.log(this.options.data);
-            },
-            after(result) {
-                if (!result.success) process.exitCode = 1;
-            }
-        },
-        {
-            options: {
-                data: 42
-            },
-            ...externalService
-        }
-    ]
-}
-```
-There is a one minute-long default timeout for a before and after test logic to prevent entire process from freezing.
-To set up a custom timeout in milliseconds use serviceTimeout property in the config file
-```typescript
-export default {
-    serviceTimeout: 1_200_000
-}
-```
-
 ### Pass CLI params to workers
 All params that you passed to qavajs cli will be available in CLI_ARGV environment variable in all child workers.
 
@@ -166,4 +130,59 @@ When('I click {string} and verify {string}', Template((locator, expected) => `
     I click '${locator}'
     I expect '${locator} > Value' to equal '${expected}'
 `));
+```
+
+### Test Execution Hooks
+`BeforeExecution` and `AfterExecution` allow to define hooks that will be executed 
+once before/after whole test execution
+
+```typescript
+import { BeforeExecution, AfterExecution } from '@qavajs/core';
+import { Server } from './server';
+
+const server = new Server();
+
+BeforeExecution(async function () {
+    await server.start();
+});
+
+AfterExecution(async function () {
+    await server.stop();
+});
+```
+
+### Service
+Services is an entities that can execute logic before and after whole test run.
+
+```typescript
+import externalService from './externalService';
+
+export default {
+    service: [
+        {
+            options: {
+                data: 42
+            },
+            before() {
+                console.log(this.options.data);
+            },
+            after(result) {
+                if (!result.success) process.exitCode = 1;
+            }
+        },
+        {
+            options: {
+                data: 42
+            },
+            ...externalService
+        }
+    ]
+}
+```
+There is a one minute-long default timeout for a before and after test logic to prevent entire process from freezing.
+To set up a custom timeout in milliseconds use serviceTimeout property in the config file
+```typescript
+export default {
+    serviceTimeout: 1_200_000
+}
 ```

index.d.ts

@@ -4,6 +4,7 @@ import { IConfiguration, IRunResult } from '@cucumber/cucumber/api';
 export const Override: typeof When;
 export { Fixture } from 'src/Fixture';
 export { Template } from 'src/Template';
+export { BeforeExecution, AfterExecution } from 'src/executionHooks.js';
 
 /**
  * Validation function

index.js

@@ -2,10 +2,13 @@ const cucumber = require('@cucumber/cucumber');
 const { Override } = require('./lib/Override');
 const { Fixture } = require('./lib/Fixture');
 const { Template } = require('./lib/Template');
+const { BeforeExecution, AfterExecution } = require('./lib/executionHooks');
 
 module.exports = {
     ...cucumber,
     Override,
     Fixture,
-    Template
+    Template,
+    BeforeExecution,
+    AfterExecution
 }

index.mjs

@@ -1,4 +1,5 @@
 export { Override } from './lib/Override.js';
 export { Fixture } from './lib/Fixture.js';
 export { Template } from './lib/Template.js';
+export { BeforeExecution, AfterExecution } from './lib/executionHooks.js';
 export * from '@cucumber/cucumber';