10.2 새 사용자 지정 R 패키지 만들기

RStudio에는 패키지 생성에 대한 지원이 내장되어 있다. RStudio 메뉴 모음으로 이동한 다음 “File,” “New Project,” “New Directory,” “R Package”를 차례로 선택한다. 그러면 그림 10.1과 같은 대화 상자가 나타난다.

그림 10.1: R 패키지 생성 대화 상자

패키지 이름을 추가하고 패키지를 생성할 디렉토리를 지정할 수 있다. “Create Project(프로젝트 생성)” 버튼을 클릭하여 R 패키지 프로젝트를 생성한다.

가이드로 따를 수있는 템플릿 파일 세트가 폴더에 있다. 키 파일은 “R” 폴더의 “hello.R”이고, “man”폴더의 “DESCRIPTION”과 “hello.Rd”이다. 이하에서 각각에 대해 살펴 보기로 한다.

10.2.1 hello.R

게시하려는 모든 코드는 “hello.R”과 마찬가지로 “R” 폴더에 있어야 한/다. 이 파일은 R 패키지 프로젝트를 생성할 때 열리고 다음과 같은 내용을 볼 수 있다.

# Hello, world!
#
# This is an example function named 'hello'
# which prints 'Hello, world!'.
#
# You can learn more about package authoring with
# RStudio at:
#
# http://r-pkgs.had.co.nz/
#
# Some useful keyboard shortcuts for package
# authoring:
#
# Install Package: 'Cmd + Shift + B'
# Check Package: 'Cmd + Shift + E'
# Test Package: 'Cmd + Shift + T'
hello <- function() {
print("Hello, world!")
}

이것은 매우 간단하지만 R 패키지 구축 프로세스가 어떻게 작동하는지 보여주기에 충분하다. 게시할 기능을 여기에 배치하여 사용 가능하게 할 수 있다. “R” 폴더에 기능 당 하나의 파일을 포함하는 것이 좋다.

10.2.2 설명서

“DESCRIPTION” 파일은 패키지에 대한 메타 데이터를 제공한다. 여기에서 제목, 설명, 버전 그리고 연락처 정보를 문서화한다. 파일을 클릭하여 열고 필드를 R 패키지에 대한 정보로 바꾼다.

Package: life
Type: Package
Title: Shows Life Expectancy Trends Since 1900
Version: 0.1.0
Author: Dae Ho Kim
Maintainer: KIM <mis@mokwon.ac.kr>
Description: Includes datasets and helper functions to help present information on life expectancy rates.
License: None
Encoding: UTF-8
LazyData: true
RoxygenNote: 7.1.1

데모를 따라하기 위해 이를 변경할 필요는 없지만 게시할 준비가되면 이러한 필드에 관련 정보가 포함되어 있는지 확인해야 한다.

10.2.3 hello.Rd

“hello.Rd”는 R 문서 파일이다. 이 파일은 함수에 포함된 문서를 기반으로 자동 생성된다. 아래에서 코드 문서화에 대해 자세히 설명하겠다.

여기에 있는 정보는 “도움말” 창에서 읽은 패키지 설명서에 나타난다. 제목은 또한 RStudio에서 코드 완성의 일부로 표시되므로 코드 줄을 입력 할 때 콘텐츠가 편집기 화면에 바로 표시된다. 이는 팀의 다른 분석가가 필요할 때 바로 컨텍스트를 제공하는 매우 편리한 방법이다. 이 모든 것이 어떻게 작동하는지 볼 수 있도록 R 패키지를 구축해 보기로 한다.