TIMEW-REPORT(1)                  User Manuals                  TIMEW-REPORT(1)

نام (NAME)
       timew-report - اجرای یک گزارش افزونه

خلاصه دستور (SYNOPSIS)
       timew [report] <report> [<range>] [<tag>...]
       timew [report] <report> <id>...

توضیحات (DESCRIPTION)
       یک گزارش افزونه را اجرا می‌کند و از فیلتر کردن داده‌ها پشتیبانی می‌نماید.
       دستور 'report' به خودی خود اختیاری است، به این معنی که این دو دستور
       معادل یکدیگر هستند:

           $ timew report foo :week
           $ timew        foo :week

       البته این در صورتی است که افزونه‌ای به نام 'foo' نصب شده باشد.

       کد بازگشتی، همان کد بازگشتی افزونه است.  اگر افزونه هیچ خروجی‌ای تولید
       نکند و کد بازگشتی غیرصفر (non-zero rc) داشته باشد، مقدار 255 بازگردانده
       می‌شود.

       فیلتر کردن بر اساس بازه زمانی و/یا برچسب‌ها، یا بر اساس شناسه (id)
       امکان‌پذیر است.

پیکربندی (CONFIGURATION)
       reports.range
           بازه زمانی پیش‌فرض را برای تمام گزارش‌ها تعیین می‌کند.  این مقدار باید
           متناظر با یک راهنمای بازه (range hint) باشد؛ به timew-hints(7)
           مراجعه کنید.  پیش‌فرض آن all است.

       reports.<name>.range
           بازه زمانی را برای گزارش name مشخص می‌کند، که در صورت تعیین نشدن
           range در خط فرمان استفاده می‌شود.  در اینجا، name نام فایل اجرایی
           گزارش بدون پسوند آن است (به عنوان مثال، به فایل اجرایی گزارش
           'foo.py' با نام 'foo' ارجاع داده می‌شود).  این مقدار باید متناظر با
           یک راهنمای بازه (range hint) باشد؛ به timew-hints(7) مراجعه کنید.
           پیش‌فرض آن مقدار reports.range است.

timew 1.9.1                       2025-08-16                   TIMEW-REPORT(1)