ここも書き換えてください

1つの文で「以下」が連続しているので、こっちはトルでも意味が通じるかな。

上の文章と似た内容だけど微妙に情報が増えて箇条書きになっている。この箇条書きでなにを伝えたいかを直前に文章で書いて欲しい。

以下は〜〜です。 以下に〜〜を示します。

みたいな

例なのでしょうがないけど、自分でファイル名を指定しつつ、拡張子も指定するというコマンドは、オプションの用途としてピンとこないなと思いました。

何か数え方のルールとかを変えられるといいんだけど。文字数でカウントするかバイト数でカウントするか、とか

これも = をトルでいいと思う

キーハード引数を示すときに = って付けるのあんまり見たことないので、トルでいいと思います

nits: 表の文章は最後の。はトルでいいかなぁ

キャプションがない。

以降も同様

ここに中身を入れて、実際に動作させた例がほしい

オプションに値が

とか?

トル

これはコマンドで呼び出すときの話ですよね?ちょっとこの文章だけだと意味が取りにくい

「短縮形」と「長い形」という表現がいまいちだなと

短いオプション名と長いオプション名とか?

表でまとめた方が見やすそう

これはなんか--nameは名前を指定するためだけにしか使われないように読めるので、ちょっと違うかなと。

例えば、名前を指定するための--nameオプション、などです。

とか?

ちょっと意味が分からなかったです。

なんか変。以降もcaptionになってない

が

これもバッククォートで囲む

などのデコレーターを

外部ライブラリ

にしたんじゃないっけか

を作成

argparseについては「<project:#argparse>」を参照してください。

とか入れて欲しい

標準ライブラリの、と書いてあるのでモジュールはトルでよいかと

バッククォートで囲んで欲しい

バッククォートで囲んでほしい

毎回太字にしなくてよいかと。初出の時だけでよいのでは

Python 3.13からサポートされていますが、ここでは3.14のことしか書かない?

https://docs.python.org/ja/3.14/howto/free-threading-python.html

これはどこ情報なのか、が気になりました

完全に分離、とはどういう意味かがわかりにくい。

なにから完全に分離しているのか

表記揺れ: インタープリター

CPU数(長い文章)+4、と書いてあるのでそれがまとまりだとわかりにくいと思います。

(os.process_cpu_count()が返す)実行環境のCPU数+4と32のどちらか

だと読みやすいかな

この表現ちょっとわかりにくいかなと思いました。

buffersizeが指定されると、その数のプロセスやスレッドなどがスケジュールされ、それ以外は待ちとなる、ということですよね。

「未取得結果の最大件数」という表現がわかりにくいなと思いました

インデントがずれている

引数が増えているので確認してください

捕捉

コードを書き換えたのでこのコメントは正しくない

https://docs.python.org/ja/3/library/asyncio-runner.html#asyncio.run

3.12からloop_factory引数が増えてる

インデントが3文字になっている

なにを複数組み込むのか?

ruff checkとruff formatを実施

とか。なにを実施するか書いて欲しい

pre-commitはCIじゃないかなー

各種ツールでruffを使用する方法、とか?

日本語がなんか変です。

で行(おこな)っておくと?

引数無しで

引数無しで

これデフォルト設定だからなー。 クォートをシングルにできるけど、設定なしの運用でいいんじゃない?みたいな記述がいいかなーって思ってます。

カンマを付けたい派

これはストーリーとしては、この前に ruff check --fix を実行していないといけないので、そのように手前で実行している必要がある

使われていないモジュールだとF401が出ちゃうのでisortの意味がない(fixできない)

無理やり使うモジュールを入れましょう

datetimeとかなにかをいれてメッセージに追加する感じで

文章（文章）。

が正しい書き方(のはず)

トル

この手前でfixされたあとのexample.pyを表示して、import osが削除されていることを確認したい

す。

系なくてもいい派です

下の設定例だとpyproject.tomlなので

前述の設定ファイルを用いて、にしてコードのキャプションに「説明 - pyproject.toml」とか書くのはどうでしょうか

checkコマンド

とか

長いので、トルでも通じるかなと

表のタイトルを入れてください。

https://myst-parser.readthedocs.io/en/latest/syntax/tables.html#table-with-captions

と、

ここで、を打たないと「一部のルール」がFにもかかっているように読める。

もしくはE系の一部とF系のルールが

とか

Flake8 (以下同様

Flake8と最初は大文字かなと

https://flake8.pycqa.org/en/latest/

同様にデフォルト設定っぽいものは除外して必要最低限にしてほしい

デフォルト設定を設定例に書いているのが気になります。

デフォルト設定はここにあることを示して、設定ファイルとしては必要最低限の記述例でいいかなと思います https://docs.astral.sh/ruff/configuration/

整形

他の箇所と表現を合わせる

を記述します。

前の文は主体が自分だったので

他のライブラリとかでuvを使ったインストールには触れていないので、ここはなくてもいいかなぁ

ここも両方指定した場合と同じとか、まるっと省略してもいいかも

このへんも2回目以降は省略しちゃってもいいんじゃないかな

いいと思います

や

箇条書きで体言止めと、だであるが混ざっているので、どちらかに統一したい派

ここまでの手順を再実行すると多分この結果は得られないはず。手前で環境作り直すとかした方がいいかも?

依存ライブラリも一緒に削除されているのがポイントかなと

uv lockコマンド

こっちはまだ依存関係という言葉が残っている。タイトルと表現を合わせたい

ここはuv の節なので、「uvで」はなくてもいいかなと思った。他も同様

インストール可能な一覧とインストールされていたらその場所を出力している

インストール可能なPythonの一覧を出力する。が正しいです

List the available Python installations

uv pythonがない

README.mdも説明した方が良いのでは

ディレクトリもあるので「名前」としたい

2回目は冗長なので「ファイル群」とかでよいかと

本書で紹介するuvのコマンド

でいいかな。主なというよりはこの書籍で紹介するものを列挙していると思うので

最新版の0.9.17

addは追加するだけどremoveはアンインストールするなので表現が揃っていない。 追加/削除 or インストール/アンインストールに揃えて欲しい

が

の方がいいかなー

uvx とバッククォートで囲みたい。以下同様

外部パッケージによって提供されるツール

とか?

.pyはつけない派?

PEP 723で提案されたけどPyPA関連はのちのち変わっていくので、仕様としてはこちらを参照するのが適切です。

(PEPドキュメントの先頭にもそう書いてある)

https://packaging.python.org/en/latest/specifications/inline-script-metadata/#inline-script-metadata

外部

この手順よりは、新規にディレクトリ作成、uv init実行した後に、pyproject.toml, uv.lockだけコピーしてuv sync実行するみたいな手順がいいのではと思った。

実際のユースケースに合わせる

uv pip installした場合はuv addと違ってpyproject.tomlとかuv.lockが更新されないということを書いた方がいいかなぁ

名を

pyproject.tomlの設定を見て、今のuv.lockファイルに存在するパッケージのままか新しいバージョンが存在するかを調べる。

みたいな意味合いだと思います。

あと、これってどっちかというと hoge>4.0.0 とかかいていて、hogeの最新バージョンがでているか(pip list -O)みたいな使い方がメインかなと思ったんですが、そうではない?

pyproject.tomlを書き換えたのはここで例として示しているために必要なだけど、本来はpyproject.toml書き換えたらuv syncの方を使うかなと思ったので(uv 素人なのではずしてたらすいません)

uv.lockファイル

トルでもいいかな(あってもいいけど)

uv lock

uv.lockファイル

uv.lockファイル

ハッシュの例はハッシュ値を省略しつつ1行くらいは載せて欲しいかな

てインストールします。 pyproject.tomlにはdevというセクション(?)が追加され~~

みたいな文章がほしい。

このときもpyproject.tomlの中は書き換えられるよ(ですよね?)とか説明があっていいと思う

依存関係というよりも、「さきほど追加したパッケージが」とかいう説明でよいのではないか

pipコマンドと同様に、とかあってもいいかも

PyPIからダウンロードしてインストールされていることとか触れて欲しい。

依存関係を管理するってちょっとイメージしにくいかなと思いました。

プロジェクトで使用するライブラリを管理する、とか?

コマンド実行後

一文が長いので「利用できます。」で一度切ってもいいかも

なにももう一つの方法なのか

仮想環境下のPythonを実行するもう一つの~

とか?

に

の方がいいかな

さっきとは異なるディレクトリに作ったと言うことですかね。手順で mkdir uv-example がないのでちょっと混乱するかも

では

◯◯な場合に仮想環境を再作成します。

みたいな用途にも触れてくれるとうれしいなと思った。

長いし、トルでも意味は通じるかなと

確認するメッセージが表示されます。

コマンドを

で

でよさそう

仮想環境を有効化した場合は、プロンプトにプロジェクト(ディレクトリ名)が表示されることにも言及して欲しい。

venvは作成したvenv名がプロンプトで表示されていたので

ここで段落を変えてもいいかな

typo: いません

手順にlsを入れるといいかなと。 venvの方にはあった

uvで作成する仮想環境は、基本的にvenvで作るやつと同じだよ、みたいな説明がほしいかな

.py は付けない?

Pythonプロジェクト

とか最初は書いておいた方がいいかなと

この手前に全体を俯瞰したいので、uvで提供しているコマンド一覧がほしい。

全部紹介しないなら、そのうち本書ではこれを紹介するよ、とか言ってほしい

これを紹介しているので、あえてバージョン指定してのインストールは教えなくてもいいかなと

これ必要な場合ってありますか?説明しなくてもいいかなと思った

pipはパッケージインストーラーであってマネージャーじゃないかなという意見

https://pip.pypa.io/en/stable/

あー、でもpipの方に「パッケージを管理する」って書いてるのか、じゃあこのままでいいかなぁ

nits: コメントでどういうチェックを有効にしたかかいてあるといいかも

起こり

したりすると

トル

日本語訳も併記して欲しい

これ、紹介しなくてもいいんじゃないかな。使いどころがなさそう

これはよくあるエラーなのか?

よくあるエラーだと上にあるTOMLDecodeErrorが出るから、それを見てちゃんと対処してね、っていう話が適切かなと思いました。

どっちかというと周辺知識よりかなと思いました

浮動小数点数

綴り間違い

とかちゃんと書いておきたい

ちょっと読みにくいかなと思いました。

PEP 680においても、以下の理由によりTOMLの読み込みのみで書き込みには対応しないことと記述してあります。

• ~~標準化が困難
• ~~設計が複雑
• ~~将来的~~安全

ライブラリ

外部ライブラリ

外部のライブラリ

バッククォートでかこんで欲しい

最初にコメントで「# さまざまなデータ型を定義」みたいな文があるといいかなと思いました

のみ

挙げられています。

最後までよんでPEPの話だと思ったので、この文の最初に

PEP 680中ではtomllibを標準ライブラリとする理由として~~~が挙げられています。

みたいに書いた方がいいかなと思いました。

でTOMLフォーマットを標準サポートすることは

とか

パッケージに関する情報を記述するpyproject.tomlの

とか?(ちょっと表現がふわっとしている&省略されているかなと思った

Python 3.11

サポートが連続するので言い換えたい。

プログラミング言語にTOMLファイルに対応したライブラリがあります。

とか

IMO: 真偽値の方が好み

結果が見にくいのでpprintしてほしい派

サンプルコードがちょっとわかりにくいかなと思いました。

基本的には必須で、任意のフィールドがあるときは NotRequired を指定する

逆に、ほとんど任意で一部必須の場合には、total=Falseを指定して、必須のフィールドにのみRequiredを指定する

だと思うので、この2つを分けて説明するのがいいと思います。

リンクがほしい

「本来の引数」というのが何を指しているのかがちょっとわからないなと思いました

TypedDictの方が使うことが多いと思うので、Anyの次でいいかなと思った

nits: まま、が連続するので冗長かな

「引数を維持したまま」で意味は通じそう

nits: 表記揺れ: デコレーター

この文章を5.16のコードの前に持っていく方がいいかなと思いました

リンクを入れて欲しい(脚注にURLが入るはず)

ここ、インデントした方がいいかも?

今後主流になるかは

くらいでいいのでは

以下は冗長なので省略でよさそう

これだと短すぎるので、なんかのリポジトリをまるっと型チェックとかする方がいいかなと思いました

このリンクがわかりにくいので、説明を書いて欲しいかな。

サンドボックスでexample.pyを◯◯した結果

みたいな

nits: 比較する、でいいかなと

VS Codeと書くのが正しいはず https://code.visualstudio.com/

nits: 体言止めと~~するがまざっているのでどっちかに統一がいかな

高速に動作 付ける機能

でよさそう

あとで比較対象にもなっているので、「型チェッカーにはmypy、pyrightなどがありますが、Pyrefryには◯◯な特徴があります」みたいな感じの文章があるといいなと思いました

MUST: 結果が書かれていないので追加する

contextパラメーターも説明を書いて欲しい

ここに追加するなら、from_numberメソッドの説明は文章でもしてほしいかな

このあたりもコメントでどういう数値を作っているか書いて欲しいかな。

ここコメントでfloatの精度によってこうなっちゃうよって説明して欲しい

ここか7.2.1に組み込み関数のroundを紹介して、偶数丸めであることを書いて欲しいかなと思った

https://docs.python.org/ja/3.14/library/functions.html#round

文章の流れが唐突な感じがする。

あります。また、チェック、修正の両方ができるツールにRuffがあります。次節ではRuffについて解説します。

とか?

クラスのことも書くといいのでは

MUST: リンク先のドキュメントが内容が無いです。変わったっぽいのでURLを変えてください

ここからkey関数について追記した

counts引数の説明を追加して欲しい

こっちの方がよく使うので、先にあってもいいかなって思いました

下の図ですが、figureにタイトルを文字列として書いてください。可能なら、顔図としてもヒストグラムの画像そのものを入れて欲しい「図：~~~」の部分の画像が不要

https://pyhack.slack.com/archives/G01CKBZ7J8J/p1762173838549059

「表：」はトルでOK 他も同様

seed関数も表7.6で説明して欲しいな

下の画像に画像タイトルまで含まれているので、タイトルはちゃんと文字として入れて欲しい

https://pyhack.slack.com/archives/G01CKBZ7J8J/p1762173838549059

これなんだ? 脚注かなんかのミスかな

今回uvを追加するのでまるっと削除でもいいかも。

nits: PowerShellだとバックスラッシュの方がいいかも?

nits: PowerShellの方が最近は一般的だから上の方がいいかな

これ、.gitignoreの中が「*」なので、venv以下は全部対象外になる、という説明だけでいいと思います。

以下のgitの手順はなくていいかなと(情報が多くて逆に読みにくい) 以下だけでいいのでは感

$ python3.14 -m venv env $ cat env/.gitignore *

SHOULD: これよく考えたらpipの制限ではなくて、Python側の制限なんじゃないだろうか。

これ、見出しレベルが違うかも?

1.1.0

1.1.0

MUST: 表タイトル入れてください

もうちょっと説明がほしいかな。 ハッシュがあるから改ざんに対応できるとか、さっきの課題にどう対応しているかの説明があるとうれしい。

でもそこまで書くとコラムとして書きすぎかなぁ。

の?

PEP 751だけだとわかりにくいし脚注もリンクだけなので、どういう内容のPEPかを最初に書いて欲しいです。

◯◯に関するPEP 751が、みたいな

数字の箇条書きであることに意味があるのかが気になった。 優先順位とかがないのであれば、数字なしの箇条書きがいいかなと思います

nits 最新版の4.0. でもいいかなと思った

これ、この手順通りにやるとpeppercornはインストール済みなので出力されなそう。ちょっと気になったのでコメントした

コメントになっていない

古いバージョンの話なのでトルでいいかなぁ

これ、見出しを設定して参照にしてください。(章、節番号変わるかもなので)

https://ryu22e-chap6.jissen-recipe2.pages.dev/sample/#id18