/* Implementation of various validation functions for use in dbus-python.

 *

 * Copyright (C) 2006 Collabora Ltd. <http://www.collabora.co.uk/>

 *

 * Permission is hereby granted, free of charge, to any person

 * obtaining a copy of this software and associated documentation

 * files (the "Software"), to deal in the Software without

 * restriction, including without limitation the rights to use, copy,

 * modify, merge, publish, distribute, sublicense, and/or sell copies

 * of the Software, and to permit persons to whom the Software is

 * furnished to do so, subject to the following conditions:

 *

 * The above copyright notice and this permission notice shall be

 * included in all copies or substantial portions of the Software.

 *

 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF

 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT

 * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,

 * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER

 * DEALINGS IN THE SOFTWARE.

 */

#include "dbus_bindings-internal.h"

dbus_bool_t

dbus_py_validate_bus_name(const char *name,

                          dbus_bool_t may_be_unique,

                          dbus_bool_t may_be_not_unique)

{

    dbus_bool_t dot = FALSE;

    dbus_bool_t unique;

    char last;

    const char *ptr;

    if (name[0] == '\0') {

        PyErr_SetString(PyExc_ValueError, "Invalid bus name: "

                        "may not be empty");

        return FALSE;

    }

    unique = (name[0] == ':');

    if (unique && !may_be_unique) {

        PyErr_Format(PyExc_ValueError, "Invalid well-known bus name '%s':"

                     "only unique names may start with ':'", name);

        return FALSE;

    }

    if (!unique && !may_be_not_unique) {

        PyErr_Format(PyExc_ValueError, "Invalid unique bus name '%s': "

                     "unique names must start with ':'", name);

        return FALSE;

    }

    if (strlen(name) > 255) {

        PyErr_Format(PyExc_ValueError, "Invalid bus name '%s': "

                     "too long (> 255 characters)", name);

        return FALSE;

    }

    last = '\0';

    for (ptr = name + (unique ? 1 : 0); *ptr; ptr++) {

        if (*ptr == '.') {

            dot = TRUE;

            if (last == '.') {

                PyErr_Format(PyExc_ValueError, "Invalid bus name '%s': "

                             "contains substring '..'", name);

                return FALSE;

            }

            else if (last == '\0') {

                PyErr_Format(PyExc_ValueError, "Invalid bus name '%s': "

                             "must not start with '.'", name);

                return FALSE;

            }

        }

        else if (*ptr >= '0' && *ptr <= '9') {

            if (!unique) {

                if (last == '.') {

                    PyErr_Format(PyExc_ValueError, "Invalid bus name '%s': "

                                 "a digit may not follow '.' except in a "

                                 "unique name starting with ':'", name);

                    return FALSE;

                }

                else if (last == '\0') {

                    PyErr_Format(PyExc_ValueError, "Invalid bus name '%s': "

                             "must not start with a digit", name);

                    return FALSE;

                }

            }

        }

        else if ((*ptr < 'a' || *ptr > 'z') &&

                 (*ptr < 'A' || *ptr > 'Z') && *ptr != '_' && *ptr != '-') {

            PyErr_Format(PyExc_ValueError, "Invalid bus name '%s': "

                         "contains invalid character '%c'", name, *ptr);

            return FALSE;

        }

        last = *ptr;

    }

    if (last == '.') {

        PyErr_Format(PyExc_ValueError, "Invalid bus name '%s': must "

                        "not end with '.'", name);

        return FALSE;

    }

    if (!dot) {

        PyErr_Format(PyExc_ValueError, "Invalid bus name '%s': must "

                        "contain '.'", name);

        return FALSE;

    }

    return TRUE;

}

dbus_bool_t

dbus_py_validate_member_name(const char *name)

{

    const char *ptr;

    if (name[0] == '\0') {

        PyErr_SetString(PyExc_ValueError, "Invalid member name: may not "

                        "be empty");

        return FALSE;

    }

    if (strlen(name) > 255) {

        PyErr_Format(PyExc_ValueError, "Invalid member name '%s': "

                     "too long (> 255 characters)", name);

        return FALSE;

    }

    for (ptr = name; *ptr; ptr++) {

        if (*ptr >= '0' && *ptr <= '9') {

            if (ptr == name) {

                PyErr_Format(PyExc_ValueError, "Invalid member name '%s': "

                             "must not start with a digit", name);

                return FALSE;

            }

        }

        else if ((*ptr < 'a' || *ptr > 'z') &&

                 (*ptr < 'A' || *ptr > 'Z') && *ptr != '_') {

            PyErr_Format(PyExc_ValueError, "Invalid member name '%s': "

                         "contains invalid character '%c'", name, *ptr);

            return FALSE;

        }

    }

    return TRUE;

}

dbus_bool_t

dbus_py_validate_interface_name(const char *name)

{

    dbus_bool_t dot = FALSE;

    char last;

    const char *ptr;

    if (name[0] == '\0') {

        PyErr_SetString(PyExc_ValueError, "Invalid interface or error name: "

                        "may not be empty");

        return FALSE;

    }

    if (strlen(name) > 255) {

        PyErr_Format(PyExc_ValueError, "Invalid interface or error name '%s': "

                     "too long (> 255 characters)", name);

        return FALSE;

    }

    last = '\0';

    for (ptr = name; *ptr; ptr++) {

        if (*ptr == '.') {

            dot = TRUE;

            if (last == '.') {

                PyErr_Format(PyExc_ValueError, "Invalid interface or "

                             "error name '%s': contains substring '..'", name);

                return FALSE;

            }

            else if (last == '\0') {

                PyErr_Format(PyExc_ValueError, "Invalid interface or error "

                             "name '%s': must not start with '.'", name);

                return FALSE;

            }

        }

        else if (*ptr >= '0' && *ptr <= '9') {

            if (last == '.') {

                PyErr_Format(PyExc_ValueError, "Invalid interface or error "

                             "name '%s': a digit may not follow '.'", name);

                return FALSE;

            }

            else if (last == '\0') {

                PyErr_Format(PyExc_ValueError, "Invalid interface or error "

                             "name '%s': must not start with a digit", name);

                return FALSE;

            }

        }

        else if ((*ptr < 'a' || *ptr > 'z') &&

                 (*ptr < 'A' || *ptr > 'Z') && *ptr != '_') {

            PyErr_Format(PyExc_ValueError, "Invalid interface or error "

                         "name '%s': contains invalid character '%c'",

                         name, *ptr);

            return FALSE;

        }

        last = *ptr;

    }

    if (last == '.') {

        PyErr_Format(PyExc_ValueError, "Invalid interface or error name "

                     "'%s': must not end with '.'", name);

        return FALSE;

    }

    if (!dot) {

        PyErr_Format(PyExc_ValueError, "Invalid interface or error name "

                     "'%s': must contain '.'", name);

        return FALSE;

    }

    return TRUE;

}

dbus_bool_t

dbus_py_validate_object_path(const char *path)

{

    const char *ptr;

    if (path[0] != '/') {

        PyErr_Format(PyExc_ValueError, "Invalid object path '%s': does not "

                     "start with '/'", path);

        return FALSE;

    }

    if (path[1] == '\0') return TRUE;

    for (ptr = path + 1; *ptr; ptr++) {

        if (*ptr == '/') {

            if (ptr[-1] == '/') {

                PyErr_Format(PyExc_ValueError, "Invalid object path '%s': "

                             "contains substring '//'", path);

                return FALSE;

            }

        }

        else if ((*ptr < 'a' || *ptr > 'z') &&

                 (*ptr < 'A' || *ptr > 'Z') &&

                 (*ptr < '0' || *ptr > '9') && *ptr != '_') {

            PyErr_Format(PyExc_ValueError, "Invalid object path '%s': "

                         "contains invalid character '%c'", path, *ptr);

            return FALSE;

        }

    }

    if (ptr[-1] == '/') {

        PyErr_Format(PyExc_ValueError, "Invalid object path '%s': ends "

                     "with '/' and is not just '/'", path);

        return FALSE;

    }

    return TRUE;

}

/* vim:set ft=c cino< sw=4 sts=4 et: */