하스켈 개발환경 (stack + IntelliJ plugin)

#1. 하스켈 컴파일러

가장 많이 쓰이는 하스켈 컴파일러는 GHC(glasgow haskell compiler)이며

콘솔창에서 사용 시 GHCI (GHC 인터프리터)를 이용해서 컴파일러를 사용합니다.

우리는 Stack을 이용해서 설치 할거라 콘솔창에 사용할때는 아래와 같이 실행시키면 됩니다.

>> stack ghci 

---

#2. Stack (하스켈 프로젝트 관리도구)

2015년에 나온 하스켈 프로젝트 관리도구입니다.

하스켈도 다른 언어와 마찬가지로, 기존에는 복잡한 프로젝트의 의존성 관리 (라이브러리나 버전이 꼬이는 것)를 개발자가 직접 해왔는데 stack이 나오게 되며 그 역할을 대신하게 되었습니다.

 

참고로 stack을 설치하면 GHC(하스켈 컴파일러)도 함께 설치됩니다.

* [더보기] 그럼 기존에는 무엇을 사용했나요?

1. 기존에는 Cabel이라는 프로젝트 관리도구를 사용했습니다.

2. 기존에는 하스켈 홈페이지에 들어가서 Haskell Platform ( GHC + Cabal 빌드 도구 + 많이 사용하는 패키지)를 많이 사용했는데 현대의 하스켈 프로젝트는 대부분 stack을 사용하므로, 우리도 stack을 사용하도록 합시다.

 

3. 하스켈의 표준 패키지 저장소는 Hackage, 스택에서 쓰이는 패키지 저장소는 Stackage 라 부릅니다.

Stackage에서는 어떠한 조합으로도 패키지 의존성이 꼬이지 않도록 모아둔 패키지를 제공해줍니다.

여기에 없는, 즉 stack.yaml을 지원하지 않는 오래된 패키지를 사용하고 싶으면 옛날에 쓰던 프로젝트 관리 도구(Cabel)를 사용해서 설치하면 됩니다.

 

4. Stack에 대해 더 궁금하다면 아래 링크를 참고해주세요.

www.sangkon.com/haskell-study-part01/

Haskell 개발 환경

---

#3. 개발환경

개발 환경은 본인이 쓰기 편한 걸 사용하시면 됩니다.

보통 편집기 플러그인으로 쉽게 사용하게 해주는데, 없으면 콘솔창 열고 stack 으로 직접 실행시켜도 됩니다.

이 글에서는 IntelliJ + IntelliJ 하스켈 플러그인 를 기준으로 설명하겠습니다.

참고로 Vscode를 사용할 경우 보통 haskero 플러그인을 사용합니다.

(2020) 어떤 IDE가 하스켈 개발에 최고일까요? 

What is the best IDE setup for developing in Haskell?

* [더보기] IntelliJ 하스켈 플러그인 

github.com/rikvdkleij/intellij-haskell/blob/master/README.md

• Syntax highlighting;
• Error/warning highlighting;
• Haskell Problems View. This tool window displays GHC messages for the currently edited files;
• Find usages of identifiers;
• Resolve references to identifiers;
• Code completion;
• In-place rename identifiers;
• View type info from (selected) expression;
• View quick documentation;
• Structure view;
• Navigate to declaration or identifier powered by Hoogle (called Navigate>Navigation by Hoogle in IntelliJ menu);
• Inspection by HLint;
• Quick fixes for HLint suggestions;
• Show error action to view formatted messages. Useful in case message consists of multiple lines (Ctrl-F10, Meta-F10 on Mac OSX);
• Intention actions to add language extension (depends on compiler error), add top-level type signature (depends on compiler warning);
• Intention action to select which module to import if the identifier is not in scope;
• Default code formatting by ormolu. Alternatively by stylish-Haskell.
• Code completion for project module names, language extensions, and package names in Cabal file;
• Running REPL, tests, and executables via Run Configurations;
• Smart code completion on typed holes (since GHC 8.4);

# 3-1 IntelliJ 설치

무료 커뮤니티 버전을 설치해도 좋고, 대학생이라면 학교 계정을 이용해 무료로 사용 할 수 있습니다.

www.jetbrains.com/idea/download/#section=windows

Download IntelliJ IDEA: The Capable & Ergonomic Java IDE by JetBrains

# 3-2 Stack 설치

스택을 설치하고 설치한 스택을 이용해 필요한 패키지를 다운받아 줍시다.

참고로 stack을 설치하면 GHC(하스켈 컴파일러)도 함께 설치됩니다.

우리는 윈도우10에 설치할거니, 아래 링크에서 Windows 항목을 찾아 64-bit installer를 다운로드 해줍시다.

docs.haskellstack.org/en/stable/install_and_upgrade/

Install/upgrade - The Haskell Tool Stack

참고로 stack의 기본 설치 경로는 다음과 같습니다.

>> C:\Users\[사용자 이름]\AppData\Roaming\local\bin\stack.exe

* 아래 도구들은 IntelliJ-Haskell에서 자동으로 설치해줍니다. 자동 설치가 안됐을 때만 해주세요.

* 설치여부는 Ctrl+Shift+A -> About Haskell Project - Help 에서 확인 가능합니다.

- stack 설치를 완료했다면, 콘솔창(윈도우+R -> cmd 입력)을 열어 개발용 패키지를 추가로 설치해줍시다.

- hindent (하스켈 코드 힌트도구) , stylish-haskell(코드 포맷팅 도구) , hlint (하스켈 lint)

- 참고로 hoogle(하스켈 docs)는 자동으로 설치됩니다.

>> stack install hindent stylish-haskell hlint

* [더보기] 라이브러리 설치 실패,  ~name~:: invalid argument(invalid character)

윈도우에서 발생하는 문자열 관련 오류(UTF-8)입니다.
ex ) commitAndReleaseBuffer: invalid argument (invalid character)

 

stack 설치경로에 한글 디렉토리를 없애주시고

콘솔창에 다음 명령어를 쳐서 문자열 인코딩을 바꾸고 다시 설치해주세요.

chcp 65001

* [더보기] 콘솔창에서 stack 실행이 안된다면

윈도우 인스톨러로 설치했다면 환경변수가 자동으로 설정되어있을건데, stack.exe를 못찾는다면 설치경로로 들어가서 직접 환경변수를 설정해주시면 됩니다. 환경변수가 무엇인지 모르신다면 cd로 직접 stack.exe 위치를 찾아서 실행시켜도 됩니다.

# 3-3 IntelliJ 프로젝트 생성 및 설정

** 프로젝트 디렉토리에 한글이나 띄워쓰기가 포함되어있으면 빌드가 안됩니다.

(~~library 이름~~:: invalid argument (invalid character)), 오류 설명 그대로, 이는 플러그인 오류가 아니라 Stack 자체 오류입니다. 읽을 수 없는 글자가 있어 빌드에 실패했다는 의미니까 당황하지말고 프로젝트 경로에 띄워쓰기나 한글 경로를 없애주세요

 

IntelliJ - Plugins 에 들어가서 아래 2개의 플러그인을 설치해줍시다.

참고로 HaskForce도 하스켈 빌드 플러그인인데, 우리는 Intellij-Haskell을 사용할거라 같이 설치하면 안됩니다.

해당 플러그인을 설치하면 프로젝트 생성 옵션에 'Haskell' 이 생긴다.

그리고 프로젝트 생성을 누르면 SDK 경로를 설정하는데, 우리가 설치한 stack.exe의 경로를 입력해 주면 됩니다.

 

[더보기] 프로젝트 생성 오류 - 인텔리제이 2020 최신버전

( Error adding module to project couldn't create haskell module... )

인텔리제이 최신버전 (2020)에서 주로 나타나는 오류입니다.

IntelliJ 에서 stack을 이용한 기본 프로젝트 폴더구조를 생성하지 못해서 나오는 오류입니다. 

이럴때는 프로젝트를 인텔리제이에서 생성하지말고

 

콘솔창을 열어 stack으로 직접 생성해주고 직접 프로젝트를 Open으로 열어주면 됩니다.

>> stack new 프로젝트이름

으로 직접 프로젝트를 생성 한 후, 해당 프로젝트를 IntelliJ - Open Project으로 열어주면 됩니다.

 

그 다음에 Project SDK를 stack.exe를 찾아서 선택해주면 잘 실행됩니다.

콘솔창을 열어 [ stack new 이름 ] 으로 프로젝트를 생성하고, IntelliJ에 들어와 Open해줍니다.

그 뒤에 Import Project 창이 나오면, 아래에 있는 Haskell Stack을 선택해주고

처음과 똑같이 stack.exe의 위치를 찾아주면 됩니다.

아래와 같이 프로젝트가 생성되면 성공. Main.hs (하스켈 파일의 첫글자는 대문자 필수)는 app 폴더안에 있습니다.

프로젝트가 성공적으로 생성되었다면, 설정에 들어가서 컴파일 환경을 설정해주면 됩니다.

아래의 코드를 Main.hs에 작성하고 실행시켜봅시다.

-- (이 기호는 주석입니다.)
-- stack ghci 로 콘솔창 실행도 가능해요.
-- :: stack ghci
-- :: main

import System.IO
main = putStrLn "Hello, World!"

Edit Configurations을 눌러 하스켈 컴파일러를 설정해줍시다.

+ 기호를 눌러 Haskell Stack Runner를 등록해주면 됩니다. 컴파일러 별명은 본인이 원하는걸로.

[더보기] Run이 작동하지 않음.

아래와 같이 직접 SDK를 설정하고 IntelliJ를 껐다가 새로켜주자.

이렇게 사람 뚜껑열리게 실행이 되지 않는 경우가 있다.

그럴땐 당황하지말고 File - Project Structure에 들어가 +를 눌러 직접 Haskell SDK를 추가해주자 (Stack Runner)

프로그램을 실행시켜 Hello World!를 출력시키면, 성공!

참고로 실행이후에 자동으로 각종 하스켈 라이브러리들과 hoogle (Haskell API search engine) 이 설치될텐데, 이게 용량이 커서 시간이 좀 걸린다.

그냥 IntelliJ를 켜놓고 딴짓하자.

 

# 3-4 IntelliJ 사용시 주의사항

참고로 인텔리제이에서 하스켈을 사용하면 기본설정이 로그가 보이지 않도록 되어있습니다.

우리는 하스켈 개발을 해야하므로, File - Setting- ... 에 들어가서 Haskell log를 보이도록 체크해줍시다.