lucky

Цель: предотвратить ошибки, забудьте о большинстве проблем с производительностью и тратьте больше времени на код вместо отладки и исправления тестов.

Таким образом, сделайте написание потрясающих веб -приложений быстрым, веселым и легким.

Приходите с рельсов?

• Ruby on Rails to Lucky On Crystal: быстро пропадает, меньше жуков и еще больше удовольствия.

Попробуйте Lucky

У Lucky есть новый новый набор гидов, который позволяет легко начать работу.

Не стесняйтесь сказать привет или задавать вопросы в нашем чате.

Или вы можете скопировать реальное рабочее приложение с Lucky Jumpstart.

Установка Lucky

Чтобы установить Lucky, прочитайте установки Lucky Guides для вашей операционной системы. Руководство проведет вас через установку утилиты командной строки, используемой для создания новых счастливых приложений.

Будьте в курсе

Будьте в курсе, следуя @luckyframework в Твиттере.

Документация

API (Main)

Как это выглядит?

Конечная точка 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 маршрута.
• Используйте 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 так как они не помечены как невозможные).

Запрос базы данных

 # 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 , чтобы получить постоянные пользователи более 1 недели назад. У 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 . Передайте параметры 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 из корня проекта.

Внося

См. Appling.md

К счастью, у тебя есть!

Мы любим всех членов сообщества, которые проделали тяжелую работу, чтобы сделать счастливчику лучше. Если вы один из этих людей, мы хотим дать вам футболку!

Чтобы получить рубашку, мы просим, ​​чтобы вы внесли значительный вклад в Lucky. Это включает в себя такие вещи, как отправка PRS с исправлением ошибок и реализациями функций, помощь другим участникам решать проблемы и развертывание приложений реального мира с использованием Lucky!

Чтобы претендовать на свою рубашку, заполните эту форму.

Участники

Полсмит Пол Смит - оригинальный создатель Lucky

Сделано из ouctrib.rocks.

Спасибо и атрибуты

• SessionHandler, Cookiehandler и Flashhandler основаны на янтаре. Спасибо Amber Team!
• Спасибо Rails за то, что вдохновили многие идеи, которые легко воспринимать как должное. Конвенция о конфигурации, удалении шаблона и, самое главное, сосредоточено на счастье разработчика.
• Благодаря Phoenix, Ecto и Elixir за вдохновляющие операции Avram's Save, единые базовые действия Lucky's Once Base и концентрации и сосредоточены на полезных сообщениях об ошибках.
• lucky watch Bounderly на Sentry. Спасибо @samueleaton!