Function add_object

include/pybind11/pybind11.h:1690–1698

\rst Adds an object to the module using the given name. Throws if an object with the given name already exists. ``overwrite`` should almost always be false: attempting to overwrite objects that pybind11 has established will, in most cases, break things. \endrst */

        has established will, in most cases, break things.
    \endrst */
    PYBIND11_NOINLINE void add_object(const char *name, handle obj, bool overwrite = false) {
        if (!overwrite && hasattr(*this, name)) {
            pybind11_fail(
                "Error during initialization: multiple incompatible definitions with name \""
                + std::string(name) + "\"");
        }

        PyModule_AddObject(ptr(), name, obj.inc_ref().ptr() /* steals a reference */);
    }

    // DEPRECATED (since PR #5688): Use PyModuleDef directly instead.
    using module_def = PyModuleDef;