From 01c72e2f339f9cda8a8f08748ed591276a7aaa99 Mon Sep 17 00:00:00 2001
From: Cyrille Bagard <nocbos@gmail.com>
Date: Tue, 10 Dec 2024 13:27:25 +0100
Subject: Implement a toString()-like interface.

---
 plugins/pychrysalide/glibext/Makefile.am  |   3 +-
 plugins/pychrysalide/glibext/module.c     |   2 +
 plugins/pychrysalide/glibext/strbuilder.c | 410 ++++++++++++++++++++++++++++++
 plugins/pychrysalide/glibext/strbuilder.h |  45 ++++
 src/glibext/Makefile.am                   |   2 +
 src/glibext/strbuilder-int.h              |  47 ++++
 src/glibext/strbuilder.c                  |  84 ++++++
 src/glibext/strbuilder.h                  |  46 ++++
 tests/glibext/strbuilder.py               |  44 ++++
 9 files changed, 682 insertions(+), 1 deletion(-)
 create mode 100644 plugins/pychrysalide/glibext/strbuilder.c
 create mode 100644 plugins/pychrysalide/glibext/strbuilder.h
 create mode 100644 src/glibext/strbuilder-int.h
 create mode 100644 src/glibext/strbuilder.c
 create mode 100644 src/glibext/strbuilder.h
 create mode 100644 tests/glibext/strbuilder.py

diff --git a/plugins/pychrysalide/glibext/Makefile.am b/plugins/pychrysalide/glibext/Makefile.am
index 69d272a..e9f7c4c 100644
--- a/plugins/pychrysalide/glibext/Makefile.am
+++ b/plugins/pychrysalide/glibext/Makefile.am
@@ -9,7 +9,7 @@ noinst_LTLIBRARIES = libpychrysaglibext.la
 # 	configuration.h configuration.c			\
 # 	linecursor.h linecursor.c				\
 # 	linegen.h linegen.c						\
-# 	module.h module.c						\
+# 	module.h module.c
 
 # if BUILD_GTK_SUPPORT
 
@@ -25,6 +25,7 @@ libpychrysaglibext_la_SOURCES =				\
 	module.h module.c						\
 	portion.h portion.c						\
 	singleton.h singleton.c					\
+	strbuilder.h strbuilder.c				\
 	work.h work.c							\
 	workqueue.h workqueue.c
 
diff --git a/plugins/pychrysalide/glibext/module.c b/plugins/pychrysalide/glibext/module.c
index d913d92..77e0c76 100644
--- a/plugins/pychrysalide/glibext/module.c
+++ b/plugins/pychrysalide/glibext/module.c
@@ -42,6 +42,7 @@
 */
 #include "portion.h"
 #include "singleton.h"
+#include "strbuilder.h"
 #include "work.h"
 #include "workqueue.h"
 #include "../helpers.h"
@@ -111,6 +112,7 @@ bool populate_glibext_module(void)
     result = true;
 
     if (result) result = ensure_python_singleton_candidate_is_registered();
+    if (result) result = ensure_python_string_builder_is_registered();
 
     if (result) result = ensure_python_binary_portion_is_registered();
     if (result) result = ensure_python_generic_work_is_registered();
diff --git a/plugins/pychrysalide/glibext/strbuilder.c b/plugins/pychrysalide/glibext/strbuilder.c
new file mode 100644
index 0000000..7c306f4
--- /dev/null
+++ b/plugins/pychrysalide/glibext/strbuilder.c
@@ -0,0 +1,410 @@
+
+/* Chrysalide - Outil d'analyse de fichiers binaires
+ * strbuilder.c - équivalent Python du fichier "glibext/strbuilder.c"
+ *
+ * Copyright (C) 2021 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 "strbuilder.h"
+
+
+#include <assert.h>
+#include <pygobject.h>
+
+
+#include <glibext/strbuilder-int.h>
+#include <plugins/dt.h>
+
+
+#include "../access.h"
+#include "../helpers.h"
+
+
+
+/* Procède à l'initialisation de l'interface d'exportation. */
+static void py_string_builder_interface_init(GStringBuilderInterface *, gpointer *);
+
+/* Exporte une chaîne de caractères à partir d'un objet. */
+bool py_string_builder_to_string_wrapper(const GStringBuilder *, unsigned int, sized_binary_t *);
+
+/* Exporte une chaîne de caractères à partir d'un objet. */
+static PyObject *py_string_builder_to_string(PyObject *, PyObject *);
+
+/* Fournit une représentation de l'objet exportable. */
+static PyObject *py_string_builder_str(PyObject *);
+
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : iface  = interface GLib à initialiser.                       *
+*                unused = adresse non utilisée ici.                           *
+*                                                                             *
+*  Description : Procède à l'initialisation de l'interface d'exportation.     *
+*                                                                             *
+*  Retour      : -                                                            *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static void py_string_builder_interface_init(GStringBuilderInterface *iface, gpointer *unused)
+{
+#define STRING_BUILDER_DOC                                                  \
+    "The StringBuilder class defines a interface for native objects aiming" \
+    " at providing a string representation of themselves.\n"                \
+    "\n"                                                                    \
+    "A typical class declaration for a new implementation looks like:\n"    \
+    "\n"                                                                    \
+    "    class NewImplem(GObject.Object, StringBuilder):\n"                 \
+    "        ...\n"                                                         \
+    "\n"                                                                    \
+    "The following method has to be defined for new implementations:\n"     \
+    "* pychrysalide.glibext.StringBuilder._to_string().\n"
+
+    iface->to_string = py_string_builder_to_string_wrapper;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : builder = objet dont l'instance est exportable.              *
+*                flags   = éventuelles indications pour l'opération.          *
+*                out     = chaîne de caractères mise en place. [OUT]          *
+*                                                                             *
+*  Description : Exporte une chaîne de caractères à partir d'un objet.        *
+*                                                                             *
+*  Retour      : Bilan de l'opération.                                        *
+*                                                                             *
+*  Remarques   : La sortie out est à nettoyer avec exit_sized_binary() après  *
+*                usage.                                                       *
+*                                                                             *
+******************************************************************************/
+
+bool py_string_builder_to_string_wrapper(const GStringBuilder *builder, unsigned int flags, sized_binary_t *out)
+{
+    bool result;                        /* Bilan à retourner               */
+    PyGILState_STATE gstate;                /* Sauvegarde d'environnement  */
+    PyObject *pyobj;                        /* Objet Python concerné       */
+    PyObject *args;                         /* Arguments pour l'appel      */
+    PyObject *pyret;                        /* Bilan de consultation       */
+    const char *utf8;                       /* Chaîne UTF-8 portée         */
+    Py_ssize_t size;                        /* Taille de ces données       */
+
+#define STRING_BUILDER_TO_STRING_WRAPPER PYTHON_WRAPPER_DEF         \
+(                                                                   \
+    _to_string, "$self, /, flags=0",                                \
+    METH_VARARGS,                                                   \
+    "Abstract method providing a string representation for the"     \
+    " object which is used as the default implementation of the"    \
+    " __repr__() method.\n"                                         \
+    "\n"                                                            \
+    "The optional *flags* argument define hints for the operation"  \
+    " (for instance the Intel or AT&T flavor for x86 assembly).\n"  \
+    "\n"                                                            \
+    "The result has to be a string or *None* in case of error."     \
+)
+
+    result = false;
+
+    gstate = PyGILState_Ensure();
+
+    pyobj = pygobject_new(G_OBJECT(builder));
+
+    if (has_python_method(pyobj, "_to_string"))
+    {
+        args = PyTuple_New(1);
+        PyTuple_SetItem(args, 0, PyLong_FromUnsignedLong(flags));
+
+        pyret = run_python_method(pyobj, "_to_string", args);
+
+        if (pyret != NULL && pyret != Py_None)
+        {
+            if (PyUnicode_Check(pyret))
+            {
+                utf8 = PyUnicode_AsUTF8AndSize(pyret, &size);
+
+                if (utf8 != NULL)
+                {
+                    assert(size >= 0);
+
+                    add_to_sized_binary(out, utf8, size);
+                    result = true;
+
+                }
+
+            }
+
+        }
+
+        Py_XDECREF(pyret);
+
+        Py_DECREF(args);
+
+    }
+
+    Py_DECREF(pyobj);
+
+    PyGILState_Release(gstate);
+
+    return result;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : self = objet manipulé ici.                                   *
+*                args = adresse non utilisée ici.                             *
+*                                                                             *
+*  Description : Exporte une chaîne de caractères à partir d'un objet.        *
+*                                                                             *
+*  Retour      : Présentation de l'élément construite ou None.                *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static PyObject *py_string_builder_to_string(PyObject *self, PyObject *args)
+{
+    PyObject *result;                       /* Emplacement à retourner     */
+    unsigned int flags;                     /* Eventuelles indications     */
+    int ret;                                /* Bilan de lecture des args.  */
+    GStringBuilder *builder;                /* Mécanismes natifs           */
+    sized_binary_t out;                     /* Description construite      */
+    bool status;                            /* Bilan de l'opération        */
+
+#define STRING_BUILDER_TO_STRING_METHOD PYTHON_METHOD_DEF           \
+(                                                                   \
+    to_string, "$self, /, flags=0",                                 \
+    METH_VARARGS, py_string_builder,                                \
+    "Provide a string representation for the object which is used"  \
+    " as the default implementation of the __repr__() method.\n"    \
+    "\n"                                                            \
+    "\n"                                                            \
+    "The optional *flags* argument define hints for the operation"  \
+    " (for instance the Intel or AT&T flavor for x86 assembly).\n"  \
+    "\n"                                                            \
+    "The result is a string or *None* in case of error."            \
+)
+
+    flags = 0;
+
+    ret = PyArg_ParseTuple(args, "|I", &flags);
+    if (!ret) return NULL;
+
+    builder = G_STRING_BUILDER(pygobject_get(self));
+
+    init_sized_binary(&out);
+
+    status = g_string_builder_to_string(builder, flags, &out);
+
+    if (status)
+        result = PyUnicode_FromStringAndSize(out.data, out.size);
+
+    else
+    {
+        result = Py_None;
+        Py_INCREF(result);
+    }
+
+    exit_sized_binary(&out);
+
+    return result;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : self = objet manipulé ici.                                   *
+*                                                                             *
+*  Description : Fournit une représentation de l'objet exportable.            *
+*                                                                             *
+*  Retour      : Présentation de l'élément construite ou None.                *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+PyObject *py_string_builder_str(PyObject *self)
+{
+    PyObject *result;                       /* Emplacement à retourner     */
+    GStringBuilder *builder;                /* Mécanismes natifs           */
+    sized_binary_t out;                     /* Description construite      */
+    bool status;                            /* Bilan de l'opération        */
+
+    builder = G_STRING_BUILDER(pygobject_get(self));
+
+    init_sized_binary(&out);
+
+    status = g_string_builder_to_string(builder, 0, &out);
+
+    if (status)
+        result = PyUnicode_FromStringAndSize(out.data, out.size);
+
+    else
+    {
+        result = Py_None;
+        Py_INCREF(result);
+    }
+
+    exit_sized_binary(&out);
+
+    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_string_builder_type(void)
+{
+    static PyMethodDef py_string_builder_methods[] = {
+        STRING_BUILDER_TO_STRING_WRAPPER,
+        STRING_BUILDER_TO_STRING_METHOD,
+        { NULL }
+    };
+
+    static PyGetSetDef py_string_builder_getseters[] = {
+        { NULL }
+    };
+
+    static PyTypeObject py_string_builder_type = {
+
+        PyVarObject_HEAD_INIT(NULL, 0)
+
+        .tp_name        = "pychrysalide.glibext.StringBuilder",
+        .tp_basicsize   = sizeof(PyObject),
+
+        .tp_str         = py_string_builder_str,
+
+        .tp_flags       = Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE,
+
+        .tp_doc         = STRING_BUILDER_DOC,
+
+        .tp_methods     = py_string_builder_methods,
+        .tp_getset      = py_string_builder_getseters
+
+    };
+
+    return &py_string_builder_type;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : -                                                            *
+*                                                                             *
+*  Description : Prend en charge l'objet 'pychrysalide.glibext.StringBuilder'.*
+*                                                                             *
+*  Retour      : Bilan de l'opération.                                        *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+bool ensure_python_string_builder_is_registered(void)
+{
+    PyTypeObject *type;                     /* Type Python 'StringBuilder' */
+    PyObject *module;                       /* Module à recompléter        */
+    PyObject *dict;                         /* Dictionnaire du module      */
+
+    static GInterfaceInfo info = {          /* Paramètres d'inscription    */
+
+        .interface_init = (GInterfaceInitFunc)py_string_builder_interface_init,
+        .interface_finalize = NULL,
+        .interface_data = NULL,
+
+    };
+
+    type = get_python_string_builder_type();
+
+    if (!PyType_HasFeature(type, Py_TPFLAGS_READY))
+    {
+        module = get_access_to_python_module("pychrysalide.glibext");
+
+        dict = PyModule_GetDict(module);
+
+        if (!register_interface_for_pygobject(dict, G_TYPE_STRING_BUILDER, type, &info))
+            return false;
+
+    }
+
+    return true;
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : arg = argument quelconque à tenter de convertir.             *
+*                dst = destination des valeurs récupérées en cas de succès.   *
+*                                                                             *
+*  Description : Tente de convertir en interface d'exportation en chaîne.     *
+*                                                                             *
+*  Retour      : Bilan de l'opération, voire indications supplémentaires.     *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+int convert_to_string_builder(PyObject *arg, void *dst)
+{
+    int result;                             /* Bilan à retourner           */
+
+    result = PyObject_IsInstance(arg, (PyObject *)get_python_string_builder_type());
+
+    switch (result)
+    {
+        case -1:
+            /* L'exception est déjà fixée par Python */
+            result = 0;
+            break;
+
+        case 0:
+            PyErr_SetString(PyExc_TypeError, "unable to convert the provided argument to string builder");
+            break;
+
+        case 1:
+            *((GStringBuilder **)dst) = G_STRING_BUILDER(pygobject_get(arg));
+            break;
+
+        default:
+            assert(false);
+            break;
+
+    }
+
+    return result;
+
+}
diff --git a/plugins/pychrysalide/glibext/strbuilder.h b/plugins/pychrysalide/glibext/strbuilder.h
new file mode 100644
index 0000000..d6aae20
--- /dev/null
+++ b/plugins/pychrysalide/glibext/strbuilder.h
@@ -0,0 +1,45 @@
+
+/* Chrysalide - Outil d'analyse de fichiers binaires
+ * strbuilder.h - prototypes pour l'équivalent Python du fichier "glibext/strbuilder.h"
+ *
+ * Copyright (C) 2021 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_GLIBEXT_STRBUILDER_H
+#define _PLUGINS_PYCHRYSALIDE_GLIBEXT_STRBUILDER_H
+
+
+#include <Python.h>
+#include <stdbool.h>
+
+
+
+/* Fournit un accès à une définition de type à diffuser. */
+PyTypeObject *get_python_string_builder_type(void);
+
+/* Prend en charge l'objet 'pychrysalide.glibext.StringBuilder'. */
+bool ensure_python_string_builder_is_registered(void);
+
+/* Tente de convertir en interface d'exportation en chaîne. */
+int convert_to_string_builder(PyObject *, void *);
+
+
+
+#endif  /* _PLUGINS_PYCHRYSALIDE_GLIBEXT_STRBUILDER_H */
diff --git a/src/glibext/Makefile.am b/src/glibext/Makefile.am
index c6fbf2a..816f033 100644
--- a/src/glibext/Makefile.am
+++ b/src/glibext/Makefile.am
@@ -45,6 +45,8 @@ libglibext_la_SOURCES =						\
 	portion.h portion.c						\
 	singleton-int.h							\
 	singleton.h singleton.c					\
+	strbuilder-int.h						\
+	strbuilder.h strbuilder.c				\
 	work-int.h								\
 	work.h work.c							\
 	workgroup-int.h							\
diff --git a/src/glibext/strbuilder-int.h b/src/glibext/strbuilder-int.h
new file mode 100644
index 0000000..97e0f4e
--- /dev/null
+++ b/src/glibext/strbuilder-int.h
@@ -0,0 +1,47 @@
+
+/* Chrysalide - Outil d'analyse de fichiers binaires
+ * strbuilder-int.h - définitions internes propres aux éléments exportant une chaîne de caractères
+ *
+ * Copyright (C) 2024 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 Chrysalide.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+
+#ifndef _GLIBEXT_STRBUILDER_INT_H
+#define _GLIBEXT_STRBUILDER_INT_H
+
+
+#include "strbuilder.h"
+
+
+
+/* Exporte une chaîne de caractères à partir d'un objet. */
+typedef bool (* strbuilder_to_string_fc) (const GStringBuilder *, unsigned int, sized_binary_t *);
+
+
+/* Instance d'objet visant à être unique (interface) */
+struct _GStringBuilderInterface
+{
+    GTypeInterface base_iface;              /* A laisser en premier        */
+
+    strbuilder_to_string_fc to_string;      /* Conversion en chaîne        */
+
+};
+
+
+
+#endif  /* _GLIBEXT_STRBUILDER_INT_H */
diff --git a/src/glibext/strbuilder.c b/src/glibext/strbuilder.c
new file mode 100644
index 0000000..54a102b
--- /dev/null
+++ b/src/glibext/strbuilder.c
@@ -0,0 +1,84 @@
+
+/* Chrysalide - Outil d'analyse de fichiers binaires
+ * strbuilder.c - exportation d'une chaîne de caractères depuis un élément
+ *
+ * Copyright (C) 2024 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 Foobar.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+
+#include "strbuilder.h"
+
+
+#include "strbuilder-int.h"
+
+
+
+/* Procède à l'initialisation de l'interface d'exportation. */
+static void g_string_builder_default_init(GStringBuilderInterface *);
+
+
+
+/* Détermine le type d'une interface pour la constitution d'objets uniques. */
+G_DEFINE_INTERFACE(GStringBuilder, g_string_builder, G_TYPE_OBJECT)
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : iface = interface GLib à initialiser.                        *
+*                                                                             *
+*  Description : Procède à l'initialisation de l'interface d'exportation.     *
+*                                                                             *
+*  Retour      : -                                                            *
+*                                                                             *
+*  Remarques   : -                                                            *
+*                                                                             *
+******************************************************************************/
+
+static void g_string_builder_default_init(GStringBuilderInterface *iface)
+{
+
+}
+
+
+/******************************************************************************
+*                                                                             *
+*  Paramètres  : builder = objet dont l'instance est exportable.              *
+*                flags   = éventuelles indications pour l'opération.          *
+*                out     = chaîne de caractères mise en place. [OUT]          *
+*                                                                             *
+*  Description : Exporte une chaîne de caractères à partir d'un objet.        *
+*                                                                             *
+*  Retour      : Bilan de l'opération.                                        *
+*                                                                             *
+*  Remarques   : La sortie out est à nettoyer avec exit_sized_binary() après  *
+*                usage.                                                       *
+*                                                                             *
+******************************************************************************/
+
+bool g_string_builder_to_string(const GStringBuilder *builder, unsigned int flags, sized_binary_t *out)
+{
+    bool result;                        /* Bilan à retourner               */
+    GStringBuilderInterface *iface;     /* Interface utilisée              */
+
+    iface = G_STRING_BUILDER_GET_IFACE(builder);
+
+    result = iface->to_string(builder, flags, out);
+
+    return result;
+
+}
diff --git a/src/glibext/strbuilder.h b/src/glibext/strbuilder.h
new file mode 100644
index 0000000..d8d0eaa
--- /dev/null
+++ b/src/glibext/strbuilder.h
@@ -0,0 +1,46 @@
+
+/* Chrysalide - Outil d'analyse de fichiers binaires
+ * strbuilder.h - prototypes pour l'exportation d'une chaîne de caractères depuis un élément
+ *
+ * Copyright (C) 2024 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 Foobar.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+
+#ifndef _GLIBEXT_STRBUILDER_H
+#define _GLIBEXT_STRBUILDER_H
+
+
+#include <stdbool.h>
+
+
+#include "helpers.h"
+#include "../common/szbin.h"
+
+
+
+#define G_TYPE_STRING_BUILDER (g_string_builder_get_type())
+
+DECLARE_INTERFACE(GStringBuilder, g_string_builder, G, STRING_BUILDER);
+
+
+/* Exporte une chaîne de caractères à partir d'un objet. */
+bool g_string_builder_to_string(const GStringBuilder *, unsigned int, sized_binary_t *);
+
+
+
+#endif  /* _GLIBEXT_STRBUILDER_H */
diff --git a/tests/glibext/strbuilder.py b/tests/glibext/strbuilder.py
new file mode 100644
index 0000000..ced405e
--- /dev/null
+++ b/tests/glibext/strbuilder.py
@@ -0,0 +1,44 @@
+
+from chrysacase import ChrysalideTestCase
+from gi.repository import GObject
+from pychrysalide.glibext import StringBuilder
+
+
+class TestStringBuilder(ChrysalideTestCase):
+    """Test cases for pychrysalide.glibext.StringBuilder."""
+
+
+    def testStringBuilderCreation(self):
+        """Create objects with StringBuilder interface."""
+
+        with self.assertRaisesRegex(NotImplementedError, 'StringBuilder can not be constructed'):
+
+            sc = StringBuilder()
+
+        class NewStringBuilderImplem(GObject.Object, StringBuilder):
+            pass
+
+        nsi = NewStringBuilderImplem()
+
+        self.assertIsNotNone(nsi)
+
+
+    def testStringBuilderMethods(self):
+        """Test the StringBuilder methods."""
+
+        class BasicStringBuilderImplem(GObject.Object, StringBuilder):
+
+            def __init__(self, desc):
+                super().__init__()
+                self._desc = desc
+
+            def _to_string(self, flags=0):
+                return self._desc
+
+        desc = 'simple_desc'
+
+        sb = BasicStringBuilderImplem(desc)
+
+        self.assertEqual(sb.to_string(), desc)
+        self.assertEqual(str(sb), desc)
+        self.assertEqual(f'{sb}', desc)
-- 
cgit v0.11.2-87-g4458