| Version: | 2.1 |
|---|---|
| Compatible: | Yotsuba 3.0, Yotsuba 3.1, Yotsuba 4 |
Kotoba is an XML parsing module mainly using CSS selectors level 3. This module is inspired by the well-known jQuery JavaScript library. However, unlink jQuery, Kotoba strictedly follows the working draft of CSS selectors level 3 (W3C proposed recomendation).
DOM element of the document.
name is the name of the node.
Append a node of DOMElement or DataElement as the last child of this node.
Get the children of this node.
If the optional parameter query is not provided, it will return all children. Otherwise, this will works like self.get, except it only looks for the direct descendants with the query.
Recursively get the (text) data of all nodes in list.
Returns as a string where the data from each node and its descendants is concatenated with an empty character.
Get the descendant with the selector (as string or unicode) which is a valid CSS3 selector.
Returns the result as DOMElements.
Get the name of the element
GUID of the vertex
Hash code of the element
Text-friendly representation of the element
Secondary constructor for lazy instantiation or resetting.
See the constructor for the usage.
Check if the object is an instance of this class.
Check if vertex (required, graph.Vertex-based object) is connected with this node.
Instantiate from an instance of XMLNode (in xml.dom.minidom). This is a static method.
Make an edge to the another vertex (required, graph.Vertex-based object).
Get the next node.
If the optional parameter new_reference is provided, the current reference will be replaced.
Get the parent of this node.
If the optional parameter new_reference is provided, the current reference will be replaced.
Get the previous node.
If the optional parameter new_reference is provided, the current reference will be replaced.
Set the name of the element with new_name (as string or unicode).
Group of reference to DOM elements
L.append(object) – append object to end
L.count(value) -> integer – return number of occurrences of value
Recursively get the (text) data of all nodes in list.
Returns as a string where the data from each node and its descendants is concatenated with an empty character.
L.extend(iterable) – extend list by appending elements from the iterable
Get the descendant with the query (as string or unicode) which is a valid CSS3 selector.
Returns the result as DOMElements.
Get the list of all vertices of the other graphs that connecting to this graph. (Make a connected-or-not-connected subgraph from it.)
L.index(value, [start, [stop]]) -> integer – return first index of value. Raises ValueError if the value is not present.
L.insert(index, object) – insert object before index
Check if the object is an instance of this class.
L.pop([index]) -> item – remove and return item at index (default last). Raises IndexError if list is empty or index is out of range.
L.remove(value) – remove first occurrence of value. Raises ValueError if the value is not present.
L.reverse() – reverse IN PLACE
L.sort(cmp=None, key=None, reverse=False) – stable sort IN PLACE; cmp(x, y) -> -1, 0, 1
Data structure representing a data block in an XML document
GUID of the vertex
Secondary constructor for lazy instantiation or resetting.
See the constructor for the usage.
Check if the object is an instance of this class.
Check if vertex (required, graph.Vertex-based object) is connected with this node.
Make an edge to the another vertex (required, graph.Vertex-based object).
XML Parser with Level-3 CSS Selectors
Currently supported selectors:
Get the element from the selector (as string or unicode). If the optional parameter root_node (as DOMElement) is given, Kotoba will use the given node as the starting point instead of the default one.
Get the root element.
Read the data (strictly well-formatted XML or Kotoba-compatible) from the source.
Source can be a file name, XML-formatted string or DOMElement (Yotsuba 3’s).
Exception for failing a series of assertions when Kotoba tries to determine whether Kotoba requires to proceed the current iteration. If this error is thrown, it is definitely a bug.
Exception when Kotaba cannot create a graph from the source. See the documentation for xml.dom.minidom (Python’s built-in module) for more information on the supported formats.
Exception for invalid selector. See the W3C document on level-3 CSS selector and the documentation of what kotoba.Kotoba supports.
Exception for error during iteration. This is a critical error.
Exception for invalid source when Kotoba reads the source. The source may be neither supported data type (string or kotoba.DOMElement) nor existed file.