Просмотр исходного текста страницы Haskell 24

== Промышленное программирование на Haskell, часть 1 ==

Весенний курс по выбору для студентов 4 курса ФКН ВШЭ.

=== Команда курса ===

Лектор: Павел Соколов aka [https://t.me/TurtlePU @TurtlePU].

Семинарист: Илья Костюченко aka [https://t.me/ilyakooo0 @ilyakooo0].

Ассистент: Даниил Рубин aka [https://t.me/supremeSwings @supremeSwings].

=== Ссылки ===

Канал в телеграм: https://t.me/+Is4I3YPaBWk3NjIy

Чат в телеграм: https://t.me/+lcim6Ukmojc5ZGUy

Материалы курса: https://github.com/Haskell-HSE

Записи лекций и семинаров: TBD

Таблица с оценками: TBD

== Setting up ==

<ol>
  <li>Если вы пользуетесь Windows, установите WSL2, если ещё не.</li>
  <li>
    Установите [https://www.haskell.org/ghcup/ ghcup] &mdash; скачайте [https://downloads.haskell.org/~ghcup/ бинарный файл] сами
    либо введите одну любимую команду:
    <ul>
      <li> '''MacOS''': <pre>brew install ghcup</pre></li>
      <li> '''Arch'''-based distros: <pre>yay -S ghcup-hs-bin</pre></li>
      <li> '''WSL2''', '''MacOS''' >= 10.13, '''Linux''': <pre>curl --proto '=https' --tlsv1.2 -sSf https://get-ghcup.haskell.org | sh</pre></li>
      <li> '''Windows Powershell''' (cringe): Команда доступна по [https://www.haskell.org/ghcup/install/#installation ссылке]</li>
    </ul>
  </li>
  <li>Убедитесь, что путь до места установки <code>ghcup</code> содержится в <code>$PATH</code> &mdash; запустите <code>ghcup list</code>.</li>
  <li>
    Установите '''<code style="background-color:black;color:rgb(0,255,0)">recommended</code>''' версии компилятора, системы сборки и языкового сервера:<pre>
ghcup install ghc recommended
ghcup install stack recommended
ghcup install hls recommended</pre>
  </li>
  <li>Убедитесь, что путь <code>~/.ghcup/bin</code> содержится в <code>$PATH</code>. При необходимости добавьте этот путь сами.</li>
  <li>
    Создайте символические ссылки на установленные версии программ:<pre>
ghcup set ghc recommended
ghcup set stack recommended
ghcup set hls recommended</pre>
  </li>
  <li>
    Настройте LSP client в своей любимой среде разработки:
    <ul>
      <li>Для '''VS Code''' есть [https://github.com/haskell/vscode-haskell плагин]. Настройка: TBD</li>
      <li>В '''NeoVim''' настройте [https://github.com/neovim/nvim-lspconfig nvim-lspconfig], он знает про HLS.</li>
      <li>Инструкцию для других сред можно найти [https://haskell-language-server.readthedocs.io/en/latest/configuration.html#configuring-your-editor здесь].</li>
    </ul>
  </li>
  <li>Опционально &mdash; установите [https://hoogle.haskell.org Hoogle] локально:
    <ol>
      <li><code>cabal install hoogle</code></li>
      <li>
        Допишите в файл <code>~/.ghci</code> следующее:<pre>
:def hoogle \x -> return $ ":!hoogle \"" ++ x ++ "\""
:def hdoc \x -> return $ ":!hoogle --info \"" ++ x ++ "\""</pre>
      </li>
      <li>Теперь можно пользоваться Hoogle прямо из ghci с помощью команд <code>:hoogle</code> и <code>:hdoc</code></li>
    </ol>
  </li>
</ol>

== План курса ==

=== Лекции, семинары ===

=== Домашние задания ===

Практические задания по пройденным темам в виде мини-проектов stack. За каждое домашнее задание можно получить до 12 баллов.

Условия публикуются в репозитории курса.

=== Проект ===

В качестве проекта предлагается доработать одно из домашних заданий следующим образом:

<ul>
<li>Расширить функционал приложения, выполненного в домашнем задании (масштаб работ нужно обсудить с лектором либо с семинаристом) (4 балла из 10);</li>
<li>Покрыть код тестами (2 балла из 10);</li>
<li>Не использовать <code>unsafe</code>, если это не было обговорено заранее (2 балла из 10);</li>
<li>Проанализировать производительность приложения (1 балл из 10; 2 балла, если в проекте разрешён unsafe);</li>
<li>Поддерживать чистоту кода (1 балл из 10; 2 балла, если в проекте разрешён unsafe):
  <ul>
  <li>предпочитать использовать готовые комбинаторы из стандартной библиотеки вместо явного паттерн-матчинга стандартных типов данных;</li>
  <li>предпочитать point-free стиль, где это разумно;</li>
  <li>предпочитать пользоваться подсказками HLint;</li>
  <li>код должен быть консистентно отформатирован, неиспользованных импортов быть не должно;</li>
  <li>если в проекте разрешён unsafe, он должен быть отделён от остального приложения какой-то безопасной абстракцией.</li>
  </ul>
</li>
</ul>

Возможны групповые проекты. Также возможны инициативные темы; они обсуждаются индивидуально, но разбалловка остаётся такой же.

Проект должен быть оформлен в приватном репозитории на github. Оценка выставляется за проект в том состоянии, в котором находилась default ветка репозитория (скорее всего main либо master) '''в полночь перед защитой'''. Либо можно оформить сдачу в виде пулл-реквеста.

Защита проекта проводится во время весенней сессии.

=== Оценивание ===

Итог = Округление(min(10, 0.64 * ДЗ + 0.36 * ПР)),

где ДЗ – средняя оценка за все домашние задания, ПР – оценка за проектную работу.

Округление арифметическое.

== Дополнительная литература ==

* Will Kurt – Get Programming with Haskell
* Bryan O'Sullivan, Don Stewart, John Goerzen – Real World Haskell
* Alexander Granin – Functional Design and Architecture
* Sandy Maguire – Algebra-Driven Design