learnhaskell/guide-ru.md

Как познать Haskell

Этот документ - рекомендованный путь к изучению языка Haskell, основанный на опыте помощи другим

Это руководство доступно на других языках:

• In English

• Auf Deutsch

• En Español

• En Français

• In Italiano

• Em Português

• 繁體中文

Не мучайтесь над одним топиком, который вы не можете понять сразу. Двигайтесь дальше!

Сообщество

IRC канал #haskell-beginners на Freenode.

IRC веб-клиент здесь.

Почтовые рассылки.

Политика сообщества

Смотрите пост про обучение от Криса Дона

Будьте дружелюбны и вежливы. Грубость и хамство испугает собеседника и оттолкнет от участия в общении.

Слабая, неконструктивная критика удовлетворяет лишь критикующего, но не помогает критикуемому.

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

Не симулируйте удивление. Не изображайте удивление, когда кто-либо говорит, что он не знает что-то. Он будут чувствовать себя ужасно, а вы не получите ничего, кроме резкости.

"ну, на самом деле". Когда кто-либо говорит что-то почти - но не совсем - верное, а вы говорите "ну, на самом деле..." и даете лишь мелкую правку. Это особенно раздражает, когда поправка не относится к основной теме разговора. Это не значит, что этот канал не про поиск правды или что нам все равно на точность. Просто почти все "ну, на самом деле" являются показухой, а не поиском правды.

Не делайте всю работу за обучающегося. Если вы ввидите, что человек работает над проблемой, вы не должны немедлено выдавать советы или готовые решения. Дайте ему поработать и поизучать, пока он сам не попросит помощи. Избегать помех - одна из основных причин существования #haskell-beginners.

Никаких -измов. Расизм, сексизм, гомофобия, трансофобия и другие виды фобий не приветствуются и не будут приняты терпимо.

---

Правила хорошего тона от Recurse Center. Спасибо за их публикацию Recurse Center.

Что такое Haskell, GHC и Cabal?

Haskell - это язык программирования, изложенный в спецификациях, последняя версия которых опубликована в 2010 году. Эта спецификация доступна как онлайн-документ.

GHC

GHC - это самый популярный способ работы с языком Haskell. Он включает в себя компилятор, REPL (интерпритатор), пакетный менеджер и другие полезные вещи.

Cabal

Cabal позволяет управлять проектами и разрешает зависимости. При помощи него вы устанавливаете и создаете проекты, обычно в песочницу (изолированное окружение).

Cabal аналогичен Bundler в Ruby, pip в Python, NPM в Node и так далее. GHC управляет пакетами сам, Cabal решает какие версии устанавливать.

Установка Haskell

НЕ УСТАНАВЛИВАЙТЕ HASKELL PLATFORM

Вместо следования инструкциям на Haskell.org, смотри инструкции ниже, как установить GHC и Cabal.

Установка GHC и Cabal

Ubuntu

Этот PPA лучший, и именно его я использую на всех моих серверах и локальных машинах с Linux.

А именно:

$ sudo apt-get update
$ sudo apt-get install python-software-properties # v12.04 and below
$ sudo apt-get install software-properties-common # v12.10 and above
$ sudo add-apt-repository -y ppa:hvr/ghc
$ sudo apt-get update
$ sudo apt-get install cabal-install-1.22 ghc-7.8.4 happy-1.19.5 alex-3.1.4

После этого, добавьте следующие пути к вашему $PATH (bash_profile, zshrc, bashrc, и тп):

export PATH=$PATH:~/.cabal/bin:/opt/cabal/1.22/bin:/opt/ghc/7.8.4/bin:/opt/happy/1.19.5/bin:/opt/alex/3.1.4/bin

Опционально: вы можете добавить также .cabal-sandbox/bin к вашему пути. Код, который вы разрабатываете, будет доступен вам из командной строки. Это работает только тогда, когда ваша текущая рабочая папка - песочница cabal.

Debian

Использование Ubuntu PPA

Если вы не используете стабильный дистрибутив, вы можете повторить все теже шаги, что и для Ubuntu, но вам надо будет выполнить дополнительную команду. Сразу после sudo add-apt-repository -y ppa:hvr/ghc выполните:

$ sudo sed -i s/jessie/trusty/g /etc/apt/sources.list.d/hvr-ghc-jessie.list

Для остальных версий Debian, просто замените все jessie именем вашей версии в команде выше.

Если по какой-то причине файл /etc/apt/sources.list.d/hvr-ghc-jessie.list не существует, то /etc/apt/sources.list должен содержать строку со ссылкой вроде этой:

deb http://ppa.launchpad.net/hvr/ghc/ubuntu jessie main

Замените jessie на trusty в этой строке.

Сборка из исходников

Вы можете использовать [это руководство] (http://www.davesquared.net/2014/05/platformless-haskell.html), написанное для Mac OS X:

Замечания:

• Выставьте ваш префикс соответственно, когда конфигурируете ghc.
• Вместо того, чтобы забирать бинарник cabal-install, скачайте исходный код и запустите скрипт bootstrap.sh.

Fedora 21

Чтобы уставновить Haskell 7.8.4 из неофициального репо (Fedora 22+ будут содержать его в официальном):

$ sudo yum-config-manager --add-repo \
> https://copr.fedoraproject.org/coprs/petersen/ghc-7.8.4/repo/fedora-21/petersen-ghc-7.8.4-fedora-21.repo
$ sudo yum install ghc cabal-install

Как указано на странице petersen/ghc-7.8.4 этот ghc не может быть установлен вместе с Fedora/EPEL ghc.

Arch Linux

Чтобы установить Haskell из официального репо на Arch Linux, выполните:

$ sudo pacman -S cabal-install ghc happy alex haddock

Gentoo

На Gentoo вы можете установить индивидуальные компоненты Haskell Platform через Portage. Если вы используете ACCEPT_KEYWORDS=arch (вместо ACCEPT_KEYWORDS=~arch), Portage установит древние версии различных компонент Haskell. Помня это, если вы используете ACCEPT_KEYWORDS=arch, добавьте следующие строки в /etc/portage/package.keywords.

dev-haskell/cabal-install
dev-lang/ghc

Как только это сделано,

$ emerge -jav dev-lang/ghc dev-haskell/cabal-install

Gentoo хранит "стабильную" (читай "старую") версию cabal-install в дереве Portage, так что, если вы хотите использовать более современную версию cabal-install, выполните (заметтье, что слеши здесь нужны)

$ \cabal update                # Слеши здесь
$ \cabal install cabal-install # нужны

Вы установили cabal глобально через Portage и локально в вашей домашней директории с cabal-install. Следующий шаг, это убедиться, что когда вы запускаете cabal в вашем терминале, ваша оболочка запускает последнюю версию в вашей домашней директории. Вам нужно добавить следующие строки к конфигурационному файлу вашей оболочки.

PATH=$PATH:$HOME/.cabal/bin
alias cabal="$HOME/.cabal/bin/cabal"

Если вы не знаете, какая оболочка у вас используется, то скорее всего это Bash. Если это Bash, то файл, в который вам надо добавлять эти строки - ~/.bashrc. Если вы используете Z-shell, то это ~/.zshrc. Вы можете понять, какая оболочка у вас используется, запустив:

echo $SHELL | xargs basename

Я использую zsh, так что вывод этой команды у меня выглядит как zsh.

После всего этого вы захотите установить дополнительные инструменты alex и happy.

$ cabal install alex happy

Поздравляю! Теперь у вас рабочий Haskell!

Mac OS X

10.9

Установите GHC для Mac OS X приложение, которое включает в себя GHC и Cabal. Оно предоставляет инструкции, как добавить GHC и Cabal в ваш путь, после того как вы скопируете приложение .app куда-либо.

10.6-10.8

Выполните установку бинарников, которая описана ниже, для этого архива.

Windows

• Минимальный установщик GHC для Windows способен скомпилировать network и тп. Технически, это бета версия, но должна работать для тех, кто читает это руководство.

Не забудьте запустить установщик как администратор, так как он захочет установить файлы в Program Files.

Пользователям других Linux дистрибутивов

Скачайте последние бинарники cabal и ghc:

• GHC.

• Cabal.

Пользователям других Unix-подобных систем

Скачайте GHC и Cabal из вашего пакетного менеджера, затем добавьте ~/.cabal/bin в ваше $PATH. Поосле этого обновите cabal и установите дополнительные инструменты alex и happy.

$ cabal update
$ cabal install cabal-install alex happy

Как я должен изучать Haskell?

Основная рекомендация, это читать лекции и выполнять все упражнения/домашние задания для Spring 13 версии курса cis194. Затем то же для курса NICTA. На оба курса ссылки представлены ниже. Все остальное может быть рассмотрено как опциональное, и вы просто будете знать куда смотреть по определенной теме.

Курс Yorgey cis194

Выполните его в первую очередь, это лучший путь получить представление о Haskell

Доступен онлайн.

Курс от Brent Yorgey, это лучшее, что я пока нашел. Этот курс ценен тем, что он не только научит вас писать базовый код на Haskell, но и также поможет вам понять комбинаторы парсера.

Единственная причина, по которой вам не стоит начинать с курса cis194, это если вы не программист или вы неопытный программист. В этом случае, начинайте с книги от Thompson и после этого уже курс cis194.

---

Курс NICTA

Этот курс мы рекомендуем выполнять после курса Yorgey cis194.

Доступен на Github здесь.

Этот курс укрепит и добавит опыта реализации абстракций, представленых в курсе cis194. Эта практика критически важна для комфортного использования в дальнейшем таких абстракций как Functor/Applicative/Monad/и тп. в Haskell. Выполнение cis194 и затем NICTA курсов представляет собой основную рекомендацию моего руководства и того, как научить любого языку Haskell.

---

Дополнительный курс после cis194 и NICTA

Предоставляет больше информации по продвинутым темам

cs240h доступен онлайн.

Это онлайн курс от Bryan O'Sullivan, который он преподает в Стенфорде. Если вы не знаете кто он такой, взгляните на половину библиотек, от которых зависят все приложения на Haskell, и вы увидите его имя в их авторах. Если вы уже закончили курс Yorgey, особого внимания в этом курсе заслуживают разделы о фантомных типах, контроле потоков информации, расширениях языка, конкурентном выполнении, pipes и линзах.

---

Специфичные топики Haskell

Эти источники не были проверены на учащихся так, как cis194 и NICTA, но с их помощью вы поймете с чего начинать изучение определенной темы. Они включают продвинутые и сложные темы и топики посвященные инструментам и текстовым редакторам.

Что делает <- / do / синтаксический сахар включения списков?

Отличная статья.

Для понимания списков и свертки

• Explain List Folds to Yourself

Для изучения некоторых из стандартных классов типов

Полезно для понимания Functor, Applicative, Monad, Monoid и других классов типов в целом, а также немного специфичной для Haskell теории категорий:

• The Typeclassopedia

Понимание базовых сообщений об ошибках в Haskell

• Understanding basic error messages

---

Laziness, strictness, guarded recursion

• Книга Marlow про параллелизм и конкаренси содержит одно из лучших представлений laziness и нормальных форм, которые я нашел. Используйте другие источники, если не поймете сразу из этого.

• More points for lazy evaluation

• Oh my laziness!

• SO вопрос 'Does haskell have laziness?'

• Слайды Johan Tibell из доклада reasoning about laziness.

Краткая демонстрация

let a = 1 : a -- guarded recursion, (:) is lazy and can be pattern matched.
let (v : _) = a
> v
1
> head a -- head a == v
1

let a = 1 * a -- not guarded, (*) is strict
> a
*** Exception: <<loop>>

IO

• Evaluation order and State tokens

• Unraveling the mystery of the IO monad.

• First class "statements".

• Haddocks for System.IO.Unsafe.unsafePerformIO При прочтении, обратите внимание на реализацию unsafeDupablePerformIO

Комментарий с обсуждения на Reddit от glaebhoerl

Перевод:

Интересное замечание: GHC должен скрывать отображение токена статуса поздаи абстрактного типа IO, потому что токен статуса должен все время быть использован линейно (не быть дуплицирован или сброшен), но система типов не может принудительно этого делать. Понятно, что другой ленивый подобный Haskell язык, имеет уникальные типы (которые подобны линейным типам и возможно отличаются, но я не знаю как), и они разкрывают передачу в Мир напрямую и предоставляют (не абстрактную) IO монаду только для соблюдения соглашения.

Оригинал:

Interesting side note: GHC needs to hide the state token representation behind an abstract IO type because the state token must always be used linearly (not duplicated or dropped), but the type system can't enforce this. Clean, another lazy Haskell-like language, has uniqueness types (which are like linear types and possibly different in ways I'm not aware of), and they expose the World-passing directly and provide a (non-abstract) IO monad only for convenience.

Монады и трансформеры монад

Не делайте этого пока вы не поняли классы типов Monoid, Funcor и Applicative!

Реализуйте монады из стандартной библиотеки (List, Maybe, Cont, Error, Reader, Writer, State) для себя, чтобы понять их лучше. Затем, может быть, напишите монадный интерпритатор для маленького языка выражений используя документ Monad Transformers Step by Step (упомянут в 'трансформеры монад' ниже).

Написание многих интерпритаторов просто изменяя монаду для изменения семантики может помочь лучше понять, что происходит.

• Этот рассказ от Tony отлично мотивирует трансформеры монад , слайды.

Также, реализуйте Control.Monad. Функции типа mapM или sequence - хорошая возможность попрактиковаться в написании общего кода монад.

Курс NICTA может быть использован как руководство для этого, он также включает написание своего собственного Applicative.

Упоминания:

• Комментарии на Reddit от htmltyp и Crandom здесь.

• Комментарий на Reddit от jozefg здесь.

Трансформеры монад

• A gentle introduction to Monad Transformers.

• Monad transformers step-by-step.

Тестирование, тесты, спеки, generative/property тестирование

• Это руководство от Kazu Yamamoto – просто фантастичecкое.

• Simple-Conduit: Хорошая простая библиотека для изучения, как работает стриминг IO в целом, знания, применимые также к таким библиотекам как Pipes и Conduit.

Парсинг в Haskell

• Руководство по Parser комбинаторy для Haskell с использованием Parsec

• Writing your own micro-Parsec

Парсинг и генерация JSON

Aeson - это стандартное решение для парсинга JSON в Haskell. Доступно из hackage и github.

• Parsing JSON using Aeson

• Aeson and user created types

• Parsing non-deterministic data with aeson and sum types

• Aeson tutorial

Алгоритмы графов и структуры данных

• Пакет fgl частично чисто функциональный кратчайший путь algos.

• Inductive graphs and Functional Graph Algorithms.

• FGL/Haskell - A Functional Graph Library.

• Data.Graph source from Containers package.

• Пакет graphs.

• SO вопрос про PHOAS

• PHOAS бесплатно.

• Tying the Knot.

• Hackage: dag.

Окружение разработки

Emacs

• Alejandro Serras's tutorial

• My dotfiles

• Chris Done's emacs config

Vim

• Vim page on haskellwiki

• Haskell-vim-now

• GHC-Mod

• GHC-Mod vim plugin

• Hindent

Sublime Text

• SublimeHaskell

Работа с Cabal

Руководства по Cabal

Cabal Hell был проблемой для пользователей Haskell до появления песочниц (sandboxes). Установка вне песочницы происходит в вашу пользовательскую базу данных пакетов. Это не очень хорошая идея, за исключением основных пакетов, таких как Cabal. alex и happy. Более ничто не должно быть установлено глобально или в пользовательскую базу данных пакетов, если вы не уверены в том, что делаете.

Несколько советов об избежании cabal hell можно найти здесь.

Для экспериментов с пакетом или в начале нового проекта, начните с команды cabal sandbox init в новой папке.

Кратко:

• Всегда используйте песочницы для установки новых пакетов, создания новых проектов, или для экспериментов.

• Используйте cabal repl для использования ghci внутри проекта.

Основанный на песочницах подход, который я советую, поможет избежать проблем с зависимостями пакетов, но он не совместим со способом, предоставляемым Haskell Platform для собраных пакетов. Если вы все еще изучаете Haskell и не понимаете как ghc-pkg и Cabal работает, избегайте платформу и вместо этого используйте инструкции по установке, описаные выше.

Stackage

Для любых пользователей (обычно для пользователей Yesod), которые испытывают проблемы со сборкой, существует Stackage.

• Хороший обзор Stackage здесь.

По мнению автора, Stackage обычно более полезен, чем cabal freeze.

Hoogle и Haddock

Поиск кода по сигнатуре типов

Поисковый движок Hoogle может искать по типам.

Например, взгляните на результат поиска для (a -> b) -> [a] -> [b] здесь.

Так же он доступен на fpcomplete здесь.

Еще есть Hayoo (который включает все пакеты hackage для поиска по дефолту).

Разворачивание собственного локального Hoogle

Взгляните сюда.

Haddock

1. Fix your hackage documentation

2. Hackage documentation v2

Заметьте, что эти публикации слегка устарели: например, теперь Hackage поддерживает новую информацию с информацией о документации и статус сборки.

Что вам правда нужно знать

Чтобы haddock включал документацию для зависимых пакетов, вам нужно выставить documentation: True в вашем ~/.cabal/config. Если это было выставлено по дефолту (False) или выставлено непосредственно в False, вам нужно будет удалить все ваши пакеты и переустановить перед генерацией haddock.

Другая вещь, о которой надо помнить, это то, что из-за способа, которым $pkg параметр интерполируется посредством cabal, не вами, html-location и content-location параметры должны быть в одиночных кавычках и набираться в оболочке или содержаться в шелл-скрипте. Они не будут работать в Makefile, потому что haddock будет думать, что они являются переменными Make!

#! /usr/bin/env sh

# Вы можете набирать это одной строкой без обратных слешей
cabal haddock --hoogle --hyperlink-source                       \
 --html-location='http://hackage.haskell.org/package/$pkg/docs' \
 --contents-location='http://hackage.haskell.org/package/$pkg'

TravisCI

Если вы такой же большой фанат TravisCI как я, тогда очень рекомендую вам взглянуть на multi-ghc-travis как основу для travis.yml ваших Haskell проектов.

Frontend/JavaScript

Мы обладаем огромными богатствами! Есть три основных вещи, которые я рекомендую:

• Haste компилятор Haskell в JavaScript

  • Компилятор на github.
  • Отличное демо Haste с примером проекта.

• GHCJS

  • GHCJS Introduction
  • Functional Reactive Web Interfaces with GHCJS and Sodium
  • Writing Atom plugins in Haskell using ghcjs

• PureScript

  • Не совсем Haskell как Haste или GHCJS, но популярный выбор многих пользователей Haskell
  • Написан и вдохновлен языком Haskell
  • Попробуйте purescript в вашем браузере здесь
  • Отличное руководство для начала

Какой фронтенд язык мне использовать?

GHCJS и Haste оба являются полноценным Haskell. GHCJS будет работать с большим числом пакетов, нежели Haste, но это не затрагивает большинство фронтенд проектов. PureScript совсем не Haskell, так что использовать Haskell код из вашего бекенда совсем не получится.

GHCJS имеет самое быстрое время выполнение на уровне 100kb (luite работает на этом). Haste и PureScript сравнимы.

PureScript имеет наилучшую интеграцию с JS инструментами (использует gulp/grunt/bower), GHCJS и Haste интегрируются лучше с инструментами Haskell (Cabal).

Все три являются отличным выбором и будут работать для большинства фронтэнд проектов.

Для более глубокого понимания laziness, NF, WHNF

• Notes on lambda calculus.

Исследовательские документы про lazy lambda calculi

• A call by need lambda calculus.

• Demonstrating Lambda Calculus Reduction

• The lazy lambda calculus.

• Lazy evaluation of Haskell

Parallelism/Concurrency

• Parallel and Concurrent Programming in Haskell. Эта книга от Simon Marlow, наверное лучшее, что я когда-либо читал о параллелизме и конкаренси.

• Хорошее руководство по тестированию и инкрементальной разработке многопоточного приложения в Haskell.

• Functional Reactive Programming

Линзы и призмы

Как только вы почувствуюте себя комфортно с Haskell, очень рекомендую изучить Lenses и Prisms, даже лишь в качестве "пользователя". Вам не обязательно нужно понимать лежащую в основе категорию для того, чтобы они были полезны.

Люди зачастую завышают сложность использования линз. Все, кто комфортно чувствует себя используя Functor/Foldable/Traversable (или даже если лишь первый) могут начать использовать линзы и призмы для облегчения своей жизни.

Если вы когда-либо делали что-то вроде: (fmap . fmap), вы уже "использовали линзы" в своей голове.

Я рекомендую следующие два руководства:

• A little lens starter tutorial

• Lens: Lenses, Folds and Traversals

За дальнейшей информацией смотрите: Lens package on hackage.

Схемы рекурсии

Некоторые сумасшедшие *-morphism слова, которые вы могли слышать, на самом деле о рекурсии. Но перед тем как трогать этот материал, вы должны знать как реализовать foldr для списков и хотя бы одну структуру данных, такую как дерево. (folds являются catamorphisms). Знание о том, как реализовать unfold (anamorphism), также помогут в осознании этих вещей.

Этот материал согласуется с traversable и foldable.

• An introduction to recursion schemes

• Don't fear the cat - Хорошая демонстрация того, как hylomorphism, это композиция из cata и ana.

• Recursion Schemes - это руководство просто замечательно!

• Functional Programming with Bananas, Lenses, Envelopes and Barbed Wire

• Catamorphisms

Ядро GHC и настройка производительности

• Write Haskell as Fast as C

• GHC Wiki: CoreSyn Type.

• Hackage: GHC Core.

• SO Question: Reading GHC Core.

• Haskell as fast as C.

• Real World Haskell, Chapter 25: Profiling and Optimizations.

Тип и теория категорий

Не необходимо для работы с Haskell, просто для тех, кто интересуется!

Если вы хотите вникнуть в типы и теорию категорий:

• Catster's Guide и Catster's Guide 2

• Вики-книга haskell содержит неплохие диаграмы

• Category Theory на haskellwiki, также содержит хорошие ссылки

• Categories from scratch, содержит несколько практических примеров.

• Список Pierce Great Works in PL.

Книги

• Рекомендации Kmett: Quora Question: What is the best textbook for category theory?

• Awodey и MacLane. Стандартные книги про теорию категорий.

• Harper's Practical Foundations for Programming Languages лучшее PL интро к теории типов, которое я читал.

• Type theory and Functional Programming.

Другие веселые темы

Parametricity, ad-hoc vs. parametric polymorphism, free theorems

• Parametricity.

• Исходники в TeX для доклада выше.

• Making ad-hoc polymorphism less ad-hoc.

• Theorems for Free!.

Initial and Final, DSLs, Finally Tagless

• Final Encodings, Part 1: A Quick Demonstration.

• Transforming Polymorphic Values.

• GADTs in Haskell 98.

• Typed Tagless-Final Linear Lambda Calculus.

• Typed tagless-final interpretations: Lecture notes.

• Typed Tagless Final Interpreters.

• The dog that didn't bark less specifically relevant but interesting.

Comonads

• Comonads in Haskell.

• SO question: Can a Monad be a Comonad.

Yoneda / CoYoneda

• SO question: Step-by-step explanation of coyoneda.

• Свободные монады для Less, серия из трех публикаций от Edward Kmett

  • Part 1: Codensity.
  • Part 2: Yoneda.
  • Part 3: Yielding IO.

Propositions vs. Judgments (computation)

• StackExchange question: What is the difference between propositions and judgements.

• Lecture notes from a short, three lecture course

Зависимая типизация

• Grokking sum types, value constructors, and type constructors squint hard.

• Lightweight Dependent-type Programming.

• Idris programming language.

Statically linking binaries

• Static linking

• Static linking with GHC on Arch Linux

• Statically linking Linux binaries for ARM & MIPS

• Statically link GMP using GHC and LLVM

Диалоги

Хранятся в этом репозитории здесь.

Они на самом деле достаточно важны и полезны. Просмотрите для погружения в некоторые из тем.