[R] R Style Guide by Hadley Wickham - 0. Welcome

해당 포스트는 Hadley Wickham이 작성한 'The tidyverse style guide' 를 번역하여 정리한 글입니다.


Lists
Intro - 0. Welcome
Analysis - 1. Files
Analysis - 2. Syntax (1)
Analysis - 2. Syntax (2)
Analysis - 3. Functions
Analysis - 4. Pipes
Analysis - 5. ggplot2
Packages - 6. Files
Packages - 7. Documentation
Packages - 8. Tests
Packages - 9. Error messages
Packages - 10. News
Packages - 11. Git/GitHub


tidyverse

tidyverse는 효율적인 R분석을 위하여 다양한 패키지들을 모아놓은

패키지 모음이자 하나의 생태계

라고 볼 수 있습니다. 최근 tidyverse에서 제공하는 다양한 패키지들은 R분석에 필수 요소들이 되었으며, 이 패키지들을 효율적으로 쓰기 위한 다양한 시도들이 공유되고 있습니다.

지금부터 소개드릴 내용은 tidyverse 개발자인 '해들리 위컴'이 직접 작성한 'R Style Guide'로 tidyverse 기반의 보다 효과적인 R 코딩 방법들을 제시합니다.

Welcome by Hadley Wickham

좋은 코딩 스타일은 올바른 문장 부호와 같습니다. 스타일 가이드 없이 코드 관리를 할 수 있지만, 가이드가 적용된다면 더욱 쉽게 읽을 수 있습니다.

이제부터 소개드리는 내용은 tidyverse 에서 사용되는 스타일을 설명합니다. tidyverse 스타일 가이드는 Google의 'Original R Style Guide' 에서 파생되었지만, 현재 Google에서 제공하고 있는 R Style Guidetidyverse 스타일 가이드에서 파생되었습니다.

모든 스타일 가이드는 기본적으로 다양한 의견들이 나타납니다. 일부 가이드는 코드 사용을 쉽게 만들어 주지만(특히 프로그래밍 구조와 들여쓰기) 대부분 가이드들은 임의적일 수 있습니다.

스타일 가이드의 가장 중요한 점은 일관성을 제공하여 사용자의 의사결정을 줄이고 코드를 쉽게 작성할 수 있도록 도와주는 것입니다.

아래 2개의 R 패키지가 tidyverse 스타일 가이드를 지원하고 있습니다.

  • styler 패키지 : styler를 사용하면 선택한 텍스트, 파일 또는 전체 프로젝트를 대화식으로 다시 스타일 지정할 수 있습니다. R Studio add-in을 활용해 기존 코드를 쉽게 re-style 할 수 있습니다.

▲ R Studio의 Add-in 예시

  • lintr 패키지 : lintr은 자동 체크 로직을 이용하여 스타일 가이드를 준수하는지 확인할 수 있습니다.

▲ R Studio의 Markers 출력 예시

출처

[1] The tidyverse style guide
[2] styler
[3] lintr

the-tidyverse-style-guide-by-Hadley-Wickham.pdf
165.9 kB

▲ The tidyverse style gudie 원문 다운받기