Blame external/pybind11/tests/test_kwargs_and_defaults.cpp

Packit 534379
/*
Packit 534379
    tests/test_kwargs_and_defaults.cpp -- keyword arguments and default values
Packit 534379
Packit 534379
    Copyright (c) 2016 Wenzel Jakob <wenzel.jakob@epfl.ch>
Packit 534379
Packit 534379
    All rights reserved. Use of this source code is governed by a
Packit 534379
    BSD-style license that can be found in the LICENSE file.
Packit 534379
*/
Packit 534379
Packit 534379
#include "pybind11_tests.h"
Packit 534379
#include "constructor_stats.h"
Packit 534379
#include <pybind11/stl.h>
Packit 534379
Packit 534379
TEST_SUBMODULE(kwargs_and_defaults, m) {
Packit 534379
    auto kw_func = [](int x, int y) { return "x=" + std::to_string(x) + ", y=" + std::to_string(y); };
Packit 534379
Packit 534379
    // test_named_arguments
Packit 534379
    m.def("kw_func0", kw_func);
Packit 534379
    m.def("kw_func1", kw_func, py::arg("x"), py::arg("y"));
Packit 534379
    m.def("kw_func2", kw_func, py::arg("x") = 100, py::arg("y") = 200);
Packit 534379
    m.def("kw_func3", [](const char *) { }, py::arg("data") = std::string("Hello world!"));
Packit 534379
Packit 534379
    /* A fancier default argument */
Packit 534379
    std::vector<int> list{{13, 17}};
Packit 534379
    m.def("kw_func4", [](const std::vector<int> &entries) {
Packit 534379
        std::string ret = "{";
Packit 534379
        for (int i : entries)
Packit 534379
            ret += std::to_string(i) + " ";
Packit 534379
        ret.back() = '}';
Packit 534379
        return ret;
Packit 534379
    }, py::arg("myList") = list);
Packit 534379
Packit 534379
    m.def("kw_func_udl", kw_func, "x"_a, "y"_a=300);
Packit 534379
    m.def("kw_func_udl_z", kw_func, "x"_a, "y"_a=0);
Packit 534379
Packit 534379
    // test_args_and_kwargs
Packit 534379
    m.def("args_function", [](py::args args) -> py::tuple {
Packit 534379
        return std::move(args);
Packit 534379
    });
Packit 534379
    m.def("args_kwargs_function", [](py::args args, py::kwargs kwargs) {
Packit 534379
        return py::make_tuple(args, kwargs);
Packit 534379
    });
Packit 534379
Packit 534379
    // test_mixed_args_and_kwargs
Packit 534379
    m.def("mixed_plus_args", [](int i, double j, py::args args) {
Packit 534379
        return py::make_tuple(i, j, args);
Packit 534379
    });
Packit 534379
    m.def("mixed_plus_kwargs", [](int i, double j, py::kwargs kwargs) {
Packit 534379
        return py::make_tuple(i, j, kwargs);
Packit 534379
    });
Packit 534379
    auto mixed_plus_both = [](int i, double j, py::args args, py::kwargs kwargs) {
Packit 534379
        return py::make_tuple(i, j, args, kwargs);
Packit 534379
    };
Packit 534379
    m.def("mixed_plus_args_kwargs", mixed_plus_both);
Packit 534379
Packit 534379
    m.def("mixed_plus_args_kwargs_defaults", mixed_plus_both,
Packit 534379
            py::arg("i") = 1, py::arg("j") = 3.14159);
Packit 534379
Packit 534379
    // test_args_refcount
Packit 534379
    // PyPy needs a garbage collection to get the reference count values to match CPython's behaviour
Packit 534379
    #ifdef PYPY_VERSION
Packit 534379
    #define GC_IF_NEEDED ConstructorStats::gc()
Packit 534379
    #else
Packit 534379
    #define GC_IF_NEEDED
Packit 534379
    #endif
Packit 534379
    m.def("arg_refcount_h", [](py::handle h) { GC_IF_NEEDED; return h.ref_count(); });
Packit 534379
    m.def("arg_refcount_h", [](py::handle h, py::handle, py::handle) { GC_IF_NEEDED; return h.ref_count(); });
Packit 534379
    m.def("arg_refcount_o", [](py::object o) { GC_IF_NEEDED; return o.ref_count(); });
Packit 534379
    m.def("args_refcount", [](py::args a) {
Packit 534379
        GC_IF_NEEDED;
Packit 534379
        py::tuple t(a.size());
Packit 534379
        for (size_t i = 0; i < a.size(); i++)
Packit 534379
            // Use raw Python API here to avoid an extra, intermediate incref on the tuple item:
Packit 534379
            t[i] = (int) Py_REFCNT(PyTuple_GET_ITEM(a.ptr(), static_cast<ssize_t>(i)));
Packit 534379
        return t;
Packit 534379
    });
Packit 534379
    m.def("mixed_args_refcount", [](py::object o, py::args a) {
Packit 534379
        GC_IF_NEEDED;
Packit 534379
        py::tuple t(a.size() + 1);
Packit 534379
        t[0] = o.ref_count();
Packit 534379
        for (size_t i = 0; i < a.size(); i++)
Packit 534379
            // Use raw Python API here to avoid an extra, intermediate incref on the tuple item:
Packit 534379
            t[i + 1] = (int) Py_REFCNT(PyTuple_GET_ITEM(a.ptr(), static_cast<ssize_t>(i)));
Packit 534379
        return t;
Packit 534379
    });
Packit 534379
Packit 534379
    // pybind11 won't allow these to be bound: args and kwargs, if present, must be at the end.
Packit 534379
    // Uncomment these to test that the static_assert is indeed working:
Packit 534379
//    m.def("bad_args1", [](py::args, int) {});
Packit 534379
//    m.def("bad_args2", [](py::kwargs, int) {});
Packit 534379
//    m.def("bad_args3", [](py::kwargs, py::args) {});
Packit 534379
//    m.def("bad_args4", [](py::args, int, py::kwargs) {});
Packit 534379
//    m.def("bad_args5", [](py::args, py::kwargs, int) {});
Packit 534379
//    m.def("bad_args6", [](py::args, py::args) {});
Packit 534379
//    m.def("bad_args7", [](py::kwargs, py::kwargs) {});
Packit 534379
Packit 534379
    // test_function_signatures (along with most of the above)
Packit 534379
    struct KWClass { void foo(int, float) {} };
Packit 534379
    py::class_<KWClass>(m, "KWClass")
Packit 534379
        .def("foo0", &KWClass::foo)
Packit 534379
        .def("foo1", &KWClass::foo, "x"_a, "y"_a);
Packit 534379
}