// sol2 // The MIT License (MIT) // Copyright (c) 2013-2022 Rapptz, ThePhD and contributors // Permission is hereby granted, free of charge, to any person obtaining a copy of // this software and associated documentation files (the "Software"), to deal in // the Software without restriction, including without limitation the rights to // use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of // the Software, and to permit persons to whom the Software is furnished to do so, // subject to the following conditions: // The above copyright notice and this permission notice shall be included in all // copies or substantial portions of the Software. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS // FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR // COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER // IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN // CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. #include "sol_test.hpp" #include "common_classes.hpp" #include #include #include #include #include #include #include #include #include #include #include inline namespace sol2_test_containers { struct returns_callable { std::vector* ptr; returns_callable(std::vector& ref_) : ptr(&ref_) { } std::vector& operator()() const { REQUIRE(ptr->size() == 3); return *ptr; } }; } // namespace sol2_test_containers TEST_CASE("containers/returns", "make sure that even references to vectors are being serialized as tables") { sol::state lua; std::vector v { 1, 2, 3 }; returns_callable f(v); lua.set_function("f", f); auto result1 = lua.safe_script("x = f()", sol::script_pass_on_error); REQUIRE(result1.valid()); sol::object x = lua["x"]; sol::type xt = x.get_type(); REQUIRE(xt == sol::type::userdata); sol::table t = x; bool matching; matching = t[1] == 1; REQUIRE(matching); matching = t[2] == 2; REQUIRE(matching); matching = t[3] == 3; REQUIRE(matching); } TEST_CASE("containers/custom usertype", "make sure container usertype metatables can be overridden") { typedef std::unordered_map bark; sol::state lua; lua.open_libraries(); lua.new_usertype( "bark", "something", [](const bark& b) { INFO("It works: " << b.at(24)); }, "size", &bark::size, "at", sol::resolve(&bark::at), "clear", &bark::clear); bark obj { { 24, 50 } }; lua.set("a", &obj); { auto result0 = lua.safe_script("assert(a:at(24) == 50)", sol::script_pass_on_error); REQUIRE(result0.valid()); auto result1 = lua.safe_script("a:something()", sol::script_pass_on_error); REQUIRE(result1.valid()); } lua.set("a", obj); { auto result = lua.safe_script("assert(a:at(24) == 50)", sol::script_pass_on_error); REQUIRE(result.valid()); } { auto result = lua.safe_script("a:something()", sol::script_pass_on_error); REQUIRE(result.valid()); } } TEST_CASE("containers/const serialization kvp", "make sure const keys / values are respected") { typedef std::map bark; sol::state lua; lua.open_libraries(); { bark obj { { 24, 50 } }; lua.set("a", std::ref(obj)); auto result0 = lua.safe_script("assert(a[24] == 50)", sol::script_pass_on_error); REQUIRE(result0.valid()); auto result1 = lua.safe_script("a[24] = 51", sol::script_pass_on_error); REQUIRE_FALSE(result1.valid()); auto result2 = lua.safe_script("assert(a[24] == 50)", sol::script_pass_on_error); REQUIRE(result2.valid()); } } TEST_CASE("containers/basic serialization", "make sure containers are turned into proper userdata and have basic hooks established") { typedef std::vector woof; sol::state lua; lua.open_libraries(); lua.set("b", woof { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 }); { auto result = lua.safe_script("for k = 1, #b do assert(k == b[k]) end", sol::script_pass_on_error); REQUIRE(result.valid()); } woof w { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 }; lua.set("b", w); { auto result = lua.safe_script("for k = 1, #b do assert(k == b[k]) end", sol::script_pass_on_error); REQUIRE(result.valid()); } lua.set("b", &w); { auto result = lua.safe_script("for k = 1, #b do assert(k == b[k]) end", sol::script_pass_on_error); REQUIRE(result.valid()); } lua.set("b", std::ref(w)); { auto result = lua.safe_script("for k = 1, #b do assert(k == b[k]) end", sol::script_pass_on_error); REQUIRE(result.valid()); } } #if 0 // LUL const int holders TEST_CASE("containers/const serialization", "make sure containers are turned into proper userdata and the basic hooks respect const-ness") { typedef std::vector woof; sol::state lua; lua.open_libraries(); lua.set("b", woof{ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 }); { auto result = lua.safe_script("for k, v in pairs(b) do assert(k == v) end", sol::script_pass_on_error); REQUIRE(result.valid()); } { auto result = lua.safe_script("b[1] = 20", sol::script_pass_on_error); REQUIRE_FALSE(result.valid()); } } #endif TEST_CASE("containers/const correctness", "usertype metatable names should reasonably ignore const attributes") { struct Vec { int x, y, z; }; sol::state lua; lua.open_libraries(sol::lib::base); lua.new_usertype("Vec", "x", &Vec::x, "y", &Vec::y, "z", &Vec::z); Vec vec; vec.x = 1; vec.y = 2; vec.z = -3; std::vector foo; foo.push_back(vec); std::vector bar; bar.push_back(&vec); auto result0 = lua.safe_script(R"( func = function(vecs) for i = 1, #vecs do vec = vecs[i] print(i, ":", vec.x, vec.y, vec.z) end end )", sol::script_pass_on_error); REQUIRE(result0.valid()); sol::protected_function f(lua["func"]); auto pfr1 = f(foo); REQUIRE(pfr1.valid()); auto pfr2 = f(bar); REQUIRE(pfr2.valid()); } TEST_CASE( "containers/usertype transparency", "Make sure containers pass their arguments through transparently and push the results as references, not new values") { class A { public: int a; A(int b = 2) : a(b) {}; void func() { } }; struct B { B() { for (std::size_t i = 0; i < 20; ++i) { a_list.emplace_back(static_cast(i)); } } std::vector a_list; }; sol::state lua; lua.new_usertype("B", "a_list", &B::a_list); auto result = lua.safe_script(R"( b = B.new() a_ref = b.a_list[2] )", sol::script_pass_on_error); REQUIRE(result.valid()); B& b = lua["b"]; A& a_ref = lua["a_ref"]; REQUIRE(&b.a_list[1] == &a_ref); REQUIRE(b.a_list[1].a == a_ref.a); } struct options { static int livingcount; static options* last; options() { ++livingcount; last = this; INFO("constructor: " << this); } std::string output_help() { last = this; INFO("func: " << this); return ""; } void begin() { } void end() { } ~options() { last = this; --livingcount; } }; options* options::last = nullptr; int options::livingcount = 0; struct machine { options opt; }; namespace sol { template <> struct is_container : std::false_type { }; } // namespace sol TEST_CASE("containers/is container", "make sure the is_container trait behaves properly") { sol::state lua; lua.open_libraries(); lua.new_usertype("options_type", "output_help", &options::output_help); lua.new_usertype( "machine_type", "new", sol::no_constructor, "opt", [](machine& m) { return &m.opt; }, "copy_opt", [](machine& m) { return m.opt; }); { machine m; lua["machine"] = &m; auto result0 = lua.safe_script(R"( machine:opt():output_help() )", sol::script_pass_on_error); REQUIRE(result0.valid()); REQUIRE(options::last == &m.opt); REQUIRE(options::livingcount == 1); } REQUIRE(options::livingcount == 0); } TEST_CASE("containers/readonly", "make sure readonly members are stored appropriately") { sol::state lua; lua.open_libraries(); struct bar { int x = 24; }; struct foo { std::list seq; }; lua.new_usertype("foo", "seq", &foo::seq, // this one works "readonly_seq", sol::readonly(&foo::seq)); lua["value"] = std::list { {}, {}, {} }; auto result0 = lua.safe_script(R"( a = foo.new() x = a.seq a.seq = value y = a.readonly_seq )", sol::script_pass_on_error); REQUIRE(result0.valid()); std::list& seqrefx = lua["x"]; std::list& seqrefy = lua["y"]; REQUIRE(&seqrefx == &seqrefy); REQUIRE(seqrefx.size() == 3); auto result = lua.safe_script("a.readonly_seq = value", sol::script_pass_on_error); REQUIRE_FALSE(result.valid()); } TEST_CASE("containers/to_args", "Test that the to_args abstractions works") { sol::state lua; lua.open_libraries(); auto result1 = lua.safe_script("function f (a, b, c, d) print(a, b, c, d) return a, b, c, d end", sol::script_pass_on_error); REQUIRE(result1.valid()); sol::function f = lua["f"]; int a, b, c, d; std::vector v2 { 3, 4 }; sol::tie(a, b, c, d) = f(1, 2, sol::as_args(v2)); REQUIRE(a == 1); REQUIRE(b == 2); REQUIRE(c == 3); REQUIRE(d == 4); std::set v4 { 7, 6, 8, 5 }; sol::tie(a, b, c, d) = f(sol::as_args(v4)); REQUIRE(a == 5); REQUIRE(b == 6); REQUIRE(c == 7); REQUIRE(d == 8); int v3[] = { 10, 11, 12 }; sol::tie(a, b, c, d) = f(9, sol::as_args(v3)); REQUIRE(a == 9); REQUIRE(b == 10); REQUIRE(c == 11); REQUIRE(d == 12); } TEST_CASE("containers/append idiom", "ensure the append-idiom works as intended") { sol::state lua; lua.open_libraries(sol::lib::base); auto result1 = lua.safe_script( R"( function f_fill(vec) print("#vec in lua: " .. #vec) for k = 1, #vec do vec[k] = k end print("#vec in lua: " .. #vec) end function f_append(vec) print("#vec in lua: " .. #vec) vec[Issue-vec] = -10456407 vec[Issue-vec + 1] = -54 print("#vec in lua: " .. #vec) end )", sol::script_pass_on_error); REQUIRE(result1.valid()); std::vector fill_cmp { 1, 2, 3 }; std::vector append_cmp { -1, -1, -10456407, -54 }; std::vector vec1 { -1, -1, -1 }; std::vector vec2 { -1, -1, -1 }; REQUIRE(vec1.size() == 3); lua["f_fill"](vec1); REQUIRE(vec1.size() == 3); REQUIRE(vec1 == fill_cmp); REQUIRE(vec2.size() == 3); lua["f_append"](vec2); REQUIRE(vec2.size() == 4); REQUIRE(vec2 == append_cmp); } TEST_CASE("containers/non_copyable", "make sure non-copyable types in containers behave properly when stored as a member variable in a bound usertype") { struct test { std::vector b; test() : b() { } test(test&&) = default; test& operator=(test&&) = default; test(const test&) = delete; test& operator=(const test&) = delete; }; SECTION("normal") { sol::state lua; lua.new_usertype("test", "b", sol::readonly(&test::b)); lua["v"] = std::vector {}; auto pfr = lua.safe_script("t = test.new() t.b = v", sol::script_pass_on_error); REQUIRE_FALSE(pfr.valid()); } } TEST_CASE("containers/pairs", "test how well pairs work with the underlying system") { using pair_arr_t = std::pair[5]; using arr_t = int[5]; sol::state lua; lua.open_libraries(sol::lib::base); std::vector> a { { "one", 1 }, { "two", 2 }, { "three", 3 }, { "four", 4 }, { "five", 5 } }; std::array, 5> b { { { "one", 1 }, { "two", 2 }, { "three", 3 }, { "four", 4 }, { "five", 5 } } }; pair_arr_t c { { "one", 1 }, { "two", 2 }, { "three", 3 }, { "four", 4 }, { "five", 5 } }; arr_t d = { 1, 2, 3, 4, 5 }; lua["a"] = std::ref(a); lua["b"] = &b; lua["c"] = std::ref(c); lua["d"] = &d; auto result1 = lua.safe_script("av1, av2 = a:get(1)", sol::script_pass_on_error); REQUIRE(result1.valid()); auto result2 = lua.safe_script("bv1, bv2 = b:get(1)", sol::script_pass_on_error); REQUIRE(result2.valid()); auto result3 = lua.safe_script("cv1, cv2 = c:get(1)", sol::script_pass_on_error); REQUIRE(result3.valid()); auto result4 = lua.safe_script("dv1, dv2 = d:get(1)", sol::script_pass_on_error); REQUIRE(result4.valid()); std::vector>& la = lua["a"]; std::array, 5>& lb = lua["b"]; pair_arr_t* plc = lua["c"]; pair_arr_t& lc = *plc; arr_t* pld = lua["d"]; arr_t& ld = *pld; std::pair& va = la[0]; std::pair& vb = lb[0]; std::pair& vc = lc[0]; int& vd = ld[0]; std::string av1 = lua["av1"]; int av2 = lua["av2"]; std::string bv1 = lua["bv1"]; int bv2 = lua["bv2"]; std::string cv1 = lua["cv1"]; int cv2 = lua["cv2"]; int dv1 = lua["dv1"]; sol::lua_nil_t dv2 = lua["dv2"]; REQUIRE(va.first == "one"); REQUIRE(va.second == 1); REQUIRE(vb.first == "one"); REQUIRE(vb.second == 1); REQUIRE(vc.first == "one"); REQUIRE(vc.second == 1); REQUIRE(vd == 1); REQUIRE(av1 == "one"); REQUIRE(av2 == 1); REQUIRE(bv1 == "one"); REQUIRE(bv2 == 1); REQUIRE(cv1 == "one"); REQUIRE(cv2 == 1); REQUIRE(dv1 == 1); REQUIRE(dv2 == sol::lua_nil); } TEST_CASE("containers/pointer types", "check that containers with unique usertypes and pointers or something") { struct base_t { virtual int get() const = 0; virtual ~base_t() { } }; struct derived_1_t : base_t { virtual int get() const override { return 250; } }; struct derived_2_t : base_t { virtual int get() const override { return 500; } }; sol::state lua; lua.open_libraries(sol::lib::base); derived_1_t d1; derived_2_t d2; std::vector> v1; v1.push_back(std::make_unique()); v1.push_back(std::make_unique()); std::vector v2; v2.push_back(&d1); v2.push_back(&d2); lua["c1"] = std::move(v1); lua["c2"] = &v2; auto result1 = lua.safe_script("b1 = c1[1]", sol::script_pass_on_error); REQUIRE(result1.valid()); base_t* b1 = lua["b1"]; int val1 = b1->get(); REQUIRE(val1 == 250); auto result2 = lua.safe_script("b2 = c2[2]", sol::script_pass_on_error); REQUIRE(result2.valid()); base_t* b2 = lua["b2"]; int val2 = b2->get(); REQUIRE(val2 == 500); } TEST_CASE("containers/keep alive", "containers are kept alive even if they are returned as a temporary") { sol::state lua; lua.open_libraries(sol::lib::base, sol::lib::table); #define PATTERN() 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 lua["get_collection"] = []() { return std::vector({ PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN(), PATTERN() }); }; #undef PATTERN sol::optional maybe_error = lua.safe_script(R"lua( print("LET'S GET IT BAYBEEE!") for i, v in pairs(get_collection()) do collectgarbage() collectgarbage() local index = i - 1 print(i, index, (index % 10), v) assert((index % 10) == v) end collectgarbage() collectgarbage() print("YEEEAH!") )lua"); REQUIRE_FALSE(maybe_error.has_value()); }