نام‌گذاری تمیز؛ اولین خط دفاع در Clean Code 🧹

یکی از عملی‌ترین ایده‌های کتاب Clean Code این است که «اسم خوب، نصف راه خوانایی کد است». خیلی از بدهی‌های فنی فقط با نام‌گذاری درست اصلاً به‌وجود نمی‌آیند.

👀 نشانه‌های نام‌گذاری بد

وقتی متغیر و تابع این‌طوری هستند:

def p(u):
    if len(u) > 0:
        for x in u:
            if x[3] == 1:
                send(x)

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

✅ چطور بهترش کنیم؟

۱️⃣ اسم باید «بگوید» چه‌کار می‌کند

def send_active_users(users):
    if len(users) == 0:
        return

    for user in users:
        if user.is_active():
            send(user)

نام تابع، ورودی و شرط‌ها واضح شده‌اند. نیاز کمتری به کامنت داریم، چون خود کد توضیح‌دهنده است.

۲️⃣ از اسم‌های عمومی مثل data, info, tmp دوری کن

# بد
result = process(data)

# بهتر
normalized_orders = normalize_orders(raw_orders)

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

۳️⃣ اسم تابع را فعل، اسم متغیر را اسم بگذار

# تابع با اسم اسمی (بدفهم)
user_status = user()

# واضح‌تر
status = get_user_status()

این الگوی ساده کمک می‌کند بدون نگاه به بدنه، از روی اسم‌ها بفهمیم هر چیزی «چیز است» یا «کار».

۴️⃣ از abbreviation بی‌معنی خودداری کن

# بد
cfg = read_cfg(pth)

# بهتر
config = read_config_file(path)

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

۵️⃣ اسم‌ها را بر اساس domain انتخاب کن

استفاده از واژه‌های همان دامنه (Order, Invoice, Payment, Discount) کد را به زبان بیزینس نزدیک می‌کند و فهم سیستم را برای همه‌ی تیم آسان‌تر می‌کند.

📚 برای مطالعه بیشتر:
Clean Code, Chapter 2: Meaningful Names
Refactoring Guru - Code Smells

در هر refactor کوچک، فقط با بهتر کردن اسم‌ها می‌شود کیفیت طراحی را بالا برد؛ بدون تغییر رفتار کد. از همین commit بعدی، روی هر اسم چند ثانیه بیشتر فکر شود، بازدهش در بلندمدت شگفت‌انگیز است ✨

🔖 #Programming #برنامه_نویسی #clean_code #naming #meaningful_names #refactoring #readability #architecture

👤 Developix

💎 Channel: @DevelopixChannel

با Migration Boost هاست‌ایران، برای مهاجرت به سرور ابری دوباره هزینه ترافیک نده! 🚀

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

✅ حداقل ۱۰۰ گیگابایت ترافیک هدیه مهاجرت
✅ افزایش حجم هدیه متناسب با ظرفیت دیسک اولیه
✅ ترافیک آپلود رایگان
✅ بدون محدودیت زمانی

سرور ابری هاست‌ایران را راه‌اندازی کنید و بکاپ‌ها، فایل‌ها و پایگاه داده خود را بدون دغدغه هزینه‌های پنهان ترافیک منتقل کنید.

👇 مشاهده پلن‌های سرور ابری هاست‌ایران
hostiran.club/Migration
hostiran.club/Migration

💠 نسخه جدید محیط توسعه VSCode منتشر شده است

🔸 ارتقا از نسخه 1.130.0 به 1.131.0

🔖 #vscode, #chat, #release

💎 @DevelopixChannel

💠 نسخه جدید محیط توسعه Zed منتشر شده است

🔸 ارتقا از نسخه 1.12.1 به 1.13.1

🔖 #zed, #chat, #release

💎 @DevelopixChannel

💠 نسخه جدید محیط توسعه VSCode منتشر شده است

🔸 ارتقا از نسخه 1.131.0 به 1.132.0

🔖 #vscode, #chat, #release

💎 @DevelopixChannel

💠 نسخه جدید محیط توسعه Zed منتشر شده است

🔸 ارتقا از نسخه 1.13.2 به 1.14.2

🔖 #zed, #chat, #release

💎 @DevelopixChannel

💠 نسخه جدید محیط توسعه VSCode منتشر شده است

🔸 ارتقا از نسخه 1.132.1 به 1.133.0

🔖 #vscode, #chat, #release

💎 @DevelopixChannel

💠 نسخه جدید محیط توسعه Zed منتشر شده است

🔸 ارتقا از نسخه 1.14.2 به 1.15.0

🔖 #zed, #chat, #release

💎 @DevelopixChannel

💠 نسخه جدید محیط توسعه ویژوال استودیو (Visual Studio) منتشر شده است

🔸 ارتقا از نسخه 18.8.3 به 18.9.0

🔖 #visual_studio, #chat, #csharp, #release

💎 @DevelopixChannel

🧩 این کد پایتون چه باگ عجیبی داره؟

هر بار که تابع add_item رو صدا می‌زنی، یه نتیجه غیرمنتظره می‌گیری.
مشکل اصلی توی این پیاده‌سازی چیه و چطور درستش می‌کنی؟

🔖 #Programming #برنامه_نویسی

👤 Developix

💎 Channel: @DevelopixChannel

💠 نسخه جدید محیط توسعه VSCode منتشر شده است

🔸 ارتقا از نسخه 1.133.0 به 1.134.0

🔖 #vscode, #chat, #release

💎 @DevelopixChannel

💠 نسخه جدید محیط توسعه Zed منتشر شده است

🔸 ارتقا از نسخه 1.15.1 به 1.16.1

🔖 #zed, #chat, #release

💎 @DevelopixChannel

🔥 پروژه: سرور LLM روی مک Apple Silicon

روی مک با Apple Silicon کار می‌کنی و می‌خواهی LLM محلی سریع داشته باشی؟ پروژه omlx دقیقا برای همین است 🤓

یک inference server سبک که مدل‌ها را با continuous batching و کش روی SSD اجرا می‌کند و همه‌چیز از منوی بالای macOS مدیریت می‌شود؛ بدون ترمینال، بدون دنگ‌وفنگ.

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

⭐️ 1,102 stars this week

🔖 #Programming #برنامه_نویسی #هوش_مصنوعی #LLM #Apple_Silicon

💎 @DevelopixChannel

💠 نسخه جدید محیط توسعه ویژوال استودیو (Visual Studio) منتشر شده است

🔸 ارتقا از نسخه 18.9.2 به 18.10.0

🔖 #visual_studio, #chat, #csharp, #release

💎 @DevelopixChannel

🔥 پروژه: چارچوب مهارت‌ توسعه‌دهنده «سوپِرپاورز»

سوپِرپاورز یک چارچوب مهارتی و متدولوژی توسعه نرم‌افزار است برای این‌که تبدیل به یک توسعه‌دهنده واقعاً «agentic» و صاحب‌اختیار در کار شوی.

داخل مخزن، راهنماها و چک‌لیست‌هایی برای مهارت‌هایی مثل اولویت‌بندی کار، دیباگ سیستماتیک، ارتباط با تیم و مدیریت ریسک پروژه وجود دارد؛ هم برای رشد فردی به‌درد می‌خورد، هم برای منتورینگ و لیدها 👀

از این‌جا می‌توان دیدش:
github.com/obra/superpowers

⭐️ 4,068 stars this week

🔖 #Programming #برنامه_نویسی #توسعه‌دهنده #متدولوژی #مدیریت_پروژه

💎 @DevelopixChannel