Function init

api/python/src/pyLIEF.cpp:217–355

void init(nb::module_& m) {
  lief_mod = &m;
  m.attr("__version__")   = nb::str(LIEF_VERSION);
  m.attr("__tag__")       = nb::str(LIEF_TAG);
  m.attr("__commit__")    = nb::str(LIEF_COMMIT);
  m.attr("__is_tagged__") = bool(LIEF_TAGGED);
  m.doc() = "LIEF Python API";

  nb::class_<LIEF::lief_version_t>(m, "lief_version_t")
    .def_rw("major", &LIEF::lief_version_t::major)
    .def_rw("minor", &LIEF::lief_version_t::minor)
    .def_rw("patch", &LIEF::lief_version_t::patch)
    .def_rw("id",    &LIEF::lief_version_t::id)
    .def("__repr__",
      [] (const LIEF::lief_version_t& version) {
        return fmt::format("<lief_version_t: {}>", version.to_string());
      }
    )
    .def("__str__",
      [] (const LIEF::lief_version_t& version) {
         return version.to_string();
      }
    )
  ;


  m.def("disable_leak_warning", [] {
    nb::set_leak_warnings(false);
  }, R"doc(
  Disable nanobind warnings about leaked objects.
  For instance:

  .. code-block:: text

      nanobind: leaked 45 instances!
      nanobind: leaked 25 types!
       - leaked type "lief._lief.FORMATS"
       - ... skipped remainder
      nanobind: leaked 201 functions!
       - leaked function ""
       - leaked function "export_symbol"
       - ... skipped remainder
      nanobind: this is likely caused by a reference counting issue in the binding code.
  )doc"_doc);

  m.def("demangle",
    [] (const std::string& mangled) {
      return LIEF::py::value_or_none(&LIEF::demangle, mangled);
    },
    R"doc(
    Demangle the given input.

    .. warning::

        This function only works with the extended version of LIEF
    )doc"_doc,
    "mangled"_a
  );