自走プログラマー - 清水川のScrapbox

自走プログラマー

https://images-na.ssl-images-amazon.com/images/I/81KkkUg652L.jpg

基本情報

書籍名: 自走プログラマー ~Pythonの先輩が教えるプロジェクト開発のベストプラクティス120

出版社: 技術評論社

著者: 清水川貴之 (著), 清原弘貴 (著), tell-k (著), 株式会社ビープラウド (監修)

ページ数: 288

金額: 2980円+税

発売時期: 2020/2/27

カテゴリ: #Python / #Web技術 / #指南書

出版社リンク: http://gihyo.jp/book/2020/978-4-297-11197-7

Amazonリンク: https://amzn.to/3aNzcN1

正誤表: http://public-errata.appspot.com/errata/book/9784297111977/

ステータス

#執筆した

本の概要

(書籍前書きより)

本書は、「プログラミング入門者が中級者にランクアップ」するのに必要な知識をお伝えする本です。扱っている120のトピックは、実際の現場で起こった問題とその解決方法を元に執筆しています。このため、扱っているプロジェクトの規模や、失敗パターンのレベル感もさまざまです。各トピックでは具体的な問題とベストプラクティス、なぜそれがベストなのかを解説します。

本書は、プログラミング言語Pythonを使って設計や開発プロセスのベストプラクティスを紹介します。Pythonにくわしくない方でも、プログラミング言語の文法を知っている方であれば理解できるようにしています。逆に、プログラミング自体が何かわからない人のための本ではありません。すでにプログラミング言語の文法や書き方、役割を知っている人が、より効率的かつ効果的にプログラムを書く、価値を創る方法をお伝えする本です。

お勧めの読者

(書籍前書きより)

チョットした便利なコードを書けるけど、中〜大規模のシステムを上手に作れない人

プログラムを書けるけど、レビュー指摘などで手戻りが多い人

優れたエンジニアになりたい人

PythonでWebアプリケーションの開発をするときの指針が欲しい人

Python入門を果たしたプログラマーで、仕事でPythonをやっていこうという人

設計の仕方や、メンテナンス性の高いプログラムの書き方を知りたい人

ライブラリの選定を、確信を持ってできるようになりたい人

shimizukawa.icon一言で言うと:

Python入門者から中級者になりたい人

Pythonプロフェッショナルプログラミング, エキスパートPythonプログラミング, 実践 Python 3 を読めるようになりたい人

対象としていない読者:

プログラミング入門、Python入門、科学計算、スクレイピング、機械学習、を学びたい

直接的な答えだけ欲しい人

この本を書いた目的

プログラミングの守破離のうち、守をまとめて伝えたい。

BeProudで中心的に活動しているメンバーは、各種公式ドキュメントや過去の経験で守の知識を持っている。

各プロジェクトでは、守を実践しつつ、必要に応じて破を交えているが、チーム開発では、離はあまりやらない。

新メンバー（rookie）が開発プロジェクトに参加すると、守がまだ身についていない状態で、破を実践しないといけない状態になり、混乱してしまう。

こういった状況を打開するべく、本書ではBeProudの守をまとめました。

執筆の想い

私たちにとってプログラマーとは，設計書をコードにする単純作業者のことではなく，やりたいことをまとめ，設計からコードにし，そしてリリースするまでをすべて1人でできる人のことを指しています。本当にすばらしいサービスやアプリケーションをつくり出すには，自走できるプログラマーが必要です。

とはいえ，すべてのプログラマーがはじめから自走できたわけではなく，組織のメンバーは常に入れ替わっていき，新しく参加するメンバーの中にはこれからいろいろなことを学んでいく人もいます。それは，技術的なつまづきと学びを繰り返して，その背景にある原理原則をメンバーそれぞれが見つけていく，長い旅のようなものです。ビープラウドには，この学びの旅をサポートする「教え合う文化」が根づいており，つまづいたときには先輩が親身になって助けてくれます。そこで先輩達が教えてきた履歴を見ると，新しいメンバーがなぜか必ずつまづいてしまうパターンがいくつもあることがわかってきました。こういった，設計からコードまで書けるようになるために知っておいてほしい技術的なトピックを集め，この本にまとめました。

本書は，プログラミング入門ならぬ，脱入門者を目指す開発者向けの指南書です。自走できるプログラマーであれば知っているであろういろいろな手法や観点を元に，「プロジェクトの各段階でプログラマーがやること」「その選択をどう判断するのか」「どうコードを実装して実現していくのか」を紹介します。一部の最新技術に注目するのではなく，実際のプロジェクトに適用して，プロジェクトを完成させるための指針をまとめました。

著者・関係者による紹介blog

hirokiky: 10年以上のノウハウを詰め込んだ「自走プログラマー」を執筆しました - Make組ブログ

この本は著者陣が仕事の中で他の人に教えたことを中心に執筆しています。たとえばコードレビューや、社内でのサポート、社内外の研修、コンサルティングの中で伝えてきたことをまとめています。ビープラウド社内のメンバーも積極的にレビュー、コメントしてくれて、社内のかなりのノウハウが取り込まれています。

執筆に際しては社内で半年から1年をかけてネタを集めて、選別する時間を設けました。著者の3人が日々の業務で伝えたことや感じたこと、過去に社内で伝えたことをネタ帳として集めてから執筆しています。たとえば「ログには5W1Hを書こう」という僕が執筆を担当したプラクティスがあるのですが、これは5年前（2015年）から社内では共有していた知識です。これは社内でも好評で、「ロギングって大事だけど、何を書くべきかを学べる場所がなかった」とフィードバックを受けていました。そのノウハウがやっと日の目を見ることになって、僕個人としてはとても嬉しいです。こんなにうれしいことはない。。

haru: 「自走プログラマー」は中級以上のPythonプログラマーになりたい人のための豊富なレシピ集 - ビープラウド社長のブログ

「理由を考えるための設計・実装の選択肢」が、前書きに書かれている「プログラミング入門者が中級者にランクアップするのに必要な知識」の本質

中級以上のプログラマーが、日々どのようなことにこだわり、思考を積み上げているかを知ることもできるでしょう（中にはそこまで考える必要あるの？というものもあるでしょう）

章構成と執筆担当

https://gyazo.com/810da5a009ea3fa3aab8d151211fee17

table:chapter-and-author

節 # タイトル著者

1.1. 関数設計 1 関数名は処理内容を想像できる名前にする hirokiky

2 関数名ではより具体的な意味の英単語を使おう hirokiky

3 関数名から想像できる型の戻り値を返す hirokiky

4 副作用のない関数にまとめる hirokiky

5 意味づけできるまとまりで関数化する hirokiky

6 リストや辞書をデフォルト引数にしない hirokiky

7 コレクションを引数にせずでintやstrを受け取る hirokiky

8 インデックス番号に意味を持たせない hirokiky

9 関数の引数に可変長引数を乱用しない hirokiky

10 コメントには「なぜ」を書く hirokiky

11 コントローラーには処理を書かない hirokiky

1.2. クラス設計 12 辞書でなくクラスを定義する hirokiky

13 dataclassを使う hirokiky

14 別メソッドに値を渡すためだけに属性を設定しない hirokiky

15 インスタンスを作る関数をクラスメソッドにする hirokiky

1.3. モジュール設計 16 utils.pyのような汎用的な名前を避ける hirokiky

17 ビジネスロジックをモジュールに分割する hirokiky

18 モジュール名のオススメ集 hirokiky

1.4. ユニットテスト 19 テストにテスト対象と同等の実装を書かない hirokiky

20 1つのテストメソッドで1つの項目のみ確認する hirokiky

21 テストケースは準備、実行、検証に分割しよう tell-k

22 単体テストをする観点から実装の設計を洗練させる hirokiky

23 テストから外部環境への依存を排除しよう hirokiky

24 テスト用のデータはテスト後に削除しよう tell-k

25 テストユーティリティーを活用する hirokiky

26 テストケース毎にテストデータを用意する tell-k

27 必要十分なテストデータを用意する tell-k

28 テストの実行順序に依存しないテストを書く hirokiky

29 返り値がリストの関数のテストで要素数をテストする hirokiky

30 テストで確認する内容に関係するデータのみ作成する hirokiky

31 過剰なmockを避ける hirokiky

32 カバレッジだけでなく重要な処理は条件網羅をする hirokiky

1.5. 実装の進め方 33 公式ドキュメントを読もう shimizukawa

34 一度に実装する範囲を小さくしよう shimizukawa

35 基本的な機能だけ実装してレビューしよう shimizukawa

36 実装方針を相談しよう tell-k

37 実装予定箇所にコメントを入れた時点でレビューしよう shimizukawa

38 必要十分なコードにする tell-k

39 開発アーキテクチャドキュメント shimizukawa

1.6. レビュー 40 PRの差分にレビューアー向け説明を書こう shimizukawa

41 PRに不要な差分を持たせないようにしよう shimizukawa

42 レビューアーはレビューの根拠を明示しよう shimizukawa

43 レビューのチェックリストを作ろう shimizukawa

44 レビュー時間をあらかじめ見積に含めよう shimizukawa

45 ちょっとした修正のつもりでコードを際限なく書き換えてしまう shimizukawa

2.1. データ設計 46 マスターデータとトランザクションデータを分けよう tell-k

47 トランザクションデータは正確に記録しよう tell-k

48 クエリで使いやすいテーブル設計をする tell-k

2.2. テーブル定義 49 NULLをなるべく避ける hirokiky

50 一意制約をつける hirokiky

51 参照頻度が低いカラムはテーブルを分ける hirokiky

52 予備カラムを用意しない hirokiky

53 ブール値でなく日時にする hirokiky

54 データはなるべく物理削除をする hirokiky

55 typeカラムを神格化しない hirokiky

56 有意コードをなるべく定義しない hirokiky

57 カラム名を統一する hirokiky

2.3. Django ORMとの付き合い方 58 DBのスキーママイグレーションとデータマイグレーションを分ける shimizukawa

59 データマイグレーションはロールバックも実装する shimizukawa

60 Django ORMでどんなSQLが発行されてるか気にしよう shimizukawa

61 ORMのN＋1問題を回避しよう shimizukawa

62 SQLから逆算してDjango ORMを組み立てる shimizukawa

3.1. エラーハンドリング 63 臆さずにエラーを発生させる shimizukawa

64 例外を握り潰さない shimizukawa

65 try節は短く書く shimizukawa

66 専用の例外クラスでエラー原因を明示する shimizukawa

3.2. ロギング 67 トラブル解決に役立つログを出力しよう shimizukawa

68 ログがどこに出ているか確認しよう shimizukawa

69 ログメッセージをフォーマットしてロガーに渡さない hirokiky

70 個別の名前でロガーを作らない hirokiky

71 info、errorだけでなくログレベルを使い分ける hirokiky

72 ログにはprintでなくloggerを使う hirokiky

73 ログには5W1Hを書く hirokiky

74 ログファイルを管理する tell-k

75 Sentry でエラーログを通知/監視する shimizukawa

3.3. トラブルシューティング・デバッグ 76 シンプルに実装しパフォーマンスを計測して改善しよう shimizukawa

77 トランザクション内はなるべく短い時間で処理する shimizukawa

78 ソースコードの更新が確実に動作に反映される工夫をしよう shimizukawa

4.1. プロジェクト構成 79 本番環境はシンプルな仕組みで構築する shimizukawa

80 OSが提供するPythonを使う shimizukawa

81 OS標準以外のPythonを使う shimizukawa

82 Docker公式のPythonを使う shimizukawa

83 Pythonの仮想環境を使う shimizukawa

84 リポジトリのルートディレクトリはシンプルに構成する shimizukawa

85 設定ファイルを環境別に分割する shimizukawa

86 状況依存の設定を環境変数に分離する shimizukawa

87 設定ファイルもバージョン管理しよう tell-k

4.2. サーバー構成 88 共有ストレージを用意しよう tell-k

89 ファイルをCDNから配信する tell-k

90 KVS（Key Value Store）を利用しよう tell-k

91 時間の掛かる処理は非同期化しよう tell-k

92 タスク非同期処理 shimizukawa

4.3. プロセス設計 93 サービスマネージャーでプロセスを管理する shimizukawa

94 デーモンは自動で起動させよう tell-k

95 Celeryのタスクにはプリミティブなデータを渡そう tell-k

4.4. ライブラリ 96 要件から適切なライブラリを選ぼう tell-k

97 バージョンをいつ上げるのか shimizukawa

98 フレームワークを使おう（巨人の肩の上に乗ろう） shimizukawa

99 フレームワークの機能を知ろう shimizukawa

4.5. リソース設計 100 ファイルパスはプログラムからの相対パスで組み立てよう tell-k

101 ファイルを格納するディレクトリを分散させる shimizukawa

102 一時的な作業ファイルは一時ファイル置き場に作成する shimizukawa

103 一時的な作業ファイルには絶対に競合しない名前を使う shimizukawa

104 セッションデータの保存にはRDBかKVSを使おう shimizukawa

4.6. ネットワーク 105 127.0.0.1と0.0.0.0の違い shimizukawa

106 ssh port forwardingによるリモートサーバーアクセス shimizukawa

107 リバースプロキシ shimizukawa

108 Unixドメインソケットによるリバースプロキシ接続 shimizukawa

109 不正なドメイン名でのアクセスを拒否する shimizukawa

110 hostsファイルを変更してドメイン登録と異なるIPアドレスにアクセスする shimizukawa

5.1. 要件定義 111 いきなり作り始めてはいけない hirokiky

112 作りたい価値から考える hirokiky

113 100%の要件定義を目指さない hirokiky

5.2. 画面モック 114 文字だけで伝えず、画像や画面で伝える hirokiky

115 モックアップは完成させよう hirokiky

116 遷移、入力、表示に注目しよう hirokiky

117 コアになる画面から書こう hirokiky

118 モックアップから実装までをイメージしよう hirokiky

119 最小で実用できる部分から作ろう hirokiky

120 ストーリーが満たせるかレビューしよう hirokiky

扱っている分野

参照しているライブラリ、ミドルウエア、ドキュメント、サービス、ツール

Python公式

enumerate：Python 3 ドキュメント https://docs.python.org/ja/3/library/functions.html#enumerate

logging - Python 用ロギング機能 - Python 3.8.1 ドキュメント https://docs.python.org/ja/3/library/logging.html#logging.Formatter

Logging Flow - Logging HOWTO - Python 3.8.1 ドキュメント https://docs.python.org/ja/3/howto/logging.html#logging-flow

mock https://docs.python.org/ja/3/library/unittest.mock.html

tempfile https://docs.python.org/ja/3/library/tempfile.html

TypedDict仕様提案：PEP-589 https://www.python.org/dev/peps/pep-0589/

TypedDict：Python 3 ドキュメント https://docs.python.org/ja/3/library/typing.html#typing.TypedDict

ソケットプログラミング HOWTO - Python 3.8.1 ドキュメント https://docs.python.org/ja/3/howto/sockets.html

Django公式

clearsession https://docs.djangoproject.com/ja/2.2/ref/django-admin/#clearsessions

DEP 0008 https://github.com/django/deps/blob/master/accepted/0008-black.rst

Djangoのコーディングスタイル https://docs.djangoproject.com/ja/2.2/internals/contributing/writing-code/coding-style/

Djangoの設定 https://docs.djangoproject.com/ja/2.2/topics/settings/

QuerySet API reference https://docs.djangoproject.com/ja/2.2/ref/models/querysets/

セッションの使いかた https://docs.djangoproject.com/ja/2.2/topics/http/sessions/#using-file-based-sessions

テストツール https://docs.djangoproject.com/ja/2.2/topics/testing/tools/

複数の値を持つリレーションの横断 https://docs.djangoproject.com/ja/2.2/topics/db/queries/#spanning-multi-valued-relationships

ALLOWED_HOSTS https://docs.djangoproject.com/ja/2.2/ref/settings/#allowed-hosts

SESSION_ENGINE https://docs.djangoproject.com/ja/2.2/ref/settings/#std:setting-SESSION_ENGINE

サードパーティーライブラリのドキュメント

Django Debug Toolbarの設定 https://django-debug-toolbar.readthedocs.io/en/latest/installation.html

Gunicornのbind http://docs.gunicorn.org/en/stable/settings.html#bind

Gunicornのデプロイ https://docs.gunicorn.org/en/stable/deploy.html

TypedDict：mypy公式ドキュメント https://mypy.readthedocs.io/en/latest/more_types.html#typeddict

パッケージ

aldjemy https://pypi.org/project/aldjemy/

APScheduler https://pypi.org/project/APScheduler/

autopep8 https://pypi.org/project/autopep8/

awesome-python https://github.com/vinta/awesome-python

black https://pypi.org/project/black/

Celery http://www.celeryproject.org/

deform https://docs.pylonsproject.org/projects/deform/en/latest/

Django Packages https://djangopackages.org/

django-background-tasks https://django-background-tasks.readthedocs.io/

django-debug-toolbar https://pypi.org/p/django-debug-toolbar

django-environ https://django-environ.readthedocs.io/

django-redis https://niwinz.github.io/django-redis/latest/

django-silk https://pypi.org/p/django-silk/

factory-boy https://factoryboy.readthedocs.io/en/latest/

fakeredis https://pypi.org/project/fakeredis/

flake8 https://pypi.org/project/flake8/

flake8-logging-format https://pypi.org/project/flake8-logging-format/

Gunicorn https://pypi.org/project/gunicorn/

moto http://docs.getmoto.org/en/latest/

nplusone https://pypi.org/p/nplusone

Pipenv https://pipenv.kennethreitz.org/

Poetry https://python-poetry.org/

pycodestyle https://pypi.org/project/pycodestyle/

pylint https://pypi.org/project/pylint/

python-decouple https://pypi.org/p/python-decouple/

responses https://github.com/getsentry/responses

SQLAlchemy https://pypi.org/project/SQLAlchemy/

uWSGI https://pypi.org/project/uWSGI/

virtualenvwrapper https://virtualenvwrapper.readthedocs.io/

WTForm https://wtforms.readthedocs.io/en/stable/

ミドルウェア

Anaconda https://www.anaconda.com/

BEGIN - PostgreSQL https://www.postgresql.jp/document/11/html/sql-begin.html

COMPOSE_FILE - Docker https://docs.docker.com/compose/reference/envvars/#compose_file

Docker https://www.docker.com/

Docker公式のPython https://hub.docker.com/_/python

Intel Python https://software.intel.com/en-us/distribution-for-python

Memcached https://memcached.org/

proxy_cache_path設定 - Nginx http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cache_path

pyenv https://github.com/pyenv/pyenv

Redis https://redis.io/

Vagrant https://www.vagrantup.com/

トランザクションの管理 - Oracle http://otndnld.oracle.co.jp/document/products/oracle11g/111/doc_dvd/server.111/E05765-03/transact.htm

名前ベースのバーチャルホスト - Apache https://httpd.apache.org/docs/2.4/ja/vhosts/name-based.html

名前ベースのバーチャルホスト - Nginx http://nginx.org/en/docs/http/request_processing.html

暗黙的なコミットを発生させるステートメント - MySQL https://dev.mysql.com/doc/refman/5.6/ja/implicit-commit.html

サービス

AWS CloudFront https://aws.amazon.com/jp/cloudfront/

Akamai https://www.akamai.com/jp/ja/

Fastly https://www.fastly.jp/

GCP Cloud CDN https://cloud.google.com/cdn/

Sentry https://sentry.io/

プログラマーのためのネーミング辞書 codic https://codic.jp

デスクトップツール

BalsamiqMockup https://balsamiq.com/wireframes/

Dash https://kapeli.com/dash

Zeal https://zealdocs.org/

標準仕様

Forwarded - MDN https://developer.mozilla.org/ja/docs/Web/HTTP/Headers/Forwarded

RFC 7239 - Forwarded HTTP Extension https://tools.ietf.org/html/rfc7239

X-Forwarded-For - MDN https://developer.mozilla.org/ja/docs/Web/HTTP/Headers/X-Forwarded-For

X-Forwarded-Host - MDN https://developer.mozilla.org/ja/docs/Web/HTTP/Headers/X-Forwarded-Host

X-Forwarded-Proto - MDN https://developer.mozilla.org/ja/docs/Web/HTTP/Headers/X-Forwarded-Proto

裏話

英語名は The Self-Propelled Programmerかな

日本語に直訳すると「自走式プログラマー」、なんだかすごそう

あるいは The Self-Driven Programmer 、こっちの方が通りが良さそう

企画開始は 2017/5/23(火)

出版が2020年2月なので、3年弱かかっている

企画開始当初、3年くらいという話をしていたら出版まで本当に3年かかった

じっくり時間をかけて中級向けに役立つ情報をまとめようとした

当初計画では、下書きを書いたら社内で実践してもらってフィードバックを集めようと計画

最後締め切りを区切られてから時間を捻出してまとめた

shimizukawa.iconは締め切りがゆるいとオーバーしちゃうのを再実感

（途中1年ほどかなり厳しいプロジェクトに入っていて、心の余裕もなかった）

やる気になってから非常に濃い密度で進められた

社内Slackの各チャンネルを追って、適用できそうか、できないとしたらなぜかを考えて反映した

書いた内容はGitHubにあるので、社内Slackで必要なシーンを見かけたら伝えた

実践してもらった結果を聞いて、原稿に反映した

「習うべき先輩をどう見極めれば良いか」問題

先輩T だと思って習ったけど実は Xさんかもしれない（トピック 98）

しかもXさん、意外とTwitterでフォロワー多かったり、コミュニティでなにかしてたりもしそう。

先輩Tさん、猫のツイートしかしてない。

このネタで1講演できるくらいの価値ありそう。

知り合いの感想

terapyon:

買って読みました。けっこう早い段階でDjango前提の話がでてきてそこは読み解きづらかったので飛ばしました。そうやって飛ばしながら読めるのはよかった。全体的には良い内容で、Pythonに特化した感じではなくもっと一般的なことを伝えたいんだなと思いました

aodag:

いいね、ああいいねえ

詳細を読むと、例で説明しきれていない気もするけど、トピックタイトルと要点だけ読んでいくと伝えたいことがよくわかる。毎回説明してたのを本にまとめたんでしょ。

その他、言及等

『自走プログラマー　～Pythonの先輩が教えるプロジェクト開発のベストプラクティス120』(清水川貴之)の感想(2レビュー) - ブクログ

自走プログラマー ~Pythonの先輩が教えるプロジェクト開発のベストプラクティス120| モノレート

『自走プログラマー ~Pythonの先輩が教えるプロジェクト開発のベストプラクティス120』のレビュー清水川貴之 (ofellabutaさん) - ブクログ

2020/05/03 自走プログラマー ~Pythonの先輩が教えるプロジェクト開発のベストプラクティス120を読んだ - niszetの日記

2020/05/10 自走プログラマー - 小さな工作室

2020/05/25 職業について少し思うこと

「独学」で始め、「自走」し、「達人」に至るわけですね。

2020/05/15 「自走プログラマー　～Pythonの先輩が教えるプロジェクト開発のベストプラクティス120」を読んだ - JUNのブログ

最高でした.

この本を一言で表すなら Pythonのベストプラクティスの結晶という感じです.

いや, まじで, やばいです. 普段なら読んだ本から使えそうな部分をメモしてまとめるのですが, この本に紹介されている内容はすべてメモしたくなったし, 全ページ黄色マーカー引きたいし, 自分が困っていた問題にピンポイントに刺さってるのがいくつもあって本当に良かったです.

この本はたまたま技術評論社のWebサイトで適当に本を探してたら見つけて, 目次見た感じ良さそうだったので買ったのですが, まさかここまで素晴らしくて実用的だとは思いませんでした.

2020/05/10 自走プログラマーを読み終えた • Software Engineer as Data Scientist

読み始めたきっかけとして、自分は機械学習エンジニアとして現在働いているが、できることの幅を広げるために最近はソフトウェアエンジニアとしてのスキルをもっと伸ばしたいと考えている。

自走プログラマーは、Pythonを使ったアプリケーション開発のアンチパターンとベストプラクティスを例示して学ぶことができる書籍で、今回の自分の状況にすごくフィットしていて楽しく学習することができた。

2020/06/29 読書メモ『自走プログラマー ~Pythonの先輩が教えるプロジェクト開発のベストプラクティス120』 - Qiita

ソフトウェア開発の経験が浅い人は1章から順番に読めばよいし、

コードは書けるけど設計が微妙という人は5章から読めばよく、

読み手のことを考えた構成で素晴らしいと思いました。

2021/06/09: みんなのPython勉強会#70のまとめ - Togetter

"自走プログラマー"は読みやすい！それ重要です。読みづらい本はどんどん積ん読になってます。 #stapy

自走プログラマー読みやすいですよね！ #stapy

ベストプラクティスは必ずしも正解ではないので、読書会で意見交換しあうのがお薦め。なるほど！ #stapy

「自走プログラマー」のお薦めポイント現場レベルでありそうな知見やサンプルコード。自分事に近い知見は本当ありがたいですよねー #stapy

「リアルな開発現場でありそうなソースコード」「先輩と後輩の生々しい会話」 #stapy #自走プログラマー

「この後輩説明上手いな」という気付き。ここに気がつくノもすごいなぁ。#stapy

shimizukawa.icon 自走プログラマー紹介トークありがとうございました！「後輩説明うまいな」からの「こう説明すればいいんだ」という発想は、執筆時には想定してませんでしたｗこんど本を紹介する際には使わせてもらいますね #stapy

トーク資料

「動くものは作れる」の一歩先へ〜「自走プログラマー」の紹介〜 - Speaker Deck

2022/03/01: 【書評】Djangoの学習に役立つ隠れた名著『自走プログラマー Pythonの先輩が教えるプロジェクト開発のベストプラクティス120』 | ハードウェアエンジニア、WEBを学ぶ。

こちらの書籍はメインタイトルにもサブタイトルにも「Django」の文字は入っていないんですよね。

Djangoの学習と並行してPython自体の学習も行っていますので、Djangoはとりあえず置いておいて、Python自体のレベルの底上げに役立つ書籍を探していました。そしてこの本を見つけたのです。

「ベストプラクティス120」ということで、いろいろなテーマが扱われていて読みやすそうですので買ってみることにしました。

そして中身をよくよく読んでみると嬉しい誤算と言うのか、Djangoを題材にしたベストプラクティスがかなり出てくるんですよね。これはほぼDjangoの本なのではないかと錯覚するくらいに。

それもそのはず、著者をよく見てみると、著者のおふたりはDjangoにもご関係のある方々なのですよね。

2022/07/26: python - ログメッセージをフォーマットせずに出力したいです。桁区切りのカンマを表示するには、どのように指定すればよいでしょうか？ - スタック・オーバーフロー

shimizukawa.icon 自走プログラマーの内容がSOで質問されていたので回答してみた

@shinya_hd - 午後7:26 · 2022年8月8日自走プログラマー。

個人開発で教えてくれる人いないからこの本はホント役に立つ。

本番リリースするためにも必要なことがたくさん詰まってる。

一年くらい寝かしていたけど読み始めてる。

@rinne_grid - 午前11:09 · 2022年8月13日自走プログラマーの第1章「コード実装」のところ、読んだ。とても良き。

・「個人的に無意識にできていること・できてないこと」がそれぞれ明確になる（思わず息を呑むことも）

・PRによるレビューの経験が少ないので、レビュアーの視点を書いてくれてるのがとても助かる。

・テストコード書きたい

@rinne_grid - 午前11:14 · 2022年8月13日個人（単独）開発だと、どうしても得ることができない知見が纏まっている。

どういう部分に気をつけてもらいたいか、後輩を指導する時にも利用できそう。

ただ、本書を読むにあたって、Djangoの基本的な知識が必要な部分がある。

@rinne_grid - 午後10:06 · 2022年8月23日自走プログラマーの本、全体的にとても良かった。個人的にはコード実装とエラー設計の章が得るものが多かった。おそらくチームメンバーと一緒にこの本の輪読会するとチームとしてスキルアップに繋がる。

それにしても、この本に登場する「先輩T」がめっちゃ優しい。悟りでも開いているのだろうか。

@gologius - 午後11:07 · 2022年10月22日この本結構よかった。ちょうど中級者～上級者くらいのことが読みやすく書いてあった。

@touki_1513 - 午後1:43 · 2022年11月4日「自走プログラマー」は、Python・Django技術者向けだったが、内容は普遍的なコーディング・テスト・DB設計規約のベストプラクティスの話で、とても参考になった。レビューやPR・要件定義にも踏み込んでいて、全部すぐ実践はできなくても、WFの工程別にチームで意識したいと思った。手元に欲しい

@naoki_maejima - 午後5:19 · 2022年11月13日『自走プログラマー』に書いてあった「実装予定の箇所にコメントした時点でレビュー依頼する」という指南、とても良いな。今まで適当にオレオレ実装したものでPR投げてたけど、自信ない場合はコメントだけでdiff作ったほうが失われる時間が少ない。

@kimihito_ - 午前9:41 · 2022年12月12日 Djangoのコードを本格的に書いて1年ほど経って、自走プログラマーを再読したけど学びが多い。抜粋版もあるのいい https://t.co/8hCAVEBdOZ

@kaeru_nantoka - 午後5:01 · 2022年12月29日「自走プログラマー」読了。Django による web開発のプロジェクトを題材に、複数のベスプラ・アンチパターンを扱っていてスッと入ってきた。テストとかクラス設計とかの入門に良さそう。（入門できた）

2023/01/02: 読書: 自走プログラマー　～Pythonの先輩が教えるプロジェクト開発のベストプラクティス120

Python での開発のベストプラクティスが実践に即して学べるいい本でした。

個人的には dataclass の使い方やログ、例外のあたりの内容が勉強になりました。

2023/05/28: 自走プログラマーを読んだ

1章これはPython使い全員に有用

3章エラー設計やロギングの話がよかった。基本的で大切なことが書いているので読み直したい。

よかったところ

1,3章あたりはPythonやプログラミングのお作法的なことが学べてよい。またプルリクや設計の初学者があまり触れない話もあり。リーダブルコードが抽象的でよくわからない人にとって良いかも

「Pythonを今まで何となく書いてきたけど、業務では全然…」というレベル感の人が読むには最適

懸念点

amazonレビューにもあったが、Web/Djangoをわかっていないのと読みづらい。web系エンジニア向けの内容なので、MLエンジニアには親和性が低い話も多い

情報が最新ではないので、頭の中で取捨選択が必要かも

コードに型アノテーションがついていないことが少し気になる（Pythonのバージョンが低い場合も考慮している？）