🚫• کاستوم‌فیلتر ها ( CUSTOM FILTERS ) در #تلبات

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


📄 - لیست کامل فیلتر ها؛

AdvancedCustomFilter : کلاس‌پایه فیلتر
IsAdminFilter : محدود کردن به ادمین/اونر
ForwardFilter : محدود کردن به فوروارد
ChatFilter : تطابق چت‌ایدی
IsDigitFilter : محدود کردن به عدد
IsReplyFilter : محدود کردن به ریپلای
LanguageFilter : محدود کردن به LC
SimpleCustomFilter : کلاس پایه فیلتر سفارشی
StateFilter : محدود کردن استیت
TextContainsFilter : محدود کردن به وجود متن در آپدیت
TextFilter : محدود کردن متن تایپ ها
TextMatchFilter : محدود کردن متن مسیج
TextStartsFilter : محدود کردن متن مسیج با شروعی خاص

👍- حالا که با انواع فیلتر های موجود در تلبات آشنا شدیم، بیایید نحوه به کار بردن و استفاده عمومی از این فیلتر ها رو ببینیم و عملی انجام بدیم؛

1️⃣ توی قدم اول باید CUSTOM_FILTERS رو از تلبات ایمپورت و سپس با متد ADD_CUSTOM_FILTER فیلتر مورد نظر رو بر شی TELEBOT اعمال کنیم :

from telebot import TeleBot, custom_filters

app = TeleBot()

app.add_custom_filter(Custom_filters.TextStartsFilter()) #EX

2️⃣ بعد از اد کردن فیلتر مورد نظر به شئ تلبات و استفاده از فیلتر ها داخل هندلر، بایستی بسته به نوع فیلتر از KEY ها داخل هندلر استفاده کنیم. توی حالت کلی بنا بر نحوه پیاده سازی فیلتر ها، KEY ها میتونن هر مقداری باشند، با فرض وجود کد بالایی و اعمال کردن فیلتر START TEXT FILTER این سمپل رو با KEY مختص به این فیلتر ببینید :

@app.message_handler(text_startswith='XD')
def _(message):
   ...

😎 حالا این هندلر در صورتی فعال و شروع به کار میکنه که آپدیت دریافتی‌ تکست و با "XD" شروع شده باشه، پس در نهایت :

from telebot import TeleBot, custom_filters
from telebot.types import Message 

app = TeleBot()

@app.message_handler(text_startswith='XD')
def _(message: Message):
    app.reply_to(message=message, text='XD')

app.add_custom_filter(custom_filters.TextStartsFilter())
app.infinity_polling()

👀- حالا که با نحوه کلی و جامع پیاده سازی کاستوم‌فیلتر ها آشنا شدید، ليست KEY و تایپ های هر فیلتر رو با هم ببینیم :

💡FilterName : Key | Type

ChatFilter : key = chat_id | type = List

TextContainsFilter : key = text_contains | type = List

TextMatchFilter : key = text | type = List

LanguageFilter : key = language_code | type = List

ForwardFilter : key = is_forwarded | type = Bool

IsAdminFilter : key = is_chat_admin | type = Bool

IsDigitFilter : key = is_digit | type = Bool

IsReplyFilter : key = is_reply | type = Bool
StateFilter : key = state | type = Int

TextStartsFilter = key = text_startswith | type = String

🧑‍🎓- پس ی جمع بندی کلی و کامل داشته باشیم، برای استفاده از هر فیلتر کافیه با متد ADD_CUSTOM_FILTER اون رو به شئ TELEBOT اد کنیم و با KEY هاشون، هندلر ها رو به آپدیت های خاصی محدود کنیم، از طرفی مانع کد زدن اضافی و از طرف دیگه موجب تمیزی و خوانایی و از همه مهم‌تر مدیریت کد‌هامون رو راحت تر میکنه، فعلا در همین اندازه شناخت داشته باشید، طی پست های آینده، از بیسیک‌ و ریشه‌ای ترین فیلتر ها اقدام به کالبد شکافی میکنیم بصورت مفصل.


پ‌ن؛ حالا انتخابتون چیه؟! 🤔 استفاده از کاستوم‌فیلتر ها یا نوشتن شروط پیچیده و استفاده از FUNC LAMBDA؟!

😎 CodingLovers | #Farshad

3k ❤️

🥱• روز دوم رو با کلاس پایه کاستوم فیلتر شروع کنیم.

پایه‌ای ترین کارکرد کاستوم فیلتر رو میتونیم با SIMPLE CUSTOM FILTER پیاده سازی کنیم، چطوری؟! کافیه اقدام‌ به ساخت ی چیلد‌ کلس با فیلتر مورد نظر در متد CHECK کنیم، توی حالت کلی به عنوان پارامتر ورودی مجاز به دریافت یک پارامتر و در نهایت بولین TRUE یا FALSE ریترن میکنه. بریم که توی عمل نحوه پیاده‌سازیش رو داشته باشیم.

1️⃣- طبق معمول‌ و روال گذشته بایستی وابستگی ها رو از CUSTOM_FILTERS ماژول تلبات ایمپورت کنیم؛

from telebot import TeleBot 
from telebot.custom_filters import SimpleCustomFilter 

app = TeleBot() 

2️⃣- توی قدم بعدی باید اقدام به ساخت  کلاس و اد کردن اون به شئ تلبات کنیم، ساختار این کلاس به این صورت باید باشه که به عنوان کلاس والد SIMPLECUSTOMFILTER رو دریافت و با ایجاد KEY اختصاصی خود و تکمیل و کاستوم کردن متد CHECK توی هندلر هامون مورد استفاده قرار بگیره، مثالی از پیاده سازیش ببینید که در ادامه قراره نکات مهمی رو مرور کنیم؛

__Bot_Status__: str = 'ON' 

class CodingLovers(SimpleCustomFilter):
    key: str = 'XD'

    @staticmethod
    def check(update):
        return (__Bot_Status__ == 'ON') 

app.add_custom_filter(CodingLovers())

🚫- نکات و الزامات این بخش:
🔵نام متد CHECK باید دقیقا به همین صورت باشه!
🟡متد CHECK حداکثر ی پارامتر که همون آپدیت هندلر باشه رو میتونه دریافت کنه ( برعکس ADVANCEDCUSTOMFILTER که در آینده باهاش آشنا میشیم )

👀- پس در نهایت این سمپل رو خواهیم داشت؛
پ‌ن، اینجا __BOT_STATUS__ رو شما حالتی فرض کنید که قراره چک کردن واقعی اتفاق بیوفته، حقیقتا مثال دیگه ای به ذهنم نرسید ☺️

from telebot import TeleBot 
from telebot.types import Message 
from telebot.custom_filters import SimpleCustomFilter

app = TeleBot() 

__Bot_Status__: str = 'ON' 

class CodingLovers(SimpleCustomFilter):
    key: str = 'XD'

    @staticmethod
    def check(update):
        return (__Bot_Status__ == 'ON')

@app.message_handler(commands=['start'], XD=True)
def _(message: Message):
    app.reply_to(message=message, text='XD') 
    
@app.message_handler(commands=['start'], XD=False)
def _(message: Message):
    app.reply_to(message=message, text='Bot is Off')

app.add_custom_filter(CodingLovers())
app.infinity_polling()

اگه بخوایم کامل تشریح کنیم که چه فرایندی توی این کد طی میشه، باید گفت : با ايجاد کلاس فیلتر مورد نظرمون و تکمیل کردن متد CHECK، در قدم اول به شی TELEBOT اد میشه و میتونیم داخل همه هندلر هامون با KEY یونیکی که واسه فیلتر در نظر گرفتیم استفاده کنیم، وقتی توی هندلر اولیمون که کامند استارت رو هندل میکنه از این فیلتر استفاده میکنیم و KEY که در این کد XD هست رو برابر بولین TRUE میزاریم، در صورتی هندلر شروع به کار و انجام دادن بلوک زیرینش میکنه که شرط داخل متد CHECK فیلرتمون برابر با TRUE باشه و در صورتی هندلر دومی شروع به کار میکنه که شرط متد CHECK فیلترمون برابر با بولین FALSE باشه!  مثال دیگه ای پیاده سازیشو میتونین اینجا ببینین، همچین اگه سوال یا ابهامی داشتید کامنت کنید.

😎 CodingLovers | #Farshad

پست های بعدی در چه باب، موضوع و یا شاخه ای باشه؟! 🤔 توی تلبات عمیق تر شیم یا..؟!

از اونجایی که توی مینی نظرسنجی قبلی هم موافق ادامه دادن و عمیق شدن توی تلبات و هم گریزی به سایر شاخه و مسائل بودین، بنا به درخواست رفقا امروز رو اختصاص میدیم به بحث برنامه نویسی موازی، بحثی که همیشه چالش برانگیز بوده ☺️

واسه آشنایی و توضیحات بیشتر، باید توی وحله اول با مفاهیم و کارکرد ی سری موارد آشنا بشیم.

ASYNCHRONOUS | ناهمگام
SYNCHRONOUS | همگام
PROCESS | پراسس
MULTI PROCESSING | چند پراسسی
THREAD | نخ، رشته
MULTI THREADING | چند نخی
CONCURRENCY | کانکرانسی

🧠• پردازنده / CENTRAL PROCESSING UNIT :

میدونیم که پردازنده یا سی‌پی‌یو قلب تپنده هر کامپیوتریه، این قلب تپنده مسئول پردازش دستورات و انواع محاسبات و از جهت دیگه مغز کامپیوتره.

توی حالت کلی و پایه‌ای عملکرد سی‌پی‌یو به سه گام خلاصه میشه؛
🟡واکشی ( FETCH ) : به زیان ساده اگه بخوایم بیان کنیم، به معنی دریافت واکنش و دستورالعمل هست، دستورالعملی که در قالب و بصورت صفر و یک از طریق رم ارسال میشن.
🔵رمزگشایی ( DECODE ) : وقتی ی دستور واکشی دریافت و ذخیره میشه، سی‌پی‌یو دستور رو به بخش INSTRUCTION DECODER منتقل میکنه و اونجا به سیگنال هایی واسه فرستاده شدن به مابقی بخش های سی‌پی‌یو تبدیل میشه.
🟣اجرا ( EXECUTE) : داخل این بخش و مرحله دستور دیکد شده مرحله قبل تحلیل و اجرا میشه، اجرا شدن دستور بسته به نوع دستور ممکنه محاسباتی، منطقی، ورودی خروجی و یا کنترلی باشه.

❕• آیا روند کارکرد CPU از قدیم تا الان به ی صورت بوده؟! روند رویه‌ای، چالش های اون و ظهور مولتی تسکینگ :

کامپیوتر‌ های قدیمی با سی‌پی‌یو ها تک پردازنده‌ای ساخته میشدن، هر فعالیت یا پروسه‌ای شامل چندتا دستور فرض میشد که بصورت پشت‌‌سر هم نوشته و به همون صورت هم اجرا میشدن، یعنی استراتژیک کلی به این صورت بود که ی فعالیت واحد با دستوراتش وارد سی‌پی‌یو می‌شد و تمامی دستوراتش به ترتیب اجرا می‌شد، بعد از انجام و تموم شدن پردازش فعالیت، فعالیت بعدی وارد می‌شد، به این حالت از اجرا به اصطلاح "SINGLE TASKING" یا "روند رویه‌ای" میگن.

کامیپوتر های جدید استراتژیک جدید تری اعمال کرد که اجرای همزمان چندین فعالیت و فرایند رو به ارمغان میاره که به اصطلاح "MULTI TASKING" یا "چند وظيفگی" هستن، البته نه به این صورت که همزمان دو یا چند فعالیت رو انجام بدن!! پس چطور میشه که همزمان چندین فعالیت رو انجام میده👀؟! تریکی که اینجا وجود داره مفهوم "سوئچینگ" هست.

سوئیچینگ تکنیک و تریک کامپیوتر های جدیده، یعنی با سوئیچ کردن مداوم بین دستورات مختلف چندین فعالیت رو انجام میده!! عملیات سوئیچینگ خیلی سریع اتفاق میوفته بصورتی که احساس و درکی توی حالت عادی از اون نداریم و حس میکنیم چندین فعالیت با هم انجام میشن.

حالا که به درک جامعه‌ای از CPU و کارکردش رسیدیم، میرسیم به بحث اصلیمون یعنی آشنایی با مفاهیم اولیه موضوعمون، ترجیح میدم از کانکارنسی یا هم‌روندی شروع کنم.

🙄• منظور از کانکارنسی چیه؟!

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

🤔• اهدافمون از استفاده کانکارنسی چیه؟!

بطور خلاصه ای اگه بخوایم بگیم، چندتا هدف اصلی و کلی داره :

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

🔵پردازش و پاسخگویی بیشتر از فعالیت ها : کانکارنسی به سیستم ها این امکان رو میده که در عین واحد به‌طور همزمان به چندین درخواست پاسخ بده و اون‌هارو پردازش کنه، اپلیکیشن مثال قبلیمون رو دوباره تصور کنین، همچین اپلیکیشنی که متصل و وابسته به دیتابیس و API هست میتونه توی هر بخشی از خودش بصورت همزمان به کاربر ها پاسخ بده و فعالیت هاشون رو پردازش کنه بدون اینکه ی کاربر منتظر بمونه درخواست ی کاربر دیگه انجام بشه و نوبتش بشه.

🟢استفاده بهینه از منابع : منطقا با اجرای همزمان چندین فرایند میتونیم از منابع سخت افزاری به‌طور بهینه استفاده کرد.

پ‌ن؛ حالا که با گوشه‌ای از نحوه‌ کارکرد CPU آشنا شدیم، با CPUهاتون مهربون تر برخورد کنین 😆

😎 CodingLovers | #Farshad

💤• روز جدید رو با آشنایی PROCESS شروع‌ کنیم.

پراسس / PROCESS چیه؟!

پراسس به عنوان ی مفهوم کلیدی توی سیستم‌عامل ها، نماینگر فعالیت‌هاییه که توی پس‌زمینه در حال اجرا هستن، وقتی ی برنامه و فعالیت رو شروع میکنین، سیستم‌عامل ی پراسس واسش ایجاد میکنه که این پراسس شامل تمامی موارد موردنیاز اجرا شدن برنامه میشه، مثلا سورس‌کد، داده‌ها، وضعیت اجرایی و..
فرض کنین در حال کار با سیستم هستین و برنامه‌ی VSCODE رو باز و شروع به کد زدن میکنین، وقتی این برنامه رو باز میکنین سیستم عامل ی درخواست مبتنی بر ایجاد پراسس جدید ارسال میکنه و پراسس ایجاد میشه، در ادامه با نحوه ایجاد شدنش مفصل تر آشنا میشیم.

پراسس ها چه رفتار هایی رو توی مدت زمان حیاتشون انجام میدن؟!

توی ی حالت کلی به شش حالت و عملکرد تقسیم میشن :
ایجاد و ساخته شدن / CREATION : بالاتر گفتیم که با باز و ران کردن ی برنامه، پراسسی ایجاد میشه، اگه بخوایم دقیق تر بیان کنیم، باید گفت ی پراسس زمانی ایجاد میشه که برنامه به حافظه بارگذاری بشه، این مرحله  شامل تخصیص منابع و بلوک کنترل میشه.

انتقال بین استیت ها : پراسس ها میتونن حالت های مختلفی داشته و توی این حالت ها جابه‌جا بشن ( درحال ایجاد ، درحالت تخصیص CPU، درحال اجرا توسط CPU، منتظر ی رویداد مثلا ورودی خروجی و یا توی حالت اتمام شده خودشون باشن ).

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

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

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

پایان پراسس : توی حالت عادی، وقتی پراسس کار خودش رو تموم میکنه به حالت پایان یافته منتقل میشه و سیستم عامل اقدام به پاکسازی برخی از اجزا مثل حافظه RAM و یا بلوک کنترل پراسس میکنه، البته باید اشاره کنم که همیشه اوضاع به همین خوب و خوشی نیست ممکنه مشکلاتی ایجاد بشه و پراسس تغیر کنه، توی ادامه پست بیشتر آشنا میشیم با این مورد.

هر پراسس چه ویژگی هایی میتونه داشته باشه؟!

هر پراسسی که توسط سیستم‌عامل ایجاد میشه بطور خاص دارای مشخصات خاصیه :

استفاده از رم / RAM : هر پراسسی مقداری از رم رو به خودش اختصاص میده که خودش به دو نوع اصلی تقسیم میشه ( استک : واسه ذخیره‌سازی متغیر و داده های محلی، هیپ : واسه ذخیره‌سازی اشیاء و داده‌های داینامیک )

استفاده از سی‌پی‌یو / CPU : هر پراسس به نوبت بسته به نوع و هسته CPU، از CPU استفاده میکنه، توی پست های قبلی با CPUها آشنا شدیم، توی کامپیوتر های جدید هر پراسس با سوئیچینگ با ترتیب از CPU استفاده میکنه.

داشتن شناسه پراسس / PID : هر پراسسی واسه شناسایی شدن توی سیستم دارای ی PID یونیکیه.

پراسس ها از نظر وضعیت و مدیریت چند نوع هستن؟!

قبل اینکه حالات پراسس رو بیان کنیم باید با دوتا مسئله آشنا بشیم، یکی پراسس والد و یکی پراسس فرزند :

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

توی حالت عادی، پراسس ها رو از نظر وضعیت میتونیم به دو دسته اصلی تقسیم کنیم، پراسس های یتیم و پراسس های زامبی!! :

پراسس های یتیم : این پراسس ها وقتی ایجاد میشن که پراسس والد قبل از تموم شدن کارش، تموم میشه، توی همچین موقعیتی معمولا سیستم عامل این پراسس رو به عنوان "INIT" نامگذاری میکنه که کمک مدیریتی ایجاد بشه ( تصور کنین ی کودک وجود داره که باباش تنهاش گذاشته 🐱 ) .
پراسس زامبی : وقتی به پراسسی به اصطلاح پراسس زامبی میگیم که کارش تموم شده ولی هنوز اطلاعاتش توسط والد خونده نشده 👀، معمولا به این پراسس، پراسس مرده هم میگن! درکل بدونین که تا وقتی توسط والد خونده نشه موجب مصرف منابعه و توی حالت انتظار قرار داره، پس از این به بعد مراقب باشین که پراسس والد رو KILL نکنین چون ممکنه پراسس های فرزند یا نابود و یا به زامبی تبدیل بشن، شما که ادم‌کُش نیستید نه؟! ( شوخی 😆 )

😎 CodingLovers | #Farshad@CodingLovers_OFF

قصد داشتم توی ی پست حداقل دو مورد از موارد لیست رو تشریح کنم، ولی امان از محدوديت کاراکتر، حتی نشد از ایموجی هم استفاده کنم 👀