EdgeX Test Automation Framework Common ( edgex-taf-common )

Overview

Contains common code or scripts such as TUC which will be common for all the project specific TAF code. TUC - Test Util Catalog.

Usage

1. Install required lib:

   git clone [email protected]:edgexfoundry/edgex-taf-common.git
   pip3 install edgex-taf-common
   pip3 install -r edgex-taf-common/requirements.txt

2. Create a edgex-taf project which contains a TAF folder.

   edgex-taf-project
   ├── TAF
   │   ├── README.md
   │   ├── __init__.py
   │   ├── config
   │   ├── testArtifacts
   │   ├── testCaseApps
   │   ├── testScenarios
   │   └── utils
   ├── .gitignore
   ├── .gitmodules
   ├── Jenkinsfile
   ├── README.md
   

3. Run test scripts via the edgex-taf-common:

   cd edgex-taf-project
   
   # Run use cases
   python3 -m TUC -u UC_coredata -u UC_metadata
   
   # Run test cases
   python3 -m TUC -t UC_coredata/event.robot -t UC_metadata/device.robot

Report location:

TAF/testArtifacts/reports/edgex
├── log.html
├── report.html
└── report.xml

4. Develop with IDE

   Since we use edgex-taf-common as module, we need to add it to the IDE. For the pycharm example, add interpreter paths.

5. Build docker image

   docker build .

Reports aggregation

Specify the reports directory and output directory

python3 -m TUC rebot --inputdir path/to/report/dir --outputdir path/to/output/dir

Then TUC will fetch robot XML reports from inputdir and regenerate new report to outputdir

path/to/output/dir
├── log.html
├── report.html
└── result.xml (xUnit compatible XML format)

Community

• Discussion: https://github.com/orgs/edgexfoundry/discussions
• Mailing lists: https://lists.edgexfoundry.org/mailman/listinfo

License

Apache-2.0