1 # Copyright (c) 2016 Comcast Cable Communications Management, LLC.
3 # Licensed under the Apache License, Version 2.0 (the "License");
4 # you may not use this file except in compliance with the License.
5 # You may obtain a copy of the License at:
7 # http://www.apache.org/licenses/LICENSE-2.0
9 # Unless required by applicable law or agreed to in writing, software
10 # distributed under the License is distributed on an "AS IS" BASIS,
11 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 # See the License for the specific language governing permissions and
13 # limitations under the License.
15 # Generate clicmd formatted output
17 from . import process, parsers
21 class SiphonCLICMD(process.Siphon):
23 identifier = "VLIB_CLI_COMMAND"
25 def __init__(self, *args, **kwargs):
26 super(SiphonCLICMD, self).__init__(*args, **kwargs)
27 self._parser = parsers.MacroInitializer()
31 def separate_page_names(self, group):
32 return self.page_label(group) + ".rst"
34 def index_sort_key(self, group):
35 _global = self._cmds["_global"]
36 if group not in self._group:
38 (directory, file) = self._group[group]
40 if file in _global and "group_label" in _global[file]:
41 return _global[file]["group_label"]
43 if directory in _global and "group_label" in _global[directory]:
44 return _global[directory]["group_label"]
48 def item_sort_key(self, item):
49 return item["value"]["path"]
51 def item_label(self, group, item):
53 (self.name, self.sanitize_label(self._cmds[group][item]["value"]["path"]))
56 def page_title(self, group):
57 _global = self._cmds["_global"]
58 (directory, file) = self._group[group]
60 if file and file in _global and "group_label" in _global[file]:
61 return _global[file]["group_label"]
63 if directory in _global and "group_label" in _global[directory]:
64 return _global[directory]["group_label"]
66 file_ext = os.path.basename(directory)
67 fname, ext = os.path.splitext(file_ext)
68 return "%s cli reference" % fname.capitalize()
71 # Register our processor
72 process.siphons["clicmd"] = SiphonCLICMD