GBS3(1)                                                                GBS3(1)



نام (NAME)
       gbs3 - مفسر و اسکریپت‌نویس گامباس (GAMBAS)


خلاصه دستور (SYNOPSIS)
       gbs3 [گزینه‌ها] [--] [<فایل اسکریپت> | <دایرکتوری پروژه> | -]
       gbs3 --convert-project <دایرکتوری مبدأ پروژه> <دایرکتوری مقصد اسکریپت>
       gbs3 --convert-script <فایل اسکریپت> [<مقصدی که دایرکتوری پروژه در آن
       ساخته می‌شود>]
       gbs3 [-p | --plugin] <فایل اسکریپت> [<دایرکتوری مقصدی که افزونه در آن
       ساخته می‌شود>]


توضیحات (DESCRIPTION)
       گامباس (Gambas) یک محیط توسعه آزاد مبتنی بر مفسر بیسیک (Basic) با
       اکستنشن‌های شیءگرا و ترکیبی از Java و Visual Basic است.  با گامباس
       می‌توانید به‌سرعت رابط کاربری گرافیکی برنامه‌های خود را با Qt یا GTK+
       طراحی کنید، به سیستم‌های پایگاه‌داده مانند MySQL، PostgreSQL، SQLite یا
       دیتابیس‌های ODBC دسترسی پیدا کنید، برنامه‌ها را با DBus هدایت نمایید،
       برنامه‌تان را به زبان‌های گوناگون ترجمه کنید، برنامه‌های GStreamer، OpenGL
       یا SDL بسازید، و مواردی از این دست...

       gbs3 مفسری است که امکان کامپایل و اجرای اسکریپت‌های گامباس را فراهم
       می‌کند.
       همچنین از gbs3 می‌توان برای تبدیل یک پروژه گامباس به اسکریپت، یا تبدیل
       مجدد یک اسکریپت به پروژه استفاده کرد.


گزینه‌ها (OPTIONS)
       -b, --buildonly
              پردازش و کامپایل اسکریپت بدون اجرای آن

       -c, --nocache
              اجبار به کامپایل اسکریپت (عدم بررسی حافظه موقت / کَش)

       --convert-project
              تبدیل یک پروژه گامباس به یک فایل اسکریپت اجرایی گامباس

       --convert-script
              تبدیل یک فایل اسکریپت گامباس به یک پروژه گامباس

       -e     اجرای کد منبع ارائه‌شده از طریق خط فرمان (با جداکننده ':' )

       -f, --fast
              استفاده از کامپایلر درجا (Just-In-Time / JIT)

       -g, --debug
              افزودن اطلاعات اشکال‌زدایی به برنامه

       -h, --help
              نمایش راهنما و خروج

       -l, --list
              نمایش فهرستی از مؤلفه‌ها یا کتابخانه‌های دردسترس، با -l component
              یا -l library

       -L, --license
              نمایش مجوز برنامه

       -p, --plugin
              تولید یک افزونه اجرایی که می‌تواند توسط سایر اسکریپت‌ها بارگذاری
              شود

       -S, --strict
              شکست عملیات در صورت تعریف 'Public' یا 'Sub' بدون تابع 'main'؛ در
              غیر این صورت ()main ساخته می‌شود

       -t, --trace
              فعال‌سازی گزینه ردیابی هنگام اجرا

       -T, --terse
              چاپ گزارش خطای بسیار مختصر هنگام خطاهای کامپایل

       -u, --use
              بارگذاری مؤلفه‌ها یا کتابخانه‌ها ('comp1,comp2,lib1...')

       -v, --verbose
              نمایش خروجی با جزئیات کامل

       -V, --version
              نمایش نسخه برنامه

       -w, --warnings
              نمایش هشدارها هنگام کامپایل


تبدیل پروژه (PROJECT CONVERSION)
       دستور gbs3 می‌تواند با استفاده از گزینه --convert-project یک پروژه
       گامباس را به یک فایل اسکریپت اجرایی تبدیل کند.  دایرکتوری ورودی پروژه
       برای ایجاد اسکریپت استفاده شده و اسکریپت حاصل در دایرکتوری خروجی نوشته
       می‌شود.  اسکریپت با همان نام پروژه اصلی ایجاد و نام‌گذاری می‌شود.

       gbs3 --convert-project MyProjectDirectory DestinationScriptDirectory


تبدیل اسکریپت (SCRIPT CONVERSION)
       دستور gbs3 می‌تواند با استفاده از گزینه --convert-script یک فایل اسکریپت
       را به یک پروژه کامل گامباس تبدیل کند.

       اسکریپت ورودی به پروژه‌ای با همان نام پایه (basename) اسکریپت تبدیل شده
       و در دایرکتوری مشخص‌شده ایجاد می‌شود.  در صورتی که دایرکتوری خروجی مشخص
       نشده باشد، از متغیر محیطی PWD به عنوان محل ایجاد پروژه گامباس استفاده
       می‌شود.

       gbs3 --convert-script MyScript.gbs ~/Projects

       این دستور دایرکتوری پروژه 'MyScript' را در دایرکتوری 'Projects' کاربر
       ایجاد می‌کند.


افزونه‌ها (PLUGINS)
       دستور gbs3 می‌تواند پس از ساخته شدن با استفاده از گزینه -p یا --plugin،
       افزونه‌هایی ایجاد کند که توسط سایر اسکریپت‌ها یا برنامه‌های گامباس قابل
       استفاده باشند.  افزونه‌ها در یک دایرکتوری انتخابی کاربر ساخته می‌شوند و
       بر خلاف یک اسکریپت معمولی که فایل‌های اجرایی آن در دایرکتوری موقت ایجاد
       شده و از آنجا اجرا می‌شوند، در همان دایرکتوری اجرا و کَش می‌گردند.  این
       امر باعث می‌شود که افزونه‌ها پس از خروج اسکریپت‌نویس پایدار بمانند.

       اگر مقصدی برای خروجی مشخص نشود، افزونه در دایرکتوری ~/.local/lib/gambas
       ایجاد می‌شود و می‌توان آن را از آنجا با استفاده از تابع ()component.load
       بارگذاری کرد.

       gbs3 -p MyPluginScript [Plugin Destination Directory]


مثال (EXAMPLE)
       #!/usr/bin/env gbs3
       for i as integer = 0 to 10
         print i;;
       next


دسترس‌پذیری (AVAILABILITY)
       آخرین نسخه گامباس همیشه از نشانی زیر قابل دریافت است:
       gambas.sourceforge.net

       مستندات این زبان در نشانی زیر قرار دارد:
       http://gambaswiki.org/wiki


گزارش باگ‌ها (REPORTING BUGS)
       گزارش باگ‌ها به http://gambaswiki.org/bugtracker


حق نشر (COPYRIGHT)
       Copyright© Benoît Minisini <benoit.minisini@gambas-basic.org>;

       این یک نرم‌افزار آزاد است؛ برای شرایط رونوشت‌برداری به کد منبع مراجعه
       کنید.  هیچ‌گونه ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک
       هدف خاص.

                                  August 2024                          GBS3(1)