Summary
この記事では、初めてCRANにパッケージを公開するための具体的なステップや留意点について詳しく探求しています。また、日本語圏特有の課題を乗り越える方法にも触れています。私自身、このプロセスで多くの学びがありましたので、その経験も交えて紹介したいと思います。 Key Points:
- CRANパッケージ公開における日本語特有の障壁を克服するためには、情報共有と実践的なガイドラインが必要です。
- {usethis}や{testthat}などのツールを日本語環境で活用できるよう、日本語ドキュメントとエラーハンドリングの解説が重要です。
- CI/CDパイプラインを整備し、自動テストを徹底することで、開発効率と品質向上が期待でき、心理的ハードルも低くなります。
CRANにパッケージを載せる話、何年も前からgithubで放置してたruncharterが最近やっと申請通った。テストカバレッジはほぼ全部、NHSRplotthedotsは満点に近いぐらいだけど、他の大きめなパッケージでも三割くらいしかないものも見かけたことある。github actionsは数種類のOSや開発版Rで自動チェックしてくれるから、ローカルだけより確実っぽい。usethisでセットアップ簡単だった気がする。DESCRIPTIONファイルのタイトル、タイトルケースじゃないとダメだった記憶があるし、説明文も一行だけだと落ちやすかったかも。URLの最後にスラッシュ忘れて失敗したことあったような…urlcheckerっていうパッケージが役立つ。pkgdownでサイト作るのはオプションみたいだけど便利ではある。この辺り細かいところで引っかかる人多そう。他にも小ネタとかはGitHubにまとめておいた気がするけど、時間経って情報古くなってる可能性あり。
本段の原文をご参照ください: https://www.johnmackintosh.net/blog/2021-11-23-cran-success/
CRANにパッケージを公開する際、日本の開発者コミュニティでは、いくつかの独特な障壁に直面するかもしれません。技術的な細かさや文書の完璧さを求める文化的な背景から、些細な形式的要件に対してかなり慎重になる傾向があります。例えば、パッケージのドキュメンテーションや説明文の品質に対する厳しい基準、コードの可読性や一貫性への高い期待など、形式面での要求が非常に厳しいです。また、日本語特有の曖昧さや、英語と日本語間の翻訳の難しさも、国際的なオープンソースコミュニティへの参加を躊躇させる要因になり得るでしょう。
)
Reference Articles
今更ながら自分でRパッケージを作ってみた（RStan連携も ...
... するためのroxygenコメントのガワが追記されます。適宜資料を参考 ... Step by step guide for creating a package that depends on RStan.
Source: 渋谷駅前で働くデータサイエンティストのブログR によるテキスト分析入門
CRAN からパッ. ケージをインストールするには次のコードを実行する。 install.packages("tidyverse", dependencies = T). この例では tidyverse という名前のパッケージ ...
Source: J-Stage
ALL
プログラミング言語
Related Discussions