81 lines
2.6 KiB
Python
81 lines
2.6 KiB
Python
"""YAML requirements renderer — for request_*.yaml style files."""
|
||
from html import escape
|
||
|
||
|
||
def render(filepath):
|
||
"""Render YAML requirements as grouped tables (F_/P_/S_ sections)."""
|
||
try:
|
||
import yaml
|
||
except ImportError:
|
||
return '<div class="warning">pyyaml not installed. Run: pip install pyyaml</div>'
|
||
|
||
with open(str(filepath), encoding='utf-8') as f:
|
||
data = yaml.safe_load(f)
|
||
|
||
if not isinstance(data, dict):
|
||
return f'<pre><code>{escape(str(data))}</code></pre>'
|
||
|
||
sections = {
|
||
'F_': ('功能需求', []),
|
||
'P_': ('性能需求', []),
|
||
'S_': ('规格需求', []),
|
||
}
|
||
other = []
|
||
|
||
for key, val in data.items():
|
||
if not isinstance(val, dict):
|
||
continue
|
||
name = val.get('name', key)
|
||
desc = val.get('description', '')
|
||
limit = val.get('limit', None)
|
||
|
||
limit_str = ''
|
||
if limit and isinstance(limit, dict):
|
||
parts = []
|
||
if 'min' in limit and limit['min'] is not None:
|
||
parts.append(f'>= {limit["min"]}')
|
||
if 'max' in limit and limit['max'] is not None:
|
||
parts.append(f'<= {limit["max"]}')
|
||
if 'value' in limit:
|
||
parts.append(str(limit['value']))
|
||
if 'unit' in limit:
|
||
parts.append(limit['unit'])
|
||
if 'count' in limit:
|
||
parts.append(f'x{limit["count"]}')
|
||
limit_str = ' '.join(parts)
|
||
|
||
entry = {'id': key, 'name': name, 'desc': desc, 'limit': limit_str}
|
||
placed = False
|
||
for prefix in sections:
|
||
if key.startswith(prefix):
|
||
sections[prefix][1].append(entry)
|
||
placed = True
|
||
break
|
||
if not placed:
|
||
other.append(entry)
|
||
|
||
html = []
|
||
for prefix, (label, items) in sections.items():
|
||
if not items:
|
||
continue
|
||
html.append(f'<h3>{label}（{len(items)} 项）</h3>')
|
||
html.append(
|
||
'<table><thead><tr>'
|
||
'<th style="width:16%">ID</th>'
|
||
'<th style="width:16%">名称</th>'
|
||
'<th>描述</th>'
|
||
'<th style="width:20%">指标</th>'
|
||
'</tr></thead><tbody>'
|
||
)
|
||
for e in items:
|
||
html.append(
|
||
f'<tr>'
|
||
f'<td class="text-mono">{escape(e["id"])}</td>'
|
||
f'<td>{escape(e["name"])}</td>'
|
||
f'<td>{escape(e["desc"])}</td>'
|
||
f'<td>{escape(e["limit"])}</td>'
|
||
f'</tr>'
|
||
)
|
||
html.append('</tbody></table>')
|
||
return '\n'.join(html)
|