Improve the LIEF Python build system by using pyproject.toml

- It also provides typing info (close #650) - Enhance the test suite - Remove deprecated PE functions
2026-06-08 15:30:44 +00:00 · 2023-02-19 20:19:03 +01:00
parent 047facb618
commit 9da2466609
338 changed files with 8632 additions and 736 deletions
@@ -0,0 +1,76 @@
+/* Copyright 2017 - 2023 R. Thomas
+ * Copyright 2017 - 2023 Quarkslab
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#include <string>
+
+#include "LIEF/MachO/ParserConfig.hpp"
+
+#include "pyMachO.hpp"
+
+namespace LIEF {
+namespace MachO {
+
+template<>
+void create<ParserConfig>(py::module& m) {
+
+  py::class_<ParserConfig>(m, "ParserConfig",
+      R"delim(
+      This class is used to tweak the MachO Parser (:class:`~lief.MachO.Parser`)
+      )delim")
+
+    .def(py::init<>())
+    .def_readwrite("parse_dyld_exports", &ParserConfig::parse_dyld_exports,
+                   "Parse the Dyld export trie")
+
+    .def_readwrite("parse_dyld_bindings", &ParserConfig::parse_dyld_bindings,
+                   "Parse the Dyld binding opcodes")
+
+    .def_readwrite("parse_dyld_rebases", &ParserConfig::parse_dyld_rebases,
+                   "Parse the Dyld rebase opcodes")
+
+    .def_readwrite("fix_from_memory", &ParserConfig::fix_from_memory,
+                   R"delim(
+                   When parsing Mach-O from memory, this option
+                   can be used to *undo* relocations and symbols bindings.
+
+                   When activated, this option requires parse_dyld_bindings
+                   and parse_dyld_rebases to be enabled.
+                   )delim")
+
+    .def("full_dyldinfo", &ParserConfig::full_dyldinfo,
+         R"delim(
+         If ``flag`` is set to ``true``, Exports, Bindings and Rebases opcodes are parsed.
+
+         .. warning::
+
+            Enabling this flag can slow down the parsing
+         )delim",
+         "flag"_a)
+
+    .def_property_readonly_static("deep",
+      [] (py::object /* self */) { return ParserConfig::deep(); },
+      R"delim(
+      Return a parser configuration such as all the objects supported by LIEF are parsed
+      )delim")
+
+    .def_property_readonly_static("quick",
+      [] (py::object /* self */) { return ParserConfig::quick(); },
+      R"delim(
+      Return a configuration to parse the most important MachO structures
+      )delim");
+}
+
+}
+}