'\" t
.\"     Title: timew-report
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.20
.\"      Date: 2025-08-16
.\"    Manual: User Manuals
.\"    Source: timew 1.9.1
.\"  Language: English
.\"
.TH "TIMEW\-REPORT" "1" "2025-08-16" "timew 1.9.1" "User Manuals"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
timew-report \- اجرای یک گزارش افزونه
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fBtimew\fP [\fBreport\fP] \fI<report>\fP [\fI<range>\fP] [\fI<tag>\fP\fB...\fP]
\fBtimew\fP [\fBreport\fP] \fI<report>\fP \fI<id>\fP\fB...\fP
.fi
.br
.SH "توضیحات (DESCRIPTION)"
.sp
یک گزارش افزونه را اجرا می‌کند و از فیلتر کردن داده‌ها پشتیبانی می‌نماید.
دستور \*(Aqreport\*(Aq به خودی خود اختیاری است، به این معنی که این دو دستور معادل یکدیگر هستند:
.sp
.if n .RS 4
.nf
.fam C
$ timew report foo :week
$ timew        foo :week
.fam
.fi
.if n .RE
.sp
البته این در صورتی است که افزونه‌ای به نام \*(Aqfoo\*(Aq نصب شده باشد.
.sp
کد بازگشتی، همان کد بازگشتی افزونه است.
اگر افزونه هیچ خروجی‌ای تولید نکند و کد بازگشتی غیرصفر (non\-zero rc) داشته باشد، مقدار 255 بازگردانده می‌شود.
.sp
فیلتر کردن بر اساس بازه زمانی و/یا برچسب‌ها، یا بر اساس شناسه (id) امکان‌پذیر است.
.SH "پیکربندی (CONFIGURATION)"
.sp
\fBreports.range\fP
.RS 4
بازه زمانی پیش‌فرض را برای تمام گزارش‌ها تعیین می‌کند.
این مقدار باید متناظر با یک راهنمای بازه (range hint) باشد؛ به \fBtimew\-hints\fP(7) مراجعه کنید.
پیش‌فرض آن \f(CRall\fP است.
.RE
.sp
\fBreports.\fP\fI<name>\fP\fB.range\fP
.RS 4
بازه زمانی را برای گزارش \fIname\fP مشخص می‌کند، که در صورت تعیین نشدن \fIrange\fP در خط فرمان استفاده می‌شود.
در اینجا، \fIname\fP نام فایل اجرایی گزارش بدون پسوند آن است (به عنوان مثال، به فایل اجرایی گزارش \*(Aqfoo.py\*(Aq با نام \*(Aqfoo\*(Aq ارجاع داده می‌شود).
این مقدار باید متناظر با یک راهنمای بازه (range hint) باشد؛ به \fBtimew\-hints\fP(7) مراجعه کنید.
پیش‌فرض آن مقدار \fBreports.range\fP است.
.RE