Python Hints

پینوشت: اگر جایی کپی کردید؛ لطفا پیام قبلی و بعدی رو هم بذارید 🌱 توضیحات مهم هست.

کانال قبلی چون ریپورت شده بود، این موارد رو مجدد می‌فرستم : #Backend_RoadMap_2025 قبل از اینکه بخواید این roadmap رو دنبال کنید باید پست قبلی رو بخونید. یک نکته‌ای که اضافه کنم؛ توی جلسات و ... که بحث شد من اصلا قرار نیست هیچ چیزی رو آموزش بدم (اشتباهات رو کمک می‌کنم حل بشه و ...) اما اینکه آموزش بدم FastAPI چیست و جطوری CRUD بنویسیم و ازین موارد با اوضاع الانم اصلا نمی‌خونه پس دلیل ساده بودنش همین پست قبلی هست. چیزایی که توقع دارم یک Senior توی جنبه‌ی فنی بکند بلد باشه (اعداد هیچ ربطی به ترتیب یادگیری نداره؛ فقط برای این هست که تهش بدونم چندتا مورد رو گفتم) از دوستان Senior هم می‌خوام اگر نکته یا موردی جا افتاده بهم یادآوری کنند. بازم توجه کنید Senior شدن کلی جنبه‌های مختلف داره ولی برای بخش فنی مربوط به بکند این لیست کافی و قوی هست؛ برای بحث‌های دیگر هم از منابع خودش می‌تونید دنبال کنید. فریمورک مورد نظرتون رو کمی بشناسید (من روی FastAPI پیش میرم ولی خیلی فرقی نیست) 1. Middleware: Starlette interface for how to write middleware. Must know: auth, request ID, timing, gzip, validators, rate-limit, logging. Important to know the order of execution. 2. CORS (and headers in general). 3. Authentication / Authorization: What is JWT + RS256. Nice to know: Auth0, Cognito. 4. SQL and SQLAlchemy 2.0 (async style). 5. Tests: * Unit tests for business logic. * Integration tests for database, Redis, etc. interactions. * Contract tests (very important) for endpoints and services you use. 6. Benchmarking: k6, load testing, CI smoke tests for performance-sensitive endpoints; wrk, hyperfine (or alternatives). 7. Docker / Docker Compose: multi-stage builds. 8. Profiling: Scalene or Perf — flamegraph interpretation. 9. Caching (Redis): cache invalidation; GET/SET strategies (Cache-Aside vs Write-Through). 10. Background tasks: FastAPI background tasks & Dramatiq (or other alternatives). Don't bring Celery or its equivalent into projects — it's heavy and overkill in most cases. Use/understand: idempotency, retries, dead-lettering. 11. Observability: Logging, tracing, metrics. Logs must be structured (JSON is a good option). Distributed tracing is a must-have. Metrics (Prometheus) are important — at minimum: response_time_ms, active_connections, etc. 12. Configuration management: Pydantic Settings; no hard-coded settings or configs. 13. Migrations: Alembic — each migration should have both UP and DOWN so it is safe to revert. 14. API documentation: FastAPI provides it automatically, but don't forget to use the Pydantic model example field. BTW: Pydantic v2 is the only accepted version. 15. Error handling + correct HTTP codes. 16. Graceful shutdown: App must stop accepting new HTTP connections, finish processing current requests, drain the database connection pool, then exit. 17. Idempotency and retries: For network/database failures — learn exponential backoff, circuit breakers, bulkheads. 18. Health checks and readiness probes: The app must provide them (Docker health check alone is not accepted). 19. Connection pooling tuning: Postgres, Redis, etc. You must be able to explain tuning decisions based on your benchmarks/profiling results. 20. Security basics: Input sanitization/validation, rate limiting, secrets management, secure defaults (CSP, HSTS), threat modeling for endpoints. 21. Scalability patterns: Focus on connection pooling and indexing first. Too many or unnecessary indexes = Fail. Nice to learn: horizontal scaling, load balancing, sharding, replication. 22. Feature flagging (dynamic configuration): All projects should have it — very important. 23. API versioning strategy: Header versioning / URL versioning. 24. Architecture Decision Records From day 1 you must have this document in the project with at least 3 entries per decision: What you decided. Why you did that. What the consequences are. --————————————- Future / next steps 1. Design system architecture. 2. Integrate message queues (when and why to use them) — Kafka, RabbitMQ. 3. Event-driven patterns. 4. Optimize for latency. 5. GraphQL / gRPC — when and why to use them.

یکی به من پیام داده، توهین نکرده ولی خوبم صحبت نکرده:

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

مکالمه من :

+ شرکت و پروژه شما چندتا برنامه‌نویس و چقدر کاربر داره ؟ - ۱۱ نفریم، ۲۰۰۰ تا هم کاربر داریم. + حقوق شما چقدر هست ؟ - حدوداً ۲۳م + هروقت شرکتی ایرانی با تورم امروز قبول کرد بابت کاری که می‌کنی بهت حداقل ۶ برابر یا بیشتر حقوق بده، اون موقع متوجه شدی که چرا کتاب خوندی و مفاهیم رو فهمیدی.

اما اگر بخوام برای همه توسعه دهنده‌های دیگر توضیح بدم؛ باید با این جمله که همیشه به بچه‌های توی تیمم می‌گم شروع کنم :

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

به خیلی از تکنولوژی‌های امروز فکر کنید؛ اگر نخوندید برید ببینید همشون از دل مشکلات در اومدند Hadoop, Kafka, Spark, Docker, K8s, ... قرار نیست همه چیز رو یاد بگیرید؛ تک تک تکنولوژی‌ها و نحوه کانفیگ اون‌ها و ... اما قرار هست آماده باشید که قبل از بروز مشکل بتونید اون رو پیدا کنید و سیستم رو ارتقا بدبد براش. مثال بزنم : چند مدت پیش یک توسعه دهنده بر اساس یکی از انیمیشن‌ها یک سایت خیلی ساده نوشته که یک مارمولک وسط صفحه هست و وقتی روی اون کلیک می‌کنی می‌گه Lizard بعد خیلی معروف شد و ملت درخواست دادند counter جهانی براش بسازه ببین دیگه ازین اپلیکیشن ساده‌تر و بی‌خطر تر وجود نداره؛ نه تراکنش مالی داره و نه یوزر پولی داده و نه هیچی ... طرف اول همه درخواست‌ها رو توی فایل می‌ریخته؛ سایت دان میشه همرو میریزه توی دیتابیس؛ سایت کند میشه (تعداد req/sec بیش از حد بالا بوده) شروع می‌کنه سرورهای بزرگتری رو خریدن؛ از ۴ دلار به ۶۰ دلار میرسه هزینه ماهانه سرور ولی مشکل همچنان پا برجاس و مسئله این بوده که با این مفهوم که write های کوچیک و زیاد روی دیتابیس داره بهش آسیب میزنه آشنا نبوده. چون مشکل رو نمی‌شناخته؛ سراغ راه حل اشتباه رفته. درنهایت بر می‌گرده و شروع به optimize کردن کد می‌کنه؛ الان سایت روی همون هاست ۴ دلاری بالاس و تا این لحظه

2,146,829,700

کلیک رو ثبت کرده (البته خیلی از کلیک‌ها رو از دست داده) ایشون وقتی تونست راه‌حل رو پیدا کنه که دیگران مشکلاتش رو بهش گفتند؛ اگر این یک بیزینس خصوصی با کاربرای واقعی بود سرور 5,000 دلاری هم نجاتش نمی‌داد (چون راه اشتباه بود) و امکان داشت با وجود هزینه بسیار بالا بهترین مشتری‌هاش رو هم از دست بده. شرکت‌هایی با محصولات خوب اینطوری از دور خارج می‌شوند؛ من شاهد این موضوع بودم (حداقل ۱۰ نفر شما برای سورس کد پروژه‌های شرکت‌هاتون من رو دعوت به همکاری دادید تا مشکل حل کنم و خب به هر دلیلی با مدیرعامل به توافق نرسیدیم)‌ توی تمام کانال‌ها من هدفم آموزش مقدمات نیست (البته غیر از Rust که خودم داشتم Syntax یاد می‌گرفتم)‌ بلکه هدفم این بوده که شما حداقل یک بار هر مشکلی رو ببینید و اگر اون الگو رو توی کار واقعی دیدید بتونید قبل از down شدن سرویس‌ها شناساییش کنید. وگرنه برای یادگرفتن یک framework فقط ۲-۳ ساعت آموزش کافی هست. راستی اون سایت هم : https://lizard.click/

Designing Data-Intensive Applications یکی از کتاب‌های مورد علاقه من هست؛ وقتی نسخه اول این کتاب منتشر شد من هم بسیار درگیر سیستم‌هایی بودم که دیتای زیادی داشتند و BigData بخشی از کارم بود. خوندن این کتاب دریچه جدیدی رو برام باز کرد و الان که فکر می‌کنم کتاب سنگینی بود؛ حالا چرا الان این رو می‌گم ؟ قبل از اتفاقات اخیر کمک یکی از دوستان قدیمی می‌کردم که تازه (۲ سال) هست وارد دنیای برنامه‌نویسی بعنوان شغل شده و چندوقتی رو درگیر یک سری مشکلات پروژه‌اش بوده؛ بعد از اینکه کمکش کردم مشکلش حل شد ازم پرسید این موارد رو از کجا یاد گرفتی و چطوری می‌تونم یاد بگیرم ؟ منم این کتاب رو بهش معرفی کردم. امروز دوباره پیام داد (ایران نیستند) و بعد از صحبت از کتاب گفت که بسیار خوندنش سخت هست براش؛ برای خیلی از سنیورها هم درک این موضوعات سخت هست بطور کلی این کتاب کتاب آسونی نیست هرچند همه چیز ساده بیان شده. همینطوری که داشتم فکر می‌کردم چطوری می‌شه این کتاب رو برای دیگران ساده کرد و پروسه یادگیری خودم رو مرور می‌کردم ( همون روش ویدئو ببین و تخمه بشکون : ویدئو اول یوتیوب pyhints )

یادآوری کنم: نه بنده و نه هیچ کدوم از کانال‌های بنده روی هیچ یک از پلتفرم‌های ایرانی اکانت نداره و نخواهد داشت. ویدئویی، متنی یا ...

یک راهکار این هست که داکر ایمیج رو از یک دوستی که قبلتر pull کرده بگیرید. چون دیدم دوستان خودم این روش رو بلد نیستند گفتم اینجا هم بذارم: سناریو اینطوری هست. من روی registry شخصی خودم این image رو نداشتم و برای راه‌اندازی پروژه یکی از دوستان بهش نیاز داشتم، بعد از تماس با دوست دیگری متوجه شدم اون‌ها هفته قبل موفق به pull کردن این ایمیج شدند و من اینطوری image رو برداشتم فرض کنیم مثلاً postgres:18 رو لازم داشتم روی سروری که ایمیج رو داشتند (بله من از دوستانم دسترسی مستقیم به سرور میگیرم)

docker save postgres:18 | gzip > postgres_dockerimg.tar.gz

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

docker load < postgres_dockerimg.tar.gz

و تمام حالا image رو روی این سرور دارم و می‌تونم به کارم ادامه بدم، اگر لازم شد می‌تونید با docker tag اسم و اطلاعات image رو تغییر بدید. پینوشت : یک توصیه امنیتی، اگر image رو از کسی یا جایی گرفتید که بهش اعتماد ندارید (۹۹.۹٪ بهتره اعتماد نداشته باشید) اول این دستور رو وارد کنید:

docker image inspect --format='{{.Id}}' postgres:18

خروجی این باید یک sha256 باشه. وارد سایت hub.docker.com بشید (گفتم که سایت کند باز می‌شه ولی pull نمیده چون کلودفلیر بسته‌اس) ایمیج مدنظر رو و تگ درستش رو پیدا کنید وارد جزئیات که بشید Index Digest رو گذاشته باید با چیزی که توی ترمینال دیدید یکسان باشه. اگر نبود image دستکاری شده و بهتره باهاش کانتینر اجرا نکنید.

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

با خبرهایی که از رسانه‌های داخلی درباره اینترنت می‌آید (که خب دیگه طبقاتی شده)، یاد این ویدئوی یوتیوب افتادم؛ درباره بررسی یک گوشی موبایل از کره شمالی و دسترسی به آنچه توسط حکومت کره شمالی اینترنت خوانده می‌شود. Youtube Link (MrWhoseTheBoss)

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

از ۱۶ مارس تا امروز که ۳ آپریل هست تصمیم گرفتم بجای اینکه خودم رو درگیر vpn کنم کتاب بخونم. با این وضعیت اینترنت که کلا کار کردن درش تخته‌‌اس، توی بخش هوش مصنوعی هم که اندازه حداقل یک سال تلاش تا همینجا عقب افتادیم (که قطعاً بیشتر هم میشه) کلی هم که خبر تعدیل و لغو پروژه دارم می‌شنوم از دوستان. خلاصه؛ دیدم جز اعصاب خوردی و ... چیزی برام نداره کلا همه چیز رو کنار گذاشتم و نشستم به یادگیری ولی جالب‌ترین کارش این بود که تعداد صفحاتی که هرروز می‌خونم رو یکجا یادداشت کردم تا ببینم فقط اگه درگیر vpn نباشم چقدر وقت می‌ذارم برای کتاب خوندن، که دیدم توی همین ۱۹ روز (با امروز) ۵۵۸ صفحه کتاب خوندم. جدای از موارد دیگه که ویدئویی دارم یاد میگیرم، خلاصه گفتم همین ۱ ساعت وقتی هم که برای وصل شدن vpn روزانه میذارم رو بیخیال بشم. و ازین سوشال مدیا خدافظی کنم برای مدتی! به امید روزای بهتری که همه منتظرش پیر شدیم. 🌹 کلا پیشنهاد می‌کنم سمت کارهایی که اینترنت نیاز دارند نیاید، بخصوص برنامه‌نویسی. دیوونه می‌شید.

From April 24 onward, your interactions with GitHub Copilot—including inputs, outputs, code snippets, and associated context—may be used to train and enhance AI models unless you opt out.

کوپایلت از ۴ اردیبهشت از دیتاهای شما برای ترین استفاده خواهد کرد، اگر نمی‌خواید:

1) Go to GitHub Account Settings 2) Select Copilot 3) Choose whether to allow your data to be used for AI model training

نوروز مبارک 🤗🎉🎊

اگر مثل من نیاز دارید با عزیزان و خانواده خارج از ایران تماس داشته باشید و اون‌ها رو از نگرانی در بیارید: https://t.me/ProxyMTProto https://t.me/vmessorg https://t.me/invoProxy این کانال‌ها و مواردی که قبلتر معرفی کرده بودم متصل هستند. سرعت بسیار ضعیف هست، اگر متصل شدید زودتر خبر سلامتی بدید و از نگرانی در بیاریدشون ♥️

#موقت بنظرم این رو شما هم باید ببینید؛ که از بحث‌های آینده که فلان دیتابیس چقدر خوبه پیشگیری کنیم. تو دنیای opensource هم دروغ شاخ دار نگید. تابلوئه و سریعا هم لو میره!

چطوری میشه با بنچمارک دروغ گفت ؟ SpacetimeDB اینکار رو برای شما کرده ویدئو بالا رو چندساعت پیش دوستان برام فرستادند (من به Postgres18 خیلی علاقمند شدم بخاطر اضافه کردن Async هرچند هنوز نتونستم کامل تستش کنم) نشستم ویدئو رو دیدم؛‌ ویدئو 56K بازدید داشته 4.7K لایک و 642 تا کامنت که همه هم مثبت بوده من تموم کامنت‌هارو چک نکردم ولی خیلی‌هاش نظر مثبت هست. جالبی قضیه اینجاس هیچکس متوجه تفاوت توی نحوه بنچمارک گیری نشده یعنی واقعا ؟ چیزی هم که ادعا می‌کنه که SpacetimeDB می‌تونه نقش سرور رو هم بازی کنه؛ از Postgres15 من یادم هست که دارند این کار رو بصورت جدی انجام میدند ملت باهاش. پس داستان چیه ؟ عدد سازی . اومدم روی گیت‌هاب issue بسازم و بگم که تکنینک مقایسه درست نیست که دیدم یک نفر دیگه اینکار رو کرده. توی ویدئو اول دقیقه 10 به بعد رو ببینید؛ تمام تست‌هایی که انجام میده client + server + db هست؛ ولی وقتی به دیتابیس خودشون میرسه. client + db هست بعد از بررسی گیت‌هاب حتی متوجه شدم برای همه کلاینت روی typescript هست ولی برای خودشون روی Rust نوشته شده با خوندن بیشتر اوضاع بدتر هم شد. علاوه بر اینکه پروتوکل‌های متفاوتی استفاده شده و ... تمام فلگ‌های optimization مربوط به کلاینت Rust رو که برای بنچمارک خودشون فقط استفاده می‌کنند تا ماکزیمم بالا بردند. هیچ چیزی جز یک عددسازی بزرگ به ذهنم نمیرسه. حالا شخصی که روی Github به این موضوع اشاره کرده بود اومده یک ویدئو هم براش ساخته (داشتم میگشتم ببینم کسی دیگه هم فهمیده این موضوع رو یا نه ویدئو رو پیدا کردم) توی این ویدئو نشون میده که SpacetimeDB حتی با تمام optimization هایی که انجام داده توی شرایط برابر به Postgresql با کانفیگ دیفالت هم نمیرسه Video on Youtube پینوشت: خواستم بگم مثل این دوستی که ویدئو SpacetimeDB رو برای من فرستاد شما تو تله نبوفتید.

توی دوران قطعی اینترنت اخیر نشستم یک مقدار هارد آرشیوم رو تمیز کردم ( چیزی توش نیست جز دوره و جزوه و کدهای قدیمی) بعد این رو دیدم ۱۷ سال پیش (قبل اینکه به سن قانونی برسم) داشتم می‌خوندم برای آزمون

RHCE = RedHat Certified Engineer

چه روزهایی؛‌ یادم میاد مدرسه آیلتس کار و خوندن برای آزمون لینوکس رو ...

یک vpn دوستان معرفی کردند؛ بسیار هم توسط اشخاص دیگه توی اینستاگرام و ... داره معرفی می‌شه. داستان اینجوری هست که شما برنامه رو روی اپ‌استور یا پلی‌استور دانلود می‌کنی؛ بعد وارد یک ربات تلگرامی به اسم برنامه می‌شی و یک کد بهت می‌ده با این کد ۶ ماه اکانت پرمیوم رایگان می‌گیری. اما: بسیار بسیار اینکار خطرناک هست؛ دلایلش ۱- وقتی با یک ربات کار می‌کنید توی تلگرام اون ربات می‌تونه تمام اطلاعات اکانت شمارو بگیره (عکس، آیدی، کد یونیک و ...) ۲- ربات به شما یک کد اختصاصی می‌ده برای اینکه اکانت شما ۶ ماه دسترسی رایگان بگیره و خب فکر می‌کنم خودتون فهمیدید که با این کد شمارو شناسایی می‌کنه توی اپلیکیشن پس تا اینجا می‌دونه، شما کی هستید و کجا‌ها میرید با vpn خودتون. ۳- فرض کنیم این vpn داخلی و سهمیه‌ای هم باشه؛ توی اپلیکیشن دیتاهای مربوط به گوشی شمارو بصورت دیفالت میگیره Device model, model number, .... که خب بعضی از این‌ها دقیقاً برای شناسایی گوشی شما هست مثل یوزرنیم تلگرام که یونیک هست اینم همونطوری هست‌. ۴- بصورت پیش‌فرض کل اپلیکیشن‌ها رو vpn می‌کنه و دیتاهای diagnostic, analytic برای خودش می‌‌فرسته که یعنی هرچیزی که دلش خواست. دیدید وقتی سیمکارت دیگری رو توی گوشی می‌ندازید پیام میاد گوشی با این شماره رجیستر نشده یا برای این فرد نیست ؟ حالا همه اینارو بذاریم کنار هم : ۱- من از vpn میفهمم شما کجاها میری با چه پترنی (چقدر آپلود و چقدر دانلود داری) توی چه ساعت‌هایی ۲- اکانت تلگرامت رو هم که برای ۶ ماه رایگان بهم دادی؛ از اون هم می‌تونم کلی چیز پیدا کنم. مثلاً یوزر نیم مشابه روی توییتر و ... یا از عکس شما چیزای بیشتر یا از کانالی که به اکانت وصل هست و ... ۳- مدل نامبر و .... گوشی رو هم که بر میدارم و اگر به دیتابیس ثبت گوشی هم دسترسی داشته باشم؛ دقیقاً می‌دونم کی هستی. شماره موبایل، کد ملی و .... همه در میاد. خلاصه خیلی خیلی مراقب باشید، پنیر مفت تو تله موشه این کانالای تک اینستاگرام هم ۹۸٪ یک بچه که ۴ تا اصطلاح یادگرفته نشسته بدون هیچ درکی ...شر پشت هم میبافه. البته اینجا ۹۸-۹۹٪ حرفه‌ای هستید خودتون و متوجه مشکل شدید ولی لطفاً به باقی هم اطلاع بدید که حداقل حواسشون باشه. کپی این مطلب حتی بدون ذکر منبع هم آزاد هست.

تست سرعت اینترنت بین‌الملل بنده بعنوان یک برنامه‌نویس بعد یارو میاد: دنبال قرارداد دلاری از ایران و ریموت هم می‌گرده