lucky

الهدف: منع الأخطاء ، ونسيان معظم مشكلات الأداء ، وقضاء المزيد من الوقت على الكود بدلاً من اختبارات تصحيح الأخطاء وإصلاحها.

باختصار ، اجعل كتابة تطبيقات الويب مذهلة سريعة وممتعة وسهلة.

قادم من القضبان؟

• Ruby on Rails to Lucky on Crystal: النيران بسرعة ، أقل من الحشرات ، وحتى أكثر متعة.

حاول محظوظ

Lucky لديه مجموعة جديدة من الأدلة التي تجعل من السهل البدء.

لا تتردد في قول مرحبًا أو طرح أسئلة في غرفة الدردشة الخاصة بنا.

أو يمكنك نسخ تطبيق عمل حقيقي مع Lucky JumpStart.

تثبيت محظوظ

لتثبيت Lucky ، اقرأ أدلة Lucky لتثبيت نظام التشغيل الخاص بك. سوف يسيرك الدليل من خلال تثبيت أداة سطر الأوامر المستخدمة لإنشاء تطبيقات محظوظة جديدة.

استمروا في ذلك

مواكبة من خلال اتباع luckyframework على Twitter.

الوثائق

API (رئيسي)

كيف تبدو؟

نقطة نهاية JSON:

 class Api::Users::Show < ApiAction
  get " /api/users/:user_id " do
    user = UserQuery .find(user_id)
    json UserSerializer .new(user)
  end
end

• إذا كنت تريد ، يمكنك إعداد طرق مخصصة مثل get "/sign_in" للطرق غير الراحة.
• يتم إنشاء طريقة user_id لأن هناك معلمة user_id route.
• استخدم json لتقديم JSON. استخراج مسلسلات لاستجابات JSON القابلة لإعادة الاستخدام.

نماذج قاعدة البيانات

 # Set up the model
class User < BaseModel
  table do
    column last_active_at : Time
    column last_name : String
    column nickname : String ?
  end
end

• قم بإعداد الأعمدة التي ترغب في استخدامها ، إلى جانب أنواعها
• يمكنك إضافة ? إلى النوع عندما يمكن أن يكون العمود nil . سيساعدك Crystal بعد ذلك على تذكر عدم استدعاء الأساليب التي لن تنجح.
• ستقوم Lucky بإعداد عمليات التحقق من صحة التواجد للحقول المطلوبة ( last_active_at و last_name نظرًا لعدم تمييزها على أنها Nilable).

الاستعلام عن قاعدة البيانات

 # Add some methods to help query the database
class UserQuery < User::BaseQuery
  def recently_active
    last_active_at.gt( 1 .week.ago)
  end

  def sorted_by_last_name
    last_name.lower.desc_order
  end
end

# Query the database
UserQuery .new.recently_active.sorted_by_last_name

• User::BaseQuery تلقائيًا عند تحديد نموذج. يرث منه لتخصيص الاستفسارات.
• قم بإعداد النطاقات المسماة مع أساليب المثيل.
• Lucky يقوم بإعداد طرق لجميع الأعمدة بحيث إذا أخطأت في اسم اسم العمود ، فسيخبرك في وقت الترجمة.
• استخدم الطريقة lower على عمود String للتأكد من أن Postgres يقوم بفرز كل شيء في الأحرف الصغيرة.
• استخدم gt لجعل المستخدمين نشطين أكثر من أسبوع واحد. لدى Lucky الكثير من التجريدات القوية لإنشاء استعلامات معقدة ، وكتابة طرق محددة (مثل lower ).

تقديم HTML:

 class Users::Index < BrowserAction
  get " /users " do
    users = UserQuery .new.sorted_by_last_name
    render IndexPage , users: users
  end
end

class Users::IndexPage < MainLayout
  needs users : UserQuery

  def content
    render_new_user_button
    render_user_list
  end

  private def render_new_user_button
    link " New User " , to: Users :: New
  end

  private def render_user_list
    ul class: " user-list " do
      users.each do | user |
        li do
          link user.name, to: Users :: Show .with(user.id)
          text " - "
          text user.nickname || " No Nickname "
        end
      end
    end
  end
end

• needs users : UserQuery المترجم أنه يجب تمرير المستخدمين من نوع UserQuery .
• إذا نسيت تمرير شيء تحتاجه الصفحة ، فسوف يعلمك في وقت الترجم. عدد أقل من الأخطاء وتصحيح الأخطاء بشكل أسرع .
• اكتب العلامات مع أساليب الكريستال. يتم إغلاق العلامات تلقائيًا وإزالة المسافة البيضاء.
• استخراج الأساليب المسمى بسهولة لأن الصفحات مصنوعة من الفصول والأساليب العادية. هذا يجعل صفحات HTML الخاصة بك سهلة القراءة بشكل لا يصدق.
• ارتباط بصفحات أخرى بسهولة. فقط استخدم اسم الإجراء: Users::New تمرير params with : Users::Show.with(user.id) . لا مزيد من المحاولة لتذكر مساعدي المسار وما إذا كان المساعد متعجدًا أم لا - إذا نسيت أن تمرر معلمة إلى مسار ، فسيعلمك Lucky في وقت الترجمة.
• منذ أن حددنا column nickname : String? كما Nilable ، سيفشل Lucky في تجميع الصفحة إذا قمت للتو بإجراء text user.nickname لأنه لا يسمح بطباعة nil . لذا بدلاً من ذلك ، نضيف احتياطيًا "No Nickname" . لا مزيد من طباعة النص الفارغ بطريق الخطأ في HTML!

الاختبار

تحتاج إلى التأكد من تثبيت التبعيات البلورية.

1. تشغيل shards install
2. تشغيل crystal spec من جذر المشروع.

المساهمة

انظر المساهمة

محظوظ لوجودك!

نحن نحب جميع أفراد المجتمع الذين قاموا بعمل شاق ليحسن الحظ. إذا كنت واحداً من هؤلاء الأشخاص ، فنحن نريد أن نقدم لك قميصًا!

للحصول على قميص ، نطلب أن تكون قد قدمت مساهمة كبيرة في Lucky. يتضمن ذلك أشياء مثل تقديم PRS مع إصلاحات الأخطاء والتطبيقات ، ومساعدة الأعضاء الآخرين على العمل من خلال المشكلات ، ونشر تطبيقات العالم الحقيقي باستخدام Lucky!

للمطالبة بقميصك ، املأ هذا النموذج.

المساهمين

Paulcsmith Paul Smith - المبدع الأصلي لـ Lucky

صنعت مع contrib.rocks.

شكرا وسمات

• تعتمد SessionHandler و CookieHandler و FlashHandler على العنبر. شكرا لفريق العنبر!
• بفضل Rails لإلهام العديد من الأفكار التي يسهل أخذها كأمر مسلم به. الاتفاقية على التكوين ، وإزالة الغلاية ، والأهم من ذلك - التركيز على سعادة المطور.
• بفضل Phoenix و Ecto و Elixir لإلهام عمليات حفظ AVRAM ، والإجراءات الأساسية والأنابيب الخاصة بـ Lucky ، والتركيز على رسائل الخطأ المفيدة.
• lucky watch يعتمد بشكل كبير على Sentry. شكرا samueleaton!