نام (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)

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