해들리 위컴의 R 패키지

책 이미지

eBook 미리보기

책 정보

· 제목 : 해들리 위컴의 R 패키지 (코드를 작성하고, 테스트하고, 문서화하고, 공유하라)
· 분류 : 국내도서 > 컴퓨터/모바일 > 프로그래밍 언어 > 프로그래밍 언어 기타
· ISBN : 9791188621613
· 쪽수 : 232쪽
· 출판일 : 2019-05-30

책 소개

해들리 위컴의 실용적인 패키지 개발 철학에 따라 재사용 가능한 R 함수, 예제 데이터, 그리고 문서를 함께 묶는 방법을 보여준다. 이 과정에서 devtools, roxygen, 그리고 공통적인 개발 업무를 자동화하는 패키지 집합인 testthat을 배우게 된다.

1부 시작하기_1
1장 서론_3
철학 4
시작하기 5
편집 규칙 6
출간 방법 7

2장 패키지 구조_8
패키지 이름 짓기 8
패키지 만들기 10
RStudio 프로젝트 12
패키지란 무엇인가? 15
라이브러리란 무엇인가? 20

2부 패키지 구성요소_23
3장 R 코드_25
R 코드 워크플로 25
사용자 함수 구성하기 26
코드 스타일 27
고수준 코드 32
CRAN 노트 37

4장 패키지 메타데이터_39
의존성: 패키지가 필요로 하는 것은 무엇인가? 40
Title과 Description: 자신이 만든 패키지가 하는 역할은 무엇인가? 44
Author: 저자는 누구인가? 45
라이선스: 패키지를 사용할 수 있는 사람은 누구인가? 47
버전 49
다른 구성요소 50

5장 객체 문서화_52
문서화 워크플로 53
대안적 문서화 워크플로 55
roxygen 주석 56
함수 문서화 59
데이터 세트 문서화 60
패키지 문서화 61
클래스, 제너릭, 그리고 메서드 문서화 61
특수문자 65
반복 작업 65
텍스트 포맷 참조 시트 68

6장 비네트: 길이가 긴 문서_71
비네트 워크플로 72
메타데이터 73
Markdown 74
knitr 78
개발 사이클 81
비네트 작성을 위한 조언 82
CRAN 노트 83
다음에 할 것 84

7장 테스트하기_85
테스트 워크플로 87
테스트 구조 88
익스펙테이션 89
테스트 작성 91
테스트 파일 96
CRAN 노트 96

8장 네임스페이스_97
동기 97
검색 경로 99
네임스페이스 101
워크플로 103
Exports 103
Imports 106
컴파일된 함수 108

9장 외부 데이터_109
내보내진 데이터 110
내부 데이터 112
원시 데이터 112
다른 데이터 113
CRAN 노트 114

10장 컴파일된 코드_115
C++ 116
C 120
컴파일된 코드의 디버깅 128
makefiles 130
다른 언어 131
라이선싱 131
개발 워크플로 132
CRAN과 관련된 문제 132

11장 설치된 파일_134
패키지 인용 135
다른 언어 137

12장 다른 구성요소_138
데모 139

3부 모범 사례_141
13장 Git과 GitHub_143
RStudio, Git, 그리고 GitHub 145
초기 설정 146
로컬 Git 레포지토리 생성 147
변경 사항 확인 149
변경 사항 기록 150
커밋 모범 사례 153
파일 무시 154
실수 되돌리기 155
GitHub와 동기화 157
GitHub 사용의 이점 158
다른 사람과 작업하기 160
이슈 162
브랜치 162
풀 리퀘스트 만들기 164
다른 레포에 풀 리퀘스트 제출하기 166
풀 리퀘스트의 검토와 수락 168
더 알아보기 169

14장 자동화된 검사_171
워크플로 171
검사 173
Travis로 모든 커밋 이후 검사하기 186

15장 패키지 릴리스_189
버전 번호 190
이전 버전과의 호환성 190
제출 과정 193
CRAN 정책 197
중요한 파일 198
릴리스 201
실패한 경우 202
패키지 게시 204
축하한다! 204

찾아보기 206

저자소개

해들리 위컴 (지은이) 정보 더보기

Posit(구 RStudio)의 수석 과학자이며, 2019년 COPSS(Committee of Presidents of Statistical Societies) 회장상을 받은 R 재단의 회원이다. 데이터 과학을 보다 쉽고 빠르고 재미있게 만들기 위한 계산 및 인지 도구를 만들고 있으며, 데이터 과학을 위한 패키지(ggplot2, dplyr, tidyr을 포함한 tidyverse 등)와 원칙에 입각한 소프트웨어 개발을 위한 패키지(roxygen2, testthat, pkgdown)를 개발하였다. 또한 저자, 교육자, 강연자로 활동하며 데이터 과학을 위한 R의 사용을 권장하고 있다. 그의 웹사이트(http://hadley.nz)에서 더 많은 정보를 볼 수 있다.

펼치기

해들리 위컴의 다른 책 >

정우준 (옮긴이) 정보 더보기

대학에서 경영학 박사 과정을 수료하였다. 회계학에 빅데이터와 데이터 과학을 접목하기 위한 노력하고 있으며, R 사용자의 저변 확대를 위해 한국R사용자커뮤니티(R Korea)를 운영하고 있다. 또한, R 시스템 메시지와 R 재단의 공식 문서를 번역하는 R 한글화 팀(R-ihelp)과 자유 소프트웨어 운동을 위한 GNU Korea의 멤버로도 활동하고 있다. 최근에는 오픈 사이언스에 관심을 갖고 W3 재단의 Open Science Community를 개설하여 의장으로서 커뮤니티 활성화를 모색하고 있다.

펼치기

정우준의 다른 책 >

리뷰

현*

★★★★★(10)

([마이리뷰]해들리 위컴의 R 패키지)

자세히

gud*

★★★★★(10)

([마이리뷰]해들리 위컴의 R 패키지)

자세히

책속에서

이 책은 자동화할 수 있는 것은 자동화해야 한다는 패키지 개발에 대한 필자의 철학을 담고 있다. 손으로 하는 작업은 가급적 줄이고 함수로 대체하라. 목표는 패키지 구조에 대한 세세한 사항에 대해 고심하는 것이 아니라 패키지에 필요한 기능이 무엇인지 생각하는 데 더 많은 시간을 할애하는 것이다.

비네트(vignette)는 길이가 긴 패키지 설명서이다. 함수 문서는 필요한 함수의 이름을 알고 있는 경우에는 매우 유용하지만, 그렇지 않으면 쓸모가 없다. 비네트는 책의 장(chapter)이나 학술 논문 같은 것으로, 패키지가 해결하도록 설계된 문제를 설명하고 독자에게 그 해결 방법을 보여준다. 비네트는 유용한 범주로 함수를 구분하고 문제를 해결하기 위해 여러 함수를 조절하는 방법을 보여준다. 비네트는 패키지의 세부 사항을 설명하려는 경우에도 유용하다. 예를 들어, 복잡한 통계 알고리즘을 구현한 경우, 패키지의 사용자가 상황을 이해하고 알고리즘을 올바르게 구현했는지 확인할 수 있도록 모든 세부 정보를 비네트에 기술할 수 있다.

때로는 테스트를 수행하는 것이 불가능하다. 왜냐하면 인터넷에 연결되어 있지 않거나 중요한 파일이 누락되었을 수 있기 때문이다. 불행히도 다른 가능성 있는 이유는 간단한데, 즉, 코드를 작성하는 데 사용하는 머신이 많을수록 모든 테스트를 실행하지 않을 가능성이 커진다는 것이다. 간단히 말해서, 테스트에 실패를 경험하기보다 건너뛰고 싶을 때가 있다. 이를 위해 skip() 함수를 사용할 수 있다. 이 함수는 오류를 내기보다는 단순히 출력에 S를 인쇄한다.