“““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

?屬性????????????大小?????日期????時間???名稱
-----------?---------??----------?-----??----

?????文件???????7750??2010-03-12?15:31??devtools\antglob.py

?????文件???????1941??2010-03-12?15:31??devtools\fixeol.py

?????文件???????2071??2010-03-12?15:31??devtools\tarball.py

?????文件??????????9??2010-03-12?15:31??devtools\__init__.py

?????文件??????65086??2010-03-12?15:31??doc\doxyfile.in

?????文件????????572??2010-03-12?15:31??doc\footer.html

?????文件????????565??2010-03-12?15:31??doc\header.html

?????文件???????4242??2010-03-12?15:31??doc\jsoncpp.dox

?????文件?????????71??2010-03-12?15:31??doc\readme.txt

?????文件???????1643??2010-03-12?15:31??doc\roadmap.dox

?????文件????????438??2010-03-12?15:31??include\json\autolink.h

?????文件???????1536??2010-03-12?15:31??include\json\config.h

?????文件???????1290??2010-03-12?15:31??include\json\features.h

?????文件????????735??2010-03-12?15:31??include\json\forwards.h

?????文件????????200??2010-03-12?15:31??include\json\json.h

?????文件???????6486??2010-03-12?15:31??include\json\reader.h

?????文件??????33960??2010-03-12?15:31??include\json\value.h

?????文件???????6188??2010-03-12?15:31??include\json\writer.h

????..A..H.?????33280??2018-02-27?12:49??makefiles\vs71\.vs\jsoncpp\v14\.suo

?????文件???????2526??2010-03-12?15:31??makefiles\vs71\Backup\jsoncpp.sln

?????文件???????3732??2018-02-26?15:05??makefiles\vs71\jsoncpp.sln

?????文件???????3112??2010-03-12?15:31??makefiles\vs71\jsontest.vcproj

?????文件???????8689??2018-02-27?11:43??makefiles\vs71\jsontest.vcxproj

?????文件????????165??2018-02-27?11:42??makefiles\vs71\jsontest.vcxproj.user

?????文件???????5713??2010-03-12?15:31??makefiles\vs71\lib_json.vcproj

?????文件??????13975??2018-02-26?16:17??makefiles\vs71\lib_json.vcxproj

?????文件????????165??2018-02-26?15:54??makefiles\vs71\lib_json.vcxproj.user

?????文件???????3485??2010-03-12?15:31??makefiles\vs71\test_lib_json.vcproj

?????文件???????9663??2018-02-27?11:45??makefiles\vs71\test_lib_json.vcxproj

?????文件??????76840??2018-02-26?15:02??makefiles\vs71\UpgradeLog.htm

............此處省略253個文件信息