بخش اول آموزش

ما ابتدا برای برنامه نویسی بهتر و راحت تر بازو ها در پایتون، از پکیجی به نام پایتون بله بات ، یا نام کامل python-bale-bot آشنا میشویم و برای این کار آن را نصب میکنیم.

این پکیج به دلیل پشتیبانی آن از asyncio، ایونت های آن ابتدا با async و متد های آن در فانکشن‌هایی که با async آغاز میشوند، با await شروع میشود.

برای نصب این پکیج به رویه زیر عمل کنید.

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

در صورتی که پایتون را ندارید، ابتدا آن را نصب کنید.

سی ام دی خود را باز کنید.

چطور سی‌ام‌دی خود را باز کنیم؟

عبارت pip install python-bale-bot را به صورت کامل و بدون نقص وارد نمایید.

به همین راحتی پکیج مورد نیاز شما برای برنامه‌نویسی بازو های بله، نصب شد.

در صورتی که از این آموزش خوشتون اومد، با کلیک بر روی لایک به نویسنده این آموزش‌ها انرژی بدید.

بخش سوم آموزش

به بخش اصلی یعنی برنامه نویسی بازو ها رسیدیم، در این بخش برنامه نویسی بازو هارا شروع میکنیم.

برای شروع برنامه نویسی به رویه زیر عمل کنید.

یک فایل چدید با پسوند .py ایجاد کنید.

بر روی آن کلیک راست کرده و آن را با VSCode (Visual Stodio Code) باز کنید.

ما برای نوشتن یک ربات خام و ابتدایی، در شروع کار، کتابخانه بله را ایمپورت میکنیم.

import bale

حال فایل را با استفاده از پایتون اجرا میکنیم، در صورتی که اروری ملاحضه نکردید یعنی پکیج به صورت کامل نصب شده و مشکلی وجود ندارد. در غیر این صورت و در صورتی که اروری در این بخش دریافت کردید، احتمال دارد پکیج به درستی نصب نشده باشد.

به همین راحتی کار اولیه مورد نیاز شما برای برنامه نویسی بازو های بله، انجام شد.

در صورتی که از این آموزش خوشتون اومد، با کلیک بر روی لایک به نویسنده انرژی بدید.

برترین کانال آموزش ساخت بازوی بله

نشانی: @programming_bale_bot

بخش چهارم آموزش

به بخش برنامه نویسی بازو ها و بخش اصلی رسیدیم، در این بخش برنامه نویسی بازو هارا شروع میکنیم.

برای شروع برنامه نویسی به رویه زیر عمل کنید.

یک فایل چدید با پسوند .py ایجاد کنید.

بر روی آن کلیک راست کرده و آن را با VSCode (Visual Stodio Code) باز کنید.

ما برای نوشتن یک ربات خام و ابتدایی، در شروع کار، کتابخانه بله ( یا همان python-bale-bot ) را ایمپورت میکنیم.

import bale

حالا با استفاده از شیء بات (Bot) بخش اصلی بازو را ایجاد میکنیم و آن را برابر با متغیری دلخواه (برای مثال bot) قرار میدهیم.

import bale
bot = bale.Bot(token = "Your Token")

حال با استفاده از دستور run بازو را اجرا میکنیم.

import bale
bot = bale.Bot(token = "Your Token")
bot.run()

در اجرای این برنامه تا به اینجای در ظاهر کار اتفاقی رخ نمی دهد. اما فرض کنید میخواهید هنگامی که کاربر پیامی به کاربر داد، بازو جواب وی را با پیامی بدهد.

‌ برای استفاده و تنظیم ایونت ها ما نیاز به متد و context منیجری به نام listen داریم.

یادآوری: این پکیج به دلیل پشتیبانی آن از asyncio، ایونت های آن ابتدا با async و متد های آن در فانکشن هایی که با async آغاز میشوند، با await شروع میشود.

import bale
bot = bale.Bot(token = "Your Token")
@bot.listen("on_message")
async def when_message(message: bale.Message):
     pass
bot.run()

برای ریپلای کردن بر روی پیام ارسالی کاربر، از پارامتر داده شده در فانکشن استفاده کرده و از دستور reply آن استفاده میکنیم.

import bale
bot = bale.Bot(token = "Your Token")
@bot.listen("on_message")
async def when_message(message: bale.Message):
     await message.reply(text="Salam!")
bot.run()

این دستور پارامتر های text و components را دریافت میکند که میتوان با پارامتر دوم، کیبورد و یا دکمه در پیام (Inline Keyboard) ایجاد نمود.

به همین راحتی برنامه نویسی یک بازوی خام با استفاده از پکیج بله، انجام شد.

در صورتی که از این آموزش خوشتون اومد، با کلیک بر روی لایک به نویسنده انرژی بدید.

برترین کانال آموزش ساخت بازوی بله

نشانی: @programming_bale_bot

بخش پنجم آموزش

در بخش پیش به آموزش برنامه نویسی بازو ها به طور اختصاصی پرداختیم. اما در این بخش قصد داریم متد های جدید تر را معرفی نمائیم. در این آموزش دو متد جدید را برای معرفی انتخاب کرده ایم.

پارامتر components در Message.reply

فانکشن message.delete() برای پاک کردن پیام ارسالی و یا پیام ارسال شده توسط کاربر

برای پارامتر components به صورت زیر عمل میکنیم.

قسمت اولیه

پس در نتیجه ما در این متد یک پارامتر components را دارا بودیم، که برای استفاده از آن باید از کلاس bale.Components استفاده کرد. این کلاس دارای دو پارامتر اجباری است، که وارد کردن یکی از پارامتر ها اجباری و وارد کردن دو تا از پارامتر ها به صورت همزمان ممنوع است .

پارامتر اول inline_keyboard می باشد که در واقع همان مفهوم دکمه در پیام را دارا می باشد. برای استفاده از این پارامتر از کلاس bale.InlineKeyboard استفاده میکنیم.

پارامتر دوم keyboard می باشد که در واقع همان مفهوم دکمه را دارا می باشد. برای استفاده از این پارامتر از کلاس bale.Keyboard استفاده میکنیم.

برای پاک کردن متغیری از نوع bale.Message به صورت زیر عمل میکنیم.

در صورتی که در کد خود و ایونت on_message، میخواهیم از پیام کاربر استفاده کنیم، از همان پارامتر اولی که به ما داده میشود استفاده میکنیم. یعنی ما یک متغیر به نام message از نوع bale.Message داریم.

حال برای پاک کردن پیام، درصورتی که دسترسی های لازم را داشته باشیم، از فانکشن delete استفاده میکنیم. این متد بدون پارامتر می باشد.

به همین راحتی فرآیند یادگیری دو بخش جدید از کتابخانه بله، طی شد.

در صورتی که از این آموزش خوشتون اومد، با کلیک بر روی لایک به نویسنده انرژی بدید.

برترین کانال آموزش ساخت بازوی بله

نشانی: @programming_bale_bot