Getting Started with LyTestTools

This guide outlines the first steps to start using LyTestTools. By the end of this guide, you will be ready to write and run tests.

Prerequisites

This guide requires that you’ve completed the following:

Start Testing

Once you have the prerequisites finished, you should have everything for testing configured and ready. You can verify this by running the following command.

~/python/python -m pytest <path_to_test_file> --build-directory <path_to_build_output>

Open 3D Engine ships with a sample test that demonstrates the use of LyTestTools, located in the Tools/LyTestTools/tests/integ/sanity_tests.py file. After compiling O3DE, you can run the sample test against your build output with the following command (run from your O3DE directory):

python -m pytest Tools/LyTestTools/tests/integ/sanity_tests.py --build-directory <cmake-build-directory>

More Information

  • PyTest framework - Information about the framework used by LyTestTools and how it helps with writing tests.

Copyright © 2026 DawnEngine. All rights reserved.

DawnEngine is a commercial 3D engine distributed under the DawnEngine end-user license agreement. Engine binaries and source are proprietary and are not covered by the licenses below.

Documentation only: the prose and templates on this site are a derivative work of Open 3D Engine (O3DE) documentation by the O3DE Contributors, used under CC BY 4.0 (documentation content), Apache 2.0 (site code), and the MIT license (inline code samples).

The open-source 3D engine that DawnEngine is built on top of is Open 3D Engine . DawnEngine is not affiliated with, endorsed by, or sponsored by The Linux Foundation or the O3DE project. “O3DE” and “Open 3D Engine” are trademarks of The Linux Foundation.