2 # Copyright (c) 2016 Comcast Cable Communications Management, LLC.
4 # Licensed under the Apache License, Version 2.0 (the "License");
5 # you may not use this file except in compliance with the License.
6 # You may obtain a copy of the License at:
8 # http://www.apache.org/licenses/LICENSE-2.0
10 # Unless required by applicable law or agreed to in writing, software
11 # distributed under the License is distributed on an "AS IS" BASIS,
12 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 # See the License for the specific language governing permissions and
14 # limitations under the License.
16 # Looks for preprocessor macros with struct initializers and siphons them
17 # off into another file for later parsing; ostensibly to generate
18 # documentation from struct initializer data.
26 DEFAULT_LOGFILE = None
27 DEFAULT_LOGLEVEL = "info"
28 DEFAULT_OUTPUT = "build-root/docs/siphons"
29 DEFAULT_PREFIX = os.getcwd()
31 ap = argparse.ArgumentParser()
32 ap.add_argument("--log-file", default=DEFAULT_LOGFILE,
33 help="Log file [%s]" % DEFAULT_LOGFILE)
34 ap.add_argument("--log-level", default=DEFAULT_LOGLEVEL,
35 choices=["debug", "info", "warning", "error", "critical"],
36 help="Logging level [%s]" % DEFAULT_LOGLEVEL)
38 ap.add_argument("--output", '-o', metavar="directory", default=DEFAULT_OUTPUT,
39 help="Output directory for .siphon files [%s]" %
41 ap.add_argument("--input-prefix", metavar="path", default=DEFAULT_PREFIX,
42 help="Prefix to strip from input pathnames [%s]" %
44 ap.add_argument("input", nargs='+', metavar="input_file",
45 help="Input C source files")
46 args = ap.parse_args()
48 logging.basicConfig(filename=args.log_file,
49 level=getattr(logging, args.log_level.upper(), None))
50 log = logging.getLogger("siphon_generate")
53 generate = siphon.generate.Generate(output_directory=args.output,
54 input_prefix=args.input_prefix)
56 # Pre-process file names in case they indicate a file with
59 for filename in args.input:
60 if filename.startswith('@'):
61 with open(filename[1:], 'r') as fp:
62 lines = fp.readlines()
69 if filename not in files:
70 files.append(filename)
72 # Iterate all the input files we've been given
73 for filename in files:
74 generate.parse(filename)
76 # Write the extracted data