smo-install/test/pythonsdk/README.md

   1 # Python ORAN SDK
   2
   3 an extension of ONAP SDK, to use ORAN and ONAP components programmatically with Python code
   4
   5
   6 ## Description
   7
   8 ORAN SDK is an extension of ONAP SDK. Please check [doc](https://python-onapsdk.readthedocs.io/en/latest/index.html) site to find out all the features about ONAP SDK.
   9
  10 This project aims to provide a consistent and complete set of interactions with ORAN’s many services.
  11
  12 Using few python commands, you should be able to run different tests with different components from ONAP and ORAN.
  13
  14 ### Setting up development environment
  15
  16 Ensure you have executed the script located in ... scripts/layer-0/0-setup-tests-env.sh
  17 This will setup eveything for you.
  18
  19 ### Testing
  20
  21 This project uses tox to run all the tests and do lint and docstyle checks.
  22
  23 ```
  24 $ tox
  25 ```
  26
  27 #### Unit testing
  28 To run only the unit test:
  29
  30 ```
  31 $ tox -e unit-tests
  32 ```
  33
  34 #### Integration testing
  35
  36 To run the integration tests, start all the needed ONAP and ORAN components & network simulators first on kubernetes.
  37
  38 Go to *scripts/layer-2* directory and start all the needed components with the scripts.
  39
  40 Then execute the integration tests with command:
  41
  42 ```
  43 $ tox -e oran-tests
  44 ```
  45
  46 #### Code analyse and check style checking
  47 To run code analyse and check check styles:
  48
  49 ```
  50 $ tox -e pylint
  51 ```
  52
  53 To check compliance with Python docstring conventions:
  54
  55 ```
  56 $ tox -e pydocstyle
  57 ```