dtob-sys 0.1.1

Raw FFI bindings to the dtob C library (encoder + decoder).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134

#include "html_rules.h"
#include <strings.h>
#include <string.h>
#include <ctype.h>

/* ------------------------------------------------------------------ */
/*  Void elements (no closing tag)                                     */
/* ------------------------------------------------------------------ */

static const char *void_tags[] = {
    "area", "base", "br", "col", "embed", "hr", "img", "input",
    "link", "meta", "param", "source", "track", "wbr", NULL
};

int html_is_void(const char *tag)
{
    for (int i = 0; void_tags[i]; i++)
        if (strcasecmp(tag, void_tags[i]) == 0) return 1;
    return 0;
}

/* ------------------------------------------------------------------ */
/*  Raw text elements (no entity decoding, read until </tag>)          */
/* ------------------------------------------------------------------ */

int html_is_raw_text(const char *tag)
{
    return strcasecmp(tag, "style") == 0 ||
           strcasecmp(tag, "script") == 0 ||
           strcasecmp(tag, "xmp") == 0;
}

/* ------------------------------------------------------------------ */
/*  Escapable raw text (entities decoded, but no child elements)       */
/* ------------------------------------------------------------------ */

int html_is_escapable_raw_text(const char *tag)
{
    return strcasecmp(tag, "textarea") == 0 ||
           strcasecmp(tag, "title") == 0;
}

/* ------------------------------------------------------------------ */
/*  Implicit closing rules                                             */
/* ------------------------------------------------------------------ */

/* helper: case-insensitive check against a NULL-terminated list */
static int tag_in(const char *tag, const char **list)
{
    for (int i = 0; list[i]; i++)
        if (strcasecmp(tag, list[i]) == 0) return 1;
    return 0;
}

/* Tags that implicitly close <p> */
static const char *p_closers[] = {
    "address", "article", "aside", "blockquote", "details", "dialog",
    "div", "dl", "fieldset", "figcaption", "figure", "footer", "form",
    "h1", "h2", "h3", "h4", "h5", "h6", "header", "hgroup", "hr",
    "main", "menu", "nav", "ol", "p", "pre", "search", "section",
    "table", "ul", NULL
};

int html_implicitly_closes(const char *parent, const char *child)
{
    if (strcasecmp(parent, "p") == 0)
        return tag_in(child, p_closers);

    if (strcasecmp(parent, "li") == 0)
        return strcasecmp(child, "li") == 0;

    if (strcasecmp(parent, "dt") == 0)
        return strcasecmp(child, "dt") == 0 || strcasecmp(child, "dd") == 0;

    if (strcasecmp(parent, "dd") == 0)
        return strcasecmp(child, "dt") == 0 || strcasecmp(child, "dd") == 0;

    if (strcasecmp(parent, "td") == 0)
        return strcasecmp(child, "td") == 0 || strcasecmp(child, "th") == 0 ||
               strcasecmp(child, "tr") == 0;

    if (strcasecmp(parent, "th") == 0)
        return strcasecmp(child, "td") == 0 || strcasecmp(child, "th") == 0 ||
               strcasecmp(child, "tr") == 0;

    if (strcasecmp(parent, "tr") == 0)
        return strcasecmp(child, "tr") == 0;

    if (strcasecmp(parent, "thead") == 0)
        return strcasecmp(child, "tbody") == 0 || strcasecmp(child, "tfoot") == 0;

    if (strcasecmp(parent, "tbody") == 0)
        return strcasecmp(child, "tbody") == 0 || strcasecmp(child, "tfoot") == 0;

    if (strcasecmp(parent, "tfoot") == 0)
        return strcasecmp(child, "tbody") == 0;

    if (strcasecmp(parent, "option") == 0)
        return strcasecmp(child, "option") == 0 || strcasecmp(child, "optgroup") == 0;

    if (strcasecmp(parent, "optgroup") == 0)
        return strcasecmp(child, "optgroup") == 0;

    if (strcasecmp(parent, "rt") == 0)
        return strcasecmp(child, "rt") == 0 || strcasecmp(child, "rp") == 0;

    if (strcasecmp(parent, "rp") == 0)
        return strcasecmp(child, "rt") == 0 || strcasecmp(child, "rp") == 0;

    if (strcasecmp(parent, "caption") == 0) {
        static const char *cap_closers[] = {
            "col", "colgroup", "thead", "tbody", "tfoot", "tr", NULL
        };
        return tag_in(child, cap_closers);
    }

    if (strcasecmp(parent, "colgroup") == 0)
        return strcasecmp(child, "col") != 0 && strcasecmp(child, "template") != 0;

    if (strcasecmp(parent, "head") == 0)
        return strcasecmp(child, "body") == 0;

    return 0;
}

/* ------------------------------------------------------------------ */
/*  Tag name normalization (lowercase in-place)                        */
/* ------------------------------------------------------------------ */

void html_normalize_tag(char *tag, size_t len)
{
    for (size_t i = 0; i < len; i++)
        tag[i] = (char)tolower((unsigned char)tag[i]);
}