]> git.phdru.name Git - extfs.d.git/blob - xml-ANNOUNCE
XML VFS version 1.1.0: show comment(s) before the root element
[extfs.d.git] / xml-ANNOUNCE
1 XML Virtual FileSystem for Midnight Commander
2
3
4 WHAT IS IT
5    View an XML file in Midnight Commander as a filesystem.
6
7
8 WHAT'S NEW in version 1.1.0 (2013-11-26)
9    Show comment(s) before the root element.
10
11 WHAT'S NEW in version 1.0.1 (2013-11-24)
12    Fixed a few minor bugs.
13
14 WHAT'S NEW in version 1.0.0 (2013-11-23)
15    With lxml.etree-based implementation show only child namespaces
16    (calculated as combined namespaces minus parent's namespaces).
17
18 WHAT'S NEW in version 0.6.0 (2013-11-22)
19    Refactored _list() and attrs2text() to be completely generic.
20
21 WHAT'S NEW in version 0.5.0 (2013-11-19)
22    Added lxml.etree-based implementation.
23
24 WHAT'S NEW in version 0.4.0 (2013-11-19)
25    Added ElementTree-based implementation.
26
27 WHAT'S NEW in version 0.3.0 (2013-11-16)
28    Initial release. Implementation based on minidom.
29
30
31 WHERE TO GET
32    Home page: http://phdru.name/Software/mc/xml.html
33    Download:  http://phdru.name/Software/mc/xml
34     git clone http://git.phdru.name/extfs.d.git
35      git clone git://git.phdru.name/extfs.d.git
36
37    Installation instructions: http://phdru.name/Software/mc/INSTALL.html
38
39
40 The VFS represents tags as directories; the directories are numbered to
41 distinguish tags with the same name; numbering also helps to sort tags by their
42 order in XML instead of sorting them by name. Attributes, text nodes and
43 comments are represented as text files; attributes are shown in a file named
44 "attributes", attributes are listed in the file as name=value lines (I
45 deliberately ignore a small chance of newline characters in values); names and
46 values are reencoded to the console encoding. Text nodes and comments are
47 collected in a file named "text", stripped and reencoded. The filesystem is
48 read-only.
49
50 Implementation based on minidom doesn't understand namespaces, it just shows
51 them among other attributes. ElementTree-based implementation doesn't show
52 namespaces at all. Implementation based on lxml.etree shows namespaces in a
53 separate file "namespaces".
54
55 It is useful to have a top-down view on an XML structure but it's especially
56 convenient to extract text values from tags. One can get, for example, a
57 base64-encoded image - just walk down the VFS to the tag's directory and copy
58 its text file to a real file.
59
60 The VFS was inspired by a FUSE xmlfs: https://github.com/halhen/xmlfs
61
62
63 AUTHOR
64    Oleg Broytman <phd@phdru.name>
65
66 COPYRIGHT
67    Copyright (C) 2013 PhiloSoft Design
68
69 LICENSE
70    GPL