Share
Embed
クレートを作ってcrates.ioに公開するまで / How to publishing to crates.io
Fukuoka.rs vol.6 〜LT会〜の登壇資料です。
クレートを作成してcrates.ioに公開して得た知見についてまとめました。
Fukuoka.rs vol.6 〜LT会〜
https://fukuokars.connpass.com/event/151353/
crates.ioにクレートを公開するまで - Qiita
https://qiita.com/tasshi/items/169c372b5230e0bd8b14
fitting - crates.io: Rust Package Registry
https://crates.io/crates/fitting
tasshi
November 08, 2019
Transcript
17 slides
-
3 https://crates.io/crates/fitting 曲線近似ライブラリ(Pure Rust) 現在実装したもの • 正規分布フィッティング • 線形フィッティング •
連立一次方程式のsolve それらしいクレートが 見当たらなかったので書いた Now in development -
4 1. 実装する 2. ドキュメンテーションコメントを書く 3. メタデータを追加する 4. crate.ioのアカウントをセットアップする 5.
クレートを公開する 参考:Publishing a Crate to Crates.io - The Rust Programming Language Recipe -
/// Returns a value of gaussian function. /// /// #
Examples /// Returns a value of gaussian function. /// /// ``` /// use fitting::gaussian::val; /// /// let (mu, sigma, a): (f64, f64, f64) = (5., 3., 1.); /// let x = 5.; /// let y = val(x, mu, sigma, a); /// assert_eq!(y, a); /// /// ``` pub fn val(x: f64, mu: f64, sigma: f64, a: f64) -> f64 { a * (-(x - mu).powi(2) / (2. * sigma.powi(2))).exp() } 6 /// でドキュメント用のコメントを書く ・マークダウンをサポート ・Exampleセクション ❯ cargo test でテスト実行 ・ドキュメントの確認 ❯ cargo doc --open 参考: What is rustdoc? - 2.ドキュメンテーションコメント -
7 The Manifest Format - The Cargo Book name:crates.ioでの名前 名前は早い者勝ち
名前が解放されることもない(たぶん) crates.io: Rust Package Registry Namespacing on Crates.io - Rust Internals license:MIT/Apache2.0が好ましい 参考: Necessities - Rust API Guidelines 3.メタデータを追加する [package] name = "fitting" version = "0.1.0" authors = ["Masaharu TASHIRO <[email protected]>"] edition = "2018" description = "Pure Rust curve fitting library" documentation = "https://docs.rs/fitting/" homepage = "https://crates.io/crates/fitting" repository = "https://github.com/mshrtsr/fitting-rs" readme = "README.md" keywords = ["fitting","statistics","probability","distribution","math"] categories = ["science"] license = "MIT" [badges] maintenance = { status = "actively-developed" } [dependencies] ndarray = { version = "0.13.0", features = ["approx"] } approx = "0.3.2" failure = "0.1.6" -
8 1. https://crates.ioのアカウント作成 2. https://crates.io/me にアクセス 3. API Access Tokenを生成
4. ローカルでターミナルを開く 5. ❯ cargo login <Your Token> 6.crate.ioのアカウントをセットアップする -
11 お好きなCIサービスを使う Travis CIを使っているクレートが多い(目視) 複数環境でビルドするとBetter(Linux, Windows, Mac)(Stable, Nightly, Beta) crates.ioにビルドステータスを表示できるのは以下の
6サービス(2019年11月) Appveyor, CircleCI, Cirrus CI, GitLab, Azure DevOps, TravisCI (GitHub Actionsも対応して欲しい) ex1.CIを設定する -
12 Travis CIの例(.travis.yml) `before_script` で fmt や clippy を行う build,
testは勝手に実行される Building a Rust Project - Travis CI キャッシュを使わないと毎回ビルドが長い Travis CIでのRust cacheとうまく付き合う - Qiita 他のCIでも同じテクニックを使えば良さそう ex1.CIを設定する language: rust rust: - stable - beta - nightly cache: directories: - ${HOME}/.cargo - ${HOME}/.rustup before_cache: - rm -rf /home/travis/.cargo/registry jobs: allow_failures: - rust: nightly fast_finish: true before_script: | cargo fmt --version cargo fmt -- --check cargo clippy --version cargo clippy cargo clean Rustの実行環境を指定 キャッシュの設定 ビルド・テストの前に実行 される処理の指定 -
13 カバレッジサービス Codecov or Coveralls 計測ツール tarpaulin, cargo-kcov, cargo-cov の3つが主流そう
tarpaulin, cargo-cov → Nightly only cargo-kcov → Personalityというシステムコールを使っていて、 Dockerコンテナ内ではこのsyscallは使えない ex2.コードカバレッジを取る -
14 Travis CI + cargo-kcov + codecovの例 kcovをソースからビルドする必要がある 毎回すると長いのでキャッシュする codecovへのアップロードはサンプル通り
https://github.com/codecov/example-rust ex2.コードカバレッジ cache: directories: - ${HOME}/kcov/ env: - PATH=$PATH:${HOME}/kcov/bin before_install: | if [ ! -d "${HOME}/kcov/bin" ]; then echo "Install kcov" && wget https://github.com/SimonKagstrom/kcov/archive/master.tar.gz && tar xzf master.tar.gz && cd kcov-master && mkdir build && cd build && cmake -DCMAKE_INSTALL_PREFIX=${HOME}/kcov .. && make && make install && cd ../.. && rm -rf kcov-master; fi after_success: | cargo kcov --no-clean-rebuild --verbose --all --no-fail-fast \ --output ./target/cov -- --verify --include-path=. --exclude-path=./target \ --exclude-region=kcov-ignore-begin:kcov-ignore-end --exclude-line=kcov-ignore-line && bash <(curl -s https://codecov.io/bash) && echo "Uploaded code coverage" キャッシュの設定 ${HOME}/kcov/bin が存在しない場合のみ kcovのビルドを行う -
15 cargo installはパッケージの更新機能はない(同パッケージの installはエラーになる) リモートのバージョンとローカルのバージョンを比較 →更新するスクリプトを組む 後から知ったけど cargo-update を使うといいらしい ex2.コードカバレッジ
before_install: | if ! type cargo-kcov > /dev/null; then echo "Install cargo-kcov" && cargo install cargo-kcov -f; else echo "Check cargo-kcov is latest" REMOTE_KCOV_VERSION=`cargo search cargo-kcov --limit 1 | sed -e 's/^cargo-kcov = "\(.*\)".*/\1/'` LOCAL_KCOV_VERSION=`cargo-kcov --version | sed -e 's/^cargo-kcov \(.*\).*/\1/'` if [ ! $REMOTE_KCOV_VERSION = $LOCAL_KCOV_VERSION ]; then echo "Upgrade cargo-kcov" && cargo install cargo-kcov -f; fi fi -
16 仕上げにStatus Badgeを設定する README.md Cargo.toml CIの設定ファイルをexcludeする バージョンを上げて再度publicしたら完成 Status Badges [package]
... exclude = ["/.github/*", "./circleci/*", "/.travis.yml"] [badges] circle-ci = { repository = "mshrtsr/fitting-rs", branch = "master" } travis-ci = { repository = "mshrtsr/fitting-rs", branch = "master" } codecov = { repository = "mshrtsr/fitting-rs", branch = "master", service = "github" } # fitting-rs [](https://crates.io/crates/fitting) [](ht tps://docs.rs/fitting) [](https://travis-ci.org/mshrtsr/f itting-rs) [](https://codecov .io/gh/mshrtsr/fitting-rs) Curve fitting library for Rust