3つ目で言語の地図ができる — Pythonを触る

Pythonを触る。コード画面と三つの言語の書類、比較用の時計。

3つ目の言語に触ると、言語の性質と一般的な考え方の区別がはっきりします。OSのPythonを直接触らない理由も、ここで押さえます。

前回: gRPCはcurlで叩けない — 関数を呼ぶようにAPIを呼ぶ 作業場所はVMの中(Ubuntu)です。Node.jsでHTTPサーバーを書く|サーバーが待ち続ける仕組みの ~/server/ と、Goで同じAPIを書く|Node.jsとの違いと単一実行ファイルの ~/go-server/ を、隣に置いて見比べます。

Goの回で、こう書きました。

1つしか知らないと、「言語の性質」と「プログラミング一般」の区別が付かない。

あれは正しかったのですが、半分でした。

2つ触ると、確かに線は引けます。 JavaScript と Go で違っていたところが「言語の性質」、同じだったところが「サーバーというものの性質」でした。

ただ、2つでは「地図」になりません。 なぜなら、こう思い込むからです。

世界には「Node.js みたいな言語」と「Go みたいな言語」があるのだな。 つまり、コンパイルしないで型を書かない側か、コンパイルして型を書く側か、2つに分かれているのだな。

分かれていません。 これは、たまたま2点を結んだだけの直線です。

点が2つなら、必ず直線が引けてしまいます。 それが本当に線なのか、実は面なのかは、3点目を置くまで分かりません。

そして Python は、その3点目として、かなり意地の悪い場所に立っています。

コンパイルするか型を書くか
Node.jsしない書かない
Goする書く
Pythonしない書かない。ただし、書ける

Node.js 寄りに見えて、Go 側の性質も持っています。 つまり 「2つに分かれている」という思い込みが、ここで壊れます。

この記事は Python の入門ではありません。 やることはGoの回とまったく同じです。

すでに動いているものと、まったく同じものを、3つ目の言語でもう一度書く。

そして今回は、もう1つだけ足します。

3つの言語で同じ計算を回して、実行時間を測る。

「Python は遅い」は、たぶん聞いたことがあると思います。 それを人から聞いた話ではなく、自分のVMで出た秒数として持つのが、この記事の山場です。

そのうえで、「遅い=駄目」ではない理由まで書きます。そこまで行かないと、ただの悪口になります。

対象レベル: 初級〜中級 / 区分: 必修

目次

この記事でわかること

  • 言語は2種類ではないこと。2つ目までは直線、3つ目で面になる。Python は Node.js と Go のどちらの側にも綺麗に入らない
  • Ubuntu 自身が Python で動いていること。だから sudo pip install はOSを壊す。Ubuntu 24.04 はそれをエラーで止めてくれる(止めてくれることが正常)
  • インデントが飾りではなく文法であること。ズレると動作が変わる、ではなくエラーになる
  • 型は書かなくていいが、書けること。ただし Python の型ヒントは実行時に何も検査しない(TypeScriptと同じ立場)
  • 同じループが Go の数十倍遅いこと。そして sum(range(...)) にすると急に速くなること。遅いのは Python のループであって、Python の全部ではない
  • 「遅い」が問題になるかどうかは、何に時間を使っているかで決まること。動く時間より、書く時間のほうが高くつく場面がある
  • 9つの言語を4象限に置いた地図。そして 「次に何を学ぶか」は、作りたいもので決まること

この記事でやること

  1. Ubuntu に最初から入っている python3 を確認し、sudo pip install をわざと踏んで、止められる
  2. venv を作る(ここから先は全部その中でやります)
  3. サーバーとは何かの回と同じサーバーを、標準ライブラリだけで書く。Node.js版・Go版と3列で並べる
  4. 同じ計算ループを3つの言語で書いて、実行時間を測る
  5. FastAPI で /api/tasks を返し、3つのポートから同じJSONが返ることを確かめる
  6. 9つの言語を4象限に置いて、地図を作る

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
インタプリタソースコードを上から1行ずつ読んで、その場で実行していくプログラム。python3 も node もこれです。Goの回のコンパイルとは逆の考え方です。
pipPython のライブラリを入れる道具。npm の回の npm にあたる位置です。
venv(仮想環境)そのプロジェクト専用の、Python とライブラリの置き場をフォルダとして作る仕組み。中で pip install しても、OS側には1ファイルも入りません。
型ヒントPython で def f(x: int) -> str: のように型を書いておける注釈。書いても書かなくても動きます。
PEP 8Python の書き方の公式な取り決め(インデントは半角スペース4つ、など)。ESLintとPrettierの回で決めていたことが、最初から文書になっています。
FastAPIPython でAPIを書くためのライブラリ。型ヒントを実際に使うのが特徴で、APIの回の Express にあたる位置です。
ASGI / uvicornFastAPI が書いたアプリを、実際にポートを掴んで動かす担当。FastAPI 単体ではポートを掴みません。

① Ubuntu の Python は、OSの部品です

まず、入っていることを確認します。入れません。

bash
$ python3 --version
$ which python3
Python 3.12.3
/usr/bin/python3

Goの回では、公式サイトから tar.gz を落として自分で入れました。Python は、その作業がありません。 最初から入っています。

そして、ここが今日いちばん危険なところです。

その python3 は、あなたのためのものではありません。Ubuntu のためのものです。

確かめられます。

bash
$ head -1 /usr/bin/add-apt-repository
$ head -1 /usr/bin/ubuntu-advantage
#!/usr/bin/python3

apt の回で使った add-apt-repository は、Python のスクリプトです。 Linuxの基本コマンドの回で見た #! の行が、/usr/bin/python3 を指しています。

つまり、こうです。

/usr/bin/python3 とそのライブラリを壊すと、Ubuntu の管理ツールが動かなくなります。

node を壊しても、Ubuntu は何も困りません。 npm の回で nvm を使ってホームディレクトリの下に入れたので、OSとは完全に分かれています。Python は違います。

sudo pip install をわざと踏む

多くの入門記事に、こう書いてあります。

sudo pip install なにか

打たないでください。 ただし、Ubuntu 24.04 なら打っても止まるので、何が起きるかだけ見ます。

bash
$ sudo apt install -y python3-pip
$ pip install requests
error: externally-managed-environment

× This environment is externally managed
╰─> To install Python packages system-wide, try apt install
    python3-xyz, where xyz is the package you want to install.

    If you wish to install a non-Debian-packaged Python package,
    create a virtual environment using python3 -m venv path/to/venv.

エラーです。そして、これは正常な動作です。

言っていること意味
externally managedこの Python は外部(apt)が管理している。 pip が勝手に触る場所ではない
try apt install python3-xyzOSに必要なものなら、apt で入れなさい
create a virtual environment自分のプログラムのためなら、venv を作りなさい

[スクリーンショット: 01_pip_externally_managed.png] VMのターミナルで pip install requests を実行し、error: externally-managed-environment が出ている画面を撮ってください。

このエラーには --break-system-packages という回避策があります。使わないでください。 オプションの名前が、そのまま「システムのパッケージを壊す」と言っています。 冗談ではなく、壊れたときの症状は「apt が動かない」です。OSの入れ直しになります。

昔の Ubuntu には、この停止装置がありませんでした。 だから「sudo pip install で入れた」という古い記事が大量に残っています。そのとおりに打って壊した人がいたから、この装置が付きました。

venv を作る

エラーが指示したとおりにします。

bash
$ sudo apt install -y python3-venv
$ mkdir -p ~/py-server
$ cd ~/py-server
$ python3 -m venv .venv
$ ls .venv
bin  include  lib  lib64  pyvenv.cfg

~/py-server/.venv/ の下に、このプロジェクト専用の Python 一式ができました。

「入る」のはここからです。

bash
$ source .venv/bin/activate

プロンプトの先頭が変わります。

(.venv) user@ubuntu:~/py-server$

(.venv) が付いていたら、中にいます。 確かめます。

bash
$ which python
$ which pip
/home/user/py-server/.venv/bin/python
/home/user/py-server/.venv/bin/pip

/usr/bin/python3 ではなくなりました。 この状態で pip install しても、入るのは ~/py-server/.venv/ の中だけです。

コマンド何をしているか
python3 -m venv .venv.venv という名前でフォルダを作る(-m は「このモジュールを実行して」)
source .venv/bin/activateいま開いているシェルの PATH の先頭に .venv/bin を差し込む。 Goの回で ~/.profile に足したのと、やっていることは同じです
deactivate出る。 PATH が元に戻ります

.venv は node_modules と同じ扱いでいいと考えてください。npm の回で「node_modules は消してよい」と書いたのと同じで、.venv も消して作り直せます。 Git に上げるものでもありません。

違うのは、.venv の中には Python 本体(へのリンク)ごと入っていることです。node_modules はライブラリだけでした。Python はライブラリだけを分離できないので、実行環境ごと複製します。

ターミナルを開き直したら、毎回これを打ちます。

bash
$ cd ~/py-server
$ source .venv/bin/activate

忘れると、そのまま /usr/bin/python3 を触ります。 この記事の残りは、全部 (.venv) が付いた状態で打ってください。

② 同じサーバーを、Python で書く

比較対象を2つ、先に出します。

サーバーとは何かの回の Node.js:

const http = require("node:http");

const server = http.createServer((req, res) => {
  console.log(`${req.method} ${req.url}`);

  res.writeHead(200, { "Content-Type": "text/html; charset=UTF-8" });
  res.end("<h1>Node.js が返しています</h1>");
});

server.listen(3000, "0.0.0.0", () => {
  console.log("http://0.0.0.0:3000/ で待っています");
});

Goの回の Go:

func main() {
	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		log.Printf("%s %s", r.Method, r.URL.Path)

		w.Header().Set("Content-Type", "text/html; charset=UTF-8")
		fmt.Fprint(w, "<h1>Go が返しています</h1>")
	})

	log.Println("http://0.0.0.0:8080/ で待っています")
	log.Fatal(http.ListenAndServe("0.0.0.0:8080", nil))
}

Python で書きます。

bash
$ cd ~/py-server
$ nano server.py
from http.server import BaseHTTPRequestHandler, HTTPServer


class Handler(BaseHTTPRequestHandler):
    def do_GET(self):
        print(f"{self.command} {self.path}")

        self.send_response(200)
        self.send_header("Content-Type", "text/html; charset=UTF-8")
        self.end_headers()
        self.wfile.write("<h1>Python が返しています</h1>".encode("utf-8"))


server = HTTPServer(("0.0.0.0", 8000), Handler)
print("http://0.0.0.0:8000/ で待っています")
server.serve_forever()

Python は未習の前提なので、1行ずつ説明します。

行何をしているか
from http.server import ...標準ライブラリから2つ取り込む。 require / import にあたります。pip install は不要(最初から入っています)
class Handler(BaseHTTPRequestHandler):「リクエストが来たときの担当」を、既存の部品を土台にして作る。 (...) の中が土台です
def do_GET(self):GET が来たときに呼ばれるメソッド。 名前が do_GET であること自体が仕様で、土台がこの名前を探しに来ます
selfその担当自身。 JavaScript の this にあたりますが、Python は引数として自分で書きます
print(f"...")console.log にあたります。f"..." は文字列の中に {} で値を埋められる書き方(テンプレートリテラルと同じ)
self.send_response(200)ステータス行を書く
self.send_header(...) / self.end_headers()ヘッダーを1つずつ書いて、最後に「終わり」を書く。 res.writeHead が1回でやっていたことを、2段階に分けています
self.wfile.write(...)本文を書き込む。 res.end / fmt.Fprint(w, ...) にあたります
.encode("utf-8")文字列をバイト列に変換する。 ここは省略できません(後述)
HTTPServer(("0.0.0.0", 8000), Handler)ポートを掴む担当を作る。 ("0.0.0.0", 8000) の二重カッコはタプル(2つ組)です
server.serve_forever()待つ。 listen / ListenAndServe にあたります

動かします。

bash
$ python3 server.py
http://0.0.0.0:8000/ で待っています

8000番を開けます。別のターミナルで:

bash
$ sudo ufw allow 8000/tcp
$ sudo ufw status

ホストのブラウザで http://192.168.226.50:8000/ を開いてください(IPは自分のVMの値に。VMの中で ip a)。

「Python が返しています」と出ます。

3列に並べる

ここが、この記事の中心です。

やることNode.jsGoPython
① ポートを掴むserver.listen(3000, "0.0.0.0")http.ListenAndServe("0.0.0.0:8080", nil)HTTPServer(("0.0.0.0", 8000), Handler)
② 待つlisten 後、終了しないListenAndServe から戻らないserver.serve_forever()
③ 受けるcreateServer((req, res) => ...)http.HandleFunc("/", func(w, r) ...)class Handler の do_GET
④ 返すres.writeHead / res.endw.Header().Set / fmt.Fprintsend_response / send_header / wfile.write
ライブラリの追加不要(node:http)不要(net/http)不要(http.server)
同時に来た要求1本の流れで回すリクエストごとに goroutine1本ずつ、順番に(標準の HTTPServer は同時に1つ)

書き方は3つとも全部違います。そして、左端の列は1つも変わっていません。

Goの回で「掴む・待つ・受ける・返す は言語が変わっても同じ」と書きました。 3つ目でも同じでした。 2点なら偶然かもしれませんが、3点そろうと、これは偶然ではないと言えます。 これが「3つ目を触る」の一番の収穫です。

[スクリーンショット: 02_3つのサーバーが同時に動く.png] VMのターミナルを3つ並べ、3000番(Node.js)・8080番(Go)・8000番(Python)が同時に待っている画面を撮ってください。

Goの回を後片づけして Go を消した人は、Go の列を飛ばして構いません。 Node.js と Python の2つでも、この記事は成立します。

③ 驚いた順に、違いを並べる

1. インデントが、文法です

これが一番驚きます。 さっきの server.py の def do_GET(self): の中身を、わざと1段戻します。

class Handler(BaseHTTPRequestHandler):
    def do_GET(self):
    print(f"{self.command} {self.path}")
bash
$ python3 server.py
  File "/home/user/py-server/server.py", line 6
    print(f"{self.command} {self.path}")
    ^
IndentationError: expected an indented block after function definition on line 5

動きません。 IndentationError という名前のエラーが、言語そのものから返ってきます。

JavaScript や Go では、こう書けます。

function f() {
console.log("これでも動く");
}

動きます。 { と } が範囲を決めていて、インデントは人間のための飾りだからです。だからESLintとPrettierの回で、「見た目を後から機械に揃えさせる」という作業が必要でした。

Python には { } がありません。 段の深さが、そのまま範囲です。

範囲を決めているものインデントを間違えたら
JavaScript{ }動く。 読みにくいだけ
Go{ }動く。 ただし gofmt が勝手に直す
Pythonインデントそのもの動かない。 または別の意味になる

「別の意味になる」のほうが怖いです。

for t in tasks:
    print(t)
    print("ループが終わりました")

この print("ループが終わりました") は、ループの中です。1段戻せば外になります。どちらも文法として正しいので、エラーは出ません。 出力の回数だけが変わります。

タブと半角スペースを混ぜると、見た目が同じでも別の深さとして扱われ、Python 3 では多くの場合 TabError で止まります。PEP 8 は「半角スペース4つ」と決めています。エディタの設定をそれに合わせてください。

戻して、動くことを確認してください。

2. 型は、書かなくていい。でも書ける

server.py のどこにも型は出てきません。 Goの回の func(w http.ResponseWriter, r *http.Request) とは対照的です。

でも、書けます。

def add(a: int, b: int) -> str:
    return a + b
bash
$ python3 -c "
  def add(a: int, b: int) -> str:
      return a + b
  print(add('あ', 'い'))
  "
あい

int と書いてあるのに文字列を渡して、str を返すと書いてあるのに文字列を足しています。 何のエラーも出ません。

Python の型ヒントは、実行時に一切検査されません。 ただのメモです。

これは、どこかで見た形です。

型を書くと、いつ守られるか
TypeScripttsc が検査する。 実行時には型が消える(TypeScriptの回)
Python の型ヒント標準では、誰も検査しない。 mypy などの別の道具を入れて初めて検査される
Goコンパイラが検査する。 通らなければ実行ファイルができない

TypeScriptの回で「型は実行時には消える」と書きました。 Python の型ヒントは、そもそも最初から効いていません。

では無意味かというと、そうではありません。 エディタが読みます。 VS Code は型ヒントを見て補完を出し、間違いに下線を引きます(VS Code Remote の回の環境でそのまま効きます)。 そして、後で出てくる FastAPI は、この型ヒントを実際に使います。 「ただのメモ」を道具側が読んで意味を持たせる、という作りです。

3. 動くのが遅い

ここは節を分けます。次の章です。

4. ライブラリの層が、異様に厚い

server.py は標準ライブラリだけで書けました。それ自体は Go も同じです。

違うのは、その先です。

bash
$ python3 -c "import json, csv, sqlite3, hashlib, statistics, zipfile, datetime; print('全部、最初から入っています')"
全部、最初から入っています
何をしたいかNode.jsPython
JSONを読む標準標準(json)
CSVを読むライブラリを入れる標準(csv)
SQLiteを触るライブラリを入れる(Node.js 22.13 以降は標準の node:sqlite もある。まだ安定版ではない)標準(sqlite3)。データベースの選び方の回で触ったものが最初から使えます
ZIPを展開するライブラリを入れる標準(zipfile)
平均・中央値を出す自分で書く標準(statistics)

Python には「電池付き(batteries included)」という言い方があります。 標準ライブラリだけで、かなりの仕事が終わるという意味です。

これは思想の違いです。 npm の回で node_modules が数百MBになったのを見ました。 JavaScript は小さい部品を大量に積む文化です。入れ替えやすい代わりに、依存が増えます。 Python は、逆側に寄っています。 標準に厚く入れて、外部ライブラリの数を減らす方向です。

どちらが良いという話ではありません。 ただし、パッケージ管理の回で見た「依存が深いほど壊れやすい」は、Python では起きにくいとは言えます。

④ 3つの言語で、同じ計算を測る

ここまで見た違いは「書き方」でした。ここからは「動いた結果」です。

5000万回の足し算を、3つの言語でやらせます。

bash
$ mkdir -p ~/bench
$ cd ~/bench

Python

bash
$ nano bench.py
import time

start = time.perf_counter()

total = 0
for i in range(50_000_000):
    total += i

elapsed = time.perf_counter() - start
print(total, f"{elapsed:.3f} 秒")
部分意味
time.perf_counter()計測用の時計を読む。 差を取ると経過秒数になります
50_000_000_ は桁区切り。 読みやすくするためだけのもので、値は 5000万 です(JavaScript も同じ書き方ができます)
range(n)0 から n-1 までを順に出すもの
f"{elapsed:.3f}"小数点以下3桁にして埋め込む

Node.js

bash
$ nano bench.js
const start = process.hrtime.bigint();

let total = 0;
for (let i = 0; i < 50_000_000; i++) {
  total += i;
}

const elapsed = Number(process.hrtime.bigint() - start) / 1e9;
console.log(total, elapsed.toFixed(3) + " 秒");

Go

bash
$ go mod init bench
$ nano bench.go
package main

import (
	"fmt"
	"time"
)

func main() {
	start := time.Now()

	total := 0
	for i := 0; i < 50000000; i++ {
		total += i
	}

	fmt.Println(total, time.Since(start))
}

Go を消した人は、ここは飛ばして構いません。 Node.js と Python の2つだけでも、差は十分に見えます。

走らせる

bash
$ cd ~/bench
$ python3 bench.py
$ node bench.js
$ go build -o bench-go bench.go
$ ./bench-go

この記事の実機(VMに2コア割り当て)ではこうなりました。

1249999975000000 3.412 秒
1249999975000000 0.052 秒
1249999975000000 22.9075ms

数字は環境で変わります。比べるのは「桁」です。

言語経過時間Go を 1 としたとき
Go約 0.023 秒1
Node.js約 0.052 秒約 2
Python約 3.4 秒約 150

[スクリーンショット: 03_3言語の実行時間.png] VMのターミナルで python3 bench.py / node bench.js / ./bench-go を続けて実行し、3つの秒数が縦に並んでいる画面を撮ってください。

まず、答えの 1249999975000000 が3つとも同じであることを見てください。やっている計算は、完全に同じです。

なぜこの差が出るのか

何が起きているか
Go先に機械語にしてある。 ループは、CPUがそのまま回している
Node.js最初は1行ずつ読むが、同じ場所を何度も通ると、その部分を機械語に変換して差し替える(JIT と呼びます)。だからループは途中から速くなります
Python標準の python3 は、それをしません。 5000万回とも、1回ずつ「次は何をする命令か」を読み直しています

さらに、Python では total += i の i も total も、ただの数字ではありません。 型や参照数などを持った箱です。足し算1回ごとに、その箱を開けて、中身を足して、新しい箱を作っています。

「Python が遅い」の正体は、だいたいこれです。

ただし、これは Python の全部ではない

同じ答えを、書き方を変えて出します。

bash
$ python3 -c "
  import time
  start = time.perf_counter()
  total = sum(range(50_000_000))
  print(total, f'{time.perf_counter() - start:.3f} 秒')
  "
1249999975000000 0.941 秒

3.4秒が 0.9秒になりました。 書いた行は短くなっています。

なぜか。

sum() と range() の中身は、Python ではありません。C言語で書かれて、コンパイル済みです。 ループを Python で回すのをやめて、「5000万回足して」と一言で C に投げたからです。

これが、Python という言語の設計そのものです。

層何語で書かれているか速さ
あなたが書く部分Python遅い
標準ライブラリ・数値計算ライブラリの中身C速い

「Python は遅い」は正しく、「Python で書いた処理は必ず遅い」は間違いです。 重い部分を、いかに自分で書かないかが Python の書き方になります。

「遅い=駄目」ではない理由

ここが、この記事で一番言いたいところです。

さっきの表を、別の軸で書き直します。

書くのにかかった時間動くのにかかった時間
Python6行3.4 秒
Node.js8行0.05 秒
Go15行(package / import / func main が要る)0.02 秒

このプログラムを1回しか動かさないなら、どれが一番安いでしょうか。

書く時間が9行ぶん少ないほうです。 3.4秒は、そのぶんを取り返せません。

極端な例に見えるかもしれませんが、実務ではこちらのほうが多いです。

場面効いてくるのは
1日1回動く集計スクリプト書く時間。 実行が3秒でも30秒でも、誰も困らない
1回きりのデータ整形書く時間。 動くのは一度だけ
秒間1000リクエストを捌くAPI動く時間。 1リクエスト1msの差が、そのままサーバー台数になる
常駐して、CPUを回し続ける処理動く時間

そして、もう1つ大事なことがあります。

APIサーバーの時間は、ほとんど「待ち」です。

パフォーマンス改善の回で見たとおり、遅いAPIの原因はたいていデータベースです。 MySQLの回のクエリが 50ms かかっているとき、言語側の処理が 0.05ms か 3ms かは、ほとんど見えません。

測る前に言語を変えるのは、パフォーマンス改善の回で「速くする前に必ず測る」と書いたことに、真正面から違反しています。

⑤ FastAPI で /api/tasks を返す

最後に、APIの回と同じものを返します。

ここで初めて、外部ライブラリを入れます。 必ず venv の中で打ってください。

bash
$ cd ~/py-server
$ source .venv/bin/activate
$ pip install fastapi uvicorn

入った場所を確認します。

bash
$ pip show -f fastapi | head -3
$ du -sh .venv
Name: fastapi
Version: 0.115.6
Location: /home/user/py-server/.venv/lib/python3.12/site-packages
20M

Location: がホームディレクトリの下です。OS側には1ファイルも入っていません。

bash
$ nano api.py
from fastapi import FastAPI

app = FastAPI()

tasks = [
    {"id": 1, "title": "Linuxのコマンドを覚える", "done": True},
    {"id": 2, "title": "サーバーを立てる", "done": True},
    {"id": 3, "title": "APIを作る", "done": False},
]


@app.get("/api/tasks")
def get_tasks():
    return tasks

これで全部です。

行意味
app = FastAPI()アプリを1つ作る。Express の const app = express() にあたります
tasks = [ {...}, ... ]辞書({})の配列。 JavaScript のオブジェクトとほぼ同じ書き方です。True / False が大文字始まりなのが Python の決まり
@app.get("/api/tasks")次の関数を、GET のこのパス担当として登録する。 @ で始まる行はデコレータと呼びます
def get_tasks():中身。return tasks と書くだけで、FastAPI が JSON に変換してヘッダーまで付けます

動かします。

bash
$ uvicorn api:app --host 0.0.0.0 --port 8000
INFO:     Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)
部分意味
api:appapi.py の中の app という変数を動かせ、という指定
--host 0.0.0.0サーバーとは何かの回と同じで、外から届くようにする

api.py の中に、ポート番号もアドレスも書いていません。 FastAPI はポートを掴みません。 掴むのは uvicorn です。「どう返すか」と「どう待つか」が、別の担当に分かれています。 Goの回の ListenAndServe や、APIの回の app.listen(3000) は、同じプログラムの中にありました。 ここも「言語の性質ではなく、そのライブラリの流儀」です。

別のターミナルで叩きます。

bash
$ curl -s http://localhost:8000/api/tasks | jq
[
  {
    "id": 1,
    "title": "Linuxのコマンドを覚える",
    "done": true
  },
  {
    "id": 2,
    "title": "サーバーを立てる",
    "done": true
  },
  {
    "id": 3,
    "title": "APIを作る",
    "done": false
  }
]

3つ並べます。 3000番(Node.js)と 8080番(Go)も動かした状態で:

bash
$ curl -s http://localhost:3000/api/tasks | jq -S . > /tmp/node.json
$ curl -s http://localhost:8080/api/tasks | jq -S . > /tmp/go.json
$ curl -s http://localhost:8000/api/tasks | jq -S . > /tmp/py.json
$ diff /tmp/node.json /tmp/py.json && diff /tmp/go.json /tmp/py.json && echo "3つとも完全に同じです"
3つとも完全に同じです

[スクリーンショット: 04_3つとも同じJSON.png] diff が何も出さず「3つとも完全に同じです」と表示されている画面を撮ってください。

diff が何も出さない、というのがこの記事の結論です。 gRPCの回で「呼ばれる側が何語で書かれているかは、呼ぶ側には関係ない」と書きました。 ここで実物になりました。 REST APIの設計の回で決めた形さえ守られていれば、中身の言語は入れ替えられます。

おまけ: 型ヒントが仕事をするところ

さっき「型ヒントは誰も検査しない」と書きました。FastAPI は例外です。

api.py に1つ足します。

@app.get("/api/tasks/{task_id}")
def get_task(task_id: int):
    for t in tasks:
        if t["id"] == task_id:
            return t
    return {"error": "not found"}
bash
$ curl -s http://localhost:8000/api/tasks/2 | jq
$ curl -s http://localhost:8000/api/tasks/abc | jq
{
  "id": 2,
  "title": "サーバーを立てる",
  "done": true
}
{
  "detail": [
    {
      "type": "int_parsing",
      "loc": ["path", "task_id"],
      "msg": "Input should be a valid integer, unable to parse string as an integer"
    }
  ]
}

abc を渡すと 422 で断られました。 task_id: int と書いただけです。検査するコードは1行も書いていません。

REST APIの回のつまずき表に「req.params.id が文字列で困る」と書きました。 TypeScriptの回でも、同じ話をしました。URLから来る値は必ず文字列です。 FastAPI は、型ヒントを読んで、実際に変換と検査をします。 「言語が検査しないメモ」を、ライブラリが拾って使っているわけです。Python らしいやり方です。

自動でドキュメントも出ます。 ブラウザで http://192.168.226.50:8000/docs を開いてください。

[スクリーンショット: 05_fastapi_docs.png] ホストのブラウザで /docs を開き、/api/tasks が一覧に出ている画面を撮ってください。

⑥ Python が強い場所

「言語は目的で選ぶ道具」というのがGoの回の結論でした。では Python の目的は何か。

分野なぜ Python なのか
データ処理・集計標準の csv / sqlite3 / statistics だけで大半が終わる。 重い部分は C で書かれたライブラリが持つ
機械学習・LLM主要なライブラリが、事実上ここにしか無い。 RAGの回で扱った埋め込みの計算も、本来の主戦場はこちらです
自動化スクリプトpython3 が最初から入っている。 相手のサーバーに何も入れずに置いて動かせる
科学計算研究分野で長く使われてきた蓄積がある

共通しているのは、こうです。

「重い計算は C で書かれた部品にやらせて、Python はその指示書を書く」という形が成立する分野。

さっき sum(range(...)) で 3.4秒 が 0.9秒 になったのと、まったく同じ構造です。

では、なぜこのサイトの scripts/ は Node.js なのか

このサイトの記事は、scripts/post-draft.mjs という Node.js のプログラムで WordPress に投稿しています。

Python でも、まったく同じものが書けます。 それでも Node.js にしている理由は、1つだけです。

フロントエンドを JavaScript で書いているから。

もし Python にしたら
覚えること1つ増える。 書き方も、ライブラリの入れ方も、venv も
得られるものほぼ無い。 やっているのは Markdown を HTML にして HTTP で送るだけで、重い計算は1つも無い

逆に、もしこのサイトが「記事のアクセスログを集計してグラフを出す」ことを始めるなら、そこは Python で書きます。 その部分だけ、Python が明確に得意だからです。

言語は、プロジェクト単位で1つに決めるものではありません。 仕事単位で選べます。 Goの回で見たとおり、HTTPで繋がっていれば、中身の言語は揃っていなくていいからです。

⑦ 言語の地図

3点そろったので、面を描きます。

縦軸を「コンパイルするか」、横軸を「型を書くか」にします。

型を書かない型を書く
先にコンパイルする(ほぼ無い)Go / Rust / C / Java / TypeScript
その場で実行するJavaScript(Node.js) / Python / PHP / Ruby(Python の型ヒントはここに片足)

それぞれ1行で書きます。

言語どんな言語か
JavaScript(Node.js)ブラウザで動く唯一の言語。そのままサーバー側でも書けるのが最大の強み。このサイトの本線
TypeScriptJavaScript に型を足しただけ。コンパイルはするが、型を消しているだけ(TypeScriptの回)
Go実行ファイル1つで動く。 書き方が1つに決まっている。インフラの道具がほぼこれ(Docker も Kubernetes も)(Goの回)
Python書くのが速く、動くのが遅い。 重い部分は C の部品に投げる設計。データ処理と機械学習は、ほぼ一択
Java型が厳格で、大きな組織・長く動くシステムに多い。Android アプリの土台でもある
PHPWebサーバーの中で動くことに特化して生まれた。WordPress がこれ(このサイト自身が動いているのも PHP です)
Ruby「書いていて気持ちがいいこと」を優先した設計。Rails でWebアプリを速く作る用途が中心
Rustメモリの安全性をコンパイル時に保証する。 速さは C 並み。そのぶん、覚えることが多い
COSやドライバを書くための言語。 Python も Node.js も、中身は C で書かれています

この地図は、あくまで入口です。 Python は型ヒントを書けますし、JavaScript もTypeScriptを足せます。Java も型推論を持っています。 綺麗に4つに割れないこと自体が、この記事の結論です。「2種類に分かれている」という思い込みを壊すために置いています。

⑧ 次に、どれを学ぶか

「次はどの言語を学ぶべきですか」という質問には、答えがありません。 問いの立て方が逆だからです。

言語から選ばない。作りたいものから選ぶ。

作りたいもの選ぶ言語
Webサイト・WebアプリJavaScript(+TypeScript)。ブラウザで動くのがこれしかない
データを集計する・分析するPython
機械学習・LLMを使うPython
CLIツール・常駐プロセス・コンテナGo
WordPress のテーマやプラグインを触るPHP
スマホアプリ各プラットフォームの言語(この段階では急がなくて構いません)
OSやドライバ、組み込みC / Rust

そして、このサイトの方針をもう一度はっきり書きます。

このサイトは、引き続き Node.js で進めます。

Go の回でも同じことを書きました。理由も同じです。 フロントエンドを JavaScript で書いてきたので、同じ言語のままのほうが、覚えることが1つ減るからです。それだけです。

Go と Python の記事は、ここで役目を終えます。

持ち帰ってほしいのは、Python の文法ではありません。

1つ目の言語では、何が言語の性質か分からない。 2つ目で、線が引ける。 3つ目で、その線が実は面だったと分かる。

これから4つ目、5つ目を触るとき、あなたはもう「入門」から始めません。 「すでに知っているものと、どこが違うか」から始められます。 それが、この2本の記事で作りたかった状態です。

つまずいたところ

症状原因
error: externally-managed-environmentvenv の外で pip install している。 エラーではなく、正常な保護動作です
--break-system-packages を勧める記事を見た使わないでください。 名前のとおり、システムのパッケージを壊します
python3 -m venv が ensurepip is not available で失敗python3-venv パッケージが入っていない。 sudo apt install -y python3-venv
pip install したのに ModuleNotFoundErrorsource .venv/bin/activate を忘れている。 which python で確認する
ターミナルを開き直したら動かなくなったvenv は開いているシェルにしか効きません。 毎回 activate します
IndentationError段の深さが揃っていない。 タブと半角スペースが混ざっていないか確認
ループの外に書いたつもりが、中で動いているインデントが1段深い。 エラーは出ないので、出力の回数で気づくしかありません
TypeError: a bytes-like object is requiredself.wfile.write に文字列をそのまま渡した。 .encode("utf-8") が必要です
日本語が文字化けするContent-Type に charset=UTF-8 を付けていない、または .encode("utf-8") をしていない
NameError: name 'true' is not definedPython の真偽値は True / False。 先頭が大文字です
Address already in use8000番を別のプロセスが掴んでいる。 sudo ss -tlnp で犯人を探す(サーバーとは何かの回と同じ)
ブラウザから見えないが curl localhost は通るufw で 8000 を開けていない、または uvicorn に --host 0.0.0.0 を付けていない
ベンチマークの秒数が記事と全然違うVMに割り当てたCPUで変わります。 見るのは絶対値ではなく桁の差です

後片づけ

venv はフォルダごと消せます。

bash
$ deactivate
$ rm -rf ~/py-server/.venv

プロジェクトごと消す場合。

bash
$ rm -rf ~/py-server ~/bench

開けたポートを閉じます。

bash
$ sudo ufw delete allow 8000/tcp
$ sudo ufw status

python3 本体は絶対に消さないでください。 apt の回の道具が動かなくなります。 sudo apt remove python3 は、Ubuntu では実質「壊す」コマンドです。入っていて正常な状態です。

~/server/ は残してください。 このサイトの本編は、引き続きそちらで進みます。

まとめ

  • 2つでは地図にならない。 2点なら必ず直線が引けてしまう。3つ目で、それが面だったと分かる
  • サーバーがやっているのは、掴む・待つ・受ける・返す。 3つ目の言語でも同じ場所に出てきた。偶然ではないと言い切れる
  • Ubuntu の python3 はOSの部品。 add-apt-repository がそれで動いている
  • sudo pip install はしない。 Ubuntu 24.04 は externally-managed-environment で止めてくれる。--break-system-packages で押し通さない
  • venv を作って、その中で pip install する。 消したければフォルダごと消せる
  • インデントが文法。 ズレると動かないか、エラーも出さずに意味が変わる
  • 型は書かなくていいが、書ける。 ただし標準では誰も検査しない。TypeScript よりさらに弱い立場
  • 標準ライブラリが厚い。 CSV も SQLite も ZIP も統計も、最初から入っている
  • 同じループが Go の約150倍遅かった。 数字で見た
  • sum(range(...)) にすると 3.4秒 が 0.9秒。 遅いのは Python のループであって、Python の全部ではない
  • 「遅い=駄目」ではない。 1日1回動くスクリプトなら、動く時間より書く時間のほうが高い
  • APIの時間はほとんど待ち時間。 測る前に言語を変えるのは、順番が逆
  • FastAPI は型ヒントを実際に使う。 task_id: int と書くだけで、abc を 422 で断る
  • Python が強いのは、データ処理・機械学習・自動化。 「重い部分を C の部品に投げられる」分野
  • このサイトの scripts/ が Node.js なのは、フロントが JavaScript だから。 それだけの理由
  • 言語は作りたいもので選ぶ。 そしてこのサイトは、引き続き Node.js で進めます

参考リンク


次に読む

この記事は 【第5段階】バックエンドとデータベース の 25 / 29 本目です。

記事
← 前の記事gRPCはcurlで叩けない — 関数を呼ぶようにAPIを呼ぶ
→ 次の記事部分一致は索引が効かない — 全文検索とMeilisearch

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

Backend›Pick a Language
  • Python(3つ目の言語として触る)
  • 言語の地図 — Java / PHP / Ruby / Rust / C はどこにいるか

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次