Add: Functional tests suite

README.md

@@ -95,6 +95,10 @@ decommission devices. [API](doc/api.md).
 
 Contributions to development can be found [here](doc/devel/development.md) - additional contributions are welcome.
 
+If you are whishing to test the library, or include new tests (either as part of a contribution or as a new feature or
+as a bug report), you can use the functional tests suite included in the project. The tests are described using a JSON
+file. You can find more information about the test suite in the [Functional Tests Guide](test/functional/README.md).
+
 ### Agent Console
 
 A command-line client to experiment with the library is packed with it. The command-line client can be started using the

package.json

@@ -33,6 +33,7 @@
     "prettier": "prettier --config .prettierrc.json --write '**/**/**/**/*.js' '**/**/**/*.js' '**/**/*.js' '**/*.js' '*.js'",
     "prettier:text": "prettier 'README.md' 'doc/*.md' 'doc/**/*.md' --no-config --tab-width 4 --print-width 120 --write --prose-wrap always",
     "test": "nyc --reporter=text mocha --recursive 'test/**/*.js' --reporter spec --timeout 8000 --ui bdd --exit --color true",
+    "test:functional": "nyc --reporter=text mocha --recursive 'test/functional/*.js' --reporter spec --timeout 5000 --ui bdd --exit  --color true",
     "test:expression": "nyc --reporter=text mocha --recursive 'test/unit/expressions/*.js' --reporter spec --timeout 5000 --ui bdd --exit --color true",
     "test:multientity": "nyc --reporter=text mocha --recursive 'test/unit/ngsiv2/plugins/multientity-plugin_test.js' --reporter spec --timeout 5000 --ui bdd --exit --color true",
     "test:debug": "mocha --recursive 'test/**/*.js' --reporter spec --inspect-brk --timeout 30000 --ui bdd --exit",
@@ -58,6 +59,9 @@
     "uuid": "~8.3.2"
   },
   "devDependencies": {
+    "async-mqtt": "~2.6.3",
+    "chai": "~4.3.10",
+    "chai-match-pattern": "~1.3.0",
     "coveralls": "~3.1.1",
     "eslint": "~8.18.0",
     "eslint-config-tamia": "~8.0.0",