66 // 3 - DOES NOT YET EXIST.  Pending changes for when this is introduced:
69 //       per-test program overrides is deprecated and should be removed.
74 // 2 - Changed the syntax() call to take only a version number, instead of the
78 // 1 - Initial version.
100     PRE(!file.is_absolute());  in relativize()
121     /// Root directory of the test programs.
137     /// Collection of test programs defined by the Kyuafile.
145     /// \param program_override The test program-specific test suite name.  May
176     /// \param build_root_ The root directory of the test programs.
245         return *state.to_userdata< parser* >(-1);  in get_from_state()
263     /// \post _test_programs is extended with the the test programs defined by
269     /// \param scheduler_handle Scheduler context to run test programs in.
320     /// \param scheduler_handle Scheduler context to run test programs in.
343             throw std::runtime_error(F("Non-existent test program '%s'") %  in callback_test_program()
371     /// \pre Can only be invoked once.
373     /// \return The collection of test programs defined by the Kyuafile.
379         PRE(_test_programs.empty());  in parse()
407 /// \pre state(-1) A table with the arguments that define the test program.  The
410 /// \pre state(upvalue 1) String with the name of the interface.
411 /// \pre state(upvalue 2) User configuration with the per-test suite settings.
412 /// \pre state(upvalue 3) Scheduler context to run test programs in.
440     if (!state.is_table(-1))  in lua_generic_test_program()
450     state.get_table(-2);  in lua_generic_test_program()
451     if (!state.is_string(-1))  in lua_generic_test_program()
454     const fs::path path(state.to_string(-1));  in lua_generic_test_program()
458     state.get_table(-2);  in lua_generic_test_program()
460     if (state.is_nil(-1)) {  in lua_generic_test_program()
461         // Leave empty to use the global test-suite value.  in lua_generic_test_program()
462     } else if (state.is_string(-1)) {  in lua_generic_test_program()
463         test_suite = state.to_string(-1);  in lua_generic_test_program()
465         throw std::runtime_error(F("Found non-string value in the test_suite "  in lua_generic_test_program()
472     while (state.next(-2)) {  in lua_generic_test_program()
473         if (!state.is_string(-2))  in lua_generic_test_program()
474             throw std::runtime_error(F("Found non-string metadata property "  in lua_generic_test_program()
477         const std::string property = state.to_string(-2);  in lua_generic_test_program()
481             if (state.is_boolean(-1)) {  in lua_generic_test_program()
482                 value = F("%s") % state.to_boolean(-1);  in lua_generic_test_program()
483             } else if (state.is_number(-1)) {  in lua_generic_test_program()
484                 value = F("%s") % state.to_integer(-1);  in lua_generic_test_program()
485             } else if (state.is_string(-1)) {  in lua_generic_test_program()
486                 value = state.to_string(-1);  in lua_generic_test_program()
499     parser::get_from_state(state)->callback_test_program(  in lua_generic_test_program()
514     state.push_string(parser::get_from_state(state)->  in lua_current_kyuafile()
524 /// \pre state(upvalue 1) User configuration with the per-test suite settings.
525 /// \pre state(upvalue 2) Scheduler context to run test programs in.
544     parser::get_from_state(state)->callback_include(  in lua_include()
545         fs::path(state.to_string(-1)), *user_config, *scheduler_handle);  in lua_include()
552 /// \pre state(-2) The syntax format name, if a v1 file.
553 /// \pre state(-1) The syntax format version.
561     if (!state.is_number(-1))  in lua_syntax()
563     const int syntax_version = state.to_integer(-1);  in lua_syntax()
569         if (!state.is_string(-2) || state.to_string(-2) != "kyuafile")  in lua_syntax()
577     parser::get_from_state(state)->callback_syntax(syntax_version);  in lua_syntax()
590     parser::get_from_state(state)->callback_test_suite(state.to_string(-1));  in lua_test_suite()
606 /// \param build_root_ The root directory for the test programs themselves.  In
609 /// \param tps_ Collection of test programs that belong to this test suite.
630 ///     containing the test programs themselves.  The layout of the build root
638 /// \return High-level representation of the configuration file.
677 /// Gets the root directory of the test programs.
687 /// Gets the collection of test programs that belong to this test suite.