Package lxml :: Module objectify :: Class ObjectifiedElement

[hide private]
[frames] | no frames]

# Class ObjectifiedElement

        object --+
                 |
    etree._Element --+
                     |
     etree.ElementBase --+
                         |
                        ObjectifiedElement

Known Subclasses:
  - ObjectifiedDataElement

Main XML Element class.

Element children are accessed as object attributes. Multiple children with the same name are available through a list index. Example:

    >>> root = XML("<root><c1><c2>0</c2><c2>1</c2></c1></root>")
    >>> second_c2 = root.c1.c2[1]
    >>> print(second_c2.text)
    1

Note that you cannot (and must not) instantiate this class or its subclasses.

Instance Methods | [hide private]

__delattr__(...) x.__delattr__('name') <==> del x.name |

__delitem__(x, y) del x[y] |

__getattr__(...) Return the (first) child with the given tag name. |

__getattribute__(...) x.__getattribute__('name') <==> x.name |

__getitem__(...) Return a sibling, counting from the first child of the parent. |

__iter__(self) Iterate over self and all siblings with the same tag. |

__len__(x) len(x) |

a new object with type S, a subtype of T

__new__(T, S, ...) |

__setattr__(...) x.__setattr__('name', value) <==> x.name = value |

__setitem__(x, i, y) x[i]=y |

__str__(...) str(x) |

addattr(self, tag, value) Add a child value to the element. |

countchildren(self) Return the number of children of this element, regardless of their name. |

descendantpaths(self, prefix=None) Returns a list of object path expressions for all descendants. |

find(self, path) Finds the first matching subelement, by tag name or path. |

findall(self, path) Finds all matching subelements, by tag name or path. |

findtext(self, path, default=None) Finds text for the first matching subelement, by tag name or path. |

getchildren(self) Returns a sequence of all direct children. |

iterfind(self, path) Iterates over all matching subelements, by tag name or path. |

Inherited from `etree.ElementBase`: `__init__`

Inherited from `etree._Element`: `__contains__`, `__copy__`, `__deepcopy__`, `__nonzero__`, `__repr__`, `__reversed__`, `addnext`, `addprevious`, `append`, `clear`, `extend`, `get`, `getiterator`, `getnext`, `getparent`, `getprevious`, `getroottree`, `index`, `insert`, `items`, `iter`, `iterancestors`, `iterchildren`, `iterdescendants`, `itersiblings`, `itertext`, `keys`, `makeelement`, `remove`, `replace`, `set`, `values`, `xpath`

Inherited from `etree._Element` (private): `_init`

Inherited from `object`: `__hash__`, `__reduce__`, `__reduce_ex__`

Properties | [hide private]

| text Text before the first subelement.
Inherited from `etree._Element`: `attrib`, `base`, `nsmap`, `prefix`, `sourceline`, `tag`, `tail` Inherited from `object`: `__class__`

Method Details | [hide private]

### __delattr__(...)

x.__delattr__('name') <==> del x.name

Overrides: object.__delattr__

### __delitem__(x, y)
(Index deletion operator)

del x[y]

Overrides: etree._Element.__delitem__

### __getattr__(...)
(Qualification operator)

Return the (first) child with the given tag name. If no namespace is provided, the child will be looked up in the same one as self.

### __getattribute__(...)

x.__getattribute__('name') <==> x.name

Overrides: object.__getattribute__

### __getitem__(...)
(Indexing operator)

Return a sibling, counting from the first child of the parent. The method behaves like both a dict and a sequence.

- If argument is an integer, returns the sibling at that position.
- If argument is a string, does the same as getattr(). This can be used to provide namespaces for element lookup, or to look up children with special names (`text` etc.).
- If argument is a slice object, returns the matching slice.

Overrides: etree._Element.__getitem__

### __iter__(self)

Iterate over self and all siblings with the same tag.

Overrides: etree._Element.__iter__

### __len__(x)
(Length operator)

len(x)

Overrides: etree._Element.__len__

### __new__(T, S, ...)

Returns: a new object with type S, a subtype of T
Overrides: object.__new__

### __setattr__(...)

x.__setattr__('name', value) <==> x.name = value

Overrides: object.__setattr__

### __setitem__(x, i, y)
(Index assignment operator)

x[i]=y

Overrides: etree._Element.__setitem__

### __str__(...)
(Informal representation operator)

str(x)

Overrides: object.__str__
  (inherited documentation)

### addattr(self, tag, value)

Add a child value to the element.

As opposed to append(), it sets a data value, not an element.

### find(self, path)

Finds the first matching subelement, by tag name or path.

Overrides: etree._Element.find

### findall(self, path)

Finds all matching subelements, by tag name or path.

Overrides: etree._Element.findall

### findtext(self, path, default=None)

Finds text for the first matching subelement, by tag name or path.

Overrides: etree._Element.findtext

### getchildren(self)

Returns a sequence of all direct children. The elements are returned in document order.

Overrides: etree._Element.getchildren

### iterfind(self, path)

Iterates over all matching subelements, by tag name or path.

Overrides: etree._Element.iterfind