یک ردیاب زمان خط فرمان خوب مبتنی بر روبی

Summarize this content to 400 words in Persian Lang
Timet یک ابزار خط فرمان است که برای ردیابی فعالیت های شما با ثبت زمان صرف شده برای هر کار طراحی شده است و به شما این امکان را می دهد که ساعات کار و بهره وری خود را مستقیماً از ترمینال خود بدون نیاز به رابط گرافیکی نظارت کنید. در اصل، این روشی برای ثبت زمان صرف شده برای پروژه ها یا کارهای مختلف با استفاده از دستورات متنی ساده است

از SQLite برای ذخیره داده ها به صورت محلی استفاده می کند، بنابراین لازم نیست نگران از دست دادن داده های خود در فضای ابری باشید. Timet می‌تواند زمان را بر حسب ثانیه، دقیقه، ساعت، روز و غیره ردیابی کند. این آن را برای ردیابی هر نوع کاری، از استراحت‌های کوتاه گرفته تا پروژه‌های طولانی، عالی می‌کند.

Timet همچنین دارای ویژگی ادغام pomodoro است. پومودورو یک تکنیک مدیریت زمان است که شامل کار در فواصل 25 دقیقه ای متمرکز با استراحت های کوتاه در بین آن ها می شود. Timet می تواند به شما کمک کند در جلسات پومودورو خود در مسیر خود بمانید و مطمئن شوید که از زمان خود بهترین استفاده را می کنید.

با Timet، در نهایت می توانید کنترل 🕐 خود را به دست بگیرید و کارهای بیشتری انجام دهید.

📄 فهرست مطالب

🔑 ویژگی های کلیدی

ذخیره سازی داده های محلی: از SQLite برای ذخیره سازی امن و خصوصی داده های محلی استفاده می کند.

سبک و سریع: طراحی کارآمد و ذخیره سازی محلی سرعت و پاسخگویی را تضمین می کند.

داده های ساخت یافته: SQLite داده ها را برای دسترسی و مدیریت آسان سازماندهی می کند.

مقیاس پذیری: توانایی رسیدگی به نیازهای روزافزون ردیابی زمان را دارد.

یکپارچگی داده ها: دقت و سازگاری داده های ذخیره شده را تضمین می کند.

پرس و جو و گزارش: گزارش های دقیق برای دوره های خاص ایجاد کنید.

صادرات CSV: داده های ردیابی زمان را برای تجزیه و تحلیل یا اشتراک گذاری به CSV صادر کنید.

ادغام پومودورو: ردیابی زمان را با تکنیک پومودورو افزایش می دهد.

بلوک زمان طرح: توزیع زمان را در بین تاریخ‌ها تجسم می‌کند و ساعت‌های پیگیری شده را نشان می‌دهد.

پلات توزیع برچسب: نسبت زمان اختصاص داده شده به هر تگ را نشان می دهد.

✔️ الزامات

نسخه روبی: >= 3.0.0
sqlite3: > 1.7

💾نصب

Gem را با اجرای:

gem install timet

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

⏳ استفاده

Timet یک رابط خط فرمان ساده برای ردیابی زمان شما ارائه می دهد.

timet: دستور اصلی برای تعامل با برنامه Timet.

tt: نام مستعار برای timet فرمان، ارائه یک جایگزین کوتاه تر.

در اینجا برخی از دستورات ضروری به شرح زیر است:

استفاده کنید timet start دستور شروع ردیابی زمان برای یک کار خاص با استفاده از یک یادداشت و “زمان pomodoro” در دقیقه (اختیاری).

به عنوان مثال، برای شروع ردیابی زمان برای یک کار به نام “task1″، باید اجرا کنید:

timet start task1 –notes=”My notes” –pomodoro=25

or

tt start task1 “My notes” 25

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

برای توقف ردیابی کار فعلی و ثبت زمان سپری شده، از timet stop فرمان این همچنین گزارشی را نشان می دهد که کل زمان صرف شده برای همه کارها را خلاصه می کند.

اگر نیاز دارید که کار خود را مکث کنید و سپس از جایی که کار را ترک کردید، ادامه دهید timet resume دستور به شما امکان می دهد ردیابی یک کار قبلا متوقف شده را از سر بگیرید.

ویرایش یک کار:
برای تغییر جزئیات یک کار ضبط شده قبلی، از timet edit [id] فرمان جایگزین کنید [id] با شناسه منحصر به فرد کاری که می خواهید ویرایش کنید. این دستور به شما امکان می دهد یادداشت ها، برچسب ها، زمان شروع یا زمان پایان کار را به روز کنید.

مثال:

timet edit 1 notes “New Meeting Notes”

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

این timet summary دستور اکنون از تعیین محدوده تاریخ برای تولید گزارش پشتیبانی می کند. این به کاربران اجازه می دهد تا داده ها را در بازه های زمانی خاص فیلتر و خلاصه کنند. فرمت تاریخ در قالب ISO 8601 (YYYY-MM-DD) است.

مثال ها:

تک تاریخ: نمایش یک گزارش برای یک تاریخ خاص.

timet su 2024-01-03

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

محدوده تاریخ: نمایش یک گزارش برای محدوده تاریخ.

timet su 2024-01-02..2024-01-03

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

صادرات گزارش‌های زمان به CSV:

دستور summary این گزینه را دارد که با مشخص کردن پرچم –csv داده های زمان شما را به یک فایل CSV صادر کند. به عنوان مثال:

timet su t –csv=summary_today.csv

وارد حالت تمام صفحه شوید

از حالت تمام صفحه خارج شوید

این یک فایل CSV (summary_today.csv) ایجاد می‌کند که حاوی تمام کارهای ردیابی شده برای روز جاری است و اشتراک‌گذاری یا وارد کردن آن را در ابزارهای دیگر آسان می‌کند. می توانید از این پرچم با هر یک از فیلترهای خلاصه (t، y، w، m) استفاده کنید.

هنگام صادرات به CSV، مُهرهای زمانی برای زمان‌های شروع و پایان به قالب تاریخ قابل خواندن (YYYY-MM-DD HH:MM:SS) تبدیل می‌شوند و از سازگاری با نرم‌افزارهایی مانند Excel یا LibreOffice اطمینان حاصل می‌کنند.

این timet d [id] دستور به شما اجازه می دهد تا کارهای ناخواسته را حذف کنید. شما می توانید شناسه وظیفه را از گزارش های زمانی تولید شده با استفاده از دستورات خلاصه پیدا کنید.

استفاده کنید timet c برای توقف هرگونه ردیابی زمان فعال

📋 مرجع فرمان

فرمان
توضیحات
مثال استفاده

timet start [tag] –notes=”” –pomodoro=[time] شروع ردیابی زمان برای یک کار با برچسب [tag] و یادداشت ها (اختیاری).
timet start Task “My notes” 25

timet stop
زمان ردیابی را متوقف کنید.
timet start Task “My notes”

timet summary today
نمایش یک گزارش از زمان پیگیری برای امروز.

timet su t یا timet su

timet summary yesterday (y)
نمایش یک گزارش از زمان پیگیری برای دیروز.
timet su y

timet summary week (w)
نمایش یک گزارش از زمان پیگیری برای هفته.
timet su w

timet summary month (m)
ردیابی ماه گذشته را از سر بگیرید.
timet su m

timet su t –csv=[filename] گزارشی از زمان پیگیری شده برای امروز نمایش داده و آن را به آن صادر کنید filename.csv.
timet su t –csv=file.csv

timet summary resume (r)
پیگیری آخرین کار را از سر بگیرید.
timet su r

timet delete [id] یک کار را با شناسه آن حذف کنید.
timet d [id]

timet cancel
ردیابی زمان فعال را لغو کنید.
timet c

timet edit [id] فیلدهای یادداشت، برچسب، شروع یا پایان یک کار را به روز کنید.
timet e [1]

timet su [date] نمایش یک گزارش از زمان پیگیری برای یک تاریخ خاص.
timet su 2024-01-03

timet su [start_date]..[end_date] نمایش یک گزارش از زمان پیگیری برای یک محدوده تاریخ.
timet su 2024-01-02..2024-01-03

📎 Github

برای اطلاعات بیشتر اینجا را بررسی کنید

gem install timet

timet start task1 --notes="My notes" --pomodoro=25

or 

tt start task1 "My notes" 25

  timet edit 1 notes "New Meeting Notes"

  timet su 2024-01-03

  timet su 2024-01-02..2024-01-03

timet su t --csv=summary_today.csv