Rewritten the whole bitfield management.

8 files changed, 775 insertions, 71 deletions

diff --git a/plugins/pychrysa/arch/vmpa.c b/plugins/pychrysa/arch/vmpa.c
index 10acf35..03434d7 100644
--- a/plugins/pychrysa/arch/vmpa.c
+++ b/plugins/pychrysa/arch/vmpa.c
@@ -186,8 +186,9 @@ static PyObject *py_vmpa_to_str(PyObject *obj)
 
 /******************************************************************************
 *                                                                             *
-*  Paramètres  : obj  = objet Python à tenter de convertir.                   *
-*                addr = structure équivalente pour Chrysalide.                *
+*  Paramètres  : a  = premier object Python à consulter.                      *
+*                b  = second object Python à consulter.                       *
+*                op = type de comparaison menée.                              *
 *                                                                             *
 *  Description : Effectue une comparaison avec un objet Python 'vmpa_t'.      *
 *                                                                             *
@@ -199,7 +200,7 @@ static PyObject *py_vmpa_to_str(PyObject *obj)
 
 static PyObject *py_vmpa_richcompare(PyObject *a, PyObject *b, int op)
 {
-    PyObject *result;                       /* Chaîne à retourner          */
+    PyObject *result;                       /* Bilan à retourner           */
     vmpa2t *addr_a;                         /* Première adresse à traiter  */
     vmpa2t addr_b;                          /* Seconde adresse à traiter   */
 
@@ -829,8 +830,9 @@ static PyObject *py_mrange_to_str(PyObject *obj)
 
 /******************************************************************************
 *                                                                             *
-*  Paramètres  : obj  = objet Python à tenter de convertir.                   *
-*                addr = structure équivalente pour Chrysalide.                *
+*  Paramètres  : a  = premier object Python à consulter.                      *
+*                b  = second object Python à consulter.                       *
+*                op = type de comparaison menée.                              *
 *                                                                             *
 *  Description : Effectue une comparaison avec un objet Python 'mrange_t'.    *
 *                                                                             *
@@ -842,7 +844,7 @@ static PyObject *py_mrange_to_str(PyObject *obj)
 
 static PyObject *py_mrange_richcompare(PyObject *a, PyObject *b, int op)
 {
-    PyObject *result;                       /* Chaîne à retourner          */
+    PyObject *result;                       /* Bilan à retourner           */
     mrange_t *range_a;                      /* Premier espace à traiter    */
     mrange_t *range_b;                      /* Second espace à traiter     */
     int status;                             /* Résultat d'une comparaison  */
@@ -854,37 +856,7 @@ static PyObject *py_mrange_richcompare(PyObject *a, PyObject *b, int op)
 
     status = cmp_mrange(range_a, range_b);
 
-    switch (op)
-    {
-        case Py_LT:
-            result = status < 0 ? Py_True : Py_False;
-            break;
-
-        case Py_LE:
-            result = status <= 0 ? Py_True : Py_False;
-            break;
-
-        case Py_EQ:
-            result = status == 0 ? Py_True : Py_False;
-            break;
-
-        case Py_NE:
-            result = status != 0 ? Py_True : Py_False;
-            break;
-
-        case Py_GT:
-            result = status > 0 ? Py_True : Py_False;
-            break;
-
-        case Py_GE:
-            result = status >= 0 ? Py_True : Py_False;
-            break;
-
-        default:
-            result = Py_NotImplemented;
-            break;
-
-    }
+    result = status_to_rich_cmp_state(status, op);
 
     Py_INCREF(result);
 
diff --git a/plugins/pychrysa/common/Makefile.am b/plugins/pychrysa/common/Makefile.am
index 93d92ac..0637229 100644
--- a/plugins/pychrysa/common/Makefile.am
+++ b/plugins/pychrysa/common/Makefile.am
@@ -2,6 +2,7 @@
 noinst_LTLIBRARIES = libpychrysacommon.la
 
 libpychrysacommon_la_SOURCES =			\
+	bits.h bits.c						\
 	fnv1a.h fnv1a.c						\
 	module.h module.c					\
 	pathname.h pathname.c
diff --git a/plugins/pychrysa/common/bits.c b/plugins/pychrysa/common/bits.c
new file mode 100644
index 0000000..33f81c3
--- /dev/null
+++ b/plugins/pychrysa/common/bits.c
@@ -0,0 +1,653 @@
+
+/* Chrysalide - Outil d'analyse de fichiers binaires
+ * bits.c - équivalent Python du fichier "common/bits.c"
+ *
+ * Copyright (C) 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
+ */
+
+
+#include "bits.h"
+
+
+#include "../helpers.h"
+
+
+
+/* Encapsulation d'un champ de bits */
+typedef struct _py_bitfield_t
+{
+    PyObject_HEAD                           /* A laisser en premier        */
+
+    bitfield_t *native;                     /* Champ de bits représenté    */
+
+} py_bitfield_t;
+
+
+
+/* Crée un nouvel objet Python de type 'bitfield_t'. */
+static PyObject *py_bitfield_new(PyTypeObject *, PyObject *, PyObject *);
+
+/* Crée une copie d'un champ de bits classique. */
+static PyObject *py_bitfield_dup(PyObject *, PyObject *);
+
+/* Effectue une opération de type 'and' avec le type 'bitfield'. */
+static PyObject *py_bitfield_nb_and(PyObject *, PyObject *);
+
+/* Effectue une opération de type 'or' avec le type 'bitfield'. */
+static PyObject *py_bitfield_nb_or(PyObject *, PyObject *);
+
+/* Effectue une comparaison avec un objet Python 'bitfield'. */
+static PyObject *py_bitfield_richcompare(PyObject *, PyObject *, int);
+
+/* Bascule à 0 un champ de bits dans son intégralité. */
+static PyObject *py_bitfield_reset_all(PyObject *, PyObject *);
+
+/* Bascule à 1 un champ de bits dans son intégralité. */
+static PyObject *py_bitfield_set_all(PyObject *, PyObject *);
+
+/* Bascule à 0 une partie d'un champ de bits. */
+static PyObject *py_bitfield_reset(PyObject *, PyObject *);
+
+/* Bascule à 1 une partie d'un champ de bits. */
+static PyObject *py_bitfield_set(PyObject *, PyObject *);
+
+/* Détermine si un bit est à 1 dans un champ de bits. */
+static PyObject *py_bitfield_test(PyObject *, PyObject *);
+
+/* Détermine si un ensemble de bits est à 0 dans un champ. */
+static PyObject *py_bitfield_test_none(PyObject *, PyObject *);
+
+/* Détermine si un ensemble de bits est à 1 dans un champ. */
+static PyObject *py_bitfield_test_all(PyObject *, PyObject *);
+
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : type = type de l'objet à instancier.                         *
+*                args = arguments fournis à l'appel.                          *
+*                kwds = arguments de type key=val fournis.                    *
+*                                                                             *
+*  Description : Crée un nouvel objet Python de type 'bitfield_t'.            *
+*                                                                             *
+*  Retour      : Instance Python mise en place.                               *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static PyObject *py_bitfield_new(PyTypeObject *type, PyObject *args, PyObject *kwds)
+{
+    py_bitfield_t *result;                  /* Instance à retourner        */
+    unsigned long length;                   /* Taille du champ à créer     */
+    int state;                              /* Initialisation par défaut   */
+    int ret;                                /* Bilan de lecture des args.  */
+
+    ret = PyArg_ParseTuple(args, "kp", &length, &state);
+    if (!ret) return NULL;
+
+    result = (py_bitfield_t *)type->tp_alloc(type, 0);
+
+    result->native = create_bit_field(length, state);
+
+    return (PyObject *)result;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : self = champ de bits à dupliquer.                            *
+*                args = non utilisé ici.                                      *
+*                                                                             *
+*  Description : Crée une copie d'un champ de bits classique.                 *
+*                                                                             *
+*  Retour      : Champ de bits mis en place.                                  *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static PyObject *py_bitfield_dup(PyObject *self, PyObject *args)
+{
+    PyObject *result;                       /* Instance à retourner        */
+    py_bitfield_t *bf;                      /* Instance à manipuler        */
+
+    bf = (py_bitfield_t *)self;
+
+    result = build_from_internal_bitfield(bf->native);;
+
+    return result;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : o1 = premier élément concerné par l'opération.               *
+*                o2 = second élément concerné par l'opération.                *
+*                                                                             *
+*  Description : Effectue une opération de type 'and' avec le type 'bitfield'.*
+*                                                                             *
+*  Retour      : Résultat de l'opération.                                     *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static PyObject *py_bitfield_nb_and(PyObject *o1, PyObject *o2)
+{
+    PyObject *result;                       /* Résultat à retourner        */
+    int ret;                                /* Bilan de compatibilité      */
+    py_bitfield_t *bf_1;                    /* Instance à manipuler #1     */
+    py_bitfield_t *bf_2;                    /* Instance à manipuler #2     */
+    py_bitfield_t *new;                     /* Nouvelle version en place   */
+
+    ret = PyObject_IsInstance(o2, (PyObject *)get_python_bitfield_type());
+    if (!ret)
+    {
+        result = NULL;
+        goto pbna_done;
+    }
+
+    bf_1 = (py_bitfield_t *)o1;
+    bf_2 = (py_bitfield_t *)o2;
+
+    result = build_from_internal_bitfield(bf_1->native);
+
+    new = (py_bitfield_t *)result;
+
+    and_bit_field(new->native, bf_2->native);
+
+ pbna_done:
+
+    return result;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : o1 = premier élément concerné par l'opération.               *
+*                o2 = second élément concerné par l'opération.                *
+*                                                                             *
+*  Description : Effectue une opération de type 'or' avec le type 'bitfield'. *
+*                                                                             *
+*  Retour      : Résultat de l'opération.                                     *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static PyObject *py_bitfield_nb_or(PyObject *o1, PyObject *o2)
+{
+    PyObject *result;                       /* Résultat à retourner        */
+    int ret;                                /* Bilan de compatibilité      */
+    py_bitfield_t *bf_1;                    /* Instance à manipuler #1     */
+    py_bitfield_t *bf_2;                    /* Instance à manipuler #2     */
+    py_bitfield_t *new;                     /* Nouvelle version en place   */
+
+    ret = PyObject_IsInstance(o2, (PyObject *)get_python_bitfield_type());
+    if (!ret)
+    {
+        result = NULL;
+        goto pbna_done;
+    }
+
+    bf_1 = (py_bitfield_t *)o1;
+    bf_2 = (py_bitfield_t *)o2;
+
+    result = build_from_internal_bitfield(bf_1->native);
+
+    new = (py_bitfield_t *)result;
+
+    or_bit_field(new->native, bf_2->native);
+
+ pbna_done:
+
+    return result;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : a  = premier object Python à consulter.                      *
+*                b  = second object Python à consulter.                       *
+*                op = type de comparaison menée.                              *
+*                                                                             *
+*  Description : Effectue une comparaison avec un objet Python 'bitfield'.    *
+*                                                                             *
+*  Retour      : Bilan de l'opération.                                        *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static PyObject *py_bitfield_richcompare(PyObject *a, PyObject *b, int op)
+{
+    PyObject *result;                       /* Bilan à retourner           */
+    int ret;                                /* Bilan de lecture des args.  */
+    py_bitfield_t *bf_a;                    /* Instance à manipuler #1     */
+    py_bitfield_t *bf_b;                    /* Instance à manipuler #2     */
+    int status;                             /* Résultat d'une comparaison  */
+
+    ret = PyObject_IsInstance(b, (PyObject *)get_python_bitfield_type());
+    if (!ret)
+    {
+        result = Py_NotImplemented;
+        goto cmp_done;
+    }
+
+    bf_a = (py_bitfield_t *)a;
+    bf_b = (py_bitfield_t *)b;
+
+    status = compare_bit_fields(bf_a->native, bf_b->native);
+
+    result = status_to_rich_cmp_state(status, op);
+
+ cmp_done:
+
+    Py_INCREF(result);
+
+    return result;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : self = champ de bits à modifier.                             *
+*                args = non utilisé ici.                                      *
+*                                                                             *
+*  Description : Bascule à 0 un champ de bits dans son intégralité.           *
+*                                                                             *
+*  Retour      : Rien (None).                                                 *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static PyObject *py_bitfield_reset_all(PyObject *self, PyObject *args)
+{
+    py_bitfield_t *bf;                      /* Instance à manipuler        */
+
+    bf = (py_bitfield_t *)self;
+
+    reset_all_in_bit_field(bf->native);
+
+    Py_RETURN_NONE;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : self = champ de bits à modifier.                             *
+*                args = non utilisé ici.                                      *
+*                                                                             *
+*  Description : Bascule à 1 un champ de bits dans son intégralité.           *
+*                                                                             *
+*  Retour      : Rien (None).                                                 *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static PyObject *py_bitfield_set_all(PyObject *self, PyObject *args)
+{
+    py_bitfield_t *bf;                      /* Instance à manipuler        */
+
+    bf = (py_bitfield_t *)self;
+
+    set_all_in_bit_field(bf->native);
+
+    Py_RETURN_NONE;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : self = champ de bits à consulter.                            *
+*                args = arguments fournis pour la conduite de l'opération.    *
+*                                                                             *
+*  Description : Bascule à 0 une partie d'un champ de bits.                   *
+*                                                                             *
+*  Retour      : -                                                            *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static PyObject *py_bitfield_reset(PyObject *self, PyObject *args)
+{
+    unsigned long first;                    /* Indice du premier bit testé */
+    unsigned long count;                    /* Nombre de bits à analyser   */
+    int ret;                                /* Bilan de lecture des args.  */
+    py_bitfield_t *bf;                      /* Instance à manipuler        */
+
+    ret = PyArg_ParseTuple(args, "kk", &first, &count);
+    if (!ret) return NULL;
+
+    bf = (py_bitfield_t *)self;
+
+    reset_in_bit_field(bf->native, first, count);
+
+    Py_RETURN_NONE;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : self = champ de bits à consulter.                            *
+*                args = arguments fournis pour la conduite de l'opération.    *
+*                                                                             *
+*  Description : Bascule à 1 une partie d'un champ de bits.                   *
+*                                                                             *
+*  Retour      : -                                                            *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static PyObject *py_bitfield_set(PyObject *self, PyObject *args)
+{
+    unsigned long first;                    /* Indice du premier bit testé */
+    unsigned long count;                    /* Nombre de bits à analyser   */
+    int ret;                                /* Bilan de lecture des args.  */
+    py_bitfield_t *bf;                      /* Instance à manipuler        */
+
+    ret = PyArg_ParseTuple(args, "kk", &first, &count);
+    if (!ret) return NULL;
+
+    bf = (py_bitfield_t *)self;
+
+    set_in_bit_field(bf->native, first, count);
+
+    Py_RETURN_NONE;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : self = champ de bits à consulter.                            *
+*                args = arguments fournis pour la conduite de l'opération.    *
+*                                                                             *
+*  Description : Détermine si un bit est à 1 dans un champ de bits.           *
+*                                                                             *
+*  Retour      : true si le bit correspondant est à l'état haut.              *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static PyObject *py_bitfield_test(PyObject *self, PyObject *args)
+{
+    PyObject *result;                       /* Bilan à faire remonter      */
+    unsigned long n;                        /* Indice du bit à traiter     */
+    int ret;                                /* Bilan de lecture des args.  */
+    py_bitfield_t *bf;                      /* Instance à manipuler        */
+    bool status;                            /* Bilan d'analyse             */
+
+    ret = PyArg_ParseTuple(args, "k", &n);
+    if (!ret) return NULL;
+
+    bf = (py_bitfield_t *)self;
+
+    status = test_in_bit_field(bf->native, n);
+
+    result = status ? Py_True : Py_False;
+
+    Py_INCREF(result);
+
+    return result;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : self = champ de bits à consulter.                            *
+*                args = arguments fournis pour la conduite de l'opération.    *
+*                                                                             *
+*  Description : Détermine si un ensemble de bits est à 0 dans un champ.      *
+*                                                                             *
+*  Retour      : True si les bits correspondants sont à l'état bas.           *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static PyObject *py_bitfield_test_none(PyObject *self, PyObject *args)
+{
+    PyObject *result;                       /* Bilan à faire remonter      */
+    unsigned long first;                    /* Indice du premier bit testé */
+    unsigned long count;                    /* Nombre de bits à analyser   */
+    int ret;                                /* Bilan de lecture des args.  */
+    py_bitfield_t *bf;                      /* Instance à manipuler        */
+    bool status;                            /* Bilan d'analyse             */
+
+    ret = PyArg_ParseTuple(args, "kk", &first, &count);
+    if (!ret) return NULL;
+
+    bf = (py_bitfield_t *)self;
+
+    status = test_none_in_bit_field(bf->native, first, count);
+
+    result = status ? Py_True : Py_False;
+
+    Py_INCREF(result);
+
+    return result;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : self = champ de bits à consulter.                            *
+*                args = arguments fournis pour la conduite de l'opération.    *
+*                                                                             *
+*  Description : Détermine si un ensemble de bits est à 1 dans un champ.      *
+*                                                                             *
+*  Retour      : True si les bits correspondants sont à l'état haut.          *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static PyObject *py_bitfield_test_all(PyObject *self, PyObject *args)
+{
+    PyObject *result;                       /* Bilan à faire remonter      */
+    unsigned long first;                    /* Indice du premier bit testé */
+    unsigned long count;                    /* Nombre de bits à analyser   */
+    int ret;                                /* Bilan de lecture des args.  */
+    py_bitfield_t *bf;                      /* Instance à manipuler        */
+    bool status;                            /* Bilan d'analyse             */
+
+    ret = PyArg_ParseTuple(args, "kk", &first, &count);
+    if (!ret) return NULL;
+
+    bf = (py_bitfield_t *)self;
+
+    status = test_all_in_bit_field(bf->native, first, count);
+
+    result = status ? Py_True : Py_False;
+
+    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_bitfield_type(void)
+{
+    static PyNumberMethods py_bitfield_nb_proto = {
+
+        .nb_and = py_bitfield_nb_and,
+        .nb_or = py_bitfield_nb_or
+
+    };
+
+    static PyMethodDef py_bitfield_methods[] = {
+        {
+            "dup", py_bitfield_dup,
+            METH_NOARGS,
+            "dup(self, /)\n--\n\nDuplicate a bitfield."
+        },
+        {
+            "reset_all", py_bitfield_reset_all,
+            METH_NOARGS,
+            "reset_all(self, /)\n--\n\nSwitch to 0 all bits in a bitfield."
+        },
+        {
+            "set_all", py_bitfield_set_all,
+            METH_NOARGS,
+            "set_all(self, /)\n--\n\nSwitch to 1 all bits in a bitfield."
+        },
+        {
+            "reset", py_bitfield_reset,
+            METH_VARARGS,
+            "reset(self, first, count, /)\n--\n\nSwitch to 0 a part of bits in a bitfield."
+        },
+        {
+            "set", py_bitfield_set,
+            METH_VARARGS,
+            "set(self, first, count, /)\n--\n\nSwitch to 1 a part of bits in a bitfield."
+        },
+        {
+            "test", py_bitfield_test,
+            METH_VARARGS,
+            "test(self, n, /)\n--\n\nTest if a given bit is set in a bitfield."
+        },
+        {
+            "test_none", py_bitfield_test_none,
+            METH_VARARGS,
+            "test_none(self, first, count, /)\n--\n\nTest a range of bits to 0."
+        },
+        {
+            "test_all", py_bitfield_test_all,
+            METH_VARARGS,
+            "test_all(self, first, count, /)\n--\n\nTest a range of bits to 1."
+        },
+        { NULL }
+    };
+
+    static PyGetSetDef py_bitfield_getseters[] = {
+        { NULL }
+    };
+
+    static PyTypeObject py_bitfield_type = {
+
+        PyVarObject_HEAD_INIT(NULL, 0)
+
+        .tp_name        = "pychrysalide.common.bitfield",
+        .tp_basicsize   = sizeof(py_bitfield_t),
+
+        .tp_as_number   = &py_bitfield_nb_proto,
+
+        .tp_flags       = Py_TPFLAGS_DEFAULT,
+
+        .tp_doc         = "Python object for bitfield_t.",
+
+        .tp_richcompare = py_bitfield_richcompare,
+
+        .tp_methods     = py_bitfield_methods,
+        .tp_getset      = py_bitfield_getseters,
+        .tp_new         = (newfunc)py_bitfield_new
+
+    };
+
+    return &py_bitfield_type;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : module = module dont la définition est à compléter.          *
+*                                                                             *
+*  Description : Prend en charge l'objet 'pychrysalide.common.bitfield'.      *
+*                                                                             *
+*  Retour      : Bilan de l'opération.                                        *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+bool register_python_bitfield(PyObject *module)
+{
+    PyTypeObject *py_bitfield_type;         /* Type Python pour 'bitfield' */
+    int ret;                                /* Bilan d'un appel            */
+
+    py_bitfield_type = get_python_bitfield_type();
+
+    if (PyType_Ready(py_bitfield_type) != 0)
+        return false;
+
+    Py_INCREF(py_bitfield_type);
+    ret = PyModule_AddObject(module, "bitfield", (PyObject *)py_bitfield_type);
+
+    return (ret == 0);
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : field = structure interne à copier en objet Python.          *
+*                                                                             *
+*  Description : Convertit une structure de type 'bitfield' en objet Python.  *
+*                                                                             *
+*  Retour      : Object Python résultant de la conversion opérée.             *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+PyObject *build_from_internal_bitfield(const bitfield_t *field)
+{
+    py_bitfield_t *result;                  /* Instance à retourner        */
+    PyTypeObject *type;                     /* Type à instancier           */
+
+    type = get_python_bitfield_type();
+
+    result = (py_bitfield_t *)type->tp_alloc(type, 0);
+
+    result->native = dup_bit_field(field);
+
+    return (PyObject *)result;
+
+}
diff --git a/plugins/pychrysa/common/bits.h b/plugins/pychrysa/common/bits.h
new file mode 100644
index 0000000..41465ce
--- /dev/null
+++ b/plugins/pychrysa/common/bits.h
@@ -0,0 +1,48 @@
+
+/* Chrysalide - Outil d'analyse de fichiers binaires
+ * bits.h - prototypes pour l'équivalent Python du fichier "common/bits.h"
+ *
+ * Copyright (C) 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_PYCHRYSA_COMMON_BITS_H
+#define _PLUGINS_PYCHRYSA_COMMON_BITS_H
+
+
+#include <Python.h>
+#include <stdbool.h>
+
+
+#include <common/bits.h>
+
+
+
+/* Fournit un accès à une définition de type à diffuser. */
+PyTypeObject *get_python_bitfield_type(void);
+
+/* Prend en charge l'objet 'pychrysalide.common.bitfield'. */
+bool register_python_bitfield(PyObject *);
+
+/* Convertit une structure de type 'bitfield' en objet Python. */
+PyObject *build_from_internal_bitfield(const bitfield_t *);
+
+
+
+#endif  /* _PLUGINS_PYCHRYSA_COMMON_BITS_H */
diff --git a/plugins/pychrysa/common/module.c b/plugins/pychrysa/common/module.c
index cc23631..cc2623a 100644
--- a/plugins/pychrysa/common/module.c
+++ b/plugins/pychrysa/common/module.c
@@ -25,6 +25,7 @@
 #include "module.h"
 
 
+#include "bits.h"
 #include "fnv1a.h"
 #include "pathname.h"
 
@@ -76,6 +77,7 @@ bool add_common_module_to_python_module(PyObject *super)
 
     result = true;
 
+    result &= register_python_bitfield(module);
     result &= register_python_fnv1a(module);
     result &= register_python_pathname(module);
 
diff --git a/plugins/pychrysa/format/symbol.c b/plugins/pychrysa/format/symbol.c
index 53fb9c9..75f226a 100644
--- a/plugins/pychrysa/format/symbol.c
+++ b/plugins/pychrysa/format/symbol.c
@@ -85,8 +85,9 @@ static bool py_binary_symbol_define_constants(PyTypeObject *);
 
 /******************************************************************************
 *                                                                             *
-*  Paramètres  : obj  = objet Python à tenter de convertir.                   *
-*                addr = structure équivalente pour Chrysalide.                *
+*  Paramètres  : a  = premier object Python à consulter.                      *
+*                b  = second object Python à consulter.                       *
+*                op = type de comparaison menée.                              *
 *                                                                             *
 *  Description : Effectue une comparaison avec un objet Python 'BinSymbol'.   *
 *                                                                             *
@@ -98,7 +99,7 @@ static bool py_binary_symbol_define_constants(PyTypeObject *);
 
 static PyObject *py_binary_symbol_richcompare(PyObject *a, PyObject *b, int op)
 {
-    PyObject *result;                       /* Chaîne à retourner          */
+    PyObject *result;                       /* Bilan à retourner           */
     int ret;                                /* Bilan de lecture des args.  */
     const GBinSymbol *sym_a;                /* Premier élément à traiter   */
     const GBinSymbol *sym_b;                /* Second élément à traiter    */
@@ -116,37 +117,7 @@ static PyObject *py_binary_symbol_richcompare(PyObject *a, PyObject *b, int op)
 
     status = g_binary_symbol_cmp(&sym_a, &sym_b);
 
-    switch (op)
-    {
-        case Py_LT:
-            result = status < 0 ? Py_True : Py_False;
-            break;
-
-        case Py_LE:
-            result = status <= 0 ? Py_True : Py_False;
-            break;
-
-        case Py_EQ:
-            result = status == 0 ? Py_True : Py_False;
-            break;
-
-        case Py_NE:
-            result = status != 0 ? Py_True : Py_False;
-            break;
-
-        case Py_GT:
-            result = status > 0 ? Py_True : Py_False;
-            break;
-
-        case Py_GE:
-            result = status >= 0 ? Py_True : Py_False;
-            break;
-
-        default:
-            result = Py_NotImplemented;
-            break;
-
-    }
+    result = status_to_rich_cmp_state(status, op);
 
  cmp_done:
 
diff --git a/plugins/pychrysa/helpers.c b/plugins/pychrysa/helpers.c
index 36d0d76..df1df05 100644
--- a/plugins/pychrysa/helpers.c
+++ b/plugins/pychrysa/helpers.c
@@ -31,6 +31,60 @@
 
 /******************************************************************************
 *                                                                             *
+*  Paramètres  : status = bilan de comparaison à traduire.                    *
+*                op     = type de comparaison menée.                          *
+*                                                                             *
+*  Description : Traduit pour Python le bilan d'une comparaison riche.        *
+*                                                                             *
+*  Retour      : Objet Python à référencer.                                   *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+PyObject *status_to_rich_cmp_state(int status, int op)
+{
+    PyObject *result;                       /* Bilan àretourner            */
+
+    switch (op)
+    {
+        case Py_LT:
+            result = status < 0 ? Py_True : Py_False;
+            break;
+
+        case Py_LE:
+            result = status <= 0 ? Py_True : Py_False;
+            break;
+
+        case Py_EQ:
+            result = status == 0 ? Py_True : Py_False;
+            break;
+
+        case Py_NE:
+            result = status != 0 ? Py_True : Py_False;
+            break;
+
+        case Py_GT:
+            result = status > 0 ? Py_True : Py_False;
+            break;
+
+        case Py_GE:
+            result = status >= 0 ? Py_True : Py_False;
+            break;
+
+        default:
+            result = Py_NotImplemented;
+            break;
+
+    }
+
+    return result;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
 *  Paramètres  : target = propriétaire de la routine visée.                   *
 *                method = désignation de la fonction à appeler.               *
 *                                                                             *
diff --git a/plugins/pychrysa/helpers.h b/plugins/pychrysa/helpers.h
index 3e079b7..950c85b 100644
--- a/plugins/pychrysa/helpers.h
+++ b/plugins/pychrysa/helpers.h
@@ -31,6 +31,9 @@
 
 
 
+/* Traduit pour Python le bilan d'une comparaison riche. */
+PyObject *status_to_rich_cmp_state(int, int);
+
 /* Indique si une routine Python existe ou non. */
 bool has_python_method(PyObject *, const char *);