Gitiles
Code Review Sign In
gerrit.opencord.org / xos / 8a1155faf9f2e85f76c8075d37b6a217f8218d4f
commit8a1155faf9f2e85f76c8075d37b6a217f8218d4f[log] [tgz]
authorDaniele Moro <daniele@opennetworking.org>Thu Feb 27 18:04:23 2020 -0800
committerDaniele Moro <daniele@opennetworking.org>Thu Feb 27 18:05:54 2020 -0800
tree2e44b111ee0f24280a2a8f743e980482f1996ec4
parentd6fc750447e3ae5bbd6762cc0d50a7fcc355886b [diff]
[CORD-3254] Fix xosapi including google/api protos

annotations.proto and http.proto from google/api are needed for runtime
proto compilation.

Change-Id: Ib50f3c4a7e0b1d08406cac15611c12bd026dded1
1 file changed
tree: 2e44b111ee0f24280a2a8f743e980482f1996ec4
  1. .dockerignore
  2. .gitignore
  3. .gitreview
  4. CODE_OF_CONDUCT.md
  5. Dockerfile.client
  6. Dockerfile.core
  7. LICENSE.txt
  8. Makefile
  9. README.md
  10. VERSION
  11. book.json
  12. docs/
  13. lib/
  14. requirements.txt
  15. scripts/
  16. testservice/
  17. tox.ini
  18. xos/
README.md

XOS

XOS is a framework for operationalizing a collection of disaggregated services. It is packaged as a project in the Open CORD initiative, with source code managed through https://gerrit.opencord.org. It is also mirrored at https://github.com/opencord.

You can download and use XOS either as part of CORD (see the CORD Guide for details) or as a standalone component (see the XOS Guide for details).

Also visit the XOS Wiki Page for additional information.

Testing the XOS Core

Run make test to run all tests on the XOS codebase. This is what happens during the verify_xos_unit-test job in Jenkins.

Running these tests requires:

  • A Python 2.7, and one or more of Python 3.5, 3.6, or 3.7 development environment
    • Requires a C build system and the python header files (under ubuntu 16.04, apt install python2-dev python3-dev build-essential) to build packages with C extensions.
  • virtualenv
  • tox version 3.2 or later

This will run 3 sets of test targets, which can also be run individually:

  • lib-test: runs tox on each of the library modules stored in lib. These are tested against both Python 2 and 3 by running both nose2 and flake8.

    If you are making changes only to a specific library, it is recommended that you run tox directly inside that modules directory, which should run much more quickly than testing all the libraries.

  • xos-test: runs nose2 to test the xos directory. This code is not yet Python 3 or flake8 clean.

  • migration-test: Runs the xos-migrate tool on the XOS core modules. This verifies that the Django migrations have been properly created. If you've changed xosgenx or the core.xproto file you may need to generate new migrations. See docs/dev/xosmigrate.md for more information.

Additionally, a virtualenv will be created in venv-xos - you can source ./venv-xos/bin/activate if you'd like to run tools like xos-migrate manually.

Issues you may encounter when developing XOS

Testing errors that complain about missing compliers or header files: src/twisted/test/raiser.c:4:20: fatal error: Python.h: No such file or directory

You probably need to install a C build system and the Python development headers.

After making changes to the requirements.txt or other files, the changes don't seem to be register

You might need to clean up any files left behind by previous development work. make clean in the root Makefile should clean up most files. Additionally, git clean -ixd will let you interactively remove all ignored files and directories from your source tree.