Defined a new Dex demangler with MUTF-8 support as plugin.

18 files changed, 848 insertions, 5 deletions

diff --git a/plugins/pychrysalide/Makefile.am b/plugins/pychrysalide/Makefile.am
index 0648bb3..3e6f0cd 100644
--- a/plugins/pychrysalide/Makefile.am
+++ b/plugins/pychrysalide/Makefile.am
@@ -20,7 +20,8 @@ pychrysalide_la_LIBADD =				\
 	format/libpychrysaformat.la			\
 	glibext/libpychrysaglibext.la		\
 	gtkext/libpychrysagtkext.la			\
-	gui/libpychrysagui.la
+	gui/libpychrysagui.la				\
+	mangling/libpychrysamangling.la
 
 pychrysalide_la_LDFLAGS = -module -avoid-version \
 	$(LIBPYTHON_LIBS) $(LIBPYGOBJECT_LIBS) \
@@ -33,4 +34,4 @@ AM_CPPFLAGS = $(LIBPYTHON_CFLAGS) $(LIBPYGOBJECT_CFLAGS) $(LIBGTK_CFLAGS) $(LIBX
 
 AM_CFLAGS = $(DEBUG_CFLAGS) $(WARNING_FLAGS) $(COMPLIANCE_FLAGS)
 
-SUBDIRS = analysis arch common core debug format glibext gtkext gui
+SUBDIRS = analysis arch common core debug format glibext gtkext gui mangling
diff --git a/plugins/pychrysalide/analysis/Makefile.am b/plugins/pychrysalide/analysis/Makefile.am
index c1639e7..2379b19 100644
--- a/plugins/pychrysalide/analysis/Makefile.am
+++ b/plugins/pychrysalide/analysis/Makefile.am
@@ -7,7 +7,8 @@ libpychrysaanalysis_la_SOURCES =		\
 	content.h content.c					\
 	loaded.h loaded.c					\
 	module.h module.c					\
-	routine.h routine.c
+	routine.h routine.c					\
+	type.h type.c
 
 libpychrysaanalysis_la_LIBADD =			\
 	contents/libpychrysaanalysiscontents.la	\
diff --git a/plugins/pychrysalide/analysis/module.c b/plugins/pychrysalide/analysis/module.c
index f4a0f5b..c9a9276 100644
--- a/plugins/pychrysalide/analysis/module.c
+++ b/plugins/pychrysalide/analysis/module.c
@@ -33,6 +33,7 @@
 #include "content.h"
 #include "loaded.h"
 #include "routine.h"
+#include "type.h"
 #include "contents/module.h"
 #include "db/module.h"
 #include "../access.h"
@@ -91,6 +92,7 @@ bool add_analysis_module_to_python_module(PyObject *super)
     result &= register_python_instr_block(module);
     //result &= register_python_binary_content(module);
     result &= register_python_binary_routine(module);
+    result &= register_python_data_type(module);
 
     result &= add_analysis_contents_module_to_python_module(module);
     result &= add_analysis_db_module_to_python_module(module);
diff --git a/plugins/pychrysalide/analysis/routine.c b/plugins/pychrysalide/analysis/routine.c
index 37f36a7..d0abd72 100644
--- a/plugins/pychrysalide/analysis/routine.c
+++ b/plugins/pychrysalide/analysis/routine.c
@@ -42,6 +42,9 @@
 
 
 
+/* Décrit la routine fournie sous forme de caractères. */
+static PyObject *py_binary_routine_to_str(PyObject *);
+
 /* Crée un nouvel objet Python de type 'BinRoutine'. */
 static PyObject *py_binary_routine_new(PyTypeObject *, PyObject *, PyObject *);
 
@@ -58,6 +61,37 @@ static PyObject *py_binary_routine_get_basic_blocks(PyObject *, void *);
 
 /******************************************************************************
 *                                                                             *
+*  Paramètres  : self = instance d'une routine version Python à traiter.      *
+*                                                                             *
+*  Description : Décrit la routine fournie sous forme de caractères.          *
+*                                                                             *
+*  Retour      : Chaîne de caractère construite pour l'occasion.              *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static PyObject *py_binary_routine_to_str(PyObject *self)
+{
+    PyObject *result;                       /* Représentation à retourner  */
+    GBinRoutine *routine;                   /* Version native de l'objet   */
+    char *desc;                             /* Description du type         */
+
+    routine = G_BIN_ROUTINE(pygobject_get(self));
+
+    desc = g_binary_routine_to_string(routine);
+
+    result = PyUnicode_FromString(desc);
+
+    free(desc);
+
+    return result;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
 *  Paramètres  : type = type de l'objet à instancier.                         *
 *                args = arguments fournis à l'appel.                          *
 *                kwds = arguments de type key=val fournis.                    *
@@ -250,6 +284,8 @@ PyTypeObject *get_python_binary_routine_type(void)
 
         .tp_name        = "pychrysalide.analysis.BinRoutine",
 
+        .tp_str         = py_binary_routine_to_str,
+
         .tp_flags       = Py_TPFLAGS_DEFAULT,
 
         .tp_doc         = "PyChrysalide binary routine",
diff --git a/plugins/pychrysalide/analysis/type.c b/plugins/pychrysalide/analysis/type.c
new file mode 100644
index 0000000..eea9596
--- /dev/null
+++ b/plugins/pychrysalide/analysis/type.c
@@ -0,0 +1,145 @@
+
+/* Chrysalide - Outil d'analyse de fichiers binaires
+ * type.c - équivalent Python du fichier "analysis/type.c"
+ *
+ * Copyright (C) 2018 Cyrille Bagard
+ *
+ *  This file is part of Chrysalide.
+ *
+ *  Chrysalide is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation; either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  Chrysalide is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+
+#include "type.h"
+
+
+#include <malloc.h>
+#include <pygobject.h>
+
+
+#include <analysis/type.h>
+
+
+#include "../helpers.h"
+
+
+
+/* Décrit le type fourni sous forme de caractères. */
+static PyObject *py_data_type_to_str(PyObject *);
+
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : self = instance d'un type version Python à traiter.          *
+*                                                                             *
+*  Description : Décrit le type fourni sous forme de caractères.              *
+*                                                                             *
+*  Retour      : Chaîne de caractère construite pour l'occasion.              *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static PyObject *py_data_type_to_str(PyObject *self)
+{
+    PyObject *result;                       /* Représentation à retourner  */
+    GDataType *type;                        /* Version native de l'objet   */
+    char *desc;                             /* Description du type         */
+
+    type = G_DATA_TYPE(pygobject_get(self));
+
+    desc = g_data_type_to_string(type);
+
+    result = PyUnicode_FromString(desc);
+
+    free(desc);
+
+    return result;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : -                                                            *
+*                                                                             *
+*  Description : Fournit un accès à une définition de type à diffuser.        *
+*                                                                             *
+*  Retour      : Définition d'objet pour Python.                              *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+PyTypeObject *get_python_data_type_type(void)
+{
+    static PyMethodDef py_data_type_methods[] = {
+        { NULL }
+    };
+
+    static PyGetSetDef py_data_type_getseters[] = {
+        { NULL }
+    };
+
+    static PyTypeObject py_data_type_type = {
+
+        PyVarObject_HEAD_INIT(NULL, 0)
+
+        .tp_name        = "pychrysalide.analysis.DataType",
+
+        .tp_str         = py_data_type_to_str,
+
+        .tp_flags       = Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE,
+
+        .tp_doc         = "PyChrysalide data type",
+
+        .tp_methods     = py_data_type_methods,
+        .tp_getset      = py_data_type_getseters
+
+    };
+
+    return &py_data_type_type;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : module = module dont la définition est à compléter.          *
+*                                                                             *
+*  Description : Prend en charge l'objet 'pychrysalide.analysis.DataType'.    *
+*                                                                             *
+*  Retour      : Bilan de l'opération.                                        *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+bool register_python_data_type(PyObject *module)
+{
+    PyTypeObject *py_data_type_type;        /* Type Python 'DataType'      */
+    PyObject *dict;                         /* Dictionnaire du module      */
+
+    py_data_type_type = get_python_data_type_type();
+
+    dict = PyModule_GetDict(module);
+
+    if (!register_class_for_pygobject(dict, G_TYPE_DATA_TYPE, py_data_type_type, &PyGObject_Type))
+        return false;
+
+    return true;
+
+}
diff --git a/plugins/pychrysalide/analysis/type.h b/plugins/pychrysalide/analysis/type.h
new file mode 100644
index 0000000..b6b8b95
--- /dev/null
+++ b/plugins/pychrysalide/analysis/type.h
@@ -0,0 +1,42 @@
+
+/* Chrysalide - Outil d'analyse de fichiers binaires
+ * type.h - prototypes pour l'équivalent Python du fichier "analysis/type.h"
+ *
+ * Copyright (C) 2018 Cyrille Bagard
+ *
+ *  This file is part of Chrysalide.
+ *
+ *  Chrysalide is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation; either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  Chrysalide is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+
+#ifndef _PLUGINS_PYOIDA_ANALYSIS_TYPE_H
+#define _PLUGINS_PYOIDA_ANALYSIS_TYPE_H
+
+
+#include <Python.h>
+#include <stdbool.h>
+
+
+
+/* Fournit un accès à une définition de type à diffuser. */
+PyTypeObject *get_python_data_type_type(void);
+
+/* Prend en charge l'objet 'pychrysalide.analysis.DataType'. */
+bool register_python_data_type(PyObject *);
+
+
+
+#endif  /* _PLUGINS_PYOIDA_ANALYSIS_TYPE_H */
diff --git a/plugins/pychrysalide/core/Makefile.am b/plugins/pychrysalide/core/Makefile.am
index 71abfa4..d5fdb9f 100644
--- a/plugins/pychrysalide/core/Makefile.am
+++ b/plugins/pychrysalide/core/Makefile.am
@@ -2,6 +2,7 @@
 noinst_LTLIBRARIES = libpychrysacore.la
 
 libpychrysacore_la_SOURCES =			\
+	demanglers.h demanglers.c			\
 	formats.h formats.c					\
 	logs.h logs.c						\
 	module.h module.c					\
diff --git a/plugins/pychrysalide/core/demanglers.c b/plugins/pychrysalide/core/demanglers.c
new file mode 100644
index 0000000..c3c1881
--- /dev/null
+++ b/plugins/pychrysalide/core/demanglers.c
@@ -0,0 +1,160 @@
+
+/* Chrysalide - Outil d'analyse de fichiers binaires
+ * demanglers.c - équivalent Python du fichier "core/demanglers.c"
+ *
+ * Copyright (C) 2018 Cyrille Bagard
+ *
+ *  This file is part of Chrysalide.
+ *
+ *  Chrysalide is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation; either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  Chrysalide is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+
+#include "demanglers.h"
+
+
+#include <pygobject.h>
+
+
+#include <core/demanglers.h>
+
+
+#include "../helpers.h"
+
+
+
+/* Fournit le décodeur de désignations correspondant à un type. */
+static PyObject *py_demanglers_get_for_type(PyObject *, PyObject *);
+
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : self = NULL car méthode statique.                            *
+*                key = nom technique du décodeur recherché.                   *
+*                                                                             *
+*  Description : Fournit le décodeur de désignations correspondant à un type. *
+*                                                                             *
+*  Retour      : Décodeur trouvé et mis en place ou None.                     *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static PyObject *py_demanglers_get_for_type(PyObject *self, PyObject *args)
+{
+    PyObject *result;                       /* Désignation à retourner     */
+    const char *key;                        /* Nom court du format         */
+    int ret;                                /* Bilan de lecture des args.  */
+    GCompDemangler *demangler;              /* Décodeur mis en place       */
+
+    ret = PyArg_ParseTuple(args, "s", &key);
+    if (!ret) return NULL;
+
+    demangler = get_compiler_demangler_for_type(key);
+
+    if (demangler != NULL)
+    {
+        result = pygobject_new(G_OBJECT(demangler));
+        Py_INCREF(result);
+
+        g_object_unref(G_OBJECT(demangler));
+
+    }
+    else
+    {
+        result = Py_None;
+        Py_INCREF(result);
+    }
+
+    return result;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : -                                                            *
+*                                                                             *
+*  Description : Fournit un accès à une définition de type à diffuser.        *
+*                                                                             *
+*  Retour      : Définition d'objet pour Python.                              *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+PyTypeObject *get_python_demanglers_type(void)
+{
+    static PyMethodDef py_demanglers_methods[] = {
+
+        { "get_for_type", py_demanglers_get_for_type,
+          METH_VARARGS | METH_STATIC,
+          "get_for_type(key, /)\n--\n\nCreate a new demangler for a given type of encoding."
+        },
+        { NULL }
+
+    };
+
+    static PyTypeObject py_demanglers_type = {
+
+        PyVarObject_HEAD_INIT(NULL, 0)
+
+        .tp_name = "pychrysalide.core.demanglers",
+        .tp_basicsize = sizeof(PyObject),
+
+        .tp_flags = Py_TPFLAGS_DEFAULT,
+
+        .tp_doc = "Access to the code demanglers",
+
+        .tp_methods = py_demanglers_methods
+
+    };
+
+    return &py_demanglers_type;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : module = module dont la définition est à compléter.          *
+*                                                                             *
+*  Description : Prend en charge l'objet 'pychrysalide.core.demanglers'.      *
+*                                                                             *
+*  Retour      : Bilan de l'opération.                                        *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+bool register_python_demanglers(PyObject *module)
+{
+    PyTypeObject *py_demanglers_type;       /* Type Python de 'demanglers' */
+    int ret;                                /* Bilan d'un appel            */
+
+    py_demanglers_type = get_python_demanglers_type();
+
+    py_demanglers_type->tp_new = PyType_GenericNew;
+
+    if (PyType_Ready(py_demanglers_type) != 0)
+        return false;
+
+    Py_INCREF(py_demanglers_type);
+    ret = PyModule_AddObject(module, "demanglers", (PyObject *)py_demanglers_type);
+
+    return (ret == 0);
+
+}
diff --git a/plugins/pychrysalide/core/demanglers.h b/plugins/pychrysalide/core/demanglers.h
new file mode 100644
index 0000000..b17c4cb
--- /dev/null
+++ b/plugins/pychrysalide/core/demanglers.h
@@ -0,0 +1,42 @@
+
+/* Chrysalide - Outil d'analyse de fichiers binaires
+ * demanglers.h - prototypes pour l'équivalent Python du fichier "core/demanglers.h"
+ *
+ * Copyright (C) 2018 Cyrille Bagard
+ *
+ *  This file is part of Chrysalide.
+ *
+ *  Chrysalide is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation; either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  Chrysalide is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+
+#ifndef _PLUGINS_PYCHRYSALIDE_CORE_DEMANGLERS_H
+#define _PLUGINS_PYCHRYSALIDE_CORE_DEMANGLERS_H
+
+
+#include <Python.h>
+#include <stdbool.h>
+
+
+
+/* Fournit un accès à une définition de type à diffuser. */
+PyTypeObject *get_python_demanglers_type(void);
+
+/* Prend en charge l'objet 'pychrysalide.core.demanglers'. */
+bool register_python_demanglers(PyObject *);
+
+
+
+#endif  /* _PLUGINS_PYCHRYSALIDE_CORE_DEMANGLERS_H */
diff --git a/plugins/pychrysalide/core/formats.c b/plugins/pychrysalide/core/formats.c
index 621277a..4f7c33a 100644
--- a/plugins/pychrysalide/core/formats.c
+++ b/plugins/pychrysalide/core/formats.c
@@ -115,7 +115,7 @@ PyTypeObject *get_python_formats_type(void)
 
         .tp_flags = Py_TPFLAGS_DEFAULT,
 
-        .tp_doc = "Python object for parameters",
+        .tp_doc = "Access to the code formats",
 
         .tp_methods = py_formats_methods
 
diff --git a/plugins/pychrysalide/core/logs.c b/plugins/pychrysalide/core/logs.c
index 8a922c1..6476ed0 100644
--- a/plugins/pychrysalide/core/logs.c
+++ b/plugins/pychrysalide/core/logs.c
@@ -201,7 +201,7 @@ PyTypeObject *get_python_logs_type(void)
 
         .tp_flags = Py_TPFLAGS_DEFAULT,
 
-        .tp_doc = "Python object for logs",
+        .tp_doc = "Access to the core log facilities",
 
         .tp_methods = py_logs_methods,
         .tp_getset  = py_logs_getseters
diff --git a/plugins/pychrysalide/core/module.c b/plugins/pychrysalide/core/module.c
index ff7f828..dd89ea0 100644
--- a/plugins/pychrysalide/core/module.c
+++ b/plugins/pychrysalide/core/module.c
@@ -28,6 +28,7 @@
 #include <assert.h>
 
 
+#include "demanglers.h"
 #include "formats.h"
 #include "logs.h"
 #include "params.h"
@@ -81,6 +82,7 @@ bool add_core_module_to_python_module(PyObject *super)
 
     result = true;
 
+    result &= register_python_demanglers(module);
     result &= register_python_formats(module);
     result &= register_python_logs(module);
     result &= register_python_params(module);
diff --git a/plugins/pychrysalide/mangling/Makefile.am b/plugins/pychrysalide/mangling/Makefile.am
new file mode 100644
index 0000000..e4f5db6
--- /dev/null
+++ b/plugins/pychrysalide/mangling/Makefile.am
@@ -0,0 +1,18 @@
+
+noinst_LTLIBRARIES = libpychrysamangling.la
+
+libpychrysamangling_la_SOURCES =		\
+	demangler.h demangler.c				\
+	module.h module.c
+
+libpychrysamangling_la_LIBADD = 
+
+libpychrysamangling_la_LDFLAGS = 
+
+
+AM_CPPFLAGS = $(LIBGTK_CFLAGS) $(LIBXML_CFLAGS) $(LIBPYTHON_CFLAGS) $(LIBPYGOBJECT_CFLAGS) \
+	-I$(top_srcdir)/src
+
+AM_CFLAGS = $(DEBUG_CFLAGS) $(WARNING_FLAGS) $(COMPLIANCE_FLAGS)
+
+SUBDIRS = 
diff --git a/plugins/pychrysalide/mangling/demangler.c b/plugins/pychrysalide/mangling/demangler.c
new file mode 100644
index 0000000..37935c9
--- /dev/null
+++ b/plugins/pychrysalide/mangling/demangler.c
@@ -0,0 +1,219 @@
+
+/* Chrysalide - Outil d'analyse de fichiers binaires
+ * demangler.c - équivalent Python du fichier "mangling/demangler.c"
+ *
+ * Copyright (C) 2018 Cyrille Bagard
+ *
+ *  This file is part of Chrysalide.
+ *
+ *  Chrysalide is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation; either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  Chrysalide is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+
+#include "demangler.h"
+
+
+#include <pygobject.h>
+
+
+#include <mangling/demangler.h>
+
+
+#include "../helpers.h"
+
+
+
+/* Tente de décoder une chaîne de caractères donnée en type. */
+static PyObject *py_compiler_demangler_decode_type(PyObject *, PyObject *);
+
+/* Tente de décoder une chaîne de caractères donnée en routine. */
+static PyObject *py_compiler_demangler_decode_routine(PyObject *, PyObject *);
+
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : self = décodeur à solliciter pour l'opération.               *
+*                args = chaîne de caractères à décoder.                       *
+*                                                                             *
+*  Description : Tente de décoder une chaîne de caractères donnée en type.    *
+*                                                                             *
+*  Retour      : Instance obtenue ou None en cas d'échec.                     *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static PyObject *py_compiler_demangler_decode_type(PyObject *self, PyObject *args)
+{
+    PyObject *result;                       /* Désignation à retourner     */
+    const char *desc;                       /* Description à traiter       */
+    int ret;                                /* Bilan de lecture des args.  */
+    GCompDemangler *demangler;              /* Décodeur mis en place       */
+    GDataType *type;                        /* Type de données obtenu      */
+
+    ret = PyArg_ParseTuple(args, "s", &desc);
+    if (!ret) return NULL;
+
+    demangler = G_COMP_DEMANGLER(pygobject_get(self));
+
+    type = g_compiler_demangler_decode_type(demangler, desc);
+
+    if (type != NULL)
+    {
+        result = pygobject_new(G_OBJECT(type));
+        Py_INCREF(result);
+
+        g_object_unref(G_OBJECT(type));
+
+    }
+    else
+    {
+        result = Py_None;
+        Py_INCREF(result);
+    }
+
+    return result;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : self = décodeur à solliciter pour l'opération.               *
+*                args = chaîne de caractères à décoder.                       *
+*                                                                             *
+*  Description : Tente de décoder une chaîne de caractères donnée en routine. *
+*                                                                             *
+*  Retour      : Instance obtenue ou None en cas d'échec.                     *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static PyObject *py_compiler_demangler_decode_routine(PyObject *self, PyObject *args)
+{
+    PyObject *result;                       /* Désignation à retourner     */
+    const char *desc;                       /* Description à traiter       */
+    int ret;                                /* Bilan de lecture des args.  */
+    GCompDemangler *demangler;              /* Décodeur mis en place       */
+    GBinRoutine *routine;                   /* Routine obtenue             */
+
+    ret = PyArg_ParseTuple(args, "s", &desc);
+    if (!ret) return NULL;
+
+    demangler = G_COMP_DEMANGLER(pygobject_get(self));
+
+    routine = g_compiler_demangler_decode_routine(demangler, desc);
+
+    if (routine != NULL)
+    {
+        result = pygobject_new(G_OBJECT(routine));
+        Py_INCREF(result);
+
+        g_object_unref(G_OBJECT(routine));
+
+    }
+    else
+    {
+        result = Py_None;
+        Py_INCREF(result);
+    }
+
+    return result;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : -                                                            *
+*                                                                             *
+*  Description : Fournit un accès à une définition de type à diffuser.        *
+*                                                                             *
+*  Retour      : Définition d'objet pour Python.                              *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+PyTypeObject *get_python_compiler_demangler_type(void)
+{
+    static PyMethodDef py_comp_demangler_methods[] = {
+        {
+            "decode_type", py_compiler_demangler_decode_type,
+            METH_VARARGS,
+            "decode_type(self, desc/)\n--\n\nDemangle a type definition from its string mangled description."
+        },
+        {
+            "decode_routine", py_compiler_demangler_decode_routine,
+            METH_VARARGS,
+            "decode_routine(self, desc/)\n--\n\nDemangle a routine definition from its string mangled description."
+        },
+        { NULL }
+    };
+
+    static PyGetSetDef py_comp_demangler_getseters[] = {
+        { NULL }
+    };
+
+    static PyTypeObject py_comp_demangler_type = {
+
+        PyVarObject_HEAD_INIT(NULL, 0)
+
+        .tp_name        = "pychrysalide.mangling.CompDemangler",
+        .tp_basicsize   = sizeof(PyGObject),
+
+        .tp_flags       = Py_TPFLAGS_DEFAULT,
+
+        .tp_doc         = "PyChrysalide generic demangler",
+
+        .tp_methods     = py_comp_demangler_methods,
+        .tp_getset      = py_comp_demangler_getseters,
+
+    };
+
+    return &py_comp_demangler_type;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : module = module dont la définition est à compléter.          *
+*                                                                             *
+*  Description : Prend en charge l'objet 'pychrysalide.mangling.DexDemangler'.*
+*                                                                             *
+*  Retour      : Bilan de l'opération.                                        *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+bool register_python_compiler_demangler(PyObject *module)
+{
+    PyTypeObject *py_comp_demangler_type;   /* Type Python 'CompDemangler' */
+    PyObject *dict;                         /* Dictionnaire du module      */
+
+    py_comp_demangler_type = get_python_compiler_demangler_type();
+
+    dict = PyModule_GetDict(module);
+
+    if (!register_class_for_pygobject(dict, G_TYPE_COMP_DEMANGLER, py_comp_demangler_type, &PyGObject_Type))
+        return false;
+
+    return true;
+
+}
diff --git a/plugins/pychrysalide/mangling/demangler.h b/plugins/pychrysalide/mangling/demangler.h
new file mode 100644
index 0000000..c2094b7
--- /dev/null
+++ b/plugins/pychrysalide/mangling/demangler.h
@@ -0,0 +1,42 @@
+
+/* Chrysalide - Outil d'analyse de fichiers binaires
+ * demangler.h - prototypes pour l'équivalent Python du fichier "mangling/demangler.h"
+ *
+ * Copyright (C) 2018 Cyrille Bagard
+ *
+ *  This file is part of Chrysalide.
+ *
+ *  Chrysalide is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation; either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  Chrysalide is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+
+#ifndef _PLUGINS_PYCHRYSALIDE_MANGLING_DEMANGLER_H
+#define _PLUGINS_PYCHRYSALIDE_MANGLING_DEMANGLER_H
+
+
+#include <Python.h>
+#include <stdbool.h>
+
+
+
+/* Fournit un accès à une définition de type à diffuser. */
+PyTypeObject *get_python_compiler_demangler_type(void);
+
+/* Prend en charge l'objet 'pychrysalide.format.elf.ElfFormat'. */
+bool register_python_compiler_demangler(PyObject *);
+
+
+
+#endif  /* _PLUGINS_DEXBNF_PYTHON_DEMANGLER_H */
diff --git a/plugins/pychrysalide/mangling/module.c b/plugins/pychrysalide/mangling/module.c
new file mode 100644
index 0000000..a462e3e
--- /dev/null
+++ b/plugins/pychrysalide/mangling/module.c
@@ -0,0 +1,91 @@
+
+/* Chrysalide - Outil d'analyse de fichiers binaires
+ * module.c - intégration du répertoire mangling en tant que module
+ *
+ * Copyright (C) 2018 Cyrille Bagard
+ *
+ *  This file is part of Chrysalide.
+ *
+ *  Chrysalide is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation; either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  Chrysalide is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+
+#include "module.h"
+
+
+#include <assert.h>
+
+
+#include "demangler.h"
+#include "../access.h"
+
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : module = module dont la définition est à compléter.          *
+*                                                                             *
+*  Description : Ajoute le module 'mangling' au module Python.                *
+*                                                                             *
+*  Retour      : -                                                            *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+bool add_mangling_module_to_python_module(PyObject *super)
+{
+    bool result;                            /* Bilan à retourner           */
+    PyObject *module;                       /* Sous-module mis en place    */
+    int ret;                                /* Bilan d'un appel            */
+
+    static PyModuleDef py_chrysalide_mangling_module = {
+
+        .m_base = PyModuleDef_HEAD_INIT,
+
+        .m_name = "pychrysalide.mangling",
+        .m_doc = "Python module for Chrysalide.mangling",
+
+        .m_size = -1,
+
+    };
+
+    result = false;
+
+    module = PyModule_Create(&py_chrysalide_mangling_module);
+    if (module == NULL) return false;
+
+    ret = PyState_AddModule(super, &py_chrysalide_mangling_module);
+    if (ret != 0) goto loading_failed;
+
+    ret = _PyImport_FixupBuiltin(module, "pychrysalide.mangling");
+    if (ret != 0) goto loading_failed;
+
+    Py_INCREF(module);
+    ret = PyModule_AddObject(super, "mangling", module);
+    if (ret != 0) goto loading_failed;
+
+    result = register_python_compiler_demangler(module);
+
+    if (result)
+        register_access_to_python_module("pychrysalide.mangling", module);
+
+ loading_failed:
+
+    assert(result);
+
+    return result;
+
+}
diff --git a/plugins/pychrysalide/mangling/module.h b/plugins/pychrysalide/mangling/module.h
new file mode 100644
index 0000000..126aa7e
--- /dev/null
+++ b/plugins/pychrysalide/mangling/module.h
@@ -0,0 +1,39 @@
+
+/* Chrysalide - Outil d'analyse de fichiers binaires
+ * module.h - prototypes pour l'intégration du répertoire mangling en tant que module
+ *
+ * Copyright (C) 2012-2017 Cyrille Bagard
+ *
+ *  This file is part of Chrysalide.
+ *
+ *  Chrysalide is free software; you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation; either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  Chrysalide is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with this program; if not, write to the Free Software
+ *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
+ */
+
+
+#ifndef _PLUGINS_PYCHRYSALIDE_MANGLING_MODULE_H
+#define _PLUGINS_PYCHRYSALIDE_MANGLING_MODULE_H
+
+
+#include <Python.h>
+#include <stdbool.h>
+
+
+
+/* Ajoute le module 'mangling' au module Python. */
+bool add_mangling_module_to_python_module(PyObject *);
+
+
+
+#endif  /* _PLUGINS_PYCHRYSALIDE_MANGLING_MODULE_H */
diff --git a/plugins/pychrysalide/pychrysa.c b/plugins/pychrysalide/pychrysa.c
index 35d14f4..70cce2a 100644
--- a/plugins/pychrysalide/pychrysa.c
+++ b/plugins/pychrysalide/pychrysa.c
@@ -55,6 +55,7 @@
 #include "glibext/module.h"
 #include "gtkext/module.h"
 #include "gui/module.h"
+#include "mangling/module.h"
 
 
 
@@ -403,6 +404,7 @@ PyMODINIT_FUNC PyInit_pychrysalide(void)
     if (status) status = add_debug_module_to_python_module(result);
     if (status) status = add_gtkext_module_to_python_module(result);
     if (status) status = add_gui_module_to_python_module(result);
+    if (status) status = add_mangling_module_to_python_module(result);
 
     if (!status)
     {