インストール / 読み込みを行うもの

“Introduction to pacman” の “Installing, Loading, Unloading, Updating, & Deleting”" で紹介されているものに説明を加えたり絞ったりした．

*_load 系の関数は指定したパッケージが未インストールの場合のみインストールも行う．

他にインストールのみで読み込み不要な場合には p_install や p_install_gh を使う．

その他便利関数10選

• p_boot
  • pacman 自身の導入すら自動化するためのコマンド． if (!require("pacman")) install.packages("pacman"); library(pacman) をクリップボードにコピーしてくれる．ファイルの頭にでも貼っておこう．
• p_citation
  • 論文などに引用したい時の情報を取得． BibTex 用のエントリも返してくれる．
• p_data
  • パッケージが提供するデータセットの一覧をコンソールに表示．
    例: p_data(datasets)
  • data(package = "datasets") と似ているが，こちらは新しいウィンドウを立ち上げる上に，パッケージ名を "" で囲む必要がある．
• p_del
  • パッケージを削除
  • p_delete でもOK
• p_depends
  • パッケージが依存するパッケージを一覧
• p_depends_reverse
  • パッケージに依存するパッケージを一覧
• p_help
  • help(package = dplyr) みたいなのを p_help(dplyr)
• p_info
  • パッケージの情報を取得．
• p_unlock

  • なんらかの事情でパッケージのインストールに失敗し， 00LOCK-package というディレクトリが発生した時に利用する．この種のディレクトリが残っていると，以下のようなエラーメッセージが出て継続的にパッケージのインストールに失敗する．

    ERROR: failed to lock directory ‘/home/atusy/R/x86_64-pc-linux-gnu-library/3.5’ for modifying
    Try removing ‘/home/atusy/R/x86_64-pc-linux-gnu-library/3.5/00LOCK-callr’

• p_vignette
  • パッケージの vignette の目次を Web ブラウザに表示．

pacman でも needs::prioritize したい？

例えば dplyr パッケージを読み込んだ後に MASS パッケージが読み込むと， dplyr::select() のつもりで使ったselect() が MASS::select() だったなんてことがある．

こんな時は

needs::prioritize(dplyr)

すると， select == dplyr::select になる．

pacman パッケージには同様の機能がない．しかし，優先したいパッケージを読み込み直せば良いので以下の要領でいける．

p_unload(dplyr)
p_load(dplyr)

どうしても同じ機能が欲しければ，以下のように関数を定義する．

p_prioritize <- function(...) {
  char <- as.character(match.call(expand.dots = FALSE)[[2]]) # 複数のパッケージを扱う
  suppressMessages(p_unload(char = char)) # 優先したいパッケージをアンロード．ロードされていない時のメッセージは抑制する．
  p_load(char = char) # 優先したいパッケージをロードし直す．
}

dplyr -> MASS の順に読み込むと select 関数は MASS パッケージ由来のものが見える．

p_load(dplyr, MASS)
environment(select)

## <environment: namespace:MASS>

新たに定義した p_prioritize() 関数を利用すると， dplyr::select() を優先させられるようになった．

p_prioritize(dplyr)
environment(select)

## <environment: namespace:dplyr>

猶，上述の実装では先に指定したパッケージほど優先する．

後に指定したパッケージほど優先する方が良い場合は

as.character(match.call(expand.dots = FALSE)[[2]])

の部分を rev() すればいいので，

rev(as.character(match.call(expand.dots = FALSE)[[2]]))

とする．

GitHub 上のパッケージも NSE で指定したい

p_load_gh("rstudio/gt") # ではなく
p_load_gh(rstudio/gt) # がいい

match.call() を使えばできるはず．

(function(...) as.character(match.call(expand.dots = FALSE)[[2]]))(rstudio/gt)

## [1] "rstudio/gt"

CRAN 上のパッケージも GitHub 上のパッケージも同じ関数で指定したい

p_load(dplyr, tidyverse/tidyr)

としたら，

/ がなければ CRAN から，あれば GitHub からインストールすればいいと思う．

多分やらないけど， cran:dplyr とか gh:tidyverse/tidyr みたいに : を使ってレポジトリを指定できるようにしてもいいかもしれない． gl: で GitLab，bb: で BitBucket みたいな．

CRAN 上のパッケージも @ でバージョン指定したい

p_load([email protected])

したら

p_install_version(dplyr, "0.7.0")
p_load(dplyr)

になる，みたいな．

GitHub 上のパッケージも一時的な利用をしたい

p_temp の GitHub 版が欲しい．

上記を合体させたい

p_load([email protected], tidyverse/tidyr, temp = TRUE)

みたいな感じにできたら便利じゃないかな，という妄想．

合体はロマン!!