94a8705ad0
Also add asan instrumentation to detect stack frame leakages (i.e. `mj_markStack` without a corresponding `mj_freeStack` in the same caller function). PiperOrigin-RevId: 562625645 Change-Id: I4e3ff66ca0b9d08ed0a95cef45393db8e3053e22
121 lines
3.9 KiB
C++
121 lines
3.9 KiB
C++
// Copyright 2021 DeepMind Technologies Limited
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
#ifndef MUJOCO_TEST_FIXTURE_H_
|
|
#define MUJOCO_TEST_FIXTURE_H_
|
|
|
|
#include <csetjmp>
|
|
#include <cstring>
|
|
#include <optional>
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
#include <gtest/gtest.h>
|
|
#include <absl/strings/string_view.h>
|
|
#include <mujoco/mjdata.h>
|
|
#include <mujoco/mjmodel.h>
|
|
#include <mujoco/mujoco.h>
|
|
|
|
extern "C" {
|
|
MJAPI void _mjPRIVATE__set_tls_error_fn(decltype(mju_user_error));
|
|
MJAPI decltype(mju_user_error) _mjPRIVATE__get_tls_error_fn();
|
|
}
|
|
|
|
namespace mujoco {
|
|
|
|
// Installs and uninstalls error callbacks on MuJoCo that fail the currently
|
|
// running test if triggered. Prefer the use of MujocoTest, unless using a
|
|
// test fixture is not possible.
|
|
class MujocoErrorTestGuard {
|
|
public:
|
|
// Sets up error and warning callbacks on MuJoCo that will fail the test if
|
|
// triggered.
|
|
MujocoErrorTestGuard();
|
|
|
|
// Clears up the callbacks from the constructor.
|
|
~MujocoErrorTestGuard();
|
|
};
|
|
|
|
// A test fixture which simplifies writing tests for the MuJoCo C API.
|
|
// By default, any MuJoCo operation which triggers a warning or error will
|
|
// trigger a test failure.
|
|
class MujocoTest : public ::testing::Test {
|
|
private:
|
|
MujocoErrorTestGuard error_guard;
|
|
};
|
|
|
|
template <typename Return, typename... Args>
|
|
auto MjuErrorMessageFrom(Return (*func)(Args...)) {
|
|
thread_local std::jmp_buf current_jmp_buf;
|
|
thread_local char err_msg[1000];
|
|
|
|
auto* old_error_handler = _mjPRIVATE__get_tls_error_fn();
|
|
auto* new_error_handler = +[](const char* msg) -> void {
|
|
std::strncpy(err_msg, msg, sizeof(err_msg));
|
|
std::longjmp(current_jmp_buf, 1);
|
|
};
|
|
|
|
return [func, old_error_handler,
|
|
new_error_handler](Args... args) -> std::string {
|
|
if (setjmp(current_jmp_buf) == 0) {
|
|
err_msg[0] = '\0';
|
|
_mjPRIVATE__set_tls_error_fn(new_error_handler);
|
|
func(args...);
|
|
}
|
|
|
|
_mjPRIVATE__set_tls_error_fn(old_error_handler);
|
|
return err_msg;
|
|
};
|
|
}
|
|
|
|
// Returns a path to a data file, under the mujoco/test directory.
|
|
const std::string GetTestDataFilePath(absl::string_view path);
|
|
|
|
// Returns a path to a data file, under the mujoco/model directory.
|
|
const std::string GetModelPath(absl::string_view path);
|
|
|
|
// Returns a newly-allocated mjModel, loaded from the contents of xml.
|
|
// On failure returns nullptr and populates the error array if present.
|
|
mjModel* LoadModelFromString(absl::string_view xml, char* error = nullptr,
|
|
int error_size = 0, mjVFS* vfs = nullptr);
|
|
|
|
// Returns a newly-allocated mjModel, loaded from the contents in model_path.
|
|
// On failure it asserts that model is null.
|
|
mjModel* LoadModelFromPath(const char* model_path);
|
|
|
|
// Returns a string loaded from first saving the model given an input.
|
|
const std::string SaveAndReadXml(const mjModel* model);
|
|
|
|
// Adds control noise.
|
|
std::vector<mjtNum> GetCtrlNoise(const mjModel* m, int nsteps,
|
|
mjtNum ctrlnoise = 0.01);
|
|
|
|
// Installs all plugins
|
|
class PluginTest : public MujocoTest {
|
|
public:
|
|
// load plugin library
|
|
PluginTest() : MujocoTest() {
|
|
mj_loadAllPluginLibraries(
|
|
std::string(std::getenv("MUJOCO_PLUGIN_DIR")).c_str(), +[](const char* filename, int first, int count) {
|
|
std::printf("Plugins registered by library '%s':\n", filename);
|
|
for (int i = first; i < first + count; ++i) {
|
|
std::printf(" %s\n", mjp_getPluginAtSlot(i)->name);
|
|
}
|
|
});
|
|
}
|
|
};
|
|
|
|
} // namespace mujoco
|
|
#endif // MUJOCO_TEST_FIXTURE_H_
|