47 Matching Annotations
  1. Last 7 days
    1. リテラルパターンの箇所に書きましたが

      nits: どこを指しているのか一瞬わからなかったので、この文をなくしてしまうか、「3.2.2の」とか「前述の」みたいな言葉で補足してあげた方がよいかもと思いました。

    1. コマンドのインストールと実行を自動的に行ってくれます。

      nits: 既存環境を汚さない?というのが気になったので、以下のようなことがわかる文があるとより親切かなと思いました。

      「uvxは現在のプロジェクトから分離された一時的な仮想環境にインストールされる」

  2. Dec 2025
    1. 「今年の残りは: ○ヶ月と○日」と出力するスクリプト

      この辺りは同じファイルを更新している?ので、ファイル名もcaptionに含めると、同いファイルを変更していることが伝わりやすいかなと思いました。 (これ以前のコードも同様に)

    1. 1つ前のASパターンと同じ動作

      nits:「1つ前の」とあったので、一つ前のサンプルみて?となったので、「前述のASパターンの例と」とした方がわかりやすいですかね?大差ないきもしますが;

    1. data["value"]

      dataはこの時点で定義されてないので、そのまま実行するとエラーになります。 NameError: name 'data' is not defined

    2. TypedDictを使用した型チェックの例

      (質問) 実際にtomlファイルは別ファイルで持つことが多いとおもうですが、(そうでもないです?あまりtomlを扱ったことがなくて;)その場合、TypedDictを用いた型チェックはできないという認識であってます?

    3. テーブルの配列

      この「テーブル」と上記の[table]が同じものに感じて、一瞬???となったので、[table]は違う名前に変えた方が混乱がないかもと思いました。(違う意味ですよね?)

    4. sample.toml

      上記のリスト13.20 のcaptionでは、sample1.tomlとなっているので、どちらかで統一した方が良さそうですかね?

  3. Nov 2025
    1. t-sqlで

      リンクがはってあるので、みればわかるのですが、この記事内でも軽くt-sqlやtdomがt-stringに対応しているライブラリであることの説明があるとよいと思いました。

    1. ret = [value async for value in multiplier_async(values)]

      このコードを書き換えるだけだとエラーになってしまったのですが、async for は 必ず async 関数内 で書く必要がありますかね?コードスペニットとしてリスト3.63に変更分だけではなく、コードを載せた方がわかりやすいかなと思いました。

    1. int型にEventCodeという型エイリアスを割り当てる

      割り当てるという表現がちょっと気になったのですが、 とはいえいい表現が思い浮かばないのですが... EventCode は int 型の 型エイリアスという認識であっていれば、 「int型の型エイリアスとして定義する 」とかどうでしょうか?

    2. example_assert_never.py:17: error: Too few arguments for "assert_never" [call-arg]

      手元だと以下のエラーになりました。記載のエラメッセージは引数がたりない?という意味なので、こちらが正しいですかね?

      example_assert_never.py:17: error: Argument 1 to "assert_never" has incompatible type "Literal[Color.BLUE]"; expected "Never" [arg-type] Found 1 error in 1 file (checked 1 source file)

    1. STRING

      自分の手元(uvで3.14)だとoptionの部分が以下のように表示されましたが、違いますかね?

      options: -h, --help show this help message and exit -s, --string STRING string to display -n, --num NUM number of times repeatedly display the string

    1. >>> current_mask = 0o0 # 「umask 000」を実行するとumaskにはこの値が設定される # 「

      の前に空白文字がありそう??

    2. import psutil

      psutilはサードパーティ製のため、インストールしない場合はModuleNotFoundErrorとなりますが、インストール手順の記載はなくてもよいですかね?。サードパーティ製と明記されているので理解はされると思いますし、現時点でこの件に関する問い合わせもないようであれば、このままでも問題ないと思います!が、気になった点としてコメントします。

    3. os.cpu_count()はバージョン3.4で追加されました。

      本書の対象バージョンが3.14とかなり進んでおり、3.4以降に追加された他の機能についても特に明記されていないため、この記述は削除してもいいかなと思いました。

  4. Oct 2025
    1. 複数の属性にまたがる

      少し読みづらかったので、以下みたいにするのどうでしょうか? 「複数の属性にまたがるデータ検証を行いたい場合は、@model_validator デコレータを使用します。」

  5. Sep 2025
    1. グラフ

      awaitグラフ としたほうがわかりやすいですかね? awaitグラフが、どういうものかわからなかったので、ここの文章もちょっとピンときませんでした。最初にこの言葉が出てきた時に、軽く説明があるとよいと思いました。

    2. 追加のデバッグコードをアプリケーションへの組み込み不要

      少し読みづらかったので、 追加のデバッグコードをアプリケーションへ組み込む必要なし とかどうでしょうか?

  6. Aug 2025
    1. データベース

      データベースは何が起動するのでしょうか?デフォルトでついてる感じになりますか?その辺の記載も軽くあるあと嬉しいと思いました。

  7. Jul 2025
    1. (4)のコード

      (4)のコードを書いている理由がよくわからなかったので、def test_api(case, a, b):のcaseにどんな情報が入っているかがわかるとよいと思いました。

  8. May 2025
  9. Apr 2025
    1. Provenance(物の起源)という情報が増えています

      画像からは、なかなか該当箇所を見つけることができなかったので、わかりやすいように枠とかで囲んであげるとよいと思いました。

    1. Flask においては、以下のようにルーティングを設定します。

      FlaskとWerkzeugの設定方法の対比を見せる意味で、同じURLを提示した方がわかりやすいかなと思いました。 下記のFastAPI/- も同様に。

    2. POST 通信

      POST通信という言葉はあまり聞きなれない言葉だったのですが、一般的ですかね? 「POSTリクエスト」という表現の方がよい気がしました。

    3. Web サーバーとして動作することになります。

      「Webサーバーとして動作することになる」?のがよくわからなかったのですが、 「この規格に準拠した Python アプリケーションを作成することで、さまざまな Web サーバー上で動作させることが可能になります。」ということですかね?

    4. ツールキット化されたものを使っていません

      ツールキット化されたもの? と一瞬思ったので、「ツールキットを使っていません」でもいいような気がしました。

  10. Mar 2025
    1. マルチプロセスによる並列化や、C拡張を使った実装な

      これが回避策であることが明確に伝わる様に、「マルチプロセスによる並列化や、C拡張を使った実装を行う必要がある」という表現にしても良いかもと思いまいた。

  11. Jan 2025
    1. 表示されます。

      この文と次の文のつながりがよくわからず読みづらかったため、 「〜表示されます。そのため、内容を確認したい〜」

      と「そのため」みたにな接続詞があるとよいかなと思いました。

  12. Nov 2024
    1. Rebecca Chen

      上の3人は〜の著者とあるので、こちらもpytypeの何をした方なのかわかるような記載があるとよいと思いました。

  13. Oct 2024
    1. 内部で表示形式を自動に選択され、相応の

      内部で表示形式「が」自動「で」選択され、

      という助詞の方がわかりやすいですかね? あと、「相応の表示」というのがわかりにくかったので、takanory さんのコメントに + 1です。

    2. Deplyボタンをクリック

      「Advanced settings」でPythonのバージョンが選択できることにも簡単に記載があるとよいと思いました。

    3. st.write()

      「st.write()で」の部分から前の文章とのつながりがよくわからなかったので、

      この段落自体の先頭に「一方で」を加えて話を切り替えるとかどうでしょうか?

      「一方でStreamlitには、DataFrameを表示する st.dataframe() や 画像を表示する st.image() といった専用の機能が存在します。専用の機能には、表示する大きさなどの引数があります。専用の機能を用いることで、表示をより細かく制御することができます」