نام (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 است.