R：自己記述型パッケージでmagrittrパイプ演算子を使用する

データ変換をチェーンするために、自分で作成%>%したmagrittrパッケージで、パッケージに導入されているパイプオペレーターを使用したいと思いdplyrます。ファイルのmagrittrようImportにリストされDESCRIPTIONます。自分のパッケージをロードし、パイプオペレーターを使用する関数をテストした後、次のエラーメッセージが表示されます。

functionname（parameter、：でエラーが発生し、関数 "％>％"が見つかりませんでした

関数のソースコード%>%をmagrittr::%>%に変更しても、パッケージをビルドできなくなるため、効果がありません。

にmagrittrリストされていれば、正しく機能しているはずですDepends。ただし、これはお勧めできません。代わりに、そのままmagrittrにImportsして次の行をに追加しますNAMESPACE。

importFrom(magrittr,"%>%")

ライティングR拡張機能を読むことをお勧めします。あなたの質問はパラグラフ1.1.3と1.5.1でカバーされています。

1つの追加のソリューション- roxygenパッケージを使用します。devtoolsパッケージの一部として実装されています。一度devtoolsインストールされている、呼び出しdevtools::document()あなたを更新しますNAMESPACEあなたのため。また、ドキュメント付きの.Rdファイルを自動ビルドするので便利です。

あなたがする#' @import packagenameすべては、そのパッケージからすべての関数#' @importFrom packagename functionnameをインポートするか、関数をインポートするために、ファイルにフォーマットで特別なコメントを追加することです。これらのコメントはファイルにいくつでも入れることができるので、各ファイルの上部に、または外部関数を必要とする各関数とともに、コメントのセットを含めることができます。

次に、実行するdevtools::document()と、コードを解析してそれらのコメントを探し、適切なNAMESPACEファイルを作成します。簡単です。

パッケージでパイプをサポートする簡単な方法があります。素晴らしいパッケージusethisには機能がありますuse_pipe()。その関数を1回実行すると、すべてが処理されます。これは、use_pipe()関数がusethisドキュメントで説明されている方法です：

パッケージの内部でmagrittrのパイプを使用し、パッケージのユーザー向けに再エクスポートするために必要な設定はありますか？

説明の「インポート」にmagrittrを追加します

必要なroxygenテンプレートを使用してR / utils-pipe.Rを作成します

HadleyのdevtoolsパッケージであるRStudioを使用していてmagrittr、DESCRIPTIONファイルのImportsセクションにリストされていると仮定して%>%、パッケージ関数で機能させるために実行した手順を次に示します。

まず、関数を書きますfoo.R：

#' Convert \code{data.frame} to \code{list}.
#' 
#' @importFrom magrittr %>%
#' @name %>%
#' @rdname pipe
#' @export
#' @param x A \code{data.frame} object.
#' @examples
#' my_result <- foo(iris)
#'
foo <- function(x) {
    x %>%
        as.list()
}

次に、を実行しdevtools::document()ます。

3番目に、を実行しdevtools::load_all()ます。

このようなファイルがR/ディレクトリに作成され、関数は期待どおりに機能するはずです。