Skip to content

Latest commit

 

History

History
829 lines (512 loc) · 44.6 KB

guide-ru.md

File metadata and controls

829 lines (512 loc) · 44.6 KB

Как познать Haskell

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

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

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

Сообщество

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 в этой строке.

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

Вы можете использовать это руководство, написанное для 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 haskell-haddock-library

Gentoo

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

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

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

$ 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

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

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

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

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

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

$ cabal update
$ cabal install cabal-install alex happy

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

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

Курс Yorgey cis1940

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

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

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

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


Курс FP

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

Доступен на Github.

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


Дополнительный курс после cis1940 и FP

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

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

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


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

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

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

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

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

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

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

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


Laziness, strictness, guarded recursion

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

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

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

Перевод:

Интересное замечание: GHC должен скрывать отображение токена статуса абстрактного типа IO, потому что токен статуса должен все время быть использован линейно (не быть дуплицирован или сброшен), но система типов не может принудительно этого делать. Clean, другой ленивый подобный 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 (упомянут в «трансформеры монад» ниже).

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

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

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

Упоминания:

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

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

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

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

Парсинг в Haskell

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

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

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

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

Emacs

Vim

Sublime Text

Работа с 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 обычно более полезен, чем 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 параметры должны быть в одиночных кавычках и набираться в оболочке или содержаться в shell-скрипте. Они не будут работать в 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

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

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

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

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

Parallelism/Concurrency

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

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

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

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

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

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

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

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

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

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

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

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

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

Книги

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

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

Initial and Final, DSLs, Finally Tagless

Comonads

Yoneda / CoYoneda

Propositions vs. Judgments (computation)

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

Statically linking binaries

Диалоги

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

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