1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
#!/usr/bin/env python
import re, sys
import os.path
try:
from lxml import etree
except ImportError:
sys.stderr.write("Please install lxml to run this script.")
sys.exit(1)
url = "http://git.musicpd.org/cgit/cirrus/mpd.git/plain/doc/protocol.xml"
if len(sys.argv) > 1:
url += "?id=release-" + sys.argv[1]
DIR = os.path.dirname(os.path.realpath(__file__))
header_file = os.path.join(DIR, "commands_header.txt")
DEPRECATED_COMMANDS = ["volume"]
with open(header_file, 'r') as f:
print(f.read())
tree = etree.parse(url)
chapter = tree.xpath('/book/chapter/title[text()= "Command reference"]/..')[0]
for section in chapter.xpath("section"):
title = section.xpath("title")[0].text
print(title)
print(len(title) * "-")
paragraphs = []
for paragraph in section.xpath("para"):
etree.strip_tags(paragraph, 'varname', 'command', 'parameter')
text = paragraph.text.rstrip()
paragraphs.append(text)
print("\n".join(paragraphs))
print("")
for entry in section.xpath("variablelist/varlistentry"):
cmd = entry.xpath("term/cmdsynopsis/command")[0].text
if cmd in DEPRECATED_COMMANDS:
continue
subcommand = ""
args = ""
begin_optional = False
first_argument = True
for arg in entry.xpath("term/cmdsynopsis/arg"):
choice = arg.attrib.get("choice", None)
if choice == "opt" and not begin_optional:
begin_optional = True
args += "["
if args != "" and args != "[":
args += ", "
replaceables = arg.xpath("replaceable")
if len(replaceables) > 0:
for replaceable in replaceables:
args += replaceable.text.lower()
elif first_argument:
subcommand = arg.text
else:
args += '"{}"'.format(arg.text)
first_argument = False
if begin_optional:
args += "]"
if subcommand != "":
cmd += "_" + subcommand
print(".. function:: MPDClient." + cmd + "(" + args + ")")
lines = []
for para in entry.xpath("listitem/para"):
etree.strip_tags(para, 'varname', 'command', 'parameter')
t = [t.rstrip() for t in para.xpath("text()")]
lines.append(" ".join(t))
description = "\n".join(lines)
description = re.sub(r':$',r'::', description,flags=re.MULTILINE)
print(description)
print("\n")
for screen in entry.xpath("listitem/screen | listitem/programlisting"):
for line in screen.text.split("\n"):
print(" " + line)
|
