.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "SPREADSHEET.PY" "1" "2026-07-07" "2.5" "LCOV" .SH "نام (NAME)" spreadsheet.py \- اسکریپت تولید فایل‌های اکسل/صفحه‌گسترده از گزارش‌های پوشش کد LCOV .INDENT 0.0 .TP .B بخش راهنما 1 .TP .B گروه راهنما ابزارهای LCOV .UNINDENT .SH "نام (NAME)" .INDENT 0.0 .TP .B spreadsheet.py تبدیل داده‌های پروفایل LCOV به صفحه‌گسترده اکسل جهت تحلیل عملکرد و مقایسه .UNINDENT .SH "خلاصه دستور (SYNOPSIS)" .INDENT 0.0 .INDENT 3.5 .sp .EX spreadsheet.py [\-o output.xlsx] [گزینه‌ها] data.json [data2.json ...] .EE .UNINDENT .UNINDENT .SH "توضیحات (DESCRIPTION)" .sp اسکریپت کاربردی .B spreadsheet.py داده‌های پروفایل JSON را از .BR genhtml ، .B geninfo و .B lcov به یک صفحه‌گسترده اکسل تبدیل می‌کند تا تحلیل آن‌ها آسان‌تر شود. این اسکریپت داده‌های زمان‌بندی عملکرد را پردازش کرده و آن‌ها را در قالبی جدولی همراه با تحلیل‌های آماری و قالب‌بندی شرطی نمایش می‌دهد. .sp این صفحه‌گسترده شامل موارد زیر است: .INDENT 0.0 .IP \(bu 2 \fBبرگه‌های خلاصه\fP برای مقایسه چندین اجرای مختلف .IP \(bu 2 \fBداده‌های زمان‌بندی به تفکیک فایل\fP برای تحلیل دقیق .IP \(bu 2 \fBخلاصه‌های آماری\fP (مجموع، میانگین، انحراف معیار) .IP \(bu 2 \fBقالب‌بندی شرطی\fP برای مشخص‌کردن مقادیر پرت .UNINDENT .SH "کدگذاری رنگی (COLOR CODING)" .sp این صفحه‌گسترده از قالب‌بندی شرطی برای مشخص‌کردن ناهنجاری‌های زمان‌بندی استفاده می‌کند: .INDENT 0.0 .IP \(bu 2 \fBزرد\fP: مقادیری که بین ۱٫۵ تا ۲٫۰ انحراف معیار بزرگ‌تر از میانگین هستند (و بیش از ۱۵٪ بالاتر از میانگین می‌باشند) .IP \(bu 2 \fBقرمز\fP: مقادیری که بیش از ۲٫۰ انحراف معیار بزرگ‌تر از میانگین هستند (و بیش از ۱۵٪ بالاتر از میانگین می‌باشند) .IP \(bu 2 \fBسبز\fP: مقادیری که بیش از ۲٫۰ انحراف معیار کوچک‌تر از میانگین هستند (عملکرد به‌مراتب بهتر) .UNINDENT .SH "ابزارهای پشتیبانی‌شده (SUPPORTED TOOLS)" .sp این اسکریپت داده‌های پروفایل ابزارهای زیر را پردازش می‌کند: .INDENT 0.0 .IP \(bu 2 \fBgeninfo\fP: زمان‌بندی تکه‌ها (Chunk timing)، پردازش فایل، عملیات فیلتر .IP \(bu 2 \fBgenhtml\fP: تجزیه سورس‌کد، تولید HTML، حاشیه‌نویسی، دسته‌بندی .IP \(bu 2 \fBlcov\fP: ادغام فایل‌های ردگیری (Tracefile)، تجزیه، پردازش قطعات .UNINDENT .SH "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \fB\-o\fP \fIfile\fP, \fB\-\-out\fP \fIfile\fP ذخیره خروجی اکسل در فایل مشخص‌شده. پیش‌فرض: \fBstats.xlsx\fP\&. .TP .B \fB\-\-threshold\fP \fIpercent\fP حداقل درصد تفاوت نسبت به میانگین جهت اعمال رنگ‌بندی. تفاوت‌های کوچک‌تر از این آستانه برجسته نمی‌شوند. پیش‌فرض: 15.0%. .TP .B \fB\-\-low\fP \fImultiplier\fP ضریب انحراف معیار برای برجسته‌سازی با رنگ زرد. مقادیری که بین .B \-\-low و .B \-\-high انحراف معیار بالاتر از میانگین باشند به رنگ زرد نشان داده می‌شوند. پیش‌فرض: 1.5. .TP .B \fB\-\-high\fP \fImultiplier\fP ضریب انحراف معیار برای برجسته‌سازی با رنگ قرمز. مقادیری که بیش از .B \-\-high انحراف معیار بالاتر از میانگین باشند به رنگ قرمز نشان داده می‌شوند. پیش‌فرض: 2.0. .TP .B \fB\-v\fP, \fB\-\-verbose\fP افزایش جزئیات گزارش. شامل داده‌های زمان‌بندی اضافی مانند عملیات خواندن و تبدیل کد. .TP .B \fB\-\-show\-filter\fP گنجاندن داده‌های زمان‌بندی عملیات فیلتر در صفحه‌گسترده. داده‌های فیلتر زمان صرف‌شده در پردازش تکه‌های فیلتر، عملیات صف و ادغام را نمایش می‌دهند. .TP .B \fIfiles\fP یک یا چند فایل داده پروفایل JSON برای پردازش. این فایل‌ها باید با استفاده از گزینه .B \-\-profile در ابزارهای .BR geninfo ، .B genhtml یا .B lcov تولید شده باشند. .UNINDENT .SH "مثال‌ها (EXAMPLES)" .sp استفاده پایه با یک فایل پروفایل تکی: .INDENT 0.0 .INDENT 3.5 .sp .EX $ spreadsheet.py \-o report.xlsx geninfo_profile.json .EE .UNINDENT .UNINDENT .sp مقایسه چندین اجرای مختلف پروفایل: .INDENT 0.0 .INDENT 3.5 .sp .EX $ spreadsheet.py \-o comparison.xlsx run1.json run2.json run3.json .EE .UNINDENT .UNINDENT .sp گنجاندن داده‌های زمان‌بندی فیلتر همراه با خروجی پرجزئیات: .INDENT 0.0 .INDENT 3.5 .sp .EX $ spreadsheet.py \-\-show\-filter \-v \-o detailed.xlsx profile.json .EE .UNINDENT .UNINDENT .sp تنظیم حساسیت جهت شناسایی داده‌های پرت: .INDENT 0.0 .INDENT 3.5 .sp .EX $ spreadsheet.py \-\-threshold 10 \-\-low 1.0 \-\-high 1.5 \-o sensitive.xlsx data.json .EE .UNINDENT .UNINDENT .SH "تولید داده‌های پروفایل (GENERATING PROFILE DATA)" .sp برای تولید داده‌های پروفایل جهت تحلیل، از گزینه \fB\-\-profile\fP استفاده کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX $ geninfo \-\-profile geninfo_profile.json \-o coverage.info ./build $ genhtml \-\-profile genhtml_profile.json \-o html coverage.info $ lcov \-\-profile lcov_profile.json \-a a.info \-a b.info \-o merged.info .EE .UNINDENT .UNINDENT .SH "نویسنده (AUTHOR)" .sp Henry Cox <\%> .SH "همچنین ببینید (SEE ALSO)" .sp \fBgenhtml(1) \%\fP, \fBgeninfo(1) \%\fP, \fBlcov(1) \%\fP .INDENT 0.0 .IP \(bu 2 مستندات xlsxwriter: \% .UNINDENT .SH "حق نشر (COPYRIGHT)" 2024-2026, LCOV Project .\" End of generated man page.