sims – Simple schema validation

This module contains classes for a very simple validation model.

Validation is specified like this:

class inner(xsc.Element):
   model = sims.NoElements()

class outer(xsc.Element):
   model = sims.Elements(inner)

With this configuration inner elements may only contain text and outer elements may only contain inner elements. Everything else will issue warnings when parsing or publishing.

exception ll.xist.sims.SIMSWarning

Bases: ll.xist.xsc.Warning

Base class for all warning classes in this module.

exception ll.xist.sims.EmptyElementWithContentWarning

Bases: ll.xist.sims.SIMSWarning

Warning that is issued when an element has content, but it shouldn’t (i.e. model is Empty)

exception ll.xist.sims.WrongElementWarning

Bases: ll.xist.sims.SIMSWarning

Warning that is issued when an element contains another element of a certain type, but shouldn’t.

exception ll.xist.sims.ElementWarning

Bases: ll.xist.sims.SIMSWarning

Warning that is issued when an element contains another element but shouldn’t contain any.

exception ll.xist.sims.IllegalTextWarning

Bases: ll.xist.sims.SIMSWarning

Warning that is issued when an element contains a text node but shouldn’t.

exception ll.xist.sims.AnyWarning

Bases: ll.xist.sims.SIMSWarning

Warning that is issued when an element contains a text node but shouldn’t.

ll.xist.sims.badtext(node)

Return whether node is a text node (i.e. ll.xist.xsc.Text that does not consist of whitespace only).

class ll.xist.sims.Empty

Bases: object

This validator checks that an element has no content.

class ll.xist.sims.Transparent

Bases: object

This validator implements the “transparent” content model of HTML5.

class ll.xist.sims.NoElements

Bases: object

This validator checks that an element does not have child elements from the same namespace.

validate(path)

check that the content of node is valid.

class ll.xist.sims.NoElementsOrText

Bases: object

This validator checks that an element does have neither child elements from the same namespace nor real (i.e. not-whitespace) text nodes.

validate(path)

check that the content of node is valid.

class ll.xist.sims.Elements

Bases: object

This validator checks that an element does have neither child elements from any of the namespaces of those elements specified in the constructor except for those elements itself nor real (i.e. not-whitespace) text nodes.

__init__(*elements)

Every element in elements may be in the content of the node to which this validator is attached. Any other element from one of the namespaces of those elements is invalid. Elements from other namespaces are OK.

validate(path)

check that the content of node is valid.

class ll.xist.sims.ElementsOrText

Bases: ll.xist.sims.Elements

This validator checks that an element doesn’t have child elements from the same namespace except those specified in the constructor.

__init__(*elements)

Every element in elements may be in the content of the node to which this validator is attached. Any other element from one of the namespaces of those elements is invalid. Elements from other namespaces are OK.

validate(path)

Check that the content of node is valid.

class ll.xist.sims.NotElements

Bases: object

This validator checks that an element doesn’t contain any of the specified elements.

__init__(*elements)

Every element in elements may not be in the content of the node to which this validator is attached.

class ll.xist.sims.All

Bases: object

This meta validator checks that all its child validators declare the content of the element to be valid.

class ll.xist.sims.Any

Bases: object

This meta validator checks that at least one of its child validators declares the content of the element to be valid.