XmlFormatter

.

XmlFormatter este o clasa deschisa Python source, care prevede formatare a documentelor XML & nbsp; Acest formatorului diferă de la alții prin manipularea spatiile de un set distnict de norme de formatare (vezi mai jos) - gândirea conținut elemente ca obiecte și conținut mixt, ca text scris. Dar formatare este suspendat pentru elementele marcate ca fiind păstra. S-ar putea găsi cel mai util pentru sarcini care implică corecturi sau prezentari. Utilizarea tipică de multe ori arata ca aceasta ::
de la xmlformatter Formatter import
formatare = Formatter (liniuța = "4")
imprima formatter.format_file ("/ home / pa / doc.xml")
Obiectul Stilul reflectă depozitarea proprietăți obiect. Prin urmare, toate spatiile din jur sunt eliminate, secvențe de spatiile sunt prăbușit ::

& Nbsp; 4.4E + 12
& Nbsp; 5.4E-11
& Nbsp;

În continuare documentul XML formatat de obiect Style ::

& Nbsp; 4.4E + 12
& Nbsp; 5.4E-11

Text Style reflectă stocarea unui text scris. Textul este de așteptat în conținut mixt. Therfore conducere și spatiile trailing sunt puse la nodurile de text în elemente imbricate la incadrand noduri de text. Notă: În cazul în care nu nod de text poate fi găsit, xmlformatter introduce un nod text care conține un singur spațiu din elementul imbricate. Secvențele de spatiile sunt prăbușit la un singur ::
& Nbsp; Es război Einmal und ist nicht mehr ...
Elementele imbricate tratate ca proprietăți obiect, dar spatiile sunt combinate cu noduri de text în loc de a fi îndepărtat :::
& Nbsp; Es război Einmal und ist nicht mehr ...
Ambele stiluri sunt folosite împreună într-un documente XML. Regulile de formatare sunt:
A: spatiile din jur sunt eliminate din conținut elementul
B: spatiile de conducere sunt eliminate din conținut elementul
C: la sfârșit spatiile sunt eliminate din conținut elementul
D: spatiile de conducere în elemente imbricate sunt puse la nod textul precedent (sau se introduce) în cadrul conținutului mixt
E: la sfârșit spatiile din elemente imbricate sunt puse la urmatoarele noduri de text (sau se introduce) în cadrul conținutului mixt
F: secvențe de spatiile (n> 0) se înlocuiesc cu un singur gol "" în elementul și conținut mixt
G: linebreak și liniuță spații albe elemente din cadrul elemente de conținut
Următorul exemplu marchează whitespaces descrise de etichetele lor într-un document XML ::
AAAA
AAAABBBB4.4E + 12CCC AAAA
AAAA BBBBEs DDDDwar Einmal und istEEEE nicht mehrF
FFFFein riesengro & szlig; er DDDDTeddyb & auml; r , F
der a & szlig, FFFFdie MilchEEEE und das Trank BrotFFFF
und als er starb da război erEEEE tot .CCCC AAAA

Următoarele prezinta documentul XML formatat: Toate spatiile înlocuit cu un singur necompletat .:

& Nbsp; 4.4E + 12
& Nbsp; Es război Einmal und ist nicht mehr ein riesengro & szlig; er Teddyb & auml; r , der un & szlig ; muri Milch und das Brot und Trank als er starb da er război tot .
Opțiuni
Formatarea poate fi influențată de o mulțime de parametri, în timp ce construcția de obiect XmlFormatter. Elementele care vor lăsat neformatat sunt prezentate într-o listă de nume de elemente, numit păstra.
& Nbsp; Toate descendenți de elemente conservate sunt lăsate neformatat, de asemenea, .:
& Nbsp; de la formatarea xmlformatter import
& Nbsp; formatorului = xmlformatter.Formatter (conservarea = ["conserva"])
& Nbsp; imprima format.format_file ("/ home / pa / doc.xml")
Crestarea poate fi ridicată prin liniuța (implicit 2). Caracterul crestarea poate fi setat prin indentChar.
de la xmlformatter Formatter import
formatare = Formatter (liniuța = "1", indentChar = " t")
imprima formatter.format_file ("/ home / pa / doc.xml")
Crestarea poate fi suprimată prin setarea comprimat pentru adevărat sau alegerea liniuța = 0 .:
de la xmlformatter Formatter import
formatare = Formatter (comprima = True)
imprima formatter.format_file ("/ home / pa / doc.xml")
Codificarea documentului formatat poate fi setat prin encoding_input. Prin codare implicită este UTF-8 sau cititi din declarația XML. Codificarea de ieșire poate fi setat prin encoding_output. sunt:
de la xmlformatter Formatter import
formatare = Formatter (encoding_input = "ISO-8859-1", encoding_output = "ISO-8859-1")
imprima formatter.format_file ("/ home / pa / doc.xml")
Modalitati
Xmlformatter poate analiza documentelor XML acordate de cale sau șir .:
de la xmlformatter Formatter import
formatare = Formatter ()
# Fișier
imprima formatter.format_file ("/ home / pa / doc.xml")
# String
formatat = formatter.format_string (" document XML ")
xmlformat.py
XmlFormatter include un instrument de linie de comandă, xmlformat.py, pentru ambalarea clasa XmlFormatter. Parametrii sunt denumite ca optiunile ::
xmlformat [--preserve "pre, literal"] [--compress] [--indent num] [fișier --outfile] [--encoding enc] [--outencoding enc] [help]
xmlformat.py poate citi de la stdin, cum ar fi ::
& Nbsp; pisică /home/pa/doc.xml | piton xmlformat.py

Notă
XmlFormatter este construit pe partea de sus a parser expat, și, prin urmare, limitată de expat. XmlFormatter este publicat sub licență de MIT

Cerințe :.

• Python