tree: 590efa9d27636ae2944a5a27b07ad01694976067 [path history] [tgz]
  1. __init__.py
  2. CMakeLists.txt
  3. gtest.cpp
  4. README.md
  5. test_alias_analysis.cpp
  6. test_argument_spec.cpp
  7. test_autodiff.cpp
  8. test_base.h
  9. test_class_import.cpp
  10. test_class_parser.cpp
  11. test_code_template.cpp
  12. test_constant_pooling.cpp
  13. test_constant_propagation.cpp
  14. test_create_autodiff_subgraphs.cpp
  15. test_custom_operators.cpp
  16. test_dce.cpp
  17. test_fuser.cpp
  18. test_graph_executor.cpp
  19. test_inliner.cpp
  20. test_interpreter.cpp
  21. test_ir.cpp
  22. test_irparser.cpp
  23. test_ivalue.cpp
  24. test_lite_interpreter.cpp
  25. test_misc.cpp
  26. test_netdef_converter.cpp
  27. test_peephole_optimize.cpp
  28. test_qualified_name.cpp
  29. test_save_load.cpp
  30. test_schema_matching.cpp
  31. test_subgraph_matcher.cpp
  32. test_subgraph_rewriter.cpp
  33. test_subgraph_utils.cpp
  34. test_utils.cpp
  35. test_utils.h
  36. tests.h
  37. tests_setup.py
  38. torch_python_test.cpp
test/cpp/jit/README.md

JIT C++ Tests

How to add a new test

First, create a new test file. Test files should have be placed in this directory, with a name that starts with test_, like test_foo.cpp.

Here is an example test file you can copy-paste.

#include <test/cpp/jit/test_base.h>

// Tests go in torch::jit
namespace torch {
namespace jit {

// 1. Test cases are void() functions.
// 2. They start with the prefix `test`
void testCaseOne() {
    // ...
}

void testCaseTwo() {
    // ...
}
}
}

Then, register your test in tests.h:

// Add to TH_FORALL_TESTS_CUDA instead for CUDA-requiring tests
#define TH_FORALL_TESTS(_)             \
  _(ADFormulas)                        \
  _(Attributes)                        \
  ...
  _(CaseOne)  // note that the `test` prefix is omitted.
  _(CaseTwo)

We glob all the test files together in CMakeLists.txt so that you don't have to edit it every time you add a test. Unfortunately, this means that in order to get the build to pick up your new test file, you need to re-run cmake:

python setup.py build --cmake

Why do we have two different test runners?

We have two different ways of running our cpp tests:

  1. With gtest, from a standalone binary.
  2. With Python, from TestJit.test_cpp and TestJit.test_cpp_cuda (in test/test_jit.py)

We want both because we need to test things from a pure-C++ environment and with all our various Python patch-points enabled.

How do I run the tests?

The following commands assume you are in PyTorch root.

  1. With gtest:
    # (re)build the test binary
    ninja build/bin/test_jit
    # run
    build/bin/test_jit --gtest_filter='glob_style_filter*'
    
  2. With Python:
    python test/test_jit.py TestJit.test_cpp TestJit.test_cpp_cuda