نام (NAME)

gnucash-cli - ابزار خط فرمان همراه با GnuCash

خلاصه دستور (SYNOPSIS)

gnucash-cli [گزینه‌ها] [ accounts.gnucash ]

توضیحات (DESCRIPTION)

gnucash-cli تعامل مشخصی را با فایل دادهٔ gnucash مستقیماً از طریق خط فرمان فراهم می‌کند.

این ابزار دارای دو حالت است: حالت quotes و حالت report .

حالت مظنه‌ها (Quotes Mode) (فعال‌سازی با --quotes <cmd>)

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

info: نسخهٔ Finance::Quote و منابع مظنهٔ در دسترس را نمایش می‌دهد.
get: مظنه‌های برخط را دریافت می‌کند. توجه داشته باشید که این دستور مستلزم پیکربندی صحیح Finance::Quote روی سیستم شما است.
دستور get گزینه‌های زیر را می‌پذیرد:
--namespace=REGEXP: عبارت باقاعده‌ای (Regular expression) که تعیین می‌کند کالاهای کدام فضای نام (namespace) دریافت شوند.
dump: مظنه‌های جاری را برای ارزها یا سهام مشخص‌شده از یک فضای نام معین واکشی کرده و نتایج را در کنسول چاپ می‌کند. پس از این دستور باید یک منبع و یک یا چند نماد ذکر شود، مگر اینکه منبع "currency" باشد که در این صورت باید دو یا چند نماد به دنبال آن بیاید؛ اولین نماد، ارزی است که نرخ برابری برای بقیهٔ نمادها بر پایهٔ آن اعلام خواهد شد.
دستور dump گزینه‌های زیر را می‌پذیرد:
-v
--verbose: تمام پارامترهایی را که Finance::Quote برای نماد بازمی‌گرداند فهرست می‌کند، به جای اینکه تنها موارد مورد نیاز GnuCash را نمایش دهد.

حالت گزارش (Report Mode) (فعال‌سازی با --report <cmd>)

این حالت دارای گزینه‌هایی برای کار با گزارش‌ها در فایل دادهٔ مشخص‌شده است. این حالت از دستور زیر پشتیبانی می‌کند:

run: یک گزارش را روی فایل دادهٔ داده‌شده اجرا می‌کند.
دستور run گزینه‌های زیر را می‌پذیرد:
--name=REPORT_NAME: نام گزارشی که باید اجرا شود
--export-type=TYPE: مشخص کردن نوع برون‌ریزی (export)

گزینه‌های عمومی (General Options)

--version: نمایش نسخهٔ GnuCash
--help: نمایش این پیام راهنما
--debug: فعال‌سازی حالت اشکال‌زدایی: افزایش سطح ثبت وقایع برای ارائهٔ جزئیات عمیق.
--extra: فعال‌سازی قابلیت‌های اضافی/توسعه/اشکال‌زدایی.
--log: بازنویسی سطح لاگ، به فرم "log.ger.path={debug,info,warn,crit,error}" این گزینه می‌تواند چندین بار مشخص شود.
--logto: فایلی که لاگ در آن ذخیره می‌شود؛ پیش‌فرض "$TMPDIR/gnucash.trace" است؛ برای نوشتن در پایانه از "stderr" یا "stdout" استفاده کنید.

فایل‌ها (FILES)

~/.gnucash/config.auto

فایل پیکربندی تولیدشده به‌صورت خودکار برای هر کاربر. به صورت دستی ویرایش نکنید!

محیط (ENVIRONMENT)

GNC_DEBUG: فعال‌سازی خروجی اشکال‌زدایی. این متغیر به شما امکان می‌دهد اشکال‌زدایی را زودتر از آنچه با --debug ممکن است، در فرایند راه‌اندازی فعال کنید.
GUILE_LOAD_PATH: مسیری جایگزین برای مسیر بارگذاری scheme در GnuCash . نیازی به تغییر این متغیر نخواهید داشت. برای اطلاعات بیشتر فایل README را ببینید.
GNC_MODULE_PATH: مسیری جایگزین برای مسیر بارگذاری scheme در GnuCash برای ماژول‌های Gnucash . نیازی به تغییر این متغیر نخواهید داشت. برای اطلاعات بیشتر فایل README را ببینید.

گزارش باگ‌ها (BUGS)

لطفاً هرگونه باگ را با استفاده از فرم گزارش باگ در وب‌گاه GnuCash گزارش دهید.

همچنین ببینید (SEE ALSO)

GnuCash دارای راهنمای آنلاین جامعی است که از طریق منوی "help" در دسترس است.

اطلاعات بیشتر و آخرین نسخه در وب‌گاه زیر در دسترس است: https://www.gnucash.org

نویسندگان (AUTHORS)

Robert Merkel <rgmerk@mira.net> این صفحهٔ راهنما را نوشته است.

GnuCash توسط Robin Clark، Linas Vepstas و هزاران مشارکت‌کنندهٔ دیگر نوشته شده است.