زبان برنامه‌نویسی

چیت‌شیت Ruby

راهنمای زبان Ruby برای متغیرها، collectionها، بلوک‌ها، کلاس و مدیریت خطا. Enumerable با blockها الگوهای رایج تبدیل و فیلتر را ساده می‌کند. برای مجموعهٔ بزرگ، eager و lazy بودن زنجیره را بسنجید. API را با آرگومان‌های نام‌دار و خروجی روشن طراحی کنید. بلوک‌ها را برای رفتار قابل‌تزریق و ensure را برای cleanup به‌کار ببرید. از این صفحه به‌عنوان مرجع سریع استفاده کنید و مثال‌ها و نکته‌ها را با نسخهٔ ابزار، نیاز و شرایط واقعی پروژهٔ خود تطبیق دهید.

NOVIN SKILLS / DIGITAL STUDIO

Map و select

هر مرحله فقط یک تبدیل مشخص انجام می‌دهد.

1active_names = users2  .select(&:active?)3  .map(&:name)4  .sort

گروه‌بندی با group_by

خروجی Hash شامل کلید و آرایهٔ اعضای هر گروه است.

1orders_by_customer = orders.group_by(&:customer_id)

شمارش با tally

tally تعداد هر مقدار را در Hash جمع می‌کند.

1word_counts = words2  .map(&:downcase)3  .tally

Keyword arguments و مقدار پیش‌فرض

نام آرگومان‌ها در call site قرارداد را خواناتر می‌کند.

1def connect(host:, port: 443, timeout: 5)2  Client.new(host: host, port: port, timeout: timeout)3end45client = connect(host: "example.test")

Block و yield

yield رفتار را به caller می‌سپارد و کد تکراری را کم می‌کند.

1def with_timing2  started_at = Process.clock_gettime(Process::CLOCK_MONOTONIC)3  yield4ensure5  elapsed = Process.clock_gettime(Process::CLOCK_MONOTONIC) - started_at6  puts "elapsed: #{elapsed.round(3)}s"7end

Class و متد نمونه

وضعیت را با instance variable نگه دارید و API عمومی کوچک بماند.

1class Counter2  def initialize(value = 0)3    @value = value4  end56  def increment7    @value += 18  end9end

Hash و مقدار پیش‌فرض

fetch مقدار پیش‌فرض می‌دهد و نبود کلید را از مقدار nil جدا می‌کند.

1settings = { theme: "dark" }2theme = settings.fetch(:theme, "system")3locale = settings.fetch(:locale, "fa")

Module و namespace

module نام‌ها را گروه‌بندی می‌کند و متدهای ماژولار را جدا نگه می‌دارد.

1module Billing2  class Invoice3    def total4      line_items.sum(&:amount)5    end6  end7end

مدیریت exception مشخص

نوع خطا را محدود کنید و جزئیات را برای تشخیص حفظ کنید.

1begin2  JSON.parse(payload)3rescue JSON::ParserError => error4  warn "invalid JSON: #{error.message}"5  {}6end

برای استفاده در پروژه

نکات کلیدی

۱
متغیر محلی ساده و نماد با :name نوشته می‌شود؛ محدوده هرکدام را بشناسید.
۲
آرایه با [] و hash با { key: value } تعریف می‌شود.
۳
برای پیمایش collection از each، برای تبدیل از map و فیلتر از select استفاده کنید.
۴
بلوک را با do ... end یا { ... } متناسب با خوانایی بنویسید.
۵
متد را با def تعریف و مقدار بازگشتی را آگاهانه مشخص کنید.
۶
کلاس را با class بسازید؛ سطح دسترسی متدها را روشن کنید.
۷
رشته قالبی: "Hello, #{name}"; داده را قبل از استفاده در HTML ایمن کنید.
۸
استثنای مشخص را با begin/rescue/ensure مدیریت کنید.
۹
وابستگی‌ها را در Gemfile تعریف و lockfile را نگه دارید.
۱۰
با ruby -c نحو را بررسی و منطق مهم را در تست پوشش دهید.
۱۱
برای منابع و بلوک‌هایی که باید آزادسازی تضمین‌شده داشته باشند، الگوی block و ensure را به‌کار ببرید.
۱۲
برای پیمایش مجموعه‌ها از Enumerable و زنجیرهٔ کوتاه و خوانای map، select و reduce استفاده کنید.