knx/examples/knxPython/pybind11/tests/test_kwargs_and_defaults.cpp

/*
    tests/test_kwargs_and_defaults.cpp -- keyword arguments and default values

    Copyright (c) 2016 Wenzel Jakob <wenzel.jakob@epfl.ch>

    All rights reserved. Use of this source code is governed by a
    BSD-style license that can be found in the LICENSE file.
*/

#include <pybind11/stl.h>

#include "constructor_stats.h"
#include "pybind11_tests.h"

#include <utility>

TEST_SUBMODULE(kwargs_and_defaults, m)
{
    auto kw_func
        = [](int x, int y)
    {
        return "x=" + std::to_string(x) + ", y=" + std::to_string(y);
    };

    // test_named_arguments
    m.def("kw_func0", kw_func);
    m.def("kw_func1", kw_func, py::arg("x"), py::arg("y"));
    m.def("kw_func2", kw_func, py::arg("x") = 100, py::arg("y") = 200);
    m.def("kw_func3", [](const char*) {}, py::arg("data") = std::string("Hello world!"));

    /* A fancier default argument */
    std::vector<int> list{{13, 17}};
    m.def(
        "kw_func4",
        [](const std::vector<int>& entries)
    {
        std::string ret = "{";

        for (int i : entries)
        {
            ret += std::to_string(i) + " ";
        }

        ret.back() = '}';
        return ret;
    },
    py::arg("myList") = list);

    m.def("kw_func_udl", kw_func, "x"_a, "y"_a = 300);
    m.def("kw_func_udl_z", kw_func, "x"_a, "y"_a = 0);

    // test line breaks in default argument representation
    struct CustomRepr
    {
        std::string repr_string;

        explicit CustomRepr(const std::string& repr) : repr_string(repr) {}

        std::string __repr__() const
        {
            return repr_string;
        }
    };

    py::class_<CustomRepr>(m, "CustomRepr")
    .def(py::init<const std::string&>())
    .def("__repr__", &CustomRepr::__repr__);

    m.def(
        "kw_lb_func0",
    [](const CustomRepr&) {},
    py::arg("custom") = CustomRepr("  array([[A, B], [C, D]])  "));
    m.def(
        "kw_lb_func1",
    [](const CustomRepr&) {},
    py::arg("custom") = CustomRepr("  array([[A, B],\n[C, D]])  "));
    m.def(
        "kw_lb_func2",
    [](const CustomRepr&) {},
    py::arg("custom") = CustomRepr("\v\n   array([[A, B], [C, D]])"));
    m.def(
        "kw_lb_func3",
    [](const CustomRepr&) {},
    py::arg("custom") = CustomRepr("array([[A, B], [C, D]])   \f\n"));
    m.def(
        "kw_lb_func4",
    [](const CustomRepr&) {},
    py::arg("custom") = CustomRepr("array([[A, B],\n\f\n[C, D]])"));
    m.def(
        "kw_lb_func5",
    [](const CustomRepr&) {},
    py::arg("custom") = CustomRepr("array([[A, B],\r  [C, D]])"));
    m.def("kw_lb_func6", [](const CustomRepr&) {}, py::arg("custom") = CustomRepr(" \v\t "));
    m.def(
        "kw_lb_func7",
    [](const std::string&) {},
    py::arg("str_arg") = "First line.\n  Second line.");
    m.def("kw_lb_func8", [](const CustomRepr&) {}, py::arg("custom") = CustomRepr(""));

    // test_args_and_kwargs
    m.def("args_function", [](py::args args) -> py::tuple
    {
        PYBIND11_WARNING_PUSH

#ifdef PYBIND11_DETECTED_CLANG_WITH_MISLEADING_CALL_STD_MOVE_EXPLICITLY_WARNING
        PYBIND11_WARNING_DISABLE_CLANG("-Wreturn-std-move")
#endif
        return args;
        PYBIND11_WARNING_POP
    });
    m.def("args_kwargs_function", [](const py::args & args, const py::kwargs & kwargs)
    {
        return py::make_tuple(args, kwargs);
    });

    // test_mixed_args_and_kwargs
    m.def("mixed_plus_args",
          [](int i, double j, const py::args & args)
    {
        return py::make_tuple(i, j, args);
    });
    m.def("mixed_plus_kwargs",
          [](int i, double j, const py::kwargs & kwargs)
    {
        return py::make_tuple(i, j, kwargs);
    });
    auto mixed_plus_both = [](int i, double j, const py::args & args, const py::kwargs & kwargs)
    {
        return py::make_tuple(i, j, args, kwargs);
    };
    m.def("mixed_plus_args_kwargs", mixed_plus_both);

    m.def("mixed_plus_args_kwargs_defaults",
          mixed_plus_both,
          py::arg("i") = 1,
          py::arg("j") = 3.14159);

    m.def(
        "args_kwonly",
        [](int i, double j, const py::args & args, int z)
    {
        return py::make_tuple(i, j, args, z);
    },
    "i"_a,
    "j"_a,
    "z"_a);
    m.def(
        "args_kwonly_kwargs",
        [](int i, double j, const py::args & args, int z, const py::kwargs & kwargs)
    {
        return py::make_tuple(i, j, args, z, kwargs);
    },
    "i"_a,
    "j"_a,
    py::kw_only{},
    "z"_a);
    m.def(
        "args_kwonly_kwargs_defaults",
        [](int i, double j, const py::args & args, int z, const py::kwargs & kwargs)
    {
        return py::make_tuple(i, j, args, z, kwargs);
    },
    "i"_a = 1,
       "j"_a = 3.14159,
       "z"_a = 42);
    m.def(
        "args_kwonly_full_monty",
        [](int h, int i, double j, const py::args & args, int z, const py::kwargs & kwargs)
    {
        return py::make_tuple(h, i, j, args, z, kwargs);
    },
    py::arg() = 1,
    py::arg() = 2,
    py::pos_only{},
    "j"_a = 3.14159,
    "z"_a = 42);

    // test_args_refcount
    // PyPy needs a garbage collection to get the reference count values to match CPython's behaviour
    // PyPy uses the top few bits for REFCNT_FROM_PYPY & REFCNT_FROM_PYPY_LIGHT, so truncate
#ifdef PYPY_VERSION
#    define GC_IF_NEEDED ConstructorStats::gc()
#    define REFCNT(x) (int) Py_REFCNT(x)
#else
#    define GC_IF_NEEDED
#    define REFCNT(x) Py_REFCNT(x)
#endif
    m.def("arg_refcount_h", [](py::handle h)
    {
        GC_IF_NEEDED;
        return h.ref_count();
    });
    m.def("arg_refcount_h", [](py::handle h, py::handle, py::handle)
    {
        GC_IF_NEEDED;
        return h.ref_count();
    });
    m.def("arg_refcount_o", [](const py::object & o)
    {
        GC_IF_NEEDED;
        return o.ref_count();
    });
    m.def("args_refcount", [](py::args a)
    {
        GC_IF_NEEDED;
        py::tuple t(a.size());

        for (size_t i = 0; i < a.size(); i++)
        {
            // Use raw Python API here to avoid an extra, intermediate incref on the tuple item:
            t[i] = REFCNT(PyTuple_GET_ITEM(a.ptr(), static_cast<py::ssize_t>(i)));
        }

        return t;
    });
    m.def("mixed_args_refcount", [](const py::object & o, py::args a)
    {
        GC_IF_NEEDED;
        py::tuple t(a.size() + 1);
        t[0] = o.ref_count();

        for (size_t i = 0; i < a.size(); i++)
        {
            // Use raw Python API here to avoid an extra, intermediate incref on the tuple item:
            t[i + 1] = REFCNT(PyTuple_GET_ITEM(a.ptr(), static_cast<py::ssize_t>(i)));
        }

        return t;
    });

    // pybind11 won't allow these to be bound: args and kwargs, if present, must be at the end.
    // Uncomment these to test that the static_assert is indeed working:
    //    m.def("bad_args1", [](py::args, int) {});
    //    m.def("bad_args2", [](py::kwargs, int) {});
    //    m.def("bad_args3", [](py::kwargs, py::args) {});
    //    m.def("bad_args4", [](py::args, int, py::kwargs) {});
    //    m.def("bad_args5", [](py::args, py::kwargs, int) {});
    //    m.def("bad_args6", [](py::args, py::args) {});
    //    m.def("bad_args7", [](py::kwargs, py::kwargs) {});

    // test_keyword_only_args
    m.def(
        "kw_only_all",
        [](int i, int j)
    {
        return py::make_tuple(i, j);
    },
    py::kw_only(),
    py::arg("i"),
    py::arg("j"));
    m.def(
        "kw_only_some",
        [](int i, int j, int k)
    {
        return py::make_tuple(i, j, k);
    },
    py::arg(),
    py::kw_only(),
    py::arg("j"),
    py::arg("k"));
    m.def(
        "kw_only_with_defaults",
        [](int i, int j, int k, int z)
    {
        return py::make_tuple(i, j, k, z);
    },
    py::arg() = 3,
    "j"_a = 4,
    py::kw_only(),
    "k"_a = 5,
    "z"_a);
    m.def(
        "kw_only_mixed",
        [](int i, int j)
    {
        return py::make_tuple(i, j);
    },
    "i"_a,
    py::kw_only(),
    "j"_a);
    m.def(
        "kw_only_plus_more",
        [](int i, int j, int k, const py::kwargs & kwargs)
    {
        return py::make_tuple(i, j, k, kwargs);
    },
    py::arg() /* positional */,
    py::arg("j") = -1 /* both */,
    py::kw_only(),
    py::arg("k") /* kw-only */);

    m.def("register_invalid_kw_only", [](py::module_ m)
    {
        m.def(
            "bad_kw_only",
            [](int i, int j)
        {
            return py::make_tuple(i, j);
        },
        py::kw_only(),
        py::arg() /* invalid unnamed argument */,
        "j"_a);
    });

    // test_positional_only_args
    m.def(
        "pos_only_all",
        [](int i, int j)
    {
        return py::make_tuple(i, j);
    },
    py::arg("i"),
    py::arg("j"),
    py::pos_only());
    m.def(
        "pos_only_mix",
        [](int i, int j)
    {
        return py::make_tuple(i, j);
    },
    py::arg("i"),
    py::pos_only(),
    py::arg("j"));
    m.def(
        "pos_kw_only_mix",
        [](int i, int j, int k)
    {
        return py::make_tuple(i, j, k);
    },
    py::arg("i"),
    py::pos_only(),
    py::arg("j"),
    py::kw_only(),
    py::arg("k"));
    m.def(
        "pos_only_def_mix",
        [](int i, int j, int k)
    {
        return py::make_tuple(i, j, k);
    },
    py::arg("i"),
    py::arg("j") = 2,
    py::pos_only(),
    py::arg("k") = 3);

    // These should fail to compile:
#ifdef PYBIND11_NEVER_DEFINED_EVER
    // argument annotations are required when using kw_only
    m.def("bad_kw_only1", [](int) {}, py::kw_only());
    // can't specify both `py::kw_only` and a `py::args` argument
    m.def("bad_kw_only2", [](int i, py::args) {}, py::kw_only(), "i"_a);
#endif

    // test_function_signatures (along with most of the above)
    struct KWClass
    {
        void foo(int, float) {}
    };
    py::class_<KWClass>(m, "KWClass")
    .def("foo0", &KWClass::foo)
    .def("foo1", &KWClass::foo, "x"_a, "y"_a);

    // Make sure a class (not an instance) can be used as a default argument.
    // The return value doesn't matter, only that the module is importable.
    m.def(
        "class_default_argument",
        [](py::object a)
    {
        return py::repr(std::move(a));
    },
    "a"_a = py::module_::import("decimal").attr("Decimal"));

    // Initial implementation of kw_only was broken when used on a method/constructor before any
    // other arguments
    // https://github.com/pybind/pybind11/pull/3402#issuecomment-963341987

    struct first_arg_kw_only {};
    py::class_<first_arg_kw_only>(m, "first_arg_kw_only")
    .def(py::init([](int)
    {
        return first_arg_kw_only();
    }),
    py::kw_only(), // This being before any args was broken
    py::arg("i") = 0)
    .def(
        "method",
    [](first_arg_kw_only&, int, int) {},
    py::kw_only(), // and likewise here
    py::arg("i") = 1,
    py::arg("j") = 2)
    // Closely related: pos_only marker didn't show up properly when it was before any other
    // arguments (although that is fairly useless in practice).
    .def(
        "pos_only",
    [](first_arg_kw_only&, int, int) {},
    py::pos_only{},
    py::arg("i"),
    py::arg("j"));
}