diff options
Diffstat (limited to 'utils/test/testapi/docs/developer/devguide')
7 files changed, 0 insertions, 257 deletions
diff --git a/utils/test/testapi/docs/developer/devguide/api.rst b/utils/test/testapi/docs/developer/devguide/api.rst deleted file mode 100644 index cd2ca27cf..000000000 --- a/utils/test/testapi/docs/developer/devguide/api.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 -.. (c) 2017 ZTE Corp. - -============ -Restful APIs -============ - -.. toctree:: - :maxdepth: 2 diff --git a/utils/test/testapi/docs/developer/devguide/framework.rst b/utils/test/testapi/docs/developer/devguide/framework.rst deleted file mode 100644 index f7a760531..000000000 --- a/utils/test/testapi/docs/developer/devguide/framework.rst +++ /dev/null @@ -1,101 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 -.. (c) 2017 ZTE Corp. - - -.. toctree:: - :maxdepth: 2 - -========= -Framework -========= - -**Test Results Collector of OPNFV Test Projects**: - -This project aims to provide a common way of gathering all the test results for OPNFV -testing projects into a single place, and a unified way of getting those results for -testing analysis projects, such as Reporting/Bitergia Dashboard/Qtip. It exposes -Restful APIs for collecting results and pushing them into a MongoDB database. - -If you are interested in how TestAPI looks like, please visit OPNFV's official `TestAPI Server`__ - -.. __: http://testresults.opnfv.org/test - -Pre-requsites -============= - -TestAPI leverages MongoDB as the data warehouse, in order to let it work -successfully, a MongoDB must be provided, the official MongoDB version in OPNFV -TestAPI is 3.2.6. And the database is **test_results_collection**, the five -collections are *users/pods/projects/testcases/scenarioes/results*. And thanks to -MongoDB's very user-friendly property, they don't need to be created in advance. - -Running locally -=============== - -Requirements -^^^^^^^^^^^^ - -All requirements are listed in requirements.txt and should be -installed by 'pip install': - - *pip install -r requirements.txt* - -Installation -^^^^^^^^^^^^ - - *python setup.py install* - -After installation, configuration file etc/config.ini will be put under -/etc/opnfv_testapi/. And all the web relevant files under 3rd_party/static -will be in /user/local/share/opnfv_testapi as a totality. - -Start Server -^^^^^^^^^^^^ - - *opnfv-testapi [--config-file <config.ini>]* - -If --config-file is provided, the specified configuration file will be employed -when starting the server, or else /etc/opnfv_testapi/config.ini will be utilized -by default. - -After executing the command successfully, a TestAPI server will be started on -port 8000, to visit web portal, please access http://hostname:8000 - -Regarding swagger-ui website, please visit http://hostname:8000/swagger/spec.html - -Running with container -====================== - -TestAPI has already containerized, the docker image is opnfv/testapi:latest. - -**Running the container not behind nginx:** - -.. code-block:: shell - - docker run -dti --name testapi -p expose_port:8000 - -e "mongodb_url=mongodb://mongodb_ip:27017/" - -e "base_url=http://host_name:expose_port" - opnfv/testapi:latest - -**Running the container behind nginx:** - -.. code-block:: shell - - docker run -dti --name testapi -p expose_port:8000 - -e "mongodb_url=mongodb://mongodb_ip:27017/" - -e "base_url=http://nginx_url" - opnfv/testapi:latest - -Unittest & pep8 -=============== - -All requirements for unit tests are outlined in test-requirements.txt, and in TestAPI project, tox is leveraged to drive the executing of unit tests and pep8 check - -**Running unit tests** - - *tox -e py27* - -**Running pep8 check** - - *tox -e pep8* diff --git a/utils/test/testapi/docs/developer/devguide/index.rst b/utils/test/testapi/docs/developer/devguide/index.rst deleted file mode 100644 index 7afcd96fe..000000000 --- a/utils/test/testapi/docs/developer/devguide/index.rst +++ /dev/null @@ -1,18 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 -.. (c) 2017 ZTE Corp. - - -*********************** -TestAPI Developer Guide -*********************** - -.. toctree:: - :maxdepth: 2 - - overview.rst - framework.rst - api.rst - swagger-ui.rst - web-portal.rst - testapi-client.rst diff --git a/utils/test/testapi/docs/developer/devguide/overview.rst b/utils/test/testapi/docs/developer/devguide/overview.rst deleted file mode 100644 index b6475f30e..000000000 --- a/utils/test/testapi/docs/developer/devguide/overview.rst +++ /dev/null @@ -1,98 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 -.. (c) 2017 ZTE Corporation - - -******** -Overview -******** - -TestAPI uses Python as primary programming language and build the framework from the following packages - -======== =============================================================================================================== -Module Package -======== =============================================================================================================== -api `Tornado-Motor`_ - API applications using Motor with tornado -swagger `tornado-swagger`_ - a wrapper for tornado which enables swagger-ui-v1.2 support -web `angular`_ - a superheroic JavaScript MVW framework, the version is AngularJS v1.3.15 -docs `sphinx`_ - a tool that makes it easy to create intelligent and beautiful documentation -testing `pytest`_ - a mature full-featured Python testing tool that helps you write better programs -======== =============================================================================================================== - - -Source Code -=========== - -The structure of repository is based on the recommended sample in `The Hitchhiker's Guide to Python`_ - -========================== ==================================================================================================== -Path Content -========================== ==================================================================================================== -``./3rd_party/`` third part included in TestAPI project -``./docker/`` configuration for building Docker image for TestAPI deployment -``./docs/`` user and developer documentation, design proposals -``./etc/`` configuration files used to install opnfv-testapi -``./opnfv_testapi/`` the actual package -``./opnfv_testapi/tests/`` package functional and unit tests -``./opts/`` optional components, e.g. one click deployment script -========================== ==================================================================================================== - - -Coding Style -============ - -TestAPI follows `OpenStack Style Guidelines`_ for source code and commit message. - -Specially, it is recommended to link each patch set with a JIRA issue. Put:: - - JIRA: RELENG-n - -in commit message to create an automatic link. - - -Testing -======= - -All testing related code are stored in ``./opnfv_testapi/tests/`` - -================== ==================================================================================================== -Path Content -================== ==================================================================================================== -``./tests/unit/`` unit test for each module, follow the same layout as ./opnfv_testapi/ -``./conftest.py`` pytest configuration in project scope -================== ==================================================================================================== - -`tox`_ is used to automate the testing tasks - -.. code-block:: shell - - cd <project_root> - pip install tox - tox - -The test cases are written in `pytest`_. You may run it selectively with - -.. code-block:: shell - - pytest opnfv_testapi/tests/unit/common/test_config.py - - -Branching -========= - -Currently, no branching for TestAPI, only master branch - - -Releasing -========= - -Currently, TestAPI does not follow community's milestones and releases - -.. _Tornado-Motor: https://motor.readthedocs.io/en/stable/tutorial-tornado.html -.. _tornado-swagger: https://github.com/SerenaFeng/tornado-swagger -.. _angular: https://code.angularjs.org/1.3.15/docs/guide -.. _sphinx: http://www.sphinx-doc.org/en/stable/ -.. _pytest: http://doc.pytest.org/ -.. _OpenStack Style Guidelines: http://docs.openstack.org/developer/hacking/ -.. _The Hitchhiker's Guide to Python: http://python-guide-pt-br.readthedocs.io/en/latest/writing/structure/ -.. _tox: https://tox.readthedocs.io/ diff --git a/utils/test/testapi/docs/developer/devguide/swagger-ui.rst b/utils/test/testapi/docs/developer/devguide/swagger-ui.rst deleted file mode 100644 index 7f53047e5..000000000 --- a/utils/test/testapi/docs/developer/devguide/swagger-ui.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 -.. (c) 2017 ZTE Corp. - -============ -Swagger page -============ - -.. toctree:: - :maxdepth: 2 diff --git a/utils/test/testapi/docs/developer/devguide/testapi-client.rst b/utils/test/testapi/docs/developer/devguide/testapi-client.rst deleted file mode 100644 index ab4c8e802..000000000 --- a/utils/test/testapi/docs/developer/devguide/testapi-client.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 -.. (c) 2017 ZTE Corp. - -============== -TestAPI client -============== - -.. toctree:: - :maxdepth: 2 diff --git a/utils/test/testapi/docs/developer/devguide/web-portal.rst b/utils/test/testapi/docs/developer/devguide/web-portal.rst deleted file mode 100644 index 62b2f1794..000000000 --- a/utils/test/testapi/docs/developer/devguide/web-portal.rst +++ /dev/null @@ -1,10 +0,0 @@ -.. This work is licensed under a Creative Commons Attribution 4.0 International License. -.. http://creativecommons.org/licenses/by/4.0 -.. (c) 2017 ZTE Corp. - -========== -Web portal -========== - -.. toctree:: - :maxdepth: 2 |