awesome/common/markup.c

/*
 * markup.c - markup functions
 *
 * Copyright © 2008 Julien Danjou <julien@danjou.info>
 *
 * This program 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 2 of the License, or
 * (at your option) any later version.
 *
 * This program 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.,
 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 */

/* asprintf */
#define _GNU_SOURCE

#include <glib.h>

#include <stdio.h>
#include <string.h>

#include "common/markup.h"

/** Callback to invoke when the opening tag of an element is seen.
 * Here is just copies element elements we do not care about, and copies
 * values we care.
 * \param context the context of GMarkup
 * \param element_name element name
 * \param attribute_names array of attribute names
 * \param attribute_values array of attribute values
 * \param user_data pointer to user data, here a markup_parser_data_t pointer
 * \param error a GError
 */
static void
markup_parse_start_element(GMarkupParseContext *context __attribute__ ((unused)),
                           const gchar *element_name,
                           const gchar **attribute_names,
                           const gchar **attribute_values,
                           gpointer user_data,
                           GError **error __attribute__ ((unused)))
{
    markup_parser_data_t *p = (markup_parser_data_t *) user_data;
    char *newtext;
    int i, j;
    ssize_t len;

    for(i = 0; p->elements[i]; i++)
        if(!a_strcmp(element_name, p->elements[i]))
        {
            for(j = 0; attribute_names[j]; j++);
            p->attribute_names[i] = p_new(char *, j);
            p->attribute_values[i] = p_new(char *, j);

            for(j = 0; attribute_names[j]; j++)
            {
                p->attribute_names[i][j] = a_strdup(attribute_names[j]);
                p->attribute_values[i][j] = a_strdup(attribute_values[j]);
            }
            if(p->elements_sub && p->elements_sub[i])
            {
                asprintf(&newtext, "%s%s", NONULL(p->text), p->elements_sub[i]);
                p_delete(&p->text);
                p->text = newtext;
            }
            return;
        }

    if(a_strcmp(element_name, "markup"))
    {
        if(!(len = asprintf(&newtext, "%s<%s ", NONULL(p->text), element_name)))
            return;
        len++; /* add \0 that asprintf does not return in len */
        for(i = 0; attribute_names[i]; i++)
        {
            len += a_strlen(attribute_names[i]) + a_strlen(attribute_values[i]) + 5;
            p_realloc(&newtext, len);
            a_strcat(newtext, len, attribute_names[i]);
            a_strcat(newtext, len, "=\"");
            a_strcat(newtext, len, attribute_values[i]);
            a_strcat(newtext, len, "\" ");
        }
        p_realloc(&newtext, ++len);
        a_strcat(newtext, len, ">");
        p_delete(&p->text);
        p->text = newtext;
    }
}

/** Callback to invoke when the closing tag of an element is seen. Note that
 * this is also called for empty tags like <empty/>.
 * Here is just copies element elements we do not care about.
 * \param context the context of GMarkup
 * \param element_name element name
 * \param user_data pointer to user data, here a markup_parser_data_t pointer
 * \param error a GError
 */
static void
markup_parse_end_element(GMarkupParseContext *context __attribute__ ((unused)),
                         const gchar *element_name,
                         gpointer user_data,
                         GError **error __attribute__ ((unused)))
{
    markup_parser_data_t *p = (markup_parser_data_t *) user_data;
    char *newtext;
    int i;

    for(i = 0; p->elements[i]; i++)
        if(!a_strcmp(element_name, p->elements[i]))
            return;

    if(a_strcmp(element_name, "markup"))
    {
        asprintf(&newtext, "%s</%s>", p->text, element_name);
        p_delete(&p->text);
        p->text = newtext;
    }
}

/** Callback to invoke when some text is seen (text is always inside an
 * element). Note that the text of an element may be spread over multiple calls
 * of this function. If the G_MARKUP_TREAT_CDATA_AS_TEXT  flag is set, this
 * function is also called for the content of CDATA marked sections.
 * Here it recopies blindly the text in the text attribute of user_data.
 * \param context the context of GMarkup
 * \param text the text
 * \param text_len the text length
 * \param user_data pointer to user data, here a markup_parser_data_t pointer
 * \param error a GError
 */
static void
markup_parse_text(GMarkupParseContext *context __attribute__ ((unused)),
                  const gchar *text,
                  gsize text_len,
                  gpointer user_data,
                  GError **error __attribute__ ((unused)))
{
    markup_parser_data_t *p = (markup_parser_data_t *) user_data;
    ssize_t len, rlen;
    char *esctext;

    len = a_strlen(p->text);
    rlen = len + 1 + text_len;
    p_realloc(&p->text, rlen);
    esctext = g_markup_escape_text(text, text_len);
    a_strncat(p->text, rlen, esctext, a_strlen(esctext));
}

/** Create a markup_parser_data_t structure with elements list.
 * \param elements an array of elements to look for, NULL terminated
 * \param elements_sub an optionnal array of values to substitude to elements, NULL
 *        terminated, or NULL if not needed
 * \param nelem number of elements in the array (without NULL)
 * \return a pointer to an allocated markup_parser_data_t which must be freed
 *         with markup_parser_data_delete()
 */
markup_parser_data_t *
markup_parser_data_new(const char **elements, const char **elements_sub, ssize_t nelem)
{
    markup_parser_data_t *p;

    p = p_new(markup_parser_data_t, 1);

    p->text = p_new(char, 1);
    p->elements = elements;
    p->elements_sub = elements_sub;
    p->attribute_names = p_new(char **, nelem);
    p->attribute_values = p_new(char **, nelem);

    return p;
}

/** Delete a markup_parser_data_t allocated.
 * \param p markup_parser_data_t pointer address
 */
void
markup_parser_data_delete(markup_parser_data_t **p)
{
    int i, j;

    for(i = 0; (*p)->elements[i]; i++)
        if((*p)->attribute_names[i])
        {
            for(j = 0; (*p)->attribute_names[i][j]; j++);
            {
                p_delete(&(*p)->attribute_names[i][j]);
                p_delete(&(*p)->attribute_values[i][j]);
            }
            p_delete(&(*p)->attribute_names[i]);
            p_delete(&(*p)->attribute_values[i]);
        }

    p_delete(&(*p)->text);
    p_delete(p);
}

/** Parse markup defined in data on the string str.
 * \param data a markup_parser_data_t allocated by markup_parser_data_new()
 * \param str a string to parse markup from
 * \param slen str length
 * \return true if success, false otherwise
 */
bool
markup_parse(markup_parser_data_t *data, const char *str, ssize_t slen)
{
    GMarkupParseContext *mkp_ctx;
    GMarkupParser parser =
    {
        /* start_element */
        markup_parse_start_element,
        /* end_element */
        markup_parse_end_element,
        /* text */
        markup_parse_text,
        /* passthrough */
        NULL,
        /* error */
        NULL
    };
    GError *error = NULL;

    mkp_ctx = g_markup_parse_context_new(&parser, 0, data, NULL);

    if(!g_markup_parse_context_parse(mkp_ctx, "<markup>", -1, &error)
       || !g_markup_parse_context_parse(mkp_ctx, str, slen, &error)
       || !g_markup_parse_context_parse(mkp_ctx, "</markup>", -1, &error)
       || !g_markup_parse_context_end_parse(mkp_ctx, &error))
    {
        warn("unable to parse text: %s\n", error->message);
        g_error_free(error);
        return false;
    }

    g_markup_parse_context_free(mkp_ctx);

    return true;
}

// vim: filetype=c:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:encoding=utf-8:textwidth=80