سلام بچه ها 👋

ببخشید بچه ها یکم سرمون شلوغ شده نرسیدیم پست از کتاب بذاریم ايشالا از شنبه دوباره شروع میکنیم 🌹

بچه ها متاسفانه اکثرتون از پیج اینستامون حمایت نمیکنید 🥲

لطفا پیج اینستامون هم فالو کنید
هر روز پست خفن میذاریم اینستا

هر پیشنهادی برای پست اینستامون دارید هم کامنت بذارید، همرو میخونیم 🌹

لینک پیج اینستامون:

https://www.instagram.com/ninja_learn?igsh=MXhxa2twd2w4OWJseQ==

بیشتر از ۴۷۰ نفر هستید بچه ها

۲۰۰ نفرتون پیجمون رو فالو کنن کلی انرژی میگیریم برای تولید محتوا

ما زمان میذاریم و دانش و تخصصمون رو از طریق تولید محتوا و ضبط دوره رایگان باهاتون به اشتراک میذاریم

وقتشه شماهم حمایت خودتون رو از ما نشون بدید ❤️

https://www.instagram.com/ninja_learn?igsh=MXhxa2twd2w4OWJseQ==

دوستان یوتوبم ساب داشته باشید به جز دوره ویدیو های اموزشی هم میزاریم 😉

https://youtube.com/@ninja_learn_ir?si=Wru4ZDvT9IGf1lnp

💎💎ربیت ام کیو RabbitMQ 💎💎

سلام بچه ها 👋

امروز میخواهیم در مورد ربیت ام کیو با هم صحبت کنیم🗣🗣


1️⃣ربیت ام کیو چی هست؟🤔
یک نرم افزار برای انتقال پیام بین سیستم ها است که میتونیم بین سیستم های مختلف پیام ارسال کنیم وبدون این که نیاز به ارتباط مستقیم و همزمان داشته باشن و با هم صحبت کنن و اطلاعاتشون رو به اشتراک بگذارند.
نوع پردازش پیام ها به صورت async هست و ربیت ام کیو با استفاده از زبان Erlang توسه داده شده هست
ربیت ام کیو مبتنی بر پروتوکل  AMQP (advantage message queuing protocol)
بخواهیم پروتوکل AMPQ رو به زبان ساده تر بگیم میشه یک استاندارد برای انتقال پیام ها بین سیستم ها و سرویس های مختلف دانست که  سیستم ها و سرویس ها را رو  به یکدیگر عملا متصل میکند.

اگه بخواهم به مثال عملی براتون بزنم🤗🫰
فرض کنیم یه اپلیکیشن فروشگاهی داریم که بخش های مختلفی مثل ثبت سفارش و انبار داری و ارسال کالا داره هر کدوم از بخش ها  باید با هم در ارتباط باشن  و اطلاعات رو به موقع رد و بدل کنن ایجا هست که RabbitMQ وارد عمل میشه با استفاده از RabbitMQ هر بخش میتونه پیام های خودش رو به صف ارسال کنه و بخش ها دیگر هر زمان نیاز بود این پیام ها رو دریافت و پردازش کنن این کار باعث میشه که بخش های مختلف یستم بتونن متقل از هم کار کنن و هر کدوم در زمان مناسب خودش پیام ها رو پردازش کنن



خوب حالا بیاییم به چندین قابلیت ربیت ام کیو بپردازیم

queu

صف مکان هایی هستند که پیام ها به صورت موقت درون اون ذخیره خواهد شد  تا زمانی که توسط مصرف کننده دریافت و پردازش بشن صف ها این امکان رو فراهم میکنن که پیام ها به ترتیب دریافت و پردازش بشن

Exchange

مبادله کننده یا exchange نقش مسیریاب رو دارن و تصمیم میگیرن که پیام ها به کدام صف ها ارسال بشن

consumer

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

routing

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

scalability

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

Reliability

یک امکان اطمینانی برای ارسال و دریافت پیام فراهم میکند  که در صورت بروز خطا یا خاموشی سیستم مورد نظر  پیام ها درون صف باقی بماند

load balancers

برای این که پیام ها به صورت متوازن باشد از الگوریتم round robin استفاده میکند که به مدیریت بهتر منابع و بار سیستم کمک کند
round robin: هر پیام به صورت برابر یک زمانی دریافت میکند و هیچ فرایند برای مدت طولانی در حالت انتظار باقی نمیماند

delay messaging

این امکان رو فراهم میسازد که پیام ها در یک صف معین پس از مدت زمان مشخص پردازش شوند

security

برای رمز نگاری ارتباطات بین تولید کننده و مصرف کننده و از TLS/ssl استفاده میکند

plugin & extentions

ربیت ام کیو برای گسترش خود قابلیت اضافه کردن پلاگین ها را برای گسترش ویژگی های خود دارد

federation
این امکان رو دارد که چندین نود در مکان های مختلف جغرافیایی قرار دارد به یکدیگر متصل شود و به کمک این پلاگین میتوان پیام ها رو بین چندین سرور RabbitMQ به اشتراک گذاشت

shovel
این پلاگین برای انتقال پیام بین دو نود در RabbitMQ به کار میرود این پلاگین پیام ها رو از یک صف در نودی به صفی دیگر در نود دیگری منتقل میکند

monitoring

ربیت ام کیو این امکان رو فراهم میسازد که یک رابط وب برای مشاهده وضعیت سیستم ها و صف ها و پیام ها استفاده میشود

multiple client

از زبان های برنامه نویسی مختلفی مانند جاوا و سی شارپ و پایتون و گو و جاوا اسکریپت و بسیاری دیگر از ربان ها رو  پشتیبانی میکند این باعث میشود که برنامه های مختلف بتواند با هم به راحتی ارتباط برقرار کنند

مرسی که تا اینجا همراه من بودید، امیدوارم این توضیحات براتون مفید بوده باشه. اگه سوال یا نظری دارید حتماً تو کامنتا بنویسید 😁✌️


@ninja_learn_ir

〰〰〰〰
Author:@LOOOOOVEEEEEEYOU

بچه ها پست جدید پایتونی داریم تو اینستا 😍

بیاید حمایت کنید ❤️

https://www.instagram.com/p/C_lTntdIzVq/?igsh=ZXJsdDZlcXRhZGJ6

💎 پروکسی (proxy) چیه و به چه دردی میخوره 💎

امروز می‌خوایم راجع به یه موضوع خیلی پرکاربرد و مهم حرف بزنیم: پروکسی (Proxy).
شاید براتون سوال باشه که پروکسی چیه و دقیقاً چه کاری انجام میده؟ 🤔
بیاید باهم بیشتر بررسی کنیم.

پروکسی یعنی چی؟ 🤷‍♂️
پروکسی یه نوع واسطه‌ست که بین دستگاه شما (مثلاً کامپیوتر یا موبایلتون) و اینترنت قرار می‌گیره. وقتی از پروکسی استفاده می‌کنید، درخواست‌هاتون (مثل وقتی یه سایت رو باز می‌کنید) اول به سرور پروکسی میره و بعد از اونجا به مقصد اصلی (یعنی همون سایت) فرستاده می‌شه. به همین خاطر، سایت مقصد هیچ‌وقت نمی‌فهمه شما دقیقاً از کجا بهش وصل شدید، چون فقط آی‌پی سرور پروکسی رو می‌بینه 😎

پروکسی چه کاربردهایی داره؟ 🤓

دور زدن محدودیت‌ها 🚫:
یکی از معروف‌ترین کاربردهای پروکسی اینه که می‌تونید باهاش فیلترها و محدودیت‌های اینترنتی رو دور بزنید. مثلاً اگه سایتی تو کشور ما فیلتر باشه، ( که ماشالله همه چی فیلتره) می‌تونید با استفاده از یه پروکسی از کشوری دیگه به اون سایت دسترسی پیدا کنید.

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

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

مدیریت پهنای باند 📊:
توی شبکه‌های بزرگ (مثلاً تو شرکت‌ها)، مدیران شبکه می‌تونن از پروکسی برای مدیریت پهنای باند استفاده کنن. اینطوری می‌تونن ترافیک اینترنت رو کنترل کنن و استفاده از منابع رو بهینه کنن.

انواع پروکسی 🌐

HTTP Proxy:
این نوع پروکسی فقط درخواست‌های HTTP رو هندل می‌کنه. یعنی وقتی شما یه سایت رو با مرورگر باز می‌کنید، درخواست شما از طریق این پروکسی عبور می‌کنه. اما این نوع پروکسی نمی‌تونه درخواست‌های
غیر HTTP (مثلاً FTP) رو پشتیبانی کنه.

SOCKS Proxy 🧦:
این یکی از همه خفن تره و تقریباً هر نوع ترافیکی رو پشتیبانی می‌کنه. می‌تونید ازش برای ارسال ایمیل، دانلود فایل یا حتی بازی‌های آنلاین استفاده کنید. اما باید بدونید که SOCKS پروکسی به‌خودی‌خود اطلاعات رو رمزنگاری نمی‌کنه و فقط ترافیک رو هدایت می‌کنه.

Transparent Proxy (پروکسی شفاف) 🛠️:
این نوع پروکسی بدون اینکه شما متوجه بشید، درخواست‌هاتون رو هدایت می‌کنه. معمولاً مدیران شبکه یا ارائه‌دهندگان اینترنت از این نوع پروکسی استفاده می‌کنن تا ترافیک رو مانیتور یا فیلتر کنن.

Reverse Proxy (پروکسی معکوس) 🔄:
این نوع پروکسی برعکس بقیه‌ست. یعنی به جای اینکه درخواست‌های شما رو به اینترنت بفرسته، درخواست‌های اینترنت رو به سرورهای داخلی هدایت می‌کنه. معمولاً برای توزیع بار سرور یا افزایش امنیت سرورها از این مدل استفاده می‌شه.

مزایا و معایب پروکسی 💡❌

مزایا ✅:

مخفی کردن هویت و آی‌پی شما
دور زدن محدودیت‌ها و فیلترینگ
مدیریت بهتر پهنای باند تو شبکه‌ها
افزایش امنیت و حفظ حریم خصوصی

معایب ⭕:

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

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

امید وارم این پست براتون مفید بوده باشه :)

#Proxy #پروکسی #حریم_خصوصی #امنیت #اینترنت #فیلترشکن #network

@ninja_learn_ir

قسمت ۱۸ دوره DRF منتشر شد 😁

تواین قسمت میریم و مدل user دیفالت جنگو رو کاستوم میکنیم


مشاهده قسمت ۱۸


@ninja_learn_ir

📕 کتاب REST API Design Rulebook

📌 فصل دوم: Identifier Design with URIs

📍پارت: سوم

#book

‏💎 Document 💎
یک سند مثل یه مفهوم singular هست که شبیه یه instance از یه آبجکت یا رکورد توی دیتابیسه.
معمولاً یه سند شامل چند تا فیلد با مقادیر مشخص و یه سری لینک به منابع دیگه‌ست.

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

این URI‌ها هر کدوم یه منبع سند رو نشون میدن:

https://api.soccer.restapi.org/leagues/seattle

https://api.soccer.restapi.org/leagues/seattle/teams/trebuchet

https://api.soccer.restapi.org/leagues/seattle/teams/trebuchet/players/mike

یه سند ممکنه منابع فرعی داشته باشه که زیرمجموعه‌های خاصش رو نشون میدن.
چون می‌تونه چندین نوع منبع مختلف رو زیر یه والد قرار بده، سند گزینه مناسبی برای منبع اصلی یه REST API (که بهش "docroot" هم می‌گن) محسوب می‌شه.

اینم یه مثال از URI که docroot رو نشون میده و همون اندپوینت API فوتباله:

https://api.soccer.restapi.org

‏💎 Collection 💎
یک مجموعه (Collection) مثل یه دایرکتوریه که سرور اون رو مدیریت می‌کنه و شامل یه سری منابعه.
کلاینت‌ها می‌تونن پیشنهاد بدن که منابع جدید به مجموعه اضافه بشن، ولی در نهایت این خود مجموعه‌ست که تصمیم می‌گیره یه منبع جدید بسازه یا نه. مجموعه خودش انتخاب می‌کنه چی رو توی خودش نگه داره و همچنین URI (آدرس) هر منبعی که داخلش هست رو هم خودش تعیین می‌کنه.

هر کدوم از URI‌های زیر یه مجموعه (Collection) رو نشون می‌ده:

https://api.soccer.restapi.org/leagues

https://api.soccer.restapi.org/leagues/seattle/teams

https://api.soccer.restapi.org/leagues/seattle/teams/trebuchet/players

‏💎 Store 💎
یک Store منبعیه که توسط کلاینت مدیریت می‌شه. Store به کلاینت API این امکان رو می‌ده که منابع رو داخلش بذاره، دوباره اون‌ها رو بیرون بیاره، و تصمیم بگیره کی اون‌ها رو حذف کنه. خود Store منابع جدید نمی‌سازه، بنابراین هیچ وقت URI جدید ایجاد نمی‌کنه. در عوض، هر منبعی که داخل مخزن گذاشته می‌شه، URI داره که کلاینت موقع اضافه کردنش انتخاب کرده.

تعامل زیر یه مثال از کاربر (با شناسه 1234) در یه برنامه کلاینت رو نشون می‌ده که از یه API فرضی فوتبال استفاده می‌کنه تا یه سند به اسم «آلونزو» رو توی مخزن علاقه‌مندی‌های خودش قرار بده:

PUT /users/1234/favorites/alonso

‏💎 Controller 💎
کنترلر یه مفهوم رویه‌ای (procedural) رو مدل‌سازی می‌کنه. کنترلرها شبیه به توابع اجرایی هستن که ورودی و خروجی دارن و پارامترها و مقادیر برگشتی رو مدیریت می‌کنن. مثل فرم‌های HTML در وب اپلیکیشن‌های سنتی، یک REST API هم از منابع کنترلر استفاده می‌کنه تا کارهایی انجام بده که به‌طور منطقی به یکی از متد های استاندارد (Create، Retrieve، Update و Delete، که بهشون CRUD می‌گن) مربوط نمی‌شن.

معمولاً اسم‌های کنترلر به‌عنوان آخرین قسمت تو مسیر URI ظاهر می‌شن و بعد از اون‌ها هیچ منبع فرعی دیگه‌ای توی سلسله‌مراتب نیست. مثال زیر یه کنترلر رو نشون می‌ده که به کلاینت اجازه می‌ده یه هشدار رو دوباره برای کاربر بفرسته:

POST /alerts/245743/resend

@ninja_learn_ir

ضمن خوش آمد گویی به دوستانی که تازه به جمعمون اضافه شدن 🌹، باید بگم که ما هر روز بخشی از خلاصه کتاب REST API Design Rulebook رو داخل کانال منتشر میکنیم و میتونید مطالعه کنید.

فایل PDF هم قبلا آپلود شده، فقط کافیه سرچ بزنید 🔎

از هشتگ #کتاب هم میتونید استفاده کنید برای دسترسی سریعتر #️⃣

استفاده کنید 😄❤️

💎 ساخت کامندهای کاستوم توی جنگو 💎

امروز می‌خوام یه موضوع خفن از جنگو رو بهتون توضیح بدم، اینکه چجوری می‌تونیم کامندهای کاستوم توی جنگو بسازیم. 😎

احتمالاً تا حالا با کامندهای پیش‌فرض جنگو مثل migrate, makemigrations, یا runserver کار کردید، ولی خب بعضی وقتا پیش میاد که نیاز داریم یه سری کارهای خاص رو توی پروژه انجام بدیم که با این کامندها نمیشه. اینجاست که کامندهای کاستوم وارد میشن! 🤓

مراحل ساخت کامند کاستوم توی جنگو

1⃣ ساخت پوشه management/commands

   اول باید توی یکی از اپلیکیشن‌هاتون یه پوشه به اسم management بسازی و داخلش یه پوشه دیگه به اسم commands بذاری. این پوشه جاییه که همه کامندهای کاستومت توش قرار می‌گیره. یادت باشه که توی هر دو پوشه باید فایل init.py رو هم بسازی که پایتون این پوشه‌ها رو بشناسه.

   مسیرش میشه چیزی شبیه این:

    |— your_app/
      |— management/
      |— __init__.py
         |—commands/
         |— __init__.py
   

2⃣ ساخت فایل کامند
   حالا نوبت اینه که کامند خودتو بسازی فرض کنیم می‌خوای یه کامند بسازی که اطلاعات کاربرا رو پرینت کنه. یه فایل به اسم print_users.py داخل پوشه commands بساز و این کد رو داخلش بذار:

from django.core.management.base import BaseCommand 
from your_app.models import User

   class Command(BaseCommand):
       help = 'چاپ کردن لیست کاربرا'

       def handle(self, *args, **kwargs):
           users = User.objects.all()
           for user in users:
                            self.stdout.write(self.style.SUCCESS(f'User: {user.username}'))
   

   اینجا:
   - از کلاس BaseCommand استفاده کردیم تا یه کامند جدید بسازیم.
   - متد handle جاییه که منطق اصلی کامند رو می‌نویسیم. هرچی تو این متد بنویسی موقع اجرای کامند اجرا میشه.
   - با self.stdout.write می‌تونیم پیام‌ها رو توی کنسول پرینت کنیم.

3⃣ اجرای کامند
   بعد از اینکه فایل رو ساختی، برای اجرای کامندت، می‌تونی این دستور رو توی ترمینال وارد کنی:

   python manage.py print_users
   

   اگه همه چیز درست باشه، لیست کاربرا رو توی کنسول می‌بینی. 🎉

امکانات بیشتر
می‌تونی کامندت رو حرفه‌ای‌تر هم بکنی:
- با اضافه کردن آرگومان (مثل python manage.py print_users --active برای کاربرای فعال)
- یا استفاده از ورودی‌های کاربر (مثل پرسیدن سوال توی ترمینال و دریافت جواب)

مثال اضافه کردن آرگومان:

def add_arguments(self, parser):
    parser.add_argument('--active', action='store_true', help='فقط کاربرای فعال')

حالا اگه --active رو اضافه کنی، فقط کاربرای فعال رو نشون میده.

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

امید وارم مفید بوده باشه :)

#backend #django

@ninja_learn_ir

سلام دوستان 👋

امروز تو یکی از گروه‌ها یه چیزی دیدم که گفتم بهتره در موردش صحبت کنم. خیلی از دوستانی که اینجا هستن سنشون زیر ۱۸ ساله. خب دوستان، تو این سن استخدام شدن تو یه شرکت خیلی سخته (نمی‌گم غیرممکنه، ولی خیلی کمه جایی پیدا بشه که با این سن کم استخدام کنه). دلیلش هم واضحه؛ شما نه کارت پایان خدمت دارین، نه وقت کافی چون درگیر درس و مدرسه هستین و...

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

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

برای همتون ارزوی بهترین هارو میکنم ❤️

دقیقا همینه 😐😂

📕 کتاب REST API Design Rulebook

📌 فصل دوم: Identifier Design with URIs

📍پارت: چهارم

#کتاب

‏💎 URI Path Design 💎
هر قسمت از مسیر URI که با اسلش (/) جدا می‌شه، یه فرصت طراحی حساب می‌شه. اگه به هر قسمت از مسیر یه ارزش معنی‌دار بدیم، می‌تونیم ساختار سلسله‌مراتبی منابع یه REST API رو بهتر نشون بدیم.

شکل 2-1 با استفاده از نشانه‌گذاری WRML نشون می‌ده که چطور طراحی مسیر URI با مدل منابعی که ارائه می‌ده ارتباط داره.

این بخش قوانینی رو ارائه می‌ده که مربوط به طراحی مسیرهای URI معنی‌دار هستن.

⭕️ برای نام‌گذاری اسناد باید از اسم مفرد استفاده بشه.
یه URI که نمایانگر یه سند هست، باید توی قسمت مسیر از یک اسم یا عبارت اسمی مفرد استفاده کنه.

مثال: URI برای یه سند مربوط به یک بازیکن به شکل مفرد خواهد بود:

https://api.soccer.restapi.org/leagues/seattle/teams/trebuchet/players/claudio

⭕️ برای نام‌گذاری کالکشن ها باید از اسم جمع استفاده بشه.
‏URI که یه مجموعه رو شناسایی می‌کنه، باید توی قسمت مسیر از اسم یا عبارت اسمی جمع استفاده کنه. نام کالکشن باید طوری انتخاب بشه که نشون بده چه چیزهایی به‌صورت یکسان داخلش قرار داره.

مثال: URI برای یه مجموعه از اسناد بازیکنان از فرم جمع اسم منابع استفاده می‌کنه:

https://api.soccer.restapi.org/leagues/seattle/teams/trebuchet/players

⭕️ برای نام‌گذاری Store ها هم باید از اسم جمع استفاده بشه. URI که یه Store رو شناسایی می‌کنه، باید توی قسمت مسیر از اسم یا عبارت اسمی جمع استفاده کنه.

مثال: URI برای یه مخزن لیست‌های پخش موسیقی ممکنه از فرم جمع به این شکل استفاده کنه:

https://api.music.restapi.org/artists/mikemassedotcom/playlists

⭕️ برای نام‌گذاری کنترلر باید از یک فعل یا عبارت فعلی استفاده بشه، درست مثل عملکرد یه تابع در برنامه‌نویسی. URI که یه منبع کنترلر رو شناسایی می‌کنه، باید به‌طوری نام‌گذاری بشه که نشون‌دهنده‌ی عملی باشه که قراره انجام بشه.

مثال‌ها:

https://api.college.restapi.org/students/morgan/register
https://api.example.restapi.org/lists/4324/dedupe
https://api.ognom.restapi.org/dbs/reindex
https://api.build.restapi.org/qa/nightly/runTestSuite

⭕️ بعضی از بخش‌های مسیر URI ثابت هستند؛ یعنی اسم‌های مشخصی دارن که توسط طراح REST API انتخاب می‌شن. اما بقیه بخش‌های مسیر متغیر هستن، یعنی به‌طور خودکار با یه شناسه پر می‌شن که به خاص بودن URI کمک می‌کنه. در نگارش الگوی URI، طراح‌ها می‌تونن هم بخش‌های ثابت و هم متغیر رو مشخص کنن. یک الگوی URI شامل متغیرهایی هست که قبل از استفاده باید جایگزین بشن.

مثال زیر سه متغیر داره: ‌`leagueId`، ‌`teamId`، و ‌`playerId`:

https://api.soccer.restapi.org/leagues/{leagueId}/teams/{teamId}/players/{playerId}

جایگزینی متغیرهای الگوی URI ممکنه توسط REST API یا کلاینت‌ها انجام بشه. هر جایگزینی می‌تونه از یه شناسه عددی یا الفبایی-عددی استفاده کنه، مثل مثال‌های زیر:

https://api.soccer.restapi.org/leagues/seattle/teams/trebuchet/players/21
https://api.soccer.restapi.org/games/3fd65a60-cb8b-11e0-9572-0800200c9a66

در اینجا، مقدار ‌`21` در قسمت متغیر ‌`playerId` قرار گرفته و مقدار UUID در قسمت متغیر ‌`gameId` جایگزین شده.


⭕️ نباید از نام‌های توابع CRUD در URI‌ها استفاده بشه. URI‌ها باید برای شناسایی منحصر‌به‌فرد منابع استفاده بشن و باید طبق قوانین بالا نام‌گذاری بشن. همون‌طور که در بخش «روش‌های درخواست» توضیح داده شده، روش‌های HTTP برای مشخص کردن عملکرد CRUD استفاده می‌شن.

مثلاً این طراحی API ارجحیت داره:

DELETE /users/1234

در مقابل، الگوهای نادرست (که نباید انجام بشن) به شکل زیر هستن:

GET /deleteUser?id=1234
GET /deleteUser/1234
DELETE /deleteUser/1234
POST /users/1234/delete

@ninja_learn_ir

💎 پکیج joi در جاوااسکریپت 💎

امروز میخوام در مورد یه پکیج خفن به اسم joi توی جاوااسکریپت صحبت کنم. 😎

خب بذارید اول بگم joi چیه و به چه دردی میخوره. 💡

فرض کن توی پروژه‌ت میخوای ورودی‌های کاربر رو validate کنی، مثلا فرم لاگین، ثبت نام، یا هر چیزی که قراره دیتای کاربر رو بفرسته.
معمولا برای اینکه مطمئن بشیم اطلاعاتی که میگیریم درسته، مثل ایمیل درست باشه، پسورد حداقل تعداد کاراکتر رو داشته باشه و ...، باید خودمون یه سری شرط بنویسیم که معمولا کدنویسی زیادی می‌طلبه.

حالا اینجاست که joi وارد میشه! 😎
با این پکیج می‌تونی خیلی راحت و سریع همه چیز رو ولیدیت کنی و نیازی نیست کلی کد بنویسی. 🙌

❓چطوری نصب کنیم؟
خیلی ساده‌ست:

npm install joi

❓حالا استفاده‌اش چطوریه؟
یه مثال ساده میزنم:

const Joi = require('joi');

const schema = Joi.object({
  username: Joi.string().alphanum().min(3).max(30).required(),
  password: Joi.string().pattern(new RegExp('^[a-zA-Z0-9]{3,30}$')).required(),
  email: Joi.string().email({ tlds: { allow: false } })
});

حالا میایم دیتا رو با این اسکیما ولیدیت می‌کنیم

const { error, value } = schema.validate({ 
  username: 'user123',
  password: 'mypassword',
  email: '[email protected]'
});

if (error) {
  console.log('خطا: ', error.details);
} else {
  console.log('همه چی اوکیه: ', value);
}

همونطور که می‌بینید، با joi می‌تونید به راحتی اسکیماهای مختلف برای ولیدیت کردن دیتا تعریف کنید.
نیازی نیست نگران درست بودن دیتا باشید، چون خودش همه چیز رو چک می‌کنه. 😎💪

برای مطالعه بیشتر میتونید به این سایت مراجعه کنید 😁

امید وارم مفید بوده باشه :)

#JOIValidation #JavaScriptTips #BackendDevelopment

@ninja_learn_ir

💎 خب Uvicorn چیه و چرا مهمه؟ 💎

سلام دوستان! امروز می‌خوام در مورد Uvicorn صحبت کنم که شاید به گوشتون خورده باشه، مخصوصاً اگه با FastAPI یا Starlette کار کرده باشید. 😎

حالا Uvicorn چیه؟

خب Uvicorn یه ASGI سرور خیلی سریع و سبک هست که برای اجرای اپلیکیشن‌های پایتونی که از پروتکل ASGI استفاده می‌کنن، طراحی شده. برعکس WSGI که واسه فریمورک‌های سنتی مثل Django و Flask استفاده میشه، ASGI این قابلیت رو داره که اپلیکیشن‌های آسنکرون (async) رو هندل کنه. 🚀

به زبون ساده‌تر، اگه بخوای یه اپلیکیشن پایتونی سریع و مقیاس‌پذیر بسازی که هم درخواست‌های همزمان رو به‌خوبی هندل کنه و هم نیاز به عملکرد بالا داشته باشه، Uvicorn گزینه‌ی ایده‌آلیه. 💥

مزایای Uvicorn

سرعت بالا 🚀:
یکی از اصلی‌ترین دلایل محبوبیت Uvicorn سرعت بالاشه. به‌خاطر استفاده از کتابخونه‌های بهینه مثل uvloop و httptools.

پشتیبانی از async ⚡ :
خب Uvicorn به طور کامل از async و await پشتیبانی می‌کنه، که این یعنی تو میتونی باهاش اپلیکیشن‌های خیلی مقیاس‌پذیر بسازی که درخواست‌های زیادی رو به‌طور همزمان هندل کنن.

سادگی در استفاده 🛠️:
استفاده از Uvicorn خیلی ساده‌ست و به راحتی میتونی اونو با FastAPI یا هر فریمورکی که از ASGI پشتیبانی میکنه استفاده کنی.

چجوری Uvicorn رو نصب و اجرا کنیم؟

نصب Uvicorn فوق‌العاده ساده‌ست. با یه دستور می‌تونی نصبش کنی:

pip install uvicorn

بعد از نصب، کافیه اپلیکیشنت رو اجرا کنی. فرض کن یه اپلیکیشن FastAPI داری:

uvicorn main:app --reload

اینجا main اسم فایل و app اسم اپلیکیشنی هست که توش تعریف شده. با سویچ --reload هم Uvicorn در حالت توسعه قرار می‌گیره و هر تغییری که بدی به‌صورت خودکار اعمال میشه.

حالا Uvicorn کجاها کاربرد داره؟

اگه با فریمورک‌هایی مثل FastAPI کار می‌کنی یا حتی می‌خوای از اپلیکیشن‌های سنگین و با تعداد درخواست بالا پشتیبانی کنی، حتماً باید از Uvicorn استفاده کنی. مثلاً برای APIهای real-time، وب‌سرویس‌ها و اپلیکیشن‌های چت Uvicorn می‌تونه فوق‌العاده مفید باشه.

جمع‌بندی 🎯

در کل، Uvicorn یه سرور سریع، سبک و مقیاس‌پذیره که اگه با اپلیکیشن‌های آسنکرون کار می‌کنی یا می‌خوای عملکرد بالایی توی هندل کردن درخواست‌ها داشته باشی، بهترین گزینه‌ست. 😎🔥

امید وارم مفید بوده باشه :)

#django #uvcorn #web_server #asgi_server

@ninja_learn_ir

📕 کتاب REST API Design Rulebook

📌 فصل دوم: Identifier Design with URIs

📍پارت: پنجم

#کتاب

‏💎 URI Query Design 💎
این بخش درباره قوانین طراحی کوئری‌های URI صحبت می‌کنه. طبق استاندارد RFC 3986، کوئری URI (که اختیاری هست) بعد از مسیر (path) و قبل از تکه‌ی اختیاری (fragment) قرار می‌گیره:

URI = schema "://" authority "/" path [ "?" query ] [ "#" fragment ]

کوئری تو URI به شناسایی منحصربه‌فرد بودن یه منبع کمک می‌کنه. به این مثال توجه کن:

https://api.college.restapi.org/students/morgan/send-sms

https://api.college.restapi.org/students/morgan/send-sms?text=hello

اولی URI یه منبعی هست که پیامک می‌فرسته. دومی همون منبع رو نشون می‌ده ولی با این تفاوت که توش پیام "hello" فرستاده می‌شه.

قسمت کوئری URI شامل یه سری پارامتره که به عنوان یه نوع تغییر یا نسخه‌ای از منبع اصلی (که تو بخش مسیر URI تعریف شده) تفسیر می‌شه. پس این دو منبع دقیقاً یکی نیستن، ولی به هم خیلی نزدیکن.

قسمت کوئری تو URI می‌تونه به کلاینت‌ها امکانات بیشتری مثل جستجو یا فیلتر کردن بده. به همین دلیل، این بخش از URI ممکنه برای کلاینت‌های یه REST API شفاف باشه (یعنی زیاد براشون مهم نباشه).

در ضمن، کل URI یه منبع باید برای واسطه‌های شبکه مثل کش‌های HTTP غیرشفاف (opaque) باشه. کش‌ها نباید رفتار خودشون رو فقط بر اساس وجود یا عدم وجود کوئری توی URI تغییر بدن. یعنی پیام‌های پاسخ نباید فقط به خاطر وجود کوئری از کش شدن حذف بشن. همونطور که تو فصل ۴ توضیح داده شده، برای کنترل رفتار واسطه‌های کش باید از هدرهای HTTP استفاده بشه، نه کوئری‌ها.

⭕️ قسمت کوئری URI می‌تونه برای فیلتر کردن کالکشن ها یا Store ها استفاده بشه.
یعنی می‌تونی ازش برای مشخص کردن معیار جستجو توی یه مجموعه یا ذخیره استفاده کنی. یه مثال بزنیم:

GET /users
GET /users?role=admin

تو درخواست اول، کلاینت از سرور لیست همه کاربران رو درخواست می‌کنه.
تو درخواست دوم، کلاینت از سرور لیست کاربرانی که نقش (role) "admin" دارن رو می‌خواد.

در واقع، قسمت کوئری (?role=admin) داره لیست کاربرا رو فیلتر می‌کنه تا فقط اونایی که نقش "admin" دارن تو پاسخ نمایش داده بشن.


⭕️ قسمت کوئری (Query) توی URI باید برای صفحه‌بندی (pagination) نتایج مجموعه یا ذخیره‌ها استفاده بشه.
کلاینت یه REST API باید از پارامترهای pageSize و pageStartIndex توی کوئری استفاده کنه. پارامتر pageSize تعداد عناصر حداکثری رو که باید توی پاسخ برگردونده بشه مشخص می‌کنه، و pageStartIndex مشخص می‌کنه که اولین عنصر از کجا شروع بشه (با ایندکس صفر).

مثال:

GET /users?pageSize=25&pageStartIndex=50

این درخواست لیستی از ۲۵ کاربر رو برمی‌گردونه که از کاربر شماره ۵۰ شروع می‌شه.

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

POST /users/search

اینجا، به جای استفاده از کوئری توی URI، کلاینت می‌تونه درخواست‌های پیچیده‌تری مثل محدوده‌های خاص یا ترتیب‌های خاص رو توی بدنه (body) پیام ارسال کنه. فقط باید مطمئن باشی که نتایج کش‌شده کنترلر به درستی مدیریت بشن.


📝 قوانین طراحی URI در REST API 📝

این خلاصه، اصطلاحات مهمی رو که تو طراحی URIs برای REST API ها به کار میره توضیح میده:
‏
🔑 Authority: بخشی از URI که مسئول فضای نام هست.
📂 Collection: نوعی منبع که مثل یه دایرکتوری از منابع سرور مدیریت می‌شه.
🛠 Controller: منبعی که عملکردهای اجرایی رو مدل‌سازی می‌کنه (مثل یه تابع).
💾 CRUD: مخفف چهار عمل اصلی: ایجاد، خواندن، بروزرسانی و حذف.
🌐 Developer portal: یه رابط کاربری وب برای جذب کلاینت‌های جدید به API.
‏🏠 Docroot: نقطه شروع مدل REST API که والد همه منابع دیگه است.
📄 Document: منبعی که یه مفهوم منفرد رو مدل‌سازی می‌کنه.
🔗 Forward slash separator (/): علامتی که برای جدا کردن منابع مرتبط در URI به کار می‌ره.
👁 Opacity of URIs: یه اصل که می‌گه ساختار URI برای کاربر نباید مهم باشه.
📍 Parent resource: منبعی که یه مفهوم زیرمجموعه رو مدیریت می‌کنه.
🔍 Query: بخشی از URI که برای جستجو و فیلتر استفاده می‌شه.
🔧 Resource archetypes: چهار نوع اصلی منابع (مستند، مجموعه، ذخیره، کنترلر).
🗄 Store: یه منبع که به‌عنوان یه مخزن مدیریت‌شده توسط کلاینت مدل‌سازی می‌شه.
📌 URI path segment: بخشی از URI که نمایانگر یه گره (node) تو مدل سلسله مراتبی منبعه.
📑 URI template: فرمت URI که شامل متغیرهایی هست که قبل از استفاده باید جایگزین بشن.

@ninja_leanr_ir

خب فصل دوم هم تموم شد و از فردا فصل ۳ رو استارت میزنیم 💪

درگیر یه پروژه شدیم و سرمون شلوغ شده به همین دلیل بعضی روزا یادمون میره پست از کتاب بذاریم لطفا به بزرگواری خودتون ببخشید 🌹

⚖ بررسی MySQL: همه چیز درباره یکی از محبوب‌ترین دیتابیس‌های دنیا 💎

امروز می‌خوام یه دیتابیس معروف و پرطرفدار رو بررسی کنیم؛ MySQL شاید اسمشو زیاد شنیده باشی ولی دقیق ندونی چیه و چه کاربردایی داره.

حالا MySQL چیه؟

خب MySQL یه دیتابیس رابطه‌ای (Relational) و اوپن سورس هست که توی سال 1995 ساخته شده. دیتابیس‌های رابطه‌ای یعنی دیتایی که توش ذخیره میشه توی جدول‌هایی با ردیف‌ها و ستون‌ها قرار می‌گیره و این جداول با همدیگه ارتباط دارن. 🛠️

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

چرا MySQL محبوبه؟

1⃣ سرعت و کارایی بالا 🚀: MySQL یکی از سریع‌ترین دیتابیس‌های رابطه‌ای هست. این یعنی درخواست‌ها و عملیات‌های دیتابیس رو خیلی سریع هندل می‌کنه.

2⃣ پشتیبانی از حجم بالا 💾: MySQL می‌تونه مقیاس‌پذیر باشه و دیتابیس‌هایی با حجم زیاد و تعداد کاربران بالا رو به‌خوبی مدیریت کنه.

3⃣ سازگاری با همه چیز 🔗: این دیتابیس تقریباً با همه زبان‌های برنامه‌نویسی و فریمورک‌های محبوب مثل Python, PHP, Node.js و Django به خوبی کار می‌کنه.

- امنیت 🔒: MySQL امنیت بالایی داره و می‌تونید به راحتی دسترسی کاربران به دیتابیس رو مدیریت کنید.

- پشتیبانی از تراکنش‌ها 💡: تراکنش‌ها (Transactions) توی MySQL به شما این امکان رو میدن که چند عملیات دیتابیسی رو به صورت اتمیک انجام بدید، یعنی یا همه اون عملیات‌ها باهم انجام بشن یا هیچکدوم.

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

sudo apt-get install mysql-server

بعد از نصب، برای ورود به دیتابیس MySQL از این دستور استفاده کن:

mysql -u root -p

چطوری با MySQL کار کنیم؟

بعد از نصب، می‌تونی جداول و دیتاهای موردنظرت رو با SQL مدیریت کنی. مثلاً برای ساخت یه جدول جدید:

CREATE TABLE users (
  id INT AUTO_INCREMENT PRIMARY KEY,
  name VARCHAR(100),
  email VARCHAR(100)
);

حالا برای اضافه کردن اطلاعات:

INSERT INTO users (name, email) VALUES ('John Doe', '[email protected]');

برای گرفتن اطلاعات:

SELECT * FROM users;

کجا از MySQL استفاده کنیم؟

خب MySQL برای پروژه‌های کوچیک و بزرگ مناسبه، از سایت‌های شخصی گرفته تا اپلیکیشن‌های بزرگ و سیستم‌های پیچیده. اگه نیاز داری یه دیتابیس سبک و سریع داشته باشی که هم اوپن سورسه و هم جامعه بزرگی داره، MySQL گزینه خوبیه. خیلی از سرویس‌های بزرگ مثل Facebook, Twitter, YouTube از MySQL استفاده می‌کنن! 😯

جمع‌بندی 🎯

در کل، MySQL یه دیتابیس رابطه‌ای قدرتمند، سریع و امنه که برای مدیریت اطلاعات توی پروژه‌های مختلف عالیه. چه پروژه‌های کوچیک داشته باشی و چه پروژه‌های بزرگ، MySQL می‌تونه نیازت رو برطرف کنه. اگه دنبال یه دیتابیس اوپن سورس و همه‌کاره هستی، حتماً یه سر به MySQL بزن😎🔥

امید وارم براتون مفید بوده باشه :)

#دیتابیس #mysql #db

@ninja_learn_ir

روز برنامه نویس مبارک 🎉


۲۱ شهریور (۱۲ سپتامبر) به عنوان "روز برنامه‌نویس" شناخته می‌شود زیرا این روز، ۲۵۶مین روز سال است. عدد ۲۵۶ برای برنامه‌نویسان معنای ویژه‌ای دارد؛ چون در سیستم دودویی (باینری) که اساس کامپیوترها و برنامه‌نویسی است، ۲۵۶ بزرگ‌ترین توانی است که می‌توان با ۸ بیت (یک بایت) نشان داد. همچنین، عدد ۲۵۶ در بسیاری از مفاهیم کامپیوتری به‌ویژه حافظه و پردازش داده‌ها اهمیت زیادی دارد. به همین دلیل، روز ۲۵۶مین روز سال در تقویم میلادی به عنوان روز برنامه‌نویس انتخاب شده است.

در تقویم میلادی، اگر سال کبیسه باشد، این روز به ۱۳ سپتامبر منتقل می‌شود.


@ninja_learn_ir