13.7.3 Il minidom e lo standard DOM

Il modulo xml.dom.minidom è essenzialmente un'implementazione compatibile con il DOM 1.0 con alcune estensioni DOM 2 (in primo luogo le estensioni sullo spazio dei nomi).

L'uso dell'interfaccia DOM all'interno di Python è diretta. Si applicano le seguenti regole:

Le interfacce sono accessibili attraverso istanze di oggetti. Le applicazioni non devono istanziare le classi; devono usare le funzioni di creazione disponibili nell'oggetto Document. Le interfacce derivate supportano tutte le operazioni (e gli attributi) dell'interfaccia di base, più alcune nuove operazioni.
Le operazioni vengono usate come metodi. Finché il DOM usa solo parametri in (NdT: in ingresso), gli argomenti vengono passati nel normale ordine (da sinistra a destra). Non ci sono argomenti facoltativi. Operazioni nulle (NdT: void) restituiscono None.
Gli attributi IDL si mappano con gli attributi di istanza. Per compatibilità con lo schema di mappatura del linguaggio OMG IDL per Python, un attributo foo diviene accessibile solo attraverso il metodo accessorio _get_foo() e _set_foo(). Gli attributi in sola lettura non devono essere cambiati; questo non è permesso durante l'esecuzione.
Il tipo intero corto, intero senza segno, long senza segno e booleano, mappano tutti ad oggetti interi di Python.
Il tipo DOMString viene mappato alle stringhe Python. xml.dom.minidom supporta sia byte che stringhe Unicode, ma normalmente produce stringhe Unicode. I valori del tipo DOMString possono avere come valore anche None, dove è permesso che IDL abbia valore null dalle specifiche DOM del W3C.
dichiarazioni di costanti const corrispondono a variabili nei loro rispettivi spazi (per esempio xml.dom.minidom.Node.PROCESSING_INSTRUCTION_NODE); essi non devono essere cambiati.
Le eccezioni DOMException non vengono attualmente supportate in xml.dom.minidom. Al loro posto, xml.dom.minidom utilizza le eccezioni standard di Python TypeError e AttributeError.
Gli oggetti NodeList vengono implementati utilizzando il tipo lista built-in di Python. A partire dalla versione 2.3 di Python, questi oggetti forniscono l'interfaccia definita nella specifica DOM, ma con le versioni più vecchie di Python non supportano le API ufficiali. Sono, comunque, molto più ``Pythoniche'' che l'interfaccia definita nelle raccomandazioni W3C.

Le seguenti interfacce non possiedono un'implementazione in xml.dom.minidom:

DOMTimeStamp
DocumentType (aggiunto in Python 2.1)
DOMImplementation (aggiunto in Python 2.1)
CharacterData
CDATASection
Notation
Entity
EntityReference
DocumentFragment

La maggior parte di queste riflettono le informazioni nel documento XML che non sono generalmente utili alla maggior parte degli utenti di DOM.

Vedete Circa questo documento... per informazioni su modifiche e suggerimenti.