]> git.phdru.name Git - extfs.d.git/blob - xml-ANNOUNCE
Torrent VFS: fix flake8 errors
[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
9 Version 1.1.5 (2015-07-08)
10    Set directories/files date/time to the last modification time of the XML
11 file.
12
13    Fix flake8 errors.
14
15 Version 1.1.4 (2015-03-21)
16    Minor documentation update.
17
18 Version 1.1.3 (2015-03-14)
19    Fix a minor bug in handling namespaces (lxml).
20
21 Version 1.1.2 (2015-01-10)
22    Changed link to installation instructions.
23
24 Version 1.1.1 (2014-07-17)
25    Fix a bug in removing excessive namespaces (lxml).
26
27 Version 1.1.0 (2013-11-26)
28    Show comment(s) before the root element.
29
30 Version 1.0.0 (2013-11-23)
31    With lxml.etree-based implementation show only child namespaces
32    (calculated as combined namespaces minus parent's namespaces).
33
34 Version 0.3.0 (2013-11-16)
35    Initial release. Implementation based on minidom.
36
37
38 WHERE TO GET
39    Home page: http://phdru.name/Software/mc/xml.html
40    Download:  http://phdru.name/Software/mc/xml
41     git clone http://git.phdru.name/extfs.d.git
42     git clone  git://git.phdru.name/extfs.d.git
43
44    Installation instructions: http://phdru.name/Software/mc/INSTALL.html
45
46
47 The VFS represents tags as directories; the directories are numbered to
48 distinguish tags with the same name; numbering also helps to sort tags by their
49 order in XML instead of sorting them by name and prevents name clash when tag
50 names coincide with the names of special files used by XML VFS. Attributes,
51 text nodes and comments are represented as text files; attributes are shown in
52 a file named "attributes", attributes are listed in the file as name=value
53 lines (I deliberately ignore a small chance of newline characters in values);
54 names and values are reencoded to the console encoding. Text nodes and comments
55 are collected in a file named "text", stripped and reencoded. The filesystem is
56 read-only.
57
58 Date/time for all directories/files set to the last modification time of the
59 XML file.
60
61 Implementation based on minidom doesn't understand namespaces, it just shows
62 them among other attributes. ElementTree-based implementation doesn't show
63 namespaces at all. Implementation based on lxml.etree shows namespaces in a
64 separate file "namespaces".
65
66 It is useful to have a top-down view on an XML structure but it's especially
67 convenient to extract text values from tags. One can get, for example, a
68 base64-encoded image - just walk down the VFS to the tag's directory and copy
69 its text file to a real file.
70
71 The VFS was inspired by a FUSE xmlfs: https://github.com/halhen/xmlfs
72
73
74 AUTHOR
75    Oleg Broytman <phd@phdru.name>
76
77 COPYRIGHT
78    Copyright (C) 2013-2015 PhiloSoft Design
79
80 LICENSE
81    GPL