mirror of
https://github.com/bluekitchen/btstack.git
synced 2024-12-29 09:26:08 +00:00
343 lines
12 KiB
Python
Executable File
343 lines
12 KiB
Python
Executable File
#!/usr/bin/env python
|
|
import os, sys, getopt, re
|
|
|
|
# Defines the names of example groups. Preserves the order in which the example groups will be parsed.
|
|
list_of_groups = ["Hello World", "GAP", "SDP Queries", "SPP Server", "BNEP/PAN", "HSP", "HFP", "Low Energy", "Dual Mode", "Audio", "HID", "LE Pairing", "Phone Book Access", "Performance", "Testing"]
|
|
|
|
# Defines which examples belong to a group. Example is defined as [example file, example title].
|
|
list_of_examples = {
|
|
"Hello World" : [["led_counter"]],
|
|
"GAP" : [["gap_inquiry"]],
|
|
"SDP Queries" : [["sdp_general_query"],["sdp_bnep_query"]],
|
|
"SPP Server" : [["spp_counter"],["spp_flowcontrol"]],
|
|
"BNEP/PAN" : [["panu_demo"]],
|
|
"HSP" : [["hsp_hs_demo"],["hsp_ag_demo"]],
|
|
"HFP" : [["hfp_hf_demo"],["hfp_ag_demo"]],
|
|
"Low Energy" : [["gap_le_advertisements"],
|
|
["gatt_browser"],
|
|
["le_counter"],
|
|
["le_streamer"]],
|
|
"Dual Mode" : [["spp_and_le_counter"]],
|
|
"Audio" : [["a2dp_sink_demo"],["a2dp_source_demo"]],
|
|
|
|
"HID" : [["hid_keyboard_demo"], ["hid_mouse_demo"], ["hog_keyboard_demo"], ["hog_mouse_demo"]],
|
|
"LE Pairing": [["sm_pairing_central"], ["sm_pairing_peripheral"]],
|
|
"Phone Book Access" : [["pbap_client_demo"]],
|
|
"Performance" : [["le_streamer"], ["le_streamer_client"], ["spp_streamer"], ["spp_streamer_client"]],
|
|
"Testing" : [["dut_mode_classic"]]
|
|
}
|
|
|
|
lst_header = """
|
|
"""
|
|
|
|
lst_ending = """
|
|
"""
|
|
|
|
examples_header = """
|
|
"""
|
|
|
|
example_item = """
|
|
- [EXAMPLE_TITLE](#sec:EXAMPLE_LABELExample): EXAMPLE_DESC.
|
|
"""
|
|
example_section = """
|
|
|
|
## EXAMPLE_TITLE: EXAMPLE_DESC {#sec:EXAMPLE_LABELExample}
|
|
|
|
"""
|
|
example_subsection = """
|
|
### SECTION_TITLE
|
|
"""
|
|
|
|
listing_reference = """[here](#lst:FILE_NAMELISTING_LABEL)
|
|
"""
|
|
|
|
listing_start = """
|
|
|
|
~~~~ {#lst:FILE_NAMELISTING_LABEL .c caption="{LISTING_CAPTION}"}
|
|
|
|
"""
|
|
|
|
listing_ending = """
|
|
~~~~
|
|
|
|
"""
|
|
|
|
def replacePlaceholder(template, title, lable):
|
|
snippet = template.replace("API_TITLE", title).replace("API_LABEL", lable)
|
|
return snippet
|
|
|
|
def latexText(text, ref_prefix):
|
|
if not text:
|
|
return ""
|
|
brief = text.replace(" in the BTstack manual","")
|
|
|
|
refs = re.match('.*(Listing\s+)(\w+).*',brief)
|
|
if refs:
|
|
brief = brief.replace(refs.group(2), "[here](#lst:"+ref_prefix + refs.group(2)+")")
|
|
|
|
return brief
|
|
|
|
def isEmptyCommentLine(line):
|
|
return re.match('(\s*\*\s*)\n',line)
|
|
|
|
def isCommentLine(line):
|
|
return re.match('(\s*\*\s*).*',line)
|
|
|
|
def isEndOfComment(line):
|
|
return re.match('\s*\*/.*', line)
|
|
|
|
def isNewItem(line):
|
|
return re.match('(\s*\*\s*\-\s*)(.*)',line)
|
|
|
|
def isTextTag(line):
|
|
return re.match('.*(@text).*', line)
|
|
|
|
def isItemizeTag(line):
|
|
return re.match("(\s+\*\s+)(-\s)(.*)", line)
|
|
|
|
def processTextLine(line, ref_prefix):
|
|
if isTextTag(line):
|
|
text_line_parts = re.match(".*(@text)(.*)", line)
|
|
return " " + latexText(text_line_parts.group(2), ref_prefix)
|
|
|
|
if isItemizeTag(line):
|
|
text_line_parts = re.match("(\s*\*\s*\-\s*)(.*)", line)
|
|
return "\n- " + latexText(text_line_parts.group(2), ref_prefix)
|
|
|
|
text_line_parts = re.match("(\s+\*\s+)(.*)", line)
|
|
if text_line_parts:
|
|
return " " + latexText(text_line_parts.group(2), ref_prefix)
|
|
return ""
|
|
|
|
def getExampleTitle(example_path):
|
|
example_title = ''
|
|
with open(example_path, 'rb') as fin:
|
|
for line in fin:
|
|
parts = re.match('.*(EXAMPLE_START)\((.*)\):\s*(.*)(\*/)?\n',line)
|
|
if parts:
|
|
example_title = parts.group(3).replace("_","\_")
|
|
continue
|
|
return example_title
|
|
|
|
class State:
|
|
SearchExampleStart = 0
|
|
SearchListingStart = 1
|
|
SearchListingPause = 2
|
|
SearchListingResume = 3
|
|
SearchListingEnd = 4
|
|
SearchItemizeEnd = 5
|
|
ReachedExampleEnd = 6
|
|
|
|
text_block = ''
|
|
itemize_block = ''
|
|
|
|
def writeTextBlock(aout, lstStarted):
|
|
global text_block
|
|
if text_block and not lstStarted:
|
|
aout.write(text_block)
|
|
text_block = ''
|
|
|
|
def writeItemizeBlock(aout, lstStarted):
|
|
global itemize_block
|
|
if itemize_block and not lstStarted:
|
|
aout.write(itemize_block + "\n\n")
|
|
itemize_block = ''
|
|
|
|
def writeListings(aout, infile_name, ref_prefix):
|
|
global text_block, itemize_block
|
|
itemText = None
|
|
state = State.SearchExampleStart
|
|
code_in_listing = ""
|
|
code_identation = " "
|
|
skip_code = 0
|
|
|
|
with open(infile_name, 'rb') as fin:
|
|
for line in fin:
|
|
if state == State.SearchExampleStart:
|
|
parts = re.match('.*(EXAMPLE_START)\((.*)\):\s*(.*)(\*/)?\n',line)
|
|
if parts:
|
|
lable = parts.group(2).replace("_","")
|
|
title = latexText(parts.group(2), ref_prefix)
|
|
desc = latexText(parts.group(3), ref_prefix)
|
|
aout.write(example_section.replace("EXAMPLE_TITLE", title).replace("EXAMPLE_DESC", desc).replace("EXAMPLE_LABEL", lable))
|
|
state = State.SearchListingStart
|
|
continue
|
|
|
|
# detect @section
|
|
section_parts = re.match('.*(@section)\s*(.*)(:?\s*.?)\*?/?\n',line)
|
|
if section_parts:
|
|
aout.write("\n" + example_subsection.replace("SECTION_TITLE", section_parts.group(2)))
|
|
continue
|
|
|
|
# detect @subsection
|
|
subsection_parts = re.match('.*(@section)\s*(.*)(:?\s*.?)\*?/?\n',line)
|
|
if section_parts:
|
|
subsubsection = example_subsection.replace("SECTION_TITLE", section_parts.group(2)).replace('section', 'subsection')
|
|
aout.write("\n" + subsubsection)
|
|
continue
|
|
|
|
if isTextTag(line):
|
|
text_block = text_block + "\n\n" + processTextLine(line, ref_prefix)
|
|
continue
|
|
|
|
skip_code = 0
|
|
lstStarted = state != State.SearchListingStart
|
|
if text_block or itemize_block:
|
|
if isEndOfComment(line) or isEmptyCommentLine(line):
|
|
skip_code = 1
|
|
if itemize_block:
|
|
# finish itemize
|
|
writeItemizeBlock(aout, lstStarted)
|
|
else:
|
|
if isEmptyCommentLine(line):
|
|
text_block = text_block + "\n\n"
|
|
|
|
else:
|
|
writeTextBlock(aout, lstStarted)
|
|
|
|
|
|
else:
|
|
if isNewItem(line) and not itemize_block:
|
|
skip_code = 1
|
|
# finish text, start itemize
|
|
writeTextBlock(aout, lstStarted)
|
|
itemize_block = "\n " + processTextLine(line, ref_prefix)
|
|
continue
|
|
if itemize_block:
|
|
skip_code = 1
|
|
itemize_block = itemize_block + processTextLine(line, ref_prefix)
|
|
elif isCommentLine(line):
|
|
# append text
|
|
skip_code = 1
|
|
text_block = text_block + processTextLine(line, ref_prefix)
|
|
else:
|
|
skip_code = 0
|
|
#continue
|
|
|
|
if state == State.SearchListingStart:
|
|
parts = re.match('.*(LISTING_START)\((.*)\):\s*(.*)(\s+\*/).*',line)
|
|
|
|
if parts:
|
|
lst_lable = parts.group(2).replace("_","")
|
|
lst_caption = latexText(parts.group(3), ref_prefix)
|
|
listing = listing_start.replace("LISTING_CAPTION", lst_caption).replace("FILE_NAME", ref_prefix).replace("LISTING_LABEL", lst_lable)
|
|
if listing:
|
|
aout.write("\n" + listing)
|
|
state = State.SearchListingEnd
|
|
continue
|
|
|
|
if state == State.SearchListingEnd:
|
|
parts_end = re.match('.*(LISTING_END).*',line)
|
|
parts_pause = re.match('.*(LISTING_PAUSE).*',line)
|
|
end_comment_parts = re.match('.*(\*/)\s*\n', line);
|
|
|
|
if parts_end:
|
|
aout.write(code_in_listing)
|
|
code_in_listing = ""
|
|
aout.write(listing_ending)
|
|
state = State.SearchListingStart
|
|
writeItemizeBlock(aout, 0)
|
|
writeTextBlock(aout, 0)
|
|
elif parts_pause:
|
|
code_in_listing = code_in_listing + code_identation + "...\n"
|
|
state = State.SearchListingResume
|
|
elif not end_comment_parts:
|
|
# aout.write(line)
|
|
if not skip_code:
|
|
code_in_listing = code_in_listing + code_identation + line.replace(" ", " ")
|
|
continue
|
|
|
|
if state == State.SearchListingResume:
|
|
parts = re.match('.*(LISTING_RESUME).*',line)
|
|
if parts:
|
|
state = State.SearchListingEnd
|
|
continue
|
|
|
|
parts = re.match('.*(EXAMPLE_END).*',line)
|
|
if parts:
|
|
if state != State.SearchListingStart:
|
|
print "Formating error detected"
|
|
writeItemizeBlock(aout, 0)
|
|
writeTextBlock(aout, 0)
|
|
state = State.ReachedExampleEnd
|
|
print "Reached end of the example"
|
|
|
|
|
|
# write list of examples
|
|
def processExamples(intro_file, examples_folder, examples_ofile):
|
|
with open(examples_ofile, 'w') as aout:
|
|
with open(intro_file, 'rb') as fin:
|
|
for line in fin:
|
|
aout.write(line)
|
|
|
|
for group_title in list_of_groups:
|
|
if not list_of_examples.has_key(group_title): continue
|
|
examples = list_of_examples[group_title]
|
|
for example in examples:
|
|
example_path = examples_folder + example[0] + ".c"
|
|
example_title = getExampleTitle(example_path)
|
|
example.append(example_title)
|
|
|
|
aout.write(examples_header)
|
|
aout.write("\n\n");
|
|
|
|
for group_title in list_of_groups:
|
|
if not list_of_examples.has_key(group_title): continue
|
|
examples = list_of_examples[group_title]
|
|
|
|
group_title = group_title + " example"
|
|
if len(examples) > 1:
|
|
group_title = group_title + "s"
|
|
group_title = group_title + ":"
|
|
|
|
aout.write("- " + group_title + "\n");
|
|
for example in examples:
|
|
ref_prefix = example[0].replace("_", "")
|
|
title = latexText(example[0], ref_prefix)
|
|
desc = latexText(example[1], ref_prefix)
|
|
aout.write(example_item.replace("EXAMPLE_TITLE", title).replace("EXAMPLE_DESC", desc).replace("EXAMPLE_LABEL", ref_prefix))
|
|
aout.write("\n")
|
|
aout.write("\n")
|
|
|
|
for group_title in list_of_groups:
|
|
if not list_of_examples.has_key(group_title): continue
|
|
examples = list_of_examples[group_title]
|
|
|
|
for example in examples:
|
|
file_name = examples_folder + example[0] + ".c"
|
|
writeListings(aout, file_name, example[0].replace("_",""))
|
|
|
|
|
|
def main(argv):
|
|
btstackfolder = "../../"
|
|
docsfolder = "docs/"
|
|
|
|
inputfolder = btstackfolder + "example/"
|
|
introfile = docsfolder + "examples/intro.md"
|
|
outputfile = docsfolder + "examples/examples.md"
|
|
|
|
cmd = 'update_listings.py [-f <inputfolder>] [-i <introfile>] [-o <outputfile>]'
|
|
try:
|
|
opts, args = getopt.getopt(argv,"hiso:",["ffolder=","ifile=","ofile="])
|
|
except getopt.GetoptError:
|
|
print cmd
|
|
sys.exit(2)
|
|
for opt, arg in opts:
|
|
if opt == '-h':
|
|
print cmd
|
|
sys.exit()
|
|
elif opt in ("-f", "--ffolder"):
|
|
inputfolder = arg
|
|
elif opt in ("-i", "--ifile"):
|
|
introfile = arg
|
|
elif opt in ("-o", "--ofile"):
|
|
outputfile = arg
|
|
print 'Input folder is ', inputfolder
|
|
print 'Intro file is ', introfile
|
|
print 'Output file is ', outputfile
|
|
|
|
processExamples(introfile, inputfolder, outputfile)
|
|
|
|
if __name__ == "__main__":
|
|
main(sys.argv[1:])
|