“““script?to?generate?doxygen?documentation.
“““

import?re
import?os
import?os.path
import?sys
import?shutil
from?devtools?import?tarball

def?find_program（*filenames）:
????“““find?a?program?in?folders?path_lst?and?sets?env[var]
????@param?filenames:?a?list?of?possible?names?of?the?program?to?search?for
????@return:?the?full?path?of?the?filename?if?found?or?‘‘?if?filename?could?not?be?found
“““
????paths?=?os.environ.get（‘PATH‘?‘‘）.split（os.pathsep）
????suffixes?=?（‘win32‘?in?sys.platform?）?and?‘.exe?.com?.bat?.cmd‘?or?‘‘
????for?filename?in?filenames:
????????for?name?in?[filename+ext?for?ext?in?suffixes.split（）]:
????????????for?directory?in?paths:
????????????????full_path?=?os.path.join（directory?name）
????????????????if?os.path.isfile（full_path）:
????????????????????return?full_path
????return?‘‘

def?do_subst_in_file（targetfile?sourcefile?dict）:
????“““Replace?all?instances?of?the?keys?of?dict?with?their?values.
????For?example?if?dict?is?{‘%VERSION%‘:?‘1.2345‘?‘%base%‘:?‘MyProg‘}
????then?all?instances?of?%VERSION%?in?the?file?will?be?replaced?with?1.2345?etc.
????“““
????try:
????????f?=?open（sourcefile?‘rb‘）
????????contents?=?f.read（）
????????f.close（）
????except:
????????print?“Can‘t?read?source?file?%s“%sourcefile
????????raise
????for?（kv）?in?dict.items（）:
????????v?=?v.replace（‘\\‘‘\\\\‘）?
????????contents?=?re.sub（k?v?contents）
????try:
????????f?=?open（targetfile?‘wb‘）
????????f.write（contents）
????????f.close（）
????except:
????????print?“Can‘t?write?target?file?%s“%targetfile
????????raise

def?run_doxygen（doxygen_path?config_file?working_dir?is_silent）:
????config_file?=?os.path.abspath（?config_file?）
????doxygen_path?=?doxygen_path
????old_cwd?=?os.getcwd（）
????try:
????????os.chdir（?working_dir?）
????????cmd?=?[doxygen_path?config_file]
????????print?‘Running:‘?‘?‘.join（?cmd?）
????????try:
????????????import?subprocess
????????except:
????????????if?os.system（?‘?‘.join（?cmd?）?）?!=?0:
????????????????print?‘Documentation?generation?failed‘
????????????????return?False
????????else:
????????????if?is_silent:
????????????????process?=?subprocess.Popen（?cmd?stdout=subprocess.PIPE?stderr=subprocess.STDOUT?）
????????????else:
????????????????process?=?subprocess.Popen（?cmd?）
????????????stdout?_?=?process.communicate（）
????????????if?process.returncode:
????????????????print?‘Documentation?generation?failed:‘
????????????????print?stdout
????????????????return?False
????????return?True
????finally:
????????os.chdir（?old_cwd?）

def?build_doc（?options??make_release=False?）:
????if?make_release:
????????options.make_tarball?=?True
????????options.with_dot?=?True
????????options.with_html_help?=?True
????????options.with_uml_look?=?True
????????options.open?=?False
????????options.silent?=?True

????version?=?open（‘version‘‘rt‘）.read（）.strip（）
????output_dir?=?‘dist/doxygen‘?#?relative?to?doc/doxyfile?location.
????if?not?os.path.isdir（?output_dir?）:
????????os.makedirs（?output_dir?）
????top_dir?=?os.path.abspa

?屬性????????????大小?????日期????時間???名稱
-----------?---------??----------?-----??----
?????目錄???????????0??2018-07-22?09:31??jsoncpp?編譯文件\
?????目錄???????????0??2018-07-22?09:36??jsoncpp?編譯文件\jsoncpp-src-0.5.0\
?????文件??????????49??2007-06-15?05:01??jsoncpp?編譯文件\jsoncpp-src-0.5.0\AUTHORS
?????目錄???????????0??2018-07-22?09:36??jsoncpp?編譯文件\jsoncpp-src-0.5.0\build\
?????目錄???????????0??2018-07-22?09:36??jsoncpp?編譯文件\jsoncpp-src-0.5.0\build\vs71\
?????目錄???????????0??2018-07-22?09:36??jsoncpp?編譯文件\jsoncpp-src-0.5.0\build\vs71\debug\
?????目錄???????????0??2018-07-22?09:40??jsoncpp?編譯文件\jsoncpp-src-0.5.0\build\vs71\debug\lib_json\
?????文件??????636859??2018-07-22?09:40??jsoncpp?編譯文件\jsoncpp-src-0.5.0\build\vs71\debug\lib_json\json_reader.obj
?????文件?????1117332??2018-07-22?09:40??jsoncpp?編譯文件\jsoncpp-src-0.5.0\build\vs71\debug\lib_json\json_value.obj
?????文件?????2916680??2018-07-22?09:40??jsoncpp?編譯文件\jsoncpp-src-0.5.0\build\vs71\debug\lib_json\json_vc71_libmtd.lib
?????文件??????750198??2018-07-22?09:40??jsoncpp?編譯文件\jsoncpp-src-0.5.0\build\vs71\debug\lib_json\json_writer.obj
?????文件??????609280??2018-07-22?09:40??jsoncpp?編譯文件\jsoncpp-src-0.5.0\build\vs71\debug\lib_json\lib_json.idb
?????文件????????1326??2018-07-22?09:40??jsoncpp?編譯文件\jsoncpp-src-0.5.0\build\vs71\debug\lib_json\lib_json.log
?????文件??????618496??2018-07-22?09:40??jsoncpp?編譯文件\jsoncpp-src-0.5.0\build\vs71\debug\lib_json\lib_json.pdb
?????目錄???????????0??2018-07-22?09:40??jsoncpp?編譯文件\jsoncpp-src-0.5.0\build\vs71\debug\lib_json\lib_json.tlog\
?????文件????????2764??2018-07-22?09:40??jsoncpp?編譯文件\jsoncpp-src-0.5.0\build\vs71\debug\lib_json\lib_json.tlog\CL.command.1.tlog
?????文件???????33554??2018-07-22?09:40??jsoncpp?編譯文件\jsoncpp-src-0.5.0\build\vs71\debug\lib_json\lib_json.tlog\CL.read.1.tlog
?????文件????????2670??2018-07-22?09:40??jsoncpp?編譯文件\jsoncpp-src-0.5.0\build\vs71\debug\lib_json\lib_json.tlog\CL.write.1.tlog
?????文件????????1382??2018-07-22?09:40??jsoncpp?編譯文件\jsoncpp-src-0.5.0\build\vs71\debug\lib_json\lib_json.tlog\Lib-link.read.1.tlog
?????文件?????????824??2018-07-22?09:40??jsoncpp?編譯文件\jsoncpp-src-0.5.0\build\vs71\debug\lib_json\lib_json.tlog\Lib-link.write.1.tlog
?????文件????????1030??2018-07-22?09:40??jsoncpp?編譯文件\jsoncpp-src-0.5.0\build\vs71\debug\lib_json\lib_json.tlog\lib.command.1.tlog
?????文件?????????240??2018-07-22?09:40??jsoncpp?編譯文件\jsoncpp-src-0.5.0\build\vs71\debug\lib_json\lib_json.tlog\lib_json.lastbuildstate
?????目錄???????????0??2018-07-22?09:31??jsoncpp?編譯文件\jsoncpp-src-0.5.0\devtools\
?????文件????????7750??2010-03-12?15:31??jsoncpp?編譯文件\jsoncpp-src-0.5.0\devtools\antglob.py
?????文件????????1941??2010-03-12?15:31??jsoncpp?編譯文件\jsoncpp-src-0.5.0\devtools\fixeol.py
?????文件????????2071??2010-03-12?15:31??jsoncpp?編譯文件\jsoncpp-src-0.5.0\devtools\tarball.py
?????文件???????????9??2010-03-12?15:31??jsoncpp?編譯文件\jsoncpp-src-0.5.0\devtools\__init__.py
?????目錄???????????0??2018-07-22?09:31??jsoncpp?編譯文件\jsoncpp-src-0.5.0\doc\
?????文件???????65086??2010-03-12?15:31??jsoncpp?編譯文件\jsoncpp-src-0.5.0\doc\doxyfile.in
?????文件?????????572??2010-03-12?15:31??jsoncpp?編譯文件\jsoncpp-src-0.5.0\doc\footer.html
?????文件?????????565??2010-03-12?15:31??jsoncpp?編譯文件\jsoncpp-src-0.5.0\doc\header.html
............此處省略188個文件信息