Rustを勉強している。ドキュメンテーションコメントとドキュメンテーションテストをひととおり眺め終わったので、まとめておく。 はじめに Rustでは、ドキュメンテーションコメントという言語標準の手段で、プログラムやライブラリに対する説明をソースコード内に埋め込んで書くことができる。埋め込みドキュメントだと、ソースコードと対応するドキュメントを一体化して管理できるため、どちらか一方だけを変更してしまうという誤りをしにくいことが利点である。 また、ドキュメンテーションテストという仕組みを使うことで、ドキュメント内のコード例をテストできる。コード例の動作確認をすぐに行えるため、ソースコードの更新によりコード例が動作しなくなるという誤りが原則として発生しない。 ドキュメンテーションコメントの例 例えば、std::option::Option の is_some メソッドのドキュメンテーションコメン

先週にRuffを開発しているAstralがuvを発表しました。 astral.sh uvは現在のところはvenv, pip, pip-toolsの基本的な機能を提供していますが、将来は"Cargo for Python"になることを目標にしています。 一見すると乱立しているPythonのパッケージ管理ツールにもう一つ加わったように見えますが、Ryeの開発者のArminとuvの開発チームは連携していて、同時に次のような発表をしています。 uv: Python packaging in Rust Rye Grows With UV | Armin Ronacher's Thoughts and Writings Ryeはもともとより良いパッケージツールがどうあるべきかの実証のために作られていて、中身は既存のツールのツギハギだった Ryeがpip-toolsやvirtualenvの代わりにuvを