ゼロからはじめる Django で ECサイト構築（その１：ECパッケージの選定）

前々から何か本が書きたいなと思っていたところで「当選したら書いてみようかな」という軽いノリでこのイベントのサークル参加に申し込みをしたら、見事に抽選に当たっ（ってしまっ）たのが二月初旬。そこからちまちまと目次を作り始め、本格的に書き始めたのは二月下旬あたり。そこから泣きそうになりながら毎日明け方まで執筆することを繰り返し、ようやく脱稿できそうな目処がついて安堵感を感じ始めています。これまでに要した総時間はおそらく 300時間を超えると思います。

こちらは昨日 Twitter で聞いたアンケート。
半数が入稿済みだった。皆さん早い！！

#技術書典4で新刊を頒布予定の皆さん、進捗どうですか？#技術書典
— akiyoko@技術書典4く-33 (@aki_yok) April 13, 2018

「基礎 Django」はどんな内容？

全148ページ（表紙や奥付を除けば本文 142ページ）まるまる Django 本です。執筆はほぼ完了し、現在絶賛校正中です。

本書の読者としては、

Python の文法はある程度分かるけど Django は初めてという初心者の方
Django を始めてみたけど今いちコツが掴めないという初級者の方
ベストプラクティスを学びたいと考えている中級者の方

を想定しています。

私自身 Django 歴がまだまだ浅い（仕事で６年ほど）ので上級者向けの本は書けませんが、Django の動作原理から実戦的な書き方まで、初級者向けの基礎知識として押さえるべき内容は全て網羅したつもりです。読者の皆さんに「Django って意外と簡単だな」と感じていただけることを目指して、基礎から詳しく丁寧に解説しています。

特に、

Django の日本語書籍が無くて困っている方
Django で一度挫折したことがある方

にオススメです。

「基礎 Django」を書いた理由は？

今回 Django 本を書いた理由はズバリ、「Django の日本語の書籍が少ない」からです。私自身、Django をずっと仕事で使っているのですが、日本語で書かれた良書が見つからず、結局「Two Scoops of Django」シリーズという海外の書籍（個人的に「ベスト・オブ・Django本」に認定）に辿り着いたわけですが、それだと初心者向けに薦める本としてはハードルが高過ぎるのではないかとモヤモヤを感じていたのです。Django の人気が今ひとつ上がらないのも、日本語の書籍が不足していることが大きな要因になっているのではないか、と思い立ったのがきっかけです。

　現場で使える「基礎 Django」｜あきよこブログ（技術書典4）

この状況を打破すべく、「無いのなら自分で書こう Django本」ということでまず私から書いてみることにしてみました。この本が版を重ね、将来「ベスト・オブ・Django本」と呼ばれるようになればという願いを込めて。

頒布本情報

B5サイズ、148ページ（１円玉より少し小さい 9.3 mm の厚さです！）。

技術書典での価格は 1,000円。
お釣りの煩雑さを考えての特別価格です（他のサークルさんもだいたい 1,000円にしているようです）。

部数は未定。

頒布場所は「く33」の「あきよこブログ」です。
見本誌を置いてますので、立ち読みだけでもお気軽にどうぞ。

f:id:akiyoko:20180415000417p:plain

秋葉原UDX、4/22（日） 11時オープンですが、午前中はどえらい混雑すると思いますのでご注意を。

今悩んでいること

来週月曜（4/16）が入稿の〆切で、そこで何部刷るかを決めなくてはいけません。

これまでの技術書典の売れ行きから考えて、200部くらい刷れば十分余るかな？と考えていたのですが、「万万が一早々に売り切れてしまって、欲しいという人が買えなかったら嫌だなぁ」という邪念がムクムクと出てきてしまっている状態がまさに今なのです。

後日、BOOTHで当日売り切れなかった紙の本（電子版はもし対応可能であれば）の販売をしようと考えているので、結構余ってもいいとは考えています。

もし反響があれば少し多めに刷ろうかなとも目論んでいたりしますが、どうなることやら。

何はともあれ、技術書典の当日（4/22）、秋葉原 UDX アキバ・スクエアまで遊びに来ていただければありがたいです！

ぜひ冷やかしにきてくださいませ。

*1:黄色の丸は「Django（ダンゴ）三兄弟」です。だいぶ古いな。。

↧

「現場で使える基礎 Django」ってどんな本？その読みどころをガッチリ解説

June 4, 2018, 3:51 pm

≫ Next: Django 1.11 と 2.0 の違い（「現場で使える基礎 Django」本の補講その１）

≪ Previous: 4/22 の「技術書典4」で「現場で使える基礎 Django」を頒布します

akiyoko です。

今回は、4月22日の「技術書典4」 *1で頒布した人生初の技術同人誌 『現場で使える基礎 Django』の概要と読みどころについて解説します。

現在、オンラインショップの「BOOTH」にて、増刷した紙の本を販売中です。*2　興味を持たれた方は、部数限定・売り切れ御免（再販予定なし）ですので、在庫があるうちにお買い求めいただければと思います。

ショップ側には入庫が完了している状態なので、すでに購入済みの方にはショップ側の検品が終わり次第、順次発送される予定です。

概要

どんな本？

この本は、B5サイズ・148ページの 本格的な Django 解説書です。

Django を仕事の現場で６年ほど使っている私が、日本語で書かれた書籍が少なくてずっと困っていたので自ら書きました。「現場でこんな本があったらなぁ」という想いで書いたので、仕事で使っているあなたにぴったりな本に仕上がっているはずです。

表紙はこんな感じです。
電車の中でも読めるようなものがよいと思い、派手さは極力抑えるようにしました。

f:id:akiyoko:20180531233638p:plain:w200

いわゆる「技術系同人誌」というジャンルの自費出版本になりますが、いたって真面目な技術解説書です。

表紙も含めて基本的に一人で作り上げました。レビューには Django 界隈から有志の方二人と、同僚二人に協力していただきました。スタートから入稿まで二ヶ月ほどで書きましたが、執筆にかかった時間は優に300時間を超えていると思います *3。

内容は？

目次はこのようになっています（クリックで拡大します）。

この本は、サンプルプロジェクトを実装ながら（読者によっては実際に手を動かしながら）技術要素を順番に説明していくような、いわゆるチュートリアル本ではありません。Django の全体像から構成要素の詳細まで、基本動作やハマりやすいポイントについて幅広く解説した本です。読者の方々に「Django って意外と簡単だな」と感じていただけることを目指して、基礎から詳しく丁寧に解説しています。

本書の構成としては、第 3 章までで Django の全体像や重要な概念の説明をおこない、第 4 章以降でそれぞれの構成要素の説明をしながら、私の知見や経験から得たベストプラクティスについても紹介しています。

f:id:akiyoko:20180526163355p:plain:w250

対象読者

本書の対象読者としては、

Python の文法はある程度分かるけど Django は初めてという初心者の方
Django を始めてみたけど今いちコツが掴めないという初級者の方
Django のベストプラクティスを学びたいと考えている中級者の方

を想定しています。特に、

Django の日本語書籍が無くて困っている方
Django で一度挫折したことがある方

にピッタリな再入門書にもなっていると思います。
しかしながら、Webアプリケーション開発の経験がまるっきり無いという方には多少難しい内容になっているかもしれません。

本の評判

日本語のまとまった情報が少ないということでやはりニーズが高かったのでしょうか、技術書典4 では（強気で刷った）300部が３時間ほどで完売してしまいました。当日は初参加の上に予想をはるかに超えた売れ行きにてんてこ舞いで、全く余裕がありませんでした。

Twitter に上がっていた Django 本の感想を勝手にピックアップさせていただきました。おおむね好評のようで、ほっとしました。

技術書典で買って今半分ぐらいまで読んだんだけど、これはヤバイ。ヤバいものを見つけたという感じ。クオリティがあまりにもあまりにも高すぎる。やべぇ。Django情報量がなぁ…とか思ってたけどこれあれば全く問題ないと思わせるほど。
ヤバい(語彙力がヤバい)
— くしゃみ (@kusyami_p) 2018年4月22日

現場で使える基礎 Django akiyoko さん

1年前に欲しかった……と思いながら見本を見て購入。Djangoって本当にいいフレームワークだと思うんですよ。

いつも雰囲気で使ってるMiddlewareや、あとわたしの好きなFormオブジェクトの解説も充実。すごくいいです。
— 515ひかる@求職中 (@515hikaru) 2018年4月22日

この本は昨日買って読んだけど良かった。これとアイスクリームの本を読めばDjangoで実用的なものが作れるかと思う。 https://t.co/UFWNx1vm61
— okazaki jun (@dario_okazaki) 2018年4月23日

技術書典4で買ったものいくつかあるけど、その場で見かけてふらっと買った「現場で使える基礎Django」がなかなかの当たりでした https://t.co/kCS8vmEGmZ
— Yoshiaki NAKANISHI (@chun_ryo) 2018年4月24日

#技術書典4で購入したDjango本、ものすごいクオリティ。しかも本格的に書き始めたのが２月下旬だと。。。
— R.Miyaji (@try0forpin) 2018年4月24日

サークル詳細 | あきよこブログ | 技術書典 https://t.co/bXHkd2SD3E
今読み進めているけど技術書典4において1,2を争うレベルで有用な戦利品だった。PythonでWものづくり(Webアプリ開発)したいと思っている人は皆読めばいいと思う
— hassaku (@hassaku_63) 2018年4月30日

本を買っていただいた上に感想までブログに書いてくださった心優しい方も何人かいらっしゃいました。本当にありがとうございます。こちらも勝手に貼り付けさせていただきます。

匿名の読後アンケートフォームを用意して感想を聞かせていただいたのですが（現在も絶賛募集しているので是非とも感想をお願いします）、その結果もおおむね良かったようです。改善すべき点としてご指摘いただいた部分については（すでに v 1.0.1 で対応したものもありますが）今後の改訂や補足ブログのネタにさせていただきたいと思います。

読みどころ

章ごとの簡単な解説をしながら、本書の読みどころについて書いていきます。

第1章：はじめに

1.1  なぜ今 Django なのか?
1.2  本書について
1.3  動作環境と各種バージョン
1.4  まとめ

短く書きたかったのですが、勢い余って長くなってしまった序章。

機械学習などで Python を使う人が増えているので、Django もどんどん盛り上がってくるよねという書き出しだったのですが、実際、私がよく参加させていただいている fin-pyでも「Django の勉強がしたい」という声がちらほら聞こえていましたし、最近では日本では初めての DjangoCongressが今年5月に開催されるなど、本格的な盛り上がりを感じます。

Django に少し詳しい人なら気になるのが、Django のバージョンでしょう。結論から言えば、仕事で使うなら今はまだ「1.11 LTS」、趣味で使うなら「2系」を使えばよいと考えています。この本では仕事の現場にフォーカスしたので「1.11」推しとなっていますが、実際には 1.11 と 2.0 はそんなに違いがありません（Python 2 のサポートが切られたことを除いて）。これについては追々、補足のブロク記事で解説したいと思います。

Python は 3.5系で動作確認しましたが、これは 3.6系でも特に問題ないはずです。改訂するのであれば、3.6系を前提に書きたいと考えています。

第2章：アーキテクチャ

2.1  全体像
2.2  MTVフレームワークとは?
2.3  まとめ

何事にもまずは全体像から掴んだ方が理解しやすいので、大枠から解説。ビューやフォーム、モデルなどの構成要素（コンポーネント）がどのように連携しながら動作しているのかを、図を見ながらざっくりと理解することができます。

第3章：プロジェクト構成

3.1  プロジェクトとアプリケーション
3.2  django-admin.py と manage.py
3.3  よくあるプロジェクト構成
3.4  ベストプラクティス1: 分かりやすいプロジェクト構成
3.5  まとめ

本章の読みどころは、startproject コマンドや startapp コマンドを使って自動生成されたファイルの説明と、分かりやすいプロジェクト構成についてです。 *4

第4章： URL ディスパッチャと URLconf

4.1  概要
4.2  URLconfの書き方
4.3  ベストプラクティス2: アプリケーションごとに urls.py を配置する
4.4  まとめ

リクエストをビュー関数に振り分ける「URLディスパッチャ」と、リクエスト URLとビュー関数をマッピングしている「URLconf」（URL設定）についての解説です。URLconf については 2系で書き方が新しくなる（ただし 1系の書き方も継続して使える）ので、そちらは補足ブログで追記したいと考えています。

第5章：ビュー（View）

5.1  概要
5.2  ビュー関数の書き方（関数ベース vs クラスベース）
5.3  全ての基本となる基本汎用ビュー
5.4  シンプルでよく使う基本汎用ビュー
5.5  さまざまな用途に特化した汎用ビュー
5.6  ログイン・ログアウトについて
5.7  まとめ

本書では、関数ベースのビューについてはほとんど説明しておらず、クラスベースビューを中心に解説しています。クラスベースビューを使う理由やメリットについてももちろん書いていますし、デメリットである継承の複雑さやオーバーライドできるメソッドや変数がどうなっているかについては、解決のヒントを提示しています。

この章に書いた、Django でのログイン・ログアウト処理は実はややこしいのですが、よく分かっていなかった人もこれを読めばだいぶスッキリすると思います。

第6章：モデル（Model）

6.1  概要
6.2  モデルクラスの書き方
6.3  「一対一」「多対一」「多対多」リレーションはどう定義するか?
6.4  よく使われるUserモデル
6.5  モデルマネージャとクエリセット
6.6  単体のオブジェクトを取得する
6.7  複数のオブジェクトを取得する
6.8  単体のオブジェクトを保存・更新・削除する
6.9  ベストプラクティス3: Userモデルを拡張する
6.10  ベストプラクティス4: 発行されるクエリを確認する
6.11  ベストプラクティス5: select_related / prefetch_related でクエリ本数を減らす
6.12  まとめ

便利だけど実はいろいろとややこしい、そんなモデルを分かりやすく解説しています。

この章は本書で最もページ数を割いたトピックですが、なぜそんなにページ数を割いたかというと、個人的にモデルが Django 最強の武器（そして最も厄介な諸刃の剣）だと考えているからです。Django を使う場合は DB を使わないことは少ないと思いますので、モデルの仕組みを理解するのは必須でしょう。

モデルの設計で重要な「一対一」「多対一」「多対多」のリレーションについては、基本から説明しています。分かりにくいモデルマネージャとクエリセット、遅延評価、関連先モデルの JOIN についても詳しく説明しています。発展編として、あまり知られていない（と思われる）「select_related」「prefetch_related」の使いどころや実際に発行される SQL 文を確認する方法についても解説しています。

またこの章では、Django の User モデルについても解説。ややこしい継承関係や User モデルのカスタマイズ方法についても取り上げています。

第7章：テンプレート（Template）

7.1  概要
7.2  変数表示
7.3  フィルタ
7.4  テンプレートタグ
7.5  ベストプラクティス6: ベーステンプレートを用意する
7.6  まとめ

Django がデフォルトのテンプレートエンジンとして利用している「DTL（Django Template Language）」の記法について解説（Jinja2 については解説していません）。数あるフィルタやテンプレートタグの中からよく使うものをピックアップして紹介しています。

第8章：フォーム（Form）

8.1  概要
8.2  バリデーションの仕組み
8.3  フォームクラスの書き方
8.4  ビューやテンプレートからフォームを利用する方法
8.5  CSRF対策について
8.6  ベストプラクティス7: こんなときは ModelForm を継承しよう
8.7  まとめ

ユーザーの入力データを保持するためのフォームですが、やはりキモとなるのはバリデーションですよね。フォームでは is_valid() を起点としてさまざまなメソッドが順番に呼ばれますが、そのややこしいバリデーションのフローを図を使って分かりやすく解説しています。また、さらにややこしい ModelForm についても何とか一枚の図にまとめてみました。必見です。

エラーに悩まされた方も多いであろう、CSRF対策（csrf_token）についてもこの章で解説しています。

第9章：ミドルウェア（Middleware）

9.1  概要
9.2  主なミドルウェアの役割
9.3  ミドルウェアの書き方
9.4  ベストプラクティス8: メッセージフレームワークを使う
9.5  まとめ

Django のミドルウェア、何となく使ってませんか？

見逃されがちなミドルウェアですが、実は縁の下の力持ちなんですよね。ということで、新規プロジェクト作成時にデフォルトで設定されるミドルウェアの役割や必要性などについて解説しています。

また、便利なメッセージフレームワーク（いわゆるフラッシュメッセージ）については、注意点やちょっとした TIPS とともにベストプラクティスとして解説しています。

あと、1.11 から導入されたミドルウェアの新しい書き方についても言及しています。django.utils.deprecation.MiddlewareMixin を継承する書き方は非推奨にマークされているので、要注意です。

ミドルウェアについてここまできちんと書いている Django の書籍は、おそらくこれまで無かったと思います。

第10章：設定オブジェクトと設定ファイル（settings.py）

10.1  概要
10.2  インストールするアプリケーション一覧
10.3  デバッグ設定
10.4  静的ファイルパス関連の設定
10.5  ロギングの設定
10.6  その他の重要な設定
10.7  ベストプラクティス9: 個人の開発環境の設定は local_settings.py に書く
10.8  ベストプラクティス10: シークレットな変数は .env ファイルに書く
10.9  まとめ

実はこの章が本書の一番のウリかもしれません。匿名の読後アンケートでも最も評価が高かった章の一つでもあります。

Django でつまづくパターンとして、settings.py によく分からない設定がたくさん羅列してあるのを見たり、runserver を動かしたときに何だか分からないエラーが出たりして途方に暮れる、というのがあるのではないでしょうか。あるいは、「この設定って何が正解？」「動いたけどこのままでいいんだろうか？」と悩みながら何となく使っているのではないでしょうか。

また、

「INSTALLED_APPS」にはアプリケーション名を書くべきか、それとも apps.py の AppConfig のサブクラスを書くべき？
静的ファイルパス関連の「STATIC_URL」「STATIC_ROOT」「STATICFILES_DIR」の違いは一体何なの？
「SECRET_KEY」や「ALLOWED_HOSTS」って何に使うの？
「LOGGING」は具体的にどう設定すればいいの？

など疑問は尽きないと思います。この章ではこれらの疑問に全てお答えしています。

そして現場で利用するなら必須のベストプラクティスとして、本番用の settings.py と個人開発用のものを分けるための方法や、シークレットな変数値を環境変数に分離する方法などについても解説しています。

第11章：データベースのマイグレーション

11.1  概要
11.2  マイグレーションコマンドについて
11.3  まとめ

マイグレーションについての説明は短め。実際の運用ではもう少しディープな理解が必要かもしれませんが、紙面の都合で割愛しました。

第12章：開発用 Web サーバ（runserver）を起動する

12.1  概要
12.2  runserver コマンドについて
12.3  まとめ

開発用の Web サーバ（runserver）の特徴や使い方、Docker で利用する場合の注意点について書きました。こちらも割とシンプルにまとめています。

第13章：管理サイト（Django Admin）

13.1  概要
13.2  モデルの登録方法
13.3  一部機能のカスタマイズ方法
13.4  利用条件
13.5  使い方
13.6  まとめ

Django の便利な点として、この管理サイト（Django Admin）が挙げられるかと思います。ログインできるユーザーや権限などの利用条件、一部機能のカスタマイズ方法など、少し詳しめに解説しています。

第14章：便利な Django パッケージを使おう

14.1  概要
14.2  DRY系パッケージ
14.3  開発補助系パッケージ
14.4  まとめ

実際に開発する際にほぼ必須の知識になってくる「Django パッケージ」について、選定のコツや私のオススメするパッケージをいくつか紹介しています。

第15章：サンプル実装

「本のオンラインショップ」をテーマに、ログイン・ログアウトまわりを中心に実装したサンプルプロジェクトです。本書で説明したことをベースにしたサンプル実装になっており、コードには日本語の説明をなるべく多く書きました。紙面の都合でコードの掲載はカットし、その代わりにソースコードのURLを載せています。

付録

付録A： macOS における Django 開発環境の構築方法
付録B： Docker でラクラク開発
付録C： 覚えておきたい Django 管理コマンド 10 選

ローカルPC への Python の導入方法については、技術書典バージョンでは Anaconda を使った方法について書いていましたが、読者の方からの指摘を受けて、「v1.0.1」（BOOTH での６月以降販売分）ではよりシンプルな方法に修正しています。また、Django の開発環境についても PyCharm をベースにしたものに書き直しました。

あと、自分でも最近取り入れて良かったと思っているのが「Docker でラクラク開発」です。ローカルPCの環境を汚すことがなく、要らなくなったらすぐに環境を作り直せるので、開発や検証が容易になります。

おわりに

「現場で使える基礎 Django」ってどういう本なの？買うべきなの？と悩んでいる人向けに、この本はどういう本なのか、誰にピッタリな本なのかを解説してみました。

仕事の現場で使っている人を主なターゲットにしていますが、仕事ではなく趣味で使ってるという方や、2系の情報が知りたいという方にも有益な情報がたくさん含まれているはずですので、是非ともお手にとっていただければと思います。よろしくお願いします。

《販売サイトはこちら》
booth.pm

おまけ

DjangoCongressJP 2018 の一日目に一般参加したのですが、偶然にも LT で発表させていただく機会を得て、「Django の同人誌を書いた話」というテーマで登壇しました。

意外と小心者なので、テンパって噛みまくりでお聞き苦しかったかと思います。その節は大変失礼いたしました。

*1:春と秋の年二回ずつ開催される、技術者による技術者のための技術系同人誌の販売イベント。今回は4回目の実施となり、参加者は6,000人を超えました。 https://techbookfest.org/event/tbf04

*2:技術書典4で頒布したものから少しだけ改訂した「v1.0.1」バージョンになります。ページ数は同じです。

*3:多忙な時期とも重なり、本当に死ぬほど疲れました。。

*4:しかしながら、これがベストか？については異論あると思います。もう少し複雑になった場合の本格的なプロジェクト構成について、もし続編を書くのであればこのあたりも補足してみたいと考えています。

↧

Django 1.11 と 2.0 の違い（「現場で使える基礎 Django」本の補講その１）

June 15, 2018, 12:18 am

≫ Next: 無料版 PyCharm で Django 開発環境を構築するまでの手順（「現場で使える基礎 Django」本の補講その２）

≪ Previous: 「現場で使える基礎 Django」ってどんな本？その読みどころをガッチリ解説

akiyoko です。
この記事では、私が執筆した Django の同人誌「現場で使える基礎 Django」で説明しきれなかった部分の加筆・補足をします。まだ本を読んでいない方にも読める記事になっていると思いますので、ご安心を。

今回は、「Django のバージョン」、とりわけ「Django 1.11 と 2.0 の違い」について取り上げます。

「現場で使える基礎 Django」の表紙に書かれた「1.11 LTS 対応」という文字を見て、「なーんだ、最新の Django 2 じゃないのかよ！」と敬遠している貴方のためにせっせと書き上げました。

《宣伝》

「現場で使える基礎 Django」は現在、増刷して絶賛発売中です！
booth.pm

Django のバージョンについて

昨年2017年12月に、Django 2.0 がリリースされました。
Wikipediaによると 1.0 がリリースされたのが2008年9月なので、実に9年3ヶ月ぶりのメジャーバージョンアップとなりました。

それから半年ほど経ちましたが、現場ではまだ1系と2系が混在している、いわば過渡期の状況ではないでしょうか（あくまで私の肌感覚ですが）。

理由は３つほど考えられます。

【理由その１】

まずは、LTS の問題です。LTS とは「Long-Term Support」の略で、開発コミュニティからセキュリティパッチが長期間提供される特別なバージョンのことを指します。その点、Django 2系はまだ LTS バージョンがリリースされていません。LTS として予定されている「2.2」のリリースは 2019年4月となっており、まだ 10ヶ月ほど先になっているのが、2系へのバージョンアップに踏み切れない理由の一つに挙げられます。

f:id:akiyoko:20180531235800p:plain:w500 — Django のバージョンごとのサポート状況

（画像は https://www.djangoproject.com/download/より引用）

すでに次期 LTS の「2.2」のロードマップも細かく決まっていて（多少ずれるようですが）、2019年の4月にリリースされることが予定されています。

予定日	詳細
2019年1月14日	Django 2.2 アルファ版; 追加機能凍結
2月15日	Django 2.2 ベータ版; バグフィックス凍結（致命的なバグ対応は除く）
3月15日	Django 2.2 RC 1（リリース候補）; 翻訳凍結
4月1日まで	Django 2.2 正式版

（https://code.djangoproject.com/wiki/Version2.2Roadmapより）

なお、1系のマイナーバージョン「1.12」はリリースされないことが決まっているため、「1.11」が 1系で最後のマイナーバージョンとなります。1系の最新バージョンは本記事の執筆時点で「1.11.14」となっています。

ということで、ビジネスで利用するとなると公式サポートが長い 1系がまだまだ主役の場合が多いのではないでしょうか。実際、現場の動きとしては「早く 2系へ移行しなければ！」という切迫感はまだあまり感じられません。

【理由その２】

次に、「Django 2系が Python 2のサポートを打ち切った」というのも、Django 2 への移行を阻害している大きな要因になっているのではないかと考えています。例えば、Python 2 で実稼働している Django 1系のプロジェクトでは、直ちに 2系にバージョンアップできない事情もあるでしょう。

【理由その３】

最後に、状況によっては利用しているライブラリが Django 2 にまだ対応していないということも考えられます。

結論として、現時点では、仕事の現場で使うなら「1.11 LTS」（2.2 LTS に向けて 2.0 から追従していくなら 2系でもOK）、趣味や研究で利用するなら「2系」を使えばよいと私は考えます。

ここで、実際の Django のバージョン別の利用状況を見てみましょう。

5月に開催された DjangoCongress JP 2018で発表された事前アンケートの結果によると、Django 各バージョンの利用状況は以下の通りでした。

f:id:akiyoko:20180530221907p:plain:w300
（DjangoCongress JP 2018 事前アンケート画像を akiyoko が編集）

Django バージョン	利用率
1.8 以前	約 12 ％
1.8 LTS	約 20 ％
1.9〜1.10	約 21 ％
1.11 LTS	約 24～25 ％
2.0	約 22～23 ％

2.0 の利用率が22～23 ％にとどまっているという結果は要注目です。私の率直な感想は「意外と少ないなぁ」でした。半分まではいかないとしても、もう少し多いのかなと予想していました。もちろんアンケート自体は何ヶ月か前から収集していたはずなので、現時点での数値とは多少の開きがあるとは思いますが。

Django 1.11 と 2.0 の変更点

Django 2.0 のリリースノートには、1系の最終バージョンである「1.11」から「2.0」への変更点が記載されています。

大きな変更点としては、

Python 2 のサポートが打ち切られた
URLconf の書き方が簡単になった（django.urls.path() が追加）
モデルの ForeignKey と OneToOneField で「on_delete」オプションが必須に

が挙げられるでしょうか。後で詳しく説明します。

それ以外の細かな変更点のうち個人的に気になったところを以下にズラズラと挙げましたが、ぶっちゃけ、そこまで大きな変更点はありません。一番インパクトが大きいのはやはり、上で挙げた「Python 2 のサポート打ち切り」でしょう。

ミドルウェアを settings.py で設定する際の変数「MIDDLEWARE_CLASSES」が廃止（「MIDDLEWARE」を使う）
User.is_authenticated() と User.is_anonymous() がメソッドではなく、属性になった
管理サイトの画面がレスポンシブ対応に
Window 関数の OVER 句に対応
- MySQL では 8.0.2 以降で対応
MySQL でクエリ内の「__search」ルックアップが使えなくなった
MySQL のトランザクション分離レベル（isolation level）のデフォルトが「read committed」に。1系では「repeatable read」だった
runserver で立ち上がるサーバが HTTP/1.1 に対応
django.conf.urls.include() の namespace を指定するときは、インクルード先の URLconf に app_name の指定が必須になった
- app_name が指定されてあって、且つ namespace を include の引数として指定すると、値を上書きできるっぽい
django.conf.urls.include() の app_name 引数がなくなった
カスタムテンプレートタグがキーワード引数のみを許容
handler404 などのハンドラがコーラブルに（1系ではドット区切りの文字列だった）
バイト文字列はインプット・アウトプット以外の部分では扱わないようになった　*1
AbstractUser.last_name の max_length が 150 に増えた（これまでは 30）
クエリをスライシングした後に QuerySet.reverse() や last() ができなくなった
外部キー制約が SQLite でも有効に
QuerySet.iterator() が一度に取得する行数が 100 から 2000 になった

ここに挙げたものの中には検証していないものも多々ありますので、誤訳や誤解がありましたらご指摘いただけるとありがたいです。

大きな変更点として挙げた３点について、詳しく説明していきます。

1. Python 2 のサポート打ち切り

先に述べた通り、Django 2.0 では Python 2系のサポートが打ち切られました。Django 2 を使う場合には、Python 3.4 以降が最低限必要になります。Django 1.11 および 2.0 がサポートする Python のバージョンをまとめたものが以下の表になります。

	Python 2.7	3.4	3.5	3.6
Django 1.11	○	○	○	○
Django 2.0	ー	○	○	○

（Python 2 系をサポートする最後のバージョンである）Django 1.11 LTS のサポートは早ければ 2020年4月に終了、Python 2.7 自体のバグフィックスのサポートは2020年1月に終了するので、Python 2 を使っているプロジェクトは2019年末までには3系への移行を済ませる必要があります。

Python 2 で苦労した私としては、Python 2 のサポートをバッサリ切ったことはかなり嬉しいのですが、対応に追われるプロジェクトも今後出てきて大変そうだなという印象です。　*2

2. URLconf の書き方（URL ルーティングのシンタックス）

Django 1系では、正規表現の URL ルーティングは django.conf.urls.url() 関数を使って

from django.conf.urls import url

...（略）...
url(r'^articles/(?P<year>[0-9]{4})/$', views.year_archive),
url(r'^shop/(?P<book_id>\d+)/$', views.detail, name='shop_detail'),

というシンタックスで書いていましたが、新しく追加された django.urls.path() 関数を使って

from django.urls import path

...（略）...
path('articles/<int:year>/', views.year_archive),
path('shop/<int:book_id>/', views.detail, name='shop_detail'),

と簡潔に書くことができるようになりました。
django.conf.urls.url() を使った書き方は、Django 2.0 でもそのまま使えるように互換性が保たれていますし、同じ用法で使える django.urls.re_path() が追加されたのでそれを使って書き直してもよいと思います。

3. ForeignKey と OneToOneField で「on_delete」オプションが必須に

モデルの ForeignKey と OneToOneField で「on_delete」フィールドオプションが必須になりました。このあたりは、「現場で使える基礎 Django」の中でもしっかり説明してあります。

ここで、細かな変更点のうち、Windows 関数のサポートについても少し説明を加えておきます。

Window 関数について

Windows 関数は、あるまとまったデータ群（Window で区切られた集合）に対して集計処理をするための機能です。ランク付け（RANK 関数を使う）が一番理解しやすいでしょうか。なお、全ての Window 関数には「OVER句」が必要になります。

（参考）[SQL] 最強の分析ツールと言われるWindow関数について私が学んだこと｜ Developers.IO

Window 関数自体は、PostgreSQL や Oracle では以前からサポートされていましたが、MySQL では 8.0.2 以降で導入されています。なお、Django 組み込みのバックエンドも PostgreSQL、Oracle、MySQL（8.0.2以降）で Window関数をサポートしていますが、データベースの種類と関数によってはサポートが異なる場合もあるとのことです。　*3

最後に、MySQL のトランザクション分離レベルについて調べたことを書いておきます。

MySQL のトランザクション分離レベルについて

「tree-tips: MySQLのトランザクション分離レベル | MySQL」に簡潔にまとめられていたのですが、1系でデフォルトだった「repeatable read」は 2系でデフォルトになる「read committed」に比べて「ファジーリード」（他セッションがコミットした更新データを参照してしまう）や「ファントムリード」（他セッションがコミットした追加データを参照してしまう）は起きないが、性能は「read committed」の方がよい（バージョン管理の範囲が狭くなるため）とされています。

MySQL 自体のデフォルトの分離レベルは MySQL5.6の公式ドキュメントによると「repeatable read」で、8.0 でも変わりません（変わるという噂もあるようですが）。それに対して、Oracle、PostgreSQL、SQL Server などでは「read committed」がデフォルトとなっています。

（参考）

そもそも 2.0 へのバージョンアップは必要なのか？

さて、そもそも 2.0 へのバージョンアップは必要なのでしょうか？

パッケージをアップデートする理由は、

新しいバージョンで導入された新しい機能や改善点を利用したい場合
バグ修正によるリスク減少
セキュリティパッチのサポート延長
一気にバージョンアップすることのコストを抑える
- 例えば、LTS から LTS への大ジャンプはコストが掛かるため、普段から出来るかぎり最新バージョンに追随しておく
依存しているパッケージ・言語のサポートの問題

などが考えられます。　*4

しかしながら、これらのメリットが無いのであれば、現在使っているパッケージを無理にバージョンアップさせなくてもよいでしょう。バージョンアップしなくても、例えば、特定箇所のバグ修正であれば手動でバックポートすることで対応できることもあります。

最後に

最後に一番大事な話。
4月に「技術書典4」で販売して即完売した「現場で使える基礎 Django」が、現在増刷して絶賛発売中です！

対象バージョンは「Django 1.11 LTS」となっていますが、この記事で説明したように、Django の「1.11 LTS」と「2.0」は（Python 2 のサポート以外は）それほど大きな変更点はなく、「2.2 LTS」がまだリリースしていないため様子見が必要ということを踏まえると、もう買うしかないという気持ちになってきたはずですよね。

*3:Query Expressions | Django documentation | Django

この本は B5サイズ・148ページの本格的な Django 解説書ですが、Django を仕事の現場で６年ほど使っている私が「現場でこんな本があったらなぁ」という想いで書いたので、仕事で使っているあなたにぴったりな本に仕上がっているはずです。
そしてこの本は特に、

Django の日本語書籍が無くて困っている方
Django で一度挫折したことがある方

に絶対オススメの一冊となっています。

過去記事で読みどころの解説や読者の方々の評価を紹介していますので、気になる方はこちらも合わせてご覧ください。

《過去記事》
akiyoko.hatenablog.jp

*1:困っている人は「Django 2.0へのアップデート (Removed support for bytestrings編)」の記事が参考になるはず！

*2:他人事ではないのが恐ろしいところ。。

*4:Upgrading Django to a newer version | Django documentation | Djangoを参考

↧

無料版 PyCharm で Django 開発環境を構築するまでの手順（「現場で使える基礎 Django」本の補講その２）

June 17, 2018, 2:26 am

≫ Next: 仮想通貨税金計算サービス「BITCOINTAX」をリリースしました

≪ Previous: Django 1.11 と 2.0 の違い（「現場で使える基礎 Django」本の補講その１）

akiyoko です。
この記事では、私が執筆した Django の同人誌「現場で使える基礎 Django」で説明しきれなかった部分の加筆・補足をしています。まだ本を読んでいない方にも読める記事になっていますので、ご安心を。

補講その２として今回は、「無料版 PyCharm で Django 開発環境を構築するまでの手順」について取り上げます。

記事の前半で「PyCharm」の概要や利点、「Professional 版」と「Community 版」（「CE」と略されます）のエディションの違い、Professinal 版のライセンスと料金体系を説明し、後半で無料版の「PyCharm CE」を使って Django の開発環境を構築するまでの手順を解説します。

同人誌を購入済みの方のために補足すると、技術書典4 で頒布したバージョン（v1.0.0）の「付録A：macOS の Python 3 環境構築の方法」や 6月以降に再販したバージョン（v1.0.1）の「付録A：macOS における Django 開発環境の構築手順」とは若干手順が異なっていますので、すでにお読みの方はご注意ください。改訂箇所は以下の通りです。

（使う必然性がなかったので）Anaconda を使わないように改訂（v1.0.1）
初心者でも簡単に環境構築できるように PyCharm CE を使うやり方に改訂（v1.0.1）
説明を簡便にするために、Python をインストールするまでの手順を省略（本記事）
インストールする Python のバージョンを 3.5.2 → 3.6.5 に変更（本記事）

本ブログ記事では長々と書いていますが、同人誌ではスッキリと書いていますのでご安心ください。

《CMコーナー》
「現場で使える基礎 Django」は現在、増刷して絶賛発売中です！
booth.pm

PyCharm とは

「PyCharm」は「統合開発環境」（IDE）と呼ばれる開発ツールで、Python で開発をする際にいろいろと便利な機能を利用することができます。仕事の現場でメモ帳を使って開発するとあまりにも非効率なので、このようなツールが一般的に使われています。

JetBrains社の IDE では Java 向けの「IntelliJ IDEA」や、PHP 向けの「PhpStorm」が有名ですが、Python 向けの IDE が「PyCharm」という位置付けになっています。私は、Python 開発にはもっぱらこの「PyCharm」を愛用しています。

メリットとデメリット

私が Python の開発に PyCharm を使う理由は、以下の点が気に入っているからです。

コードジャンプ機能と自動整形機能を使うことで開発効率が著しく向上する
インストールしたそのままの状態で快適に使える

その他にも以下のようなメリットがあり、Python があまり得意でない方にも便利に使うことができるのも魅力です。

「venv」（仮想環境を作成するためのモジュール）や「pip」（パッケージ管理ツール）のコマンドの使い方が分からなくても、PyCharm の画面からポチポチと操作できる
Windows 版も Mac 版もだいたい同じ操作性や見た目になるのでナレッジが共有しやすい

現時点でのデメリットとしては、例えば以下のものが挙げられるかと思います。

一部機能が有料の Professional 版でないと使えない（後述します）
現時点で Pipenvに未対応　*1
conda を使っている場合に PyCharm の画面からパッケージがインストールできない不具合がある（？）

PyCharm 関連でよく話題に上がるのが、エディションとライセンス、そして料金体系です。

エディション（Professional 版と Community 版の違い）

PyCharm には有料の「Professional」版と無料の「Community」版（CE）とがあり、Community 版では一部機能が使えないといった制限があります。
機能の比較表が以下になります。 *2

f:id:akiyoko:20180616115941p:plain
（Features - PyCharmより引用）

この中で私が考える Professional 版のメリットはズバリ、以下の三点です。

ファイルの同期とリモートデバッグ（Remote development capabilities）
データベースのサポート（Database & SQL support）
Django などの各種フレームワークのサポート（Python web frameworks）

まず、「ファイルの同期とリモートデバッグ」は、私が Professonal 版を選んでいる一番大きな理由です。ファイルの同期とはその名の通り、Vagrant や AWS の外部サーバに SFTP 等で自動的にファイルを同期してくれる機能で、実サーバで動作検証する際に非常に便利に使うことができます。リモートデバッグとは、サーバで動作させている Django のプロセスをブレークポイントで止めて IDE 内でステップ実行できる便利機能です。pdbを使ってコンソールでデバッガを使うのと比較して、見慣れた環境でデバッグできるのため効率が劇的に上がります。

二点目の「データベースサポート」は、IDE 内でデータベースのレコードを表形式で表示したり、表のセルを更新することでレコードを直感的に変更できたりと、データベースの操作を IDE 内で統合的に使えるようにしてくれる機能です。
f:id:akiyoko:20180616163255p:plain
SQLite については良さげなクライアントツールがないので個人的にこの機能は重宝していますが、例えば MySQL であれば Sequel Pro、PostgreSQL であれば「PSequel」などのクラアンとツールがあれば特に必要ないとは思います。あと、ER図の作成機能があるので、プロジェクトによってはニーズはあると思います。

最後の「Django などの各種フレームワークのサポート」ですが、例えば Django の場合であれば、テンプレートエンジンに合わせたシンタックスのハイライトや、ファイルに合わせたコード補完をサポートしてくれます。これらの機能はあればもちろん便利なのですが、私の感覚では必要不可欠とまでは言えないように感じています。詳しい情報は「Web Development and Django Support - Features | PyCharm」を参考にしてください。

ちなみに後述する通り、学生は無料で Professional が使えるので、問答無用で Professional 版を利用すればよいと思います。

ライセンスと料金体系

以降で、Professional 版のライセンスについて説明します。

2017年以降はそれまであった「永久ライセンス」は無くなり、「サブスクリプションライセンス」方式になりました。PyCharm のサブスクリプションは、継続年数によって値段が異なるので少しややこしいです。また、基本は年払いですが、初年度に限り月払い（継続課金）も可能です。 *3

ライセンスは、PC1台ごとではなく、ユーザー1人ごとの料金になっています。ライセンスが1つあれば複数マシンで（別のOSでも可）利用できるのは嬉しい限りです。ただし、同一のユーザーが使うという前提でなければいけません。 *4

次に、コマーシャルライセンスとパーソナルライセンスの違いについて説明します。両者に機能的な差はありません。目的（開発するものが企業の製品・サービスなのか否か）によって、そのライセンスが異なります。パーソナルライセンスは、個人用に使うため（企業ではなく自分のお金で自分のために使う）のものですが、商用サービスの開発にも使えるとのことです。 *5　企業の業務内で利用する場合はコマーシャルライセンスを使いましょう、とのこと。 *6

そして気になる料金体系はこちら。
正確な値段については、公式サイトを適宜ご確認ください。

【パーソナル（個人）ライセンス】　*7

継続年数	料金（年額）
1年目	89.00 USドル /年
2年目	71.00 USドル /年
3年目以降	53.00 USドル /年

【コマーシャル（企業）ライセンス】　*8

継続年数	料金（年額）
1年目	199.00 USドル /年
2年目	159.00 USドル /年
3年目以降	119.00 USドル /年

また、大学のメールアドレスなど何らかの証明が必要となりますが、学生であれば無料で Professional 版が利用できます（PyCharm だけでなく JetBrains 社の全製品が無料になります）。 *9

私は個人的に有料の Professional版を利用していますが、以降で説明する内容は無料の Community 版でも問題なく動作させることができますのでご安心ください。

Django 開発環境を PyCharm CE で構築するまでの手順

手順の解説

今回の手順について、全体像となぜそのようにするのかをＱ＆Ａ形式で説明します。

まず、全体像はこちらになります。

f:id:akiyoko:20180617162502p:plain

1．Python 3 をインストール

Ｑ．Python 3 のバージョンは何を選べばよい？
Ａ．3.6 系の最新安定版（執筆時点の最新版は「3.6.5」）を選ぶのがよいです。しかしながら 3.5 系でも Django を使う上では特に問題ないと思います。バージョン 3.6 と 3.5 の違いについては以下を参考にしてください。

（参考）
What's New In Python 3.6 — Python 3.6.6rc1 ドキュメント
Python3.6の新機能
Python 3.6 の（個人的に）注目の変更点 - methaneのブログ

Ｑ．Python 3 はどうやってインストールすればよい？
Ａ．Python 公式サイトからダウンロードしてインストールするのが一番簡単です。macOS の場合は、Python のバージョンが簡単に切り替えられるように Pyenvというツールを使ってインストールすることをオススメしますが、やや手順が面倒になります。同人誌の付録では Pyenv を使ってインストールする手順についても説明しています。

Ｑ．venv とは？
Ａ．仮想環境作成モジュールです。Python 3.3 以降では「venv」が標準で付属しており、Python 3.5 以降は仮想環境を作成するのに（「virtualenv」や「pyvenv」ではなく）「venv」が推奨されています。 *10

Ｑ．pip とは？
Ａ．Django などの Python パッケージをインストール・アンインストールするためのパッケージ管理ツールです。Python 3.4 以降では「pip」が標準で付属しています。 *11

2．PyCharm をインストール

Ｑ．なぜ PyCharm を使うの？
Ａ．開発しやすいのが一番の理由です。そのほか、「venv」（仮想環境を作成するためのモジュール）や「pip」（パッケージ管理ツール）に詳しくなくても PyCharm の画面をポチポチ操作するだけで仮想環境を作れたり、ライブラリをインストールしたりできるので、初心者にも優しいツールになっています。

Ｑ．初期設定は？
Ａ．PyCharm は「out of the box（箱から取り出してすぐに使える、難しい設定などは一切なしで使える）」というのが大きな魅力のひとつですので、インストール直後の状態でほとんどそのまま使えます。より開発しやすくするための最低限の設定については、拙ブログの過去記事「 PyCharm のオレオレ最強設定 - akiyoko blog」を参考にしてください。

3．PyCharm プロジェクトを作成

Ｑ．PyCharm プロジェクトを作成するときに何を指定すればよい？
Ａ．ワークスペースのディレクトリのパス、仮想環境のディレクトリのパス、Python インタープリタのパスを指定します。ワークスペース以外はプロジェクト作成後でも指定できますが、プロジェクト作成時に済ませておくことをオススメします。

Ｑ．ワークスペースのディレクトリは何を設定すればよい？
Ａ．私はデフォルトのディレクトリを使っています。macOS であれば「~/PycharmProjects/」がデフォルトのワークスペースを配置する場所になります。

Ｑ．仮想環境のディレクトリのパスは何を設定すればよい？
Ａ．デフォルトのまま、プロジェクトが作成されるディレクトリ直下に「venv」という名前のディレクトリを作ればよいでしょう。

Ｑ．Python インタープリタのパスは何を設定すればよい？
Ａ．macOS であれば「which python3」で表示されるパス（*12）、Windows であれば「where python」で表示されるパスを指定します。

Ｑ．Django をローカルPC にインストールするのはなぜ？
Ａ．以下の理由があります。
Django に同梱されている django-admin.py（Django 管理コマンドユーティリティ）でプロジェクトのひな形を作るため
プロジェクトのひな形作成時に生成される manage.py（プロジェクト管理コマンドユーティリティ）でアプリケーションのひな形を作るため
PyCharm 上で Django モジュールへのコードジャンプができるようにするため

以降で、無料版 PyCharm で Django 開発環境を構築するまでの手順を実際に進めていきます。なお、私の環境は macOS 10.13（High Sierra）でそれを前提に進めていきますが、Windows 環境でも問題なく進められると思います。

1．Python 3 をインストール

Python 公式サイトから Python 3 をインストールします。
なお、macOS にはデフォルト状態では Python 2.7 が入っています。Windows 10 の場合は Python はインストールされていないと思います。

https://www.python.org/downloads/から、インストーラをダウンロードします。

f:id:akiyoko:20180617173533p:plain

インストーラをダブルクリックしてインストールします。

f:id:akiyoko:20180617174009p:plain:w400

macOS の場合は自動的に PATH に指定されますが、Windows の場合はインストーラ実行時に「Add Python 3.6 to PATH」をクリックして PATH に追加します。

f:id:akiyoko:20180617174021p:plain:w350

今回の場合では、macOS では「python3」として実行できるようになります（Windows の場合は「python」）。

（macOS 10.13 の場合）

$ python3 --version
Python 3.6.5

$ which python3
/Library/Frameworks/Python.framework/Versions/3.6/bin/python3

（Windows 10 の場合）

> python --version
Python 3.6.5

> where python
C:\Users\akiyoko\AppData\Local\Programs\Python\Python36-32\python.exe

2．PyCharm CE をインストール

https://www.jetbrains.com/pycharm/download/から、Community 版である「PyCharm CE」のインストーラをダウンロードします。

f:id:akiyoko:20180617174742p:plain

インストーラをダブルクリックしてインストールを完了させます。

PyCharm CE を起動すると、いくつか初回設定を選択する画面になりますが、こちらは自分のスタイルに合わせて適宜選択します（後で変更し直すこともできます）。

なお、最初に出てくるキーマップ（keymap scheme）は、以前から使っているユーザーであれば「Mac OS X 10.5+ keymap」がよいかと思います。PyCharm 公式ショートカット一覧（Windows版 / Mac版）も非常に役立ちます。

f:id:akiyoko:20180617174858p:plain:w500
f:id:akiyoko:20180617174913p:plain:w500
f:id:akiyoko:20180617174927p:plain:w500
f:id:akiyoko:20180617174940p:plain:w500

3．PyCharm プロジェクトを作成

PyCharm プロジェクトを作成するには、PyCharm 起動後に「Create New Project」をクリックします。

f:id:akiyoko:20180617175016p:plain:w400

次の内容を入力してプロジェクトを新規作成します。
この際、「Virtualenv」を指定することで、プロジェクトごとに仮想環境が作成されます（仮想環境のディレクトリ名は「venv」としています）。 *13

項目	設定値
Location:	「/Users/akiyoko/PycharmProjects/mysite」
New environment using:	「Virtualenv」
Location:	「/Users/akiyoko/PycharmProjects/mysite/venv」
Base interpreter:	「/Library/Frameworks/Python.framework/Versions/3.6/bin/python3」（「which python3」の実行結果をコピー＆ペースト（*14））

f:id:akiyoko:20180617175028p:plain

PyCharm プロジェクトが作成されました。

f:id:akiyoko:20180617175045p:plain

「Preferences」（⌘ + ,）から「Project Interpreter」を開き、下部の「+」ボタンをクリックして、Python パッケージをインストールする画面を開きます。

f:id:akiyoko:20180617175102p:plain

例えば、「Django」を検索して、現時点の 2系の最新版である「2.0.6」をインストールします。

f:id:akiyoko:20180617175118p:plain

依存パッケージを含めてインストールが完了しました。

f:id:akiyoko:20180617175143p:plain

次に、左下のアイコンをマウスオーバーして「Terminal」を選択すると、仮想環境がアクティベートされたターミナルが起動します。

f:id:akiyoko:20180617175200p:plain

アクティベートされない場合は、「Preferences」から［Tool］>［Terminal］>［Activate virtualenv］にチェックが入っているかを確認してみてください。

f:id:akiyoko:20180617175224p:plain

それでもダメな場合は、仕方なく以下のコマンドを実行します。

$ source venv/bin/activate

　
最後に、ターミナル上で次のコマンドを実行して、Django プロジェクトのひな形を作成します。設定ディレクトリ名は拙書に倣って「config」としています。

(venv) $ django-admin.py startproject config .

これで PyCharm で Django を開発する環境が整いました。

最後に

最後に一番大事な話。
4月に「技術書典4」で販売して即完売した「現場で使える基礎 Django」が、現在増刷して絶賛発売中です！

無償の PyCharm CE を利用すれば、仮想環境を作成するための「venv」やパッケージ管理ツールの「pip」のことがよく分からなくても、Python 開発のためのプロジェクトを簡単に作成することができます。今回紹介した手順に従えば、Django の開発環境もラクラクと構築することができると思います。これで安心して Django の開発に取り組めますよね。あとはこの本を読んで勉強するだけですよね。

*3:4. If I choose a monthly subscription, do I have to place an order every month? – Licensing and Purchasing FAQ

Django の日本語書籍が無くて困っている方
Django で一度挫折したことがある方

に絶対オススメの一冊となっています。

過去記事で読みどころの解説や読者の方々の評価を紹介していますので、気になる方はこちらも合わせてご覧ください。

《過去記事》
akiyoko.hatenablog.jp

*1:https://youtrack.jetbrains.com/issue/PY-26492によると「In Progress」となっています。

*2:Professional vs. Community - Compare Editions | PyCharmにも比較表があります。

*4:Can several products be used at the same time with the All Products license? – Licensing and Purchasing FAQ

*5:Can I use my personal license for commercial development? – Licensing and Purchasing FAQ

*6:What is the difference between the commercial and personal licenses? – Licensing and Purchasing FAQ

*7:https://www.jetbrains.com/pycharm/buy/#edition=personal

*8:https://www.jetbrains.com/pycharm/buy/#edition=commercial

*9:For Students: Free Professional Developer Tools by JetBrains

*10:28.3. venv — 仮想環境の作成 — Python 3.6.5 ドキュメント

*11:pip - python.jp

*12:もし macOS で Pyenv を利用しているのであれば、「pyenv which python」で表示されるパスを指定します。

*13:「Virtualenv」と表示されていますが、内部では venv が使われるっぽいです。

*14:macOS で Pyenv を利用している場合は「pyenv which python」、Windows の場合は「where python」で表示されるパスを指定します。

↧

仮想通貨税金計算サービス「BITCOINTAX」をリリースしました

February 13, 2018, 3:21 pm

≫ Next: これぞベスト・オブ・Django 本！『現場で使える Django の教科書《基礎編》』が Kindle で販売中

≪ Previous: 無料版 PyCharm で Django 開発環境を構築するまでの手順（「現場で使える基礎 Django」本の補講その２）

アカウント登録不要、完全無料で利用できる税金計算サービス「BITCOINTAX」をリリースしました

もっと手軽に仮想通貨取引の税金計算を！
ドラッグ＆ドロップだけで使える税金計算サービスが登場

f:id:akiyoko:20180213212659p:plain

【サービスURL 】
　BITCOINTAX ： https://bitcointax.jp/

背景

「ビットコイン」「NEM」「仮想通貨」などといったキーワードが連日のようにニュースを賑わせるようになり、ビットコインを始めとする仮想通貨が国内で広く認知されるようになってきました。仮想通貨を売買できる取引所も金融庁に仮想通貨交換業者として登録された業者を中心に競い合うように次々と設立され、スマホで手軽に仮想通貨の取引ができるようになった一方で、仮想通貨取引にかかる税金計算は複雑で、専門知識のない人にとっては非常にストレスフルな作業になってしまいがちです。

昨年12月に国税庁から「仮想通貨に関する所得の計算方法等について」という資料が公表されましたが、特に仮想通貨同士の売買については取引当時の時価を計算する必要があるなど計算は煩雑です。国内の取引所ならまだしも、国外の取引所で売買した場合の日本円での時価は容易には算出できず、国税庁の方針に従って税金計算をするには困難を極めます。

2月16日より平成29年分の所得税等の確定申告受付が開始されるにあたり、これから仮想通貨の税金計算をしようとする人がその煩わしさに途方もない時間を奪われてしまう人が多く出てしてしまうことが懸念されます。最近になって仮想通貨の税金計算サービスがいくつかリリースされ始めてきましたが、いずれのサービスもアカウント登録が必要であったりと手軽に使えるものがありませんでした。

そこで「BITCOINTAX」は、

アカウント登録不要
取引所の取引履歴ファイルをドラッグ＆ドロップするだけ
無料で全ての機能が利用可能

という特徴を備え、誰でも簡単に使える税金計算サービスとしてリリースいたしました。

なお、現在の対応取引所は、bitFlyer（*1）、Coincheck、Zaif（*2）、bitbank、BITPoint、Poloniex、Bittrex、Binance、HitBTC、CryptoBridgeの計10種類となっておりますが、要望次第で随時対応を予定しています。

【お知らせ】

Bittrex 対応済み（2018年2月15日更新）
ご指摘を受けて一部計算の誤りを修正しました。お手数ですが、16日以前に利用された方は再度計算し直してください（2018年2月16日更新）
BITPoint 対応済み（2018年2月17日更新）
Zaif 対応済み（2018年2月18日更新）
Binance 対応済み（2018年2月18日更新）
CryptoBridge 対応済み（2018年2月19日更新）
HitBTC 対応済み（2018年2月21日更新）
bitbank 対応済み（2018年2月23日更新）

なお、他の取引所への対応やバグの修正依頼は、admin@bitcointax.jp 宛にご連絡ください（取引履歴ファイルを添付していただけると助かります）。

日本における仮想通貨のさらなる発展と、仮想通貨に携わる方々のストレスが少しでも解消されることを願っています。

【サービスURL 】
　BITCOINTAX ： https://bitcointax.jp/

使い方

BITCOINTAXにアクセスし、各取引所でダウンロードした CSV形式（取引所によっては Excel形式）の取引履歴のファイルをドラッグ＆ドロップするだけで利用可能です。

f:id:akiyoko:20180213214829g:plain

アカウント登録などの面倒な作業無しに、すぐに使うことができます。

【サービスURL 】
　BITCOINTAX ： https://bitcointax.jp/

その他の特徴

複数ファイルをまとめてドラッグ＆ドロップすることも可能です（最大5ファイル・1MBまで）
計算結果が表示された後に、続けて別の取引所のファイルをアップロードできます（計算が全てやり直されます）
計算結果が表示された後に、計算結果を CSV形式でダウンロードできます（ダウンロードした CSVファイルを再びアップロードすることもできます）
アップロードされたファイルはサーバで保持していません

計算方法

時価計算方法は移動平均法による　*3
時価計算には以下のデータを使用
- bitFlyer の各通貨の時価については、Cryptowatch APIが提供している1〜6時間足データを使用
- Coincheck の各通貨の時価については、Coincheck が提供している日足データを使用
- Zaif の各通貨の時価については、Zaif が提供している日足データを使用
- bitbank のビットコインの時価については、bitbank.cc APIが提供している時間足データを使用
- Binance の各通貨の時価については、Binance API が提供している日足データを使用
- CryptoBridge の各通貨の時価については、CoinMarketCap が提供している日足データを使用（ただし、120通貨中 63通貨のみ。2018年2月19日現在）
- 上記以外の海外取引所の各通貨の時価については、~~Kraken（BTC/USD）~~Poloniex APIが提供している時間足データを使用（2018年2月20日更新）
- 海外取引所の場合の USD/JPY については、ドル円為替の日足データを使用
- 2016年1月以降のデータを使用しているため、2015年12月以前の取引がある場合には対応できない場合があります

免責

本サービスは予告なく停止、終了、仕様が変更されることがあります
本サービスの利用によって生じたいかなる損失または損害については一切の責任を負いません

【サービスURL 】
　BITCOINTAX ： https://bitcointax.jp/

問い合わせ先

パブリックな問い合わせは GitHub Issue、プライベートな問い合わせは admin@bitcointax.jp または Twitterにお願いします

*1:現物取引のみ。bitFlyer Lightning（ビットコイン現物・FX・先物取引、イーサリアム現物の取引）には未対応です。

*2:現物取引のみ。信用取引・AirFX取引・先物取引には未対応です。

*3:参考：「移動平均法（棚卸資産の評価方法）の仕訳・会計処理 | 仕訳NET」

↧

これぞベスト・オブ・Django 本！『現場で使える Django の教科書《基礎編》』が Kindle で販売中

September 29, 2018, 3:54 pm

≫ Next: 薄いのに？薄くない！技術書典5 で Django の薄い本の第二弾『現場で使える Django の教科書《実践編》』を頒布します

≪ Previous: 仮想通貨税金計算サービス「BITCOINTAX」をリリースしました

akiyoko です。

8月に Kindle 版『現場で使える Django の教科書《基礎編》』を販売しました。技術書典4 で頒布した『現場で使える基礎 Django』の改訂本です（書籍名も変更しました）。

全面的な修正と36ページ（本文144→180ページ）の加筆をおこない、まさに「Django を現場で使うための基礎知識」として十分な内容になっているものと自負しています。

◆ Kindle（電子版）

作者:横瀬明仁
発売日: 2018/08/21
メディア: Kindle版
この商品を含むブログを見る

◆ Kindle（ペーパーバック版）

作者:横瀬明仁
出版社/メーカー: NextPublishing Authors Press
発売日: 2018/08/26
メディア:オンデマンド (ペーパーバック)
この商品を含むブログを見る

改訂内容

技術書典4 版より、以下の加筆をおこなっています。

Django 2.1 対応（第4章など）
設定ファイルについて大幅加筆（第10章）
マイグレーションについて加筆（第11章）
Docker の活用について加筆・修正（第15章・付録D）
Python 3、PyCharm のインストールなど初心者向けの付録を追加（付録AをA・B・Cに拡充）
表紙（デザイン by 橋本 OSO 鉄也さん）

なお、技術書典4 版の読みどころについては過去記事にガッチリ書かせていただきましたので、興味ある方はぜひご参照ください。

《過去記事》
akiyoko.hatenablog.jp

対象読者

本書の対象読者としては、

Python の文法はある程度分かるけど Django は初めてという初心者の方
Django を始めてみたけど今いちコツが掴めないという初級者の方
Django のベストプラクティスを学びたいと考えている中級者の方

を想定しています。特に、

Django の日本語書籍が無くて困っている方
Django で一度挫折したことがある方

第1章：はじめに
第2章：アーキテクチャ
第3章：プロジェクト構成
第4章：URLディスパッチャと URLconf
第5章：ビュー（View）
第6章：モデル（Model）
第7章：テンプレート（Template）
第8章：フォーム（Form）
第9章：ミドルウェア（Middleware）
第10章：設定オブジェクトと設定ファイル（settings.py）
第11章：データベースのマイグレーション
第12章：開発用 Web サーバ（runserver）を起動する
第13章：管理サイト（Django Admin）
第14章：便利な Django パッケージを使おう
第15章：サンプルコード
付録A：Python3 のインストール手順
付録B：PyCharm のインストールと初期設定
付録C：PyCharm による Django 開発環境の構築手順
付録D：Docker でラクラク開発
付録E：覚えておきたい Django 管理コマンド10選

Amazon レビューより

ありがたいことに、Amazon レビューで非常に良い評価をいただいています。
いくつか紹介させていただきます。

日本語情報の少ない、待望のDjango書籍です。Django2にも対応しています。
膨大な機能のあるDjangoフレームワークの、主要な機能をわかりやすく解説しています。
図や表もよく出てきて良い感じです。
その機能がどう動いているか、どういう流れなのかといった解説もあり、フレームワーク自体への理解も助けてくれるでしょう。

個人的には、何らかのチュートリアルが終わった人、一度挫折した人、新しいDjangoを知らない人に特にオススメです。
よくまとまっていますし、いくつかのベストプラクティクスと一緒に学ぶことができます。

Djangoの最新版に対応した日本語の書籍ということで貴重な書籍だと思います。
内容も実際に業務を行う上でのポイントもかかれており、実際にDjangoで何かWebサービスを作成するうえで役に立つ本だと思いました。
公式のチュートリアルを行ってから読むとDjangoの理解が進むと思います。

プログラマーの為の実践向け書籍。
django を勉強したけど、よく理解できなかった人向け。
django 公式ドキュメントで疑問に思った多くの事を補完できた。

まとめ

これぞ「ベスト・オブ・Django 本」と言えるような本ができました。
私自身仕事で Django を使っていて「Django の基礎知識がちゃんと書いてある本がほしいなぁ」という想いで書いた本なので、特に、仕事の現場で Django を使っている人に読んでいただきたいと思っています。

ということで現在、Kindle にて『現場で使える Django の教科書《基礎編》』が絶賛販売中です！　現場に一冊、ぜひともよろしくお願いします。

◆ Kindle（電子版）

作者:横瀬明仁
発売日: 2018/08/21
メディア: Kindle版
この商品を含むブログを見る

◆ Kindle（ペーパーバック版）

作者:横瀬明仁
出版社/メーカー: NextPublishing Authors Press
発売日: 2018/08/26
メディア:オンデマンド (ペーパーバック)
この商品を含むブログを見る

【追記】
10/8（祝・月）の技術書典5で、続編の『現場で使える Django の教科書《実践編》』を頒布予定です。ぜひ遊びにきてください！！

　現場で使える Django の教科書《実践編》｜あきよこブログ（技術書典5）

speakerdeck.com

↧

薄いのに？薄くない！技術書典5 で Django の薄い本の第二弾『現場で使える Django の教科書《実践編》』を頒布します

October 2, 2018, 6:55 pm

≫ Next: 技術書典5 で頒布される Django / Python の薄い本の情報を集めてみた

≪ Previous: これぞベスト・オブ・Django 本！『現場で使える Django の教科書《基礎編》』が Kindle で販売中

akiyoko です。

10/8 の「技術書典5」で、二作目の技術同人誌『現場で使える Django の教科書《実践編》』を頒布します。先週末にすでに入稿完了したので、あとは当日を待つのみです。

「薄いのに？」「薄くない！」

Djangoの薄い（薄くない）本の第二弾《実践編》が出るってよ！

《実践編》はこんな人にオススメ
① Djangoをもっと知りたい方
② 仕事で本格的に使いたい方
③《基礎編》を読み終えた方

本日入稿完了。当日お会いできるのを楽しみにしています！#技術書典 #Django pic.twitter.com/QIabA9CB5H
— akiyoko / か06@技術書典5 /「現場で使えるDjangoの教科書」販売中 (@aki_yok) 2018年9月29日

《実践編》はどんな内容？

全176ページまるまる Django 本です。
Python についての解説は一切ありません。

前回の技術書典4で出した『現場で使える基礎 Django』（*1）の続編にあたりますが、続編といっても Django の基本的な知識を有する方であれば理解できる内容の本になっていますのでご安心を。

前作同様、現場で使える知識を中心に、さらに実践的な内容に踏み込んでいます。
たとえば、

認証まわりの機能についての総まとめ＋ソーシャル連携認証の仕組みから導入まで
ファイルアップロードについての完全解説
ユニットテストの仕組みから効率良く書く方法まで
クラウド環境に Django サイトをデプロイする手順をイチから分かりやすく
本番公開時のセキュリティについて（チェックシート付き）
Django サイトの高速化についての TIPS

などを盛り込んでいます。
詳しくは後述の目次をご参照ください。

いわば全編がベストプラクティスで、現場のノウハウをこれでもかと詰め込んでいます。前作にも勝るとも劣らない、著者渾身の一作です。

なお、本書の読者としては、

Django をもっと知りたい方
仕事の現場で本格的に Django を使いたい方
前作《基礎編》を読み終えた方

を想定しています。
特に、前作《基礎編》を読み終えた方には絶対オススメです。なぜなら「基礎のちょっと先」に手を出そうと考えている人向けの本になっているからです。詳しくは後で説明します。

表紙

表紙はちょっと大人っぽいシックなカラーに仕上がっています。今回は橋本 OSO 鉄也さんというプロの方にデザインしていただきました。前回の緑の表紙は私がお絵描きしたものだったので、ガラッと様変わりしていてパット見、同じ著者のものとは気付かない方もいるんじゃないかなと思います。

Django の語源にもなっているジャンゴ・ラインハルトのセルマーギターや「現場」のコンクリート感など、コダワリ満載です。すごくお気に入りです。

技術書典の帰り、あるいは通勤通学の電車・バスの中で広げてもまわりがザワザワしない表紙になっています。

第1章：はじめに
第2章：開発のヒント（認証まわりをサクッと実装）
第3章：開発のヒント（Bootstrap 4 対応）
第4章：開発のヒント（Ajax 対応と JSON レスポンス）
第5章：開発のヒント（ファイルアップロード）
第6章：ユニットテスト
第7章：デプロイ
第8章：セキュリティの TIPS
第9章：高速化のための TIPS
付録A：メール送信の設定
付録B：Let’s Encrypt で SSL/TLS 証明書発⾏

となっています。

表紙を除いた本文は全 176 ページ（目次・あとがき含む）です。
文字数は16万字ほどあります（400字詰め原稿用紙 400枚！）。

f:id:akiyoko:20181003024813p:plain:w400

本の厚さは（１円玉より大きい）11 mm 超もあります。全然薄くありません。そしてただ厚いだけでなく、内容も非常に濃いです。執筆は想像を絶するほど大変でした。9月はマジ死にました。。

読みどころ

もちろん全編が読みどころなのですが、中でも特に一番の読みどころは「第7章：デプロイ」で、44ページというちょっとした同人誌一冊分の紙面を使って、クラウド環境への Django プロジェクトのデプロイ手順を一から完全解説しています。そろそろ Heroku を卒業して、自由度の高いサーバに Django をデプロイしてみたいという人には打ってつけの内容になっているでしょう。
OS は Ubuntu 18.04、ソフトウェアは現状の最新のもの（systemd＋Nginx＋Gunicorn＋MySQL 8.0 or PostgreSQL 10.5）を使用。公開鍵を作るという最初の一歩から（*2）最後は Let's Encrypt で常時SSL 化するところまで、一気通貫で説明しています。世の中で一番詳しい Django のデプロイ解説書にもなっているはずです。

「第2章：開発のヒント（認証まわりをサクッと実装）」も、Django アプリの第一歩として非常に良いリファレンス（参考資料）になると思います。ちょっとした応用編として、ソーシャル連携認証を簡単に実装する方法について、「OAuth って何？」というレベルの方にも分かりやすいようその仕組みから解説しています。

「第8章：セキュリティの TIPS」や「第9章：高速化のための TIPS」もぜひ読んでいただきたい章です。いざ本番リリースするという段になって、「このまま公開してセキュリティ的に大丈夫なんだろうか？」「何だか遅いように感じるけど何でだろう？」と途方に暮れたことはありませんか？　そんな現場のお悩みを解消するヒントをここに書きました。

そのほか読みどころはいろいろあるのですが、もう全部読んでくださいとしか言えません。もし目次の内容で気になるものがあれば、ぜひ買って読んでみてください。中身については絶対の自信があります。知りたかったことが見つかったり、新しい発見があったりするはずです。

《実践編》を書いた理由は？

前作《基礎編》を書いた理由は　Django 開発の現場で「Django の日本語の書籍が少ない」とずっと感じていたからでした。そして技術書典4で同人誌を出し、予想をはるかに超える反響をいただきました。想像以上に現場で Django が使われているという実感を持った一方で、「それだったらもっと実践的な内容の本も必要じゃないのか？」と感じたのが今回の本を書いたきっかけです。

当初は《実践編》ではなく《応用編》としてもう少し難しい内容の本を書こうと考えていました。しかしそんなとき、匿名の方からいただいた「《基礎編》やチュートリアルの次は具体的に何をすればいいの？」という質問が目に留まりました。そういった初級者から一歩踏み出すための教材がまだ全然ないという現状にハッと気付き、だったら「基礎のちょっと先」の本を書いてそれに応えようと考えたのでした。

「次の本」の構想はあったものの、今回の《実践編》を実際に書き始めたのは 8月に入ってからです。そして 8月の半ば頃まではほとんど《基礎編》の Kindle版を出すための作業をしていたので、執筆期間は実質１ヶ月半くらいでしょうか。書き始めた頃はまさかこんなページ数になろうとは考えもしませんでした。9月は特に酷くて、毎日のように朝までボロボロになるまで書き続けていました（昼間は Django じゃない仕事があって何もできないので・・）。

頒布本情報

当日のお品書きを作りました。
お釣りがなるべく出ないように考慮した「会場特別価格」です。

f:id:akiyoko:20181002011116p:plain:w400

《実践編》は B5サイズ、176ページ。
技術書典5での会場特別価格 1,500円です。

前回の技術書典では新作が3時間で完売したので、今回はドンと倍プッシュしてみました（部数はヒミツ）。当日、来場者の行列を見て「これは買えないな」と思った方でも、もしかしたら買えるかもしれませんよ。

あと、既刊の《基礎編》も多少持っていきます。

f:id:akiyoko:20181003023739p:plain:w400

こちらは先に少し言及したように、Kindle で電子版とペーパーバック（紙）版が絶賛販売中です。ありがたいことに好評をいただいているようです。

◆ Kindle（電子版）

作者:横瀬明仁
発売日: 2018/08/21
メディア: Kindle版
この商品を含むブログを見る

◆ Kindle（ペーパーバック版）

作者:横瀬明仁
出版社/メーカー: NextPublishing Authors Press
発売日: 2018/08/26
メディア:オンデマンド (ペーパーバック)
この商品を含むブログを見る

頒布場所は「か06」の「あきよこブログ」です。
見本誌を置いてますので、立ち読みだけでもお気軽にどうぞ。

　現場で使える Django の教科書《実践編》｜あきよこブログ（技術書典5）

f:id:akiyoko:20180930143251p:plain

池袋サンシャインシティ2F、10/8（祝・月） 11時オープンです。
午前中は混雑すると思いますのでご注意を。

「Django 島」について

そして、全国の Django 好きの方に朗報！！
何と今回の技術書典5では、Django の新刊が4冊以上は確定。もしかすると、それ以上出る可能性があります。Django 好きのみんな、10/8（祝・月）は池袋に集合やで～！！

#技術書典5では #Djangoの薄い本が5冊も！ぜひサークルチェックを！

か05：jbkinghttps://t.co/ZSFJkSVLEh
か06：あきよこブログhttps://t.co/W5K7uS6v6l
か07：みる会https://t.co/28Fdn4kxgn
か08：Route 312https://t.co/zjcEdhHni2
う08：黒塗りのビールhttps://t.co/DXsZc6h15W pic.twitter.com/RqIOjgBL2v
— akiyoko / か06@技術書典5 /「現場で使えるDjangoの教科書」販売中 (@aki_yok) 2018年9月15日

*1:8月より、その改訂版の『現場で使える Django の教科書《基礎編》』を Kindle で販売中です。

*2:もっと言うとその前のデプロイ先の選定や Webサーバとアプリケーションサーバの違いの説明から

↧

技術書典5 で頒布される Django / Python の薄い本の情報を集めてみた

October 5, 2018, 9:37 pm

≫ Next: 初学者・初級者向け Django の学習ロードマップ

≪ Previous: 薄いのに？薄くない！技術書典5 で Django の薄い本の第二弾『現場で使える Django の教科書《実践編》』を頒布します

akiyoko です。

10/8（祝）の「技術書典5」で薄い本を出します。ブースは「か06：あきよこブログ」です。

「薄いのに？」「薄くない！」

Djangoの薄い（薄くない）本の第二弾《実践編》が出るってよ！

《実践編》はこんな人にオススメ
① Djangoをもっと知りたい方
② 仕事で本格的に使いたい方
③《基礎編》を読み終えた方

本日入稿完了。当日お会いできるのを楽しみにしています！#技術書典 #Django pic.twitter.com/QIabA9CB5H
— akiyoko / か06@技術書典5 /「現場で使えるDjangoの教科書」販売中 (@aki_yok) 2018年9月29日

今回の技術書典5では、（私のを含めて）何と Django の薄い本が合計7冊（新刊5冊・既刊2冊）も出そうな感じです。Django 好きにはたまらないですよね！

#技術書典5では #Djangoの薄い本が7冊（新刊5冊・既刊2冊）出るぞ！😂

か05https://t.co/ZSFJkSVLEh
か06https://t.co/W5K7uS6v6l
か07https://t.co/28Fdn4kxgn
か08https://t.co/zjcEdhHni2
う08https://t.co/DXsZc6h15W
け42https://t.co/xyFNG6erzU

初心者向けから実践編や応用編も！😆
— akiyoko / か06@技術書典5 /「現場で使えるDjangoの教科書」販売中 (@aki_yok) 2018年10月5日

技術書典はドンキ的なごった煮感が好きなのですが、いかんせん技術書典公式のサークルリストには「サークルカット」と呼ばれる一枚絵とサークル名、ざっくりとしたカテゴリが載っているのみで、結局ひとつひとつ目でチェックしていくしかありません。しかも今回は、サークル数が前回のほぼ倍（500サークル弱）に増えたのでそのチェック作業も重労働です。そこで、「私が注目している」という理由から、技術書典5 で頒布される「Django / Python」系の薄い本の情報を集めてみました。そっち系に興味がある方のみどうぞ。

青枠で囲んだ本は「新刊」、グレーの枠は「既刊」であることを示しています。出版社ブースについては本の数が多いので一律、本のタイトルは非掲載としました。なお、10/5 深夜時点の掲載情報を元にしています。販売価格やページ数は今後サークル主によって変更になる可能性があるので（書かなきゃよかった・・）、実際に購入する際は各自でチェックをお願いします。

情報の取得に際しては、Pythonista らしく、Scrapyでスクレイピング・・ではなく、手でひとつひとつ集めました。画像は PyOCR・・ではなく目でチェックしました。抜け漏れはいくつもあるかと思いますがご容赦ください（もし間違えてたら連絡くだされば即対応します）。

そもそも「技術書典」って何？

「技術書典」は、春と秋の年二回ずつ開催される、技術者による技術者のための技術系同人誌の販売イベントです。今回が5回目の開催になりますが、回を重ねるごとに認知度や参加者の数、サークルの熱量がどんどん増えていて、公式によると今回は一万人ほどの来場者を見込んでいるとのことです。

それでは、手動スクレイピングの成果をお見せします。
順番はサークルの並び順（あいうえお順・ただしスポンサーが先）です。

Python 関連

ス01：株式会社インプレス（カブシキガイシャインプレス）

あ05：データリファインメント（データリファインメント）

Kaggleのチュートリアル第２版（108ページ / ￥1,000）

あ10：Secure旅団

俺らの愛したセキュリティ（￥1,000）

い07：マークアップ言語愛好会

マスタリング docutils（32ページ）

う04：改善屋tech

え12：PEAKS

ゼロから創る暗号通貨（304ページ / ￥3,600）

え39：つばめさんチーム

趣味のPython（80ページ / ￥500）

お21：日経BP出版局

か04：仮面の人

か09：Thunder Claw

ほぼPythonだけでサーバーレスアプリをつくろう（144ページ / ￥1,000）

か19：なにココ

PyCharmのすすめ ~デプロイとデバッグ編~（￥500）

か35：株式会社マイナビ出版

か49：KLab 株式会社

KLab Tech Book Vol. 2（76ページ / ￥500）

き07：eMbLog

PythonでGUIをつくろう〜はじめてのQt for Python〜（120ページ / ￥1,000）
PythonでGUIをつくろう〜はじめてのQt for Python〜（カラー電子書籍版）（120ページ / ￥800）

き21：74th

Fabric & Invoke Quick Guide（8ページ / 無料）

PythonタスクランナーFabric & Invokeを活用する技術（本+PDF / 80ページ / ￥1,000）
PythonタスクランナーFabric & Invokeを活用する技術（PDF / 79ページ / ￥800）

く05：craft by SKDN

【委託】Hello worldカルタ（￥1,900）

く11：暗黙の型宣言

「改訂版」流体計算で覚えるPython3（第2版）（188ページ / ￥500）

け02：電脳律速

株とPytnonでお金儲けを目指す本２（42ページ / ￥500）

株とPytnonでお金儲けを目指す本（84ページ / ￥1,000）

Django 関連

f:id:akiyoko:20181006210430p:plain

う08：黒塗りのビール

黒ビール好きの【IonicとDjangoの本】（100ページ / ￥1,000）

か05：jbking

どじゃんご本#1（72ページ / ￥1,000）

か06：あきよこブログ

現場で使える Django の教科書《実践編》（176ページ / ￥1,500）

現場で使える Django の教科書《基礎編》（180ページ / ￥1,500）

か07：みる会

Visual Studioでお気楽Web開発 Python + Django（48ページ / ￥300）

か08：Route 312

実践レシピおいしく使うDjango（56ページ / ￥500）

け42：しょうゆのさーくる

nuxtとvuesaxとDjangoで作るモダンなサービスの作り方。tipsもあるよ！（28ページ / ￥500）

まとめ

Python 盛り上がれ。Django もっともっと盛り上がれ～！

最後に、私のサークルの頒布物まとめ記事もどうぞ。

イラスト図解式この一冊で全部わかるWeb技術の基本

↧

初学者・初級者向け Django の学習ロードマップ

November 30, 2018, 8:34 pm

≫ Next: 仕事で本格的に Django を使うなら『現場で使える Django の教科書《実践編》』がオススメ！

≪ Previous: 技術書典5 で頒布される Django / Python の薄い本の情報を集めてみた

この投稿は「Django Advent Calendar 2018 - Qiita」の1日目の記事です。

akiyoko です。
2018年はまぎれもなく「Django の一年」でした（少なくとも個人的には）。

振り返れば、4月と10月に技術書典で Django の技術同人誌を出したり、Django Girls Tokyoという女性エンジニア向けイベントのコーチをしたり、モグモグ Djangoのスタッフをしたりと、Django を始めたばかりの方と向き合う機会が特に多かったです。

そんな中、
「Django って難しいよね」
「やってみたけどよく分からなかったので諦めた」
という声を聞くことが何度かありました。

最初は「フルスタックゆえに学習コストが高い」というのが原因なのかなとぼんやり思っていたのですが、最近はそうではなく、Webアプリケーション開発の前に知らないといけない知識やスキルが多すぎる、つまり、Django に至るまでの道のりが長すぎるというのが大きな原因になっているのではないかと考えるようになってきました。

そこで本記事では、「ビフォー Django」（Django に至るまで）と「アフター Django」（Django を学びはじめた後）に分けてそれぞれ必要となる知識やスキルを整理し、それを踏まえて特に初学者・初級者に向けた「Django の学習ロードマップ」を示してみようと考えています。私があれこれ妄想しただけのものなのでもちろん異論反論あるかと思いますが、ジャストアイデアとして温かくご査収いただければ幸いです。

本記事を書くにあたって、Djangoのハマりどころや難しいと感じている点について、Django 経験者に匿名のオンラインアンケートをおこないました。その結果、予想を大きく上回る92名（！）の方から回答をいただくことができました（アンケート期間は11月13日〜28日）。アンケートにご協力いただいた方々にこの場を借りて感謝申し上げます。

docs.google.com

ビフォー Django（Django に至るまで）

Webアプリケーションを初めて学ぶという場合は、Django をはじめとした Webアプリケーションフレームワークを学習する前にいわゆる「予備知識」あるいは「前提知識」を身につける必要があります。また、Python 未経験の方であれば、Django 学習のスタート地点に立つために Python の読み書きがひと通りできるレベルのスキルが必要になります。

学習ロードマップ

Webアプリケーションフレームワーク、および Python の基礎を習得するために必要と思われる「Web技術」「データベース」「インフラ」「Python」の知識やスキルの洗い出しをしてみました。レベルについては「ITスキル標準とは?：IPA 独立行政法人情報処理推進機構」を参考にしてみました（が、雰囲気程度です）。

f:id:akiyoko:20181201110838p:plain — （図1．Django 以前に必要な知識・スキル）

これらを最低限レベル2まで習得した上で、ようやく次のステップである Django という土壌に立てるわけです。そりゃあしんどいですよねぇ。

なお、レベル3 のスキルについては案件に応じて獲得する必要がありますが、すべての場合において必須というわけではありません。

学習方針（案）

新しい言語やプロダクトの学習をする場合の学習法は世の中にたくさんありますが、

書籍を読む（技術同人誌や電子版を含む）
オンラインチュートリアルを読む（非公式のものも含む）
ブログ記事を読む　*1
プログラミングしながら学べる学習サービスで学ぶ　*2
動画学習サービスで学ぶ　*3
勉強会に参加する　*4

くらいに分類できるかと思います。それぞれの学習法にはメリット・デメリットがあります。たとえば、次のような感じです。

f:id:akiyoko:20181201114854p:plain:w550

当たり前ですが、自分のレベルや好き嫌いに合った学習法をオススメします。

また今回のアンケート結果から、

若い人ほど、ブログで学習する（相関係数 r＝0.19）
若い人ほど、プログラミング学習サービスで学習する（r＝0.21）

という分析結果が得られました。経験がある人は二次情報を見ない（一次情報をあたる）という傾向を表しているのでしょうか。効率から言えば一次情報にあたる方がよいのでしょうが、経験が浅い人からすると最初は何が分からないかも分からない状態なので、「〇〇とは」系の簡単なブログ記事で全体像や雰囲気をざっくり掴むところから入るのがよいでしょう。

本記事の最後に、私がオススメする教材リンクを掲載しました。初学者向け（★）、初級者向け（★★）、脱初級者〜中級者向け（★★★）に分けて紹介していますので、ご自身のレベルに合わせて参考にしてください。

　オススメ教材リンク（ビフォー Django）

アフター Django（Django を学びはじめた後）

ようやく Django を学習しはじめたところで、ここでフルスタック由来の「学習コスト高い問題」という壁が立ちはだかります。

まずは、アンケート結果から見ていきます。

難易度

「Djangoは難しいと感じますか？」という問いに、4人に1人の方（全体の25％）が「Django は難しい」と回答しました。「簡単」と答えた方は10人に1人（9.8％）しかいませんでした。

f:id:akiyoko:20181201085304p:plain:w450 — Ｑ４.「Djangoは難しいと感じますか？」

Ｑ３.「Django の経験はどのくらいですか？」の結果によると回答者の多く（63％）が「Django 経験が1年未満」だったことから、単に「難しい」の割合が「簡単」の割合よりも多いというだけで「Django ＝難しい」とは言い切れません。次に示すのは、Django の経験年数ごとに難易度の度数を集計した度数分布表です。パッと見て、経験1年未満で「難しい」と答える割合が多かった（「1年未満」の36.2％が「難しい」と回答）ことが分かります。「Django 経験年数」（階級値を使用）と「難しいと回答した割合」の相関を調べると、やはり 経験が浅い人ほど「難しい」と感じる傾向が大きいことが分かりました（弱い相関 r＝0.24）。

f:id:akiyoko:20181129012004p:plain:w550 — 表．Django 経験年数ごとの難易度の度数分布表

ハマりどころ

「Djangoでハマったところ、あるいは難しいと思うところはどこですか？」という問いに対する回答結果（選択方式・複数回答可）を得票順に並べ替えたのが、次のグラフです。

f:id:akiyoko:20181130235710p:plain — Ｑ５.「Djangoでハマったところ、あるいは難しいと思うところはどこですか？」

「全体像を理解するのが難しい」と回答した方が最も多かったです。そしてまた、初学者や初級者が多いと思われる「経験1年未満」のグループで「全体像」と答えた割合が特に多かったことも分かりました（次に示す Django 経験年数ごとの度数分布表を参照）。初学者や初級者は最初のイメージを掴むところでつまづいてしまう、というのがあるのでしょう。

f:id:akiyoko:20181130235624p:plain — 表．Django 経験年数ごとのハマりどころの度数分布表

ハマりポイントの第2位は「デプロイ」でした。こちらも「1年未満」のグループで「デプロイ」を挙げる方が多かったようですが、これについては、初学者が手始めに利用することの多い Django Girls チュートリアルの後半に突如として出てくる Heroku へのデプロイでつまづいてトラウマになった人が多かったのでは？というのが個人的な見解です。最近リニューアルした新バージョンの Django Girls チュートリアルのデプロイでは PythonAnywhereというよりシンプルな環境を使うように改良されているので、つまづくことはだいぶ少なくなっていると思います *5。一度諦めていた方もぜひ再チャレンジを。

ハマりどころとしては以下、「ビュー」「ユニットテスト」「静的ファイル」と続いています。ビューやユニットテストについては、Django が用意してくれているクラスを継承して簡単に書ける反面、何をオーバーライドして使えばよいのかがブラックボックスになっていて分かりづらいという点がハマりどころになっているのではないかと想像します。このあたりは現時点ではまとまったよい情報がほとんどなく、「ソースコードを読めば分かる」的な側面もあります。

そのほか、上の度数分布表を見ると経験が「1～3年」のグループでは「フォーム」「静的ファイル」「ユニットテスト」が多くなっていて本格的に使い始めている感じがするなど Django の経験年数によってハマりどころが変化しているところや、セットで利用されることが多いからでしょうか、フォームとテンプレートのハマり度に相関があった（相関 r＝0.56）のは、非常に興味深かったです。

学習ロードマップ

以上のアンケートと私の経験を踏まえて、Django についてはこのような学習ロードマップを提案してみたいと思います。

f:id:akiyoko:20181201102426p:plain — （図2．Django 以降で必要な知識・スキル）

学習方針（案）

真っ先に全体像を把握するところから始めます。フルスタックである Django がカバーしている範囲を見極めることや、機能単位で分離している構成要素（コンポーネント）同士のつながりを把握することが重要であると考えるからです。

全体像を把握した後は、簡単な Django プロジェクトのサンプルを作成して動かすのがよいでしょう。 Django にはプロジェクトのひな型を作るためのコマンド（startproject）や簡易的な Webサーバを実行するコマンド（runserver）があらかじめ用意されているため、導入部分をチュートリアル形式で学ぶというスタイルとの相性がよいです。

そして「Django はチュートリアルで十分」という意見も多く出るくらい、Django は非常にチュートリアルが充実しています。*6有名どころでいえば、

Django Girls チュートリアル（超初心者向け）
Django 公式チュートリアル
Python Django入門（1500いいねされている有名 Qiita 記事）
DjangoBrothers チュートリアル（新しめの実践的なチュートリアル）

などが挙げられるでしょうか。

その中でも「Django 公式チュートリアル」から入る初学者の方が多いと思いますが、少し注意が必要です。というのも、公式チュートリアルには図が一切なく、全体像が把握しづらいです。あと、大事なところをしれっとすっ飛ばしたり、リンクで逃げて説明していなかったりと少し不親切なところも散見されます。したがって、初学者・初級者向けには少し分かりづらいかもしれないと感じています。あと、「ビフォー Django」の内容については触れられていません。

ちなみに Django 公式チュートリアルは完全に日本語翻訳がされていますが、リンクをたどった先がほとんど英語のままになっていることも多いです（ドキュメント全体の3〜4割しか翻訳できておらず *7、特に詳細レベルの内容については翻訳されていないものが多い）。英語が苦手なエンジニアはそこで腰が引けてしまうかもしれません。

「ビフォー Django」をきちんと学習してこなかった方には「Django Girls チュートリアル」をオススメします。インターネットの仕組みやコマンドラインの使い方から、HTML や CSS などの基礎的な話についてもカバーしてくれています。ただし先に述べた通り、途中に出てくるデプロイやそれに付随する Git の習得については非エンジニアの方にはレベルが高すぎるため、とりあえずはすっ飛ばしてもよいでしょう。

次のレベルとなるプロレベルの基礎知識としては、各コンポーネントの詳細な使い方や書き方、Django で特に充実しているユーザーまわりの機能について把握しておく必要があるでしょう。本格的に仕事で使う場合には、ユニットテストの書き方についても理解しておく必要があります。「Django パッケージ」は開発効率を格段に向上させるので、積極的に導入したいところです。また、個人的にハマりポイントが多いと感じている「静的ファイル・メディアファイル」についても必要になるケースが多いため、正しい知識をインプットしておきましょう。

このように Django についても、全体から詳細へ、というパターンで学習することをオススメします。この記事の最後に私がオススメする教材リンクを掲載しました。初学者向け（★）、初級者向け（★★）、脱初級者〜中級者向け（★★★）に分けて紹介していますので、ご自身のレベルに合わせて参考にしてください。

　オススメ教材リンク（アフター Django）

オススメ教材リンク（ビフォー Django）

私の観測範囲がビフォー Django について疎いため、網羅的にカバーしきれていません。あとで追加するかもです。

初学者向け（★）

《 Web技術》

◆ 超絶初心者のためのサーバとクライアントの話（ブログ）
qiita.com

◆ 『イラスト図解式この一冊で全部わかるWeb技術の基本』（書籍）

買って読みましたが、図＋簡潔な説明で書かれていて非常に分かりやすかったです。

posted with ヨメレバ

小林恭平,坂本陽 SBクリエイティブ 2017-03-16

スラスラ読める Pythonふりがなプログラミング (ふりがなプログラミングシリーズ)

◆ HTML & CSS | Progate [プロゲート]（学習サービス）
prog-8.com

◆ JavaScript | Progate [プロゲート]（学習サービス）
prog-8.com

《データベース》

◆ SQL | Progate [プロゲート]（学習サービス）
prog-8.com

《インフラ》

◆ Command Line | Progate [プロゲート]（学習サービス）
prog-8.com

《 Python 》

Python のバージョンは、よほどの事情がない限り「Python 3」を勉強しましょう。文字コードの扱いが大変すぎますし、何より、Django の新バージョン 2.0 以降では Python 2 はサポート外になっていますので。

◆ Python | Progate [プロゲート]（学習サービス）
prog-8.com

◆ 『スラスラ読める Pythonふりがなプログラミング』（書籍）

小学生でも読めてしまう、画期的な Python 参考書です。

posted with ヨメレバ

リブロワークスインプレス 2018-06-22

◆ 『Python3 入門ノート』（書籍）

入門者にもやさしく、最後に少し機械学習の導入部分まで学べる一石二鳥の本。

詳細! Python 3 入門ノート

posted with ヨメレバ

大重美幸ソーテック社 2017-05-24

◆ 『Pythonチュートリアル第3版』（書籍）

Pythonの作者 Guido van Rossum が書いた本の翻訳書です。私も持っている Python の資格試験「Python 3 エンジニア認定基礎試験」の教材にもなっていますので、この本をマスターすれば Python の資格もバッチリです。

Pythonチュートリアル第3版

posted with ヨメレバ

Guido van Rossum オライリージャパン 2016-03-24

初級者向け（★★）

《 Python 》

Django に限っていえば、基本文法と仮想環境の使い方、Python パッケージの活用だけで十分です。Django の前提知識としては、そのあたりを押さえておけばよいでしょう。

◆ 『Pythonエンジニアファーストブック』（書籍）

ついでに Django 基礎知識も学べる一石二鳥の本。まるまる一冊 Django ではないですが一章分（70ページ）割いています。

Pythonエンジニアファーストブック

posted with ヨメレバ

鈴木たかのり,清原弘貴,嶋田健志,池内孝啓,関根裕紀技術評論社 2017-09-09

体系的に学ぶ安全なWebアプリケーションの作り方第2版脆弱性が生まれる原理と対策の実践

脱初級者〜中級者向け（★★★）

《インフラ》

◆ 『体系的に学ぶ安全なWebアプリケーションの作り方第2版脆弱性が生まれる原理と対策の実践』（書籍）

「徳丸本」と呼ばれているほど有名なセキュリティ対策本の第2版。

posted with ヨメレバ

徳丸浩 SBクリエイティブ 2018-06-21

オススメ教材リンク（アフター Django）

初学者向け（★）

《全体像》

全体像をつかむための一枚絵などの情報は意外と少なかったです。

◆ Djangoフレームワークの紹介（その他）

Django 界隈で有名な tokibito さんのスライドです。

Djangoフレームワークの紹介 from Shinya Okano

◆ Rails以外全くわからないマンがDjangoに触れてみて驚いたRailsとの違い - Qiita（ブログ）

Rails から来た人が最初に読むと全体像がつかめて分かりやすいです。

はじめに · Django Girls Tutorial

《チュートリアル》

プロジェクトの作成からはじまり、runserver で管理画面を確認して、簡単な機能を実装するところまでをひと通りおさえるというチュートリアルがよくあるパターンです。Django ではチュートリアル系の情報が大変充実しています。

◆ Django Girls チュートリアル（チュートリアル）

大人気のチュートリアルです。非エンジニアなどの超初心者ならこちらをオススメします。インターネットの仕組みやコマンドラインの使い方から HTML や CSS など、初歩の初歩からステップ・バイ・ステップで解説してくれています。

古いバージョンのものは Heroku にデプロイするようになっていて結構ハマる人がいましたが、リニューアルされたものは PythonAnywhere にデプロイする形に書き直されていて、ハマることは少なくなっているはずです。

なお「Girls」と付いていますが、女性じゃなくてもウェルカムだそうです。もともとは世界的な女性向けイベントのために作られたサイトを各国語で翻訳したものです。

◆ 公式チュートリアル（チュートリアル）

初学者にはちょっと難しいところもあるかもしれませんが、安心と信頼の公式チュートリアルです。

はじめての Django アプリ作成、その 1 | Django documentation | Django

◆ Python Django入門 (1)（ブログ）

ブログ系で Django のチュートリアルを勉強するなら、これがよいでしょう。

プログラミング初心者でも安心、Python/Django入門講座 | Udemy

◆ Django入門編1: Djangoの基本を理解しよう | プログラミング学習サービス【paizaラーニング】（動画学習サービス）

11月29日に「Django」の講座が追加されました。早速やってみましたが、初心者にもやさしい系でした。「エル、エス、エンター！」

paiza.jp

◆ 『プログラミング初心者でも安心、Python/Django入門講座』（動画学習サービス）

Udemy の Django 講座をいくつか受講しましたが、その中で圧倒的に良かったのがこの narito さんの『プログラミング初心者でも安心、Python/Django入門講座』です。Udemy は頻繁にセールをやっているので、それを狙って気になった講座をまとめて買うのもよいでしょう。

◆ DjangoBrothers チュートリアル（チュートリアル）

比較的新しいチュートリアルで、しっかり Django 2系です。解説も丁寧でやさしいです。

www.djangobrothers.com

◆ Python Django 超入門（書籍）

そもそも Django の書籍は少ないので貴重です。超初心者向けならこの本です。ちなみに電子版はありません。

Python Django 超入門

posted with ヨメレバ

掌田津耶乃秀和システム 2018-06-09

Django for Beginners: Build websites with Python and Django (English Edition)[Kindle版]

◆ 『Django for Beginners: Learn web development with Django 2.0』（書籍）

英語に問題がないなら、Django 本の選択肢は広がります。こちらは実用系チュートリアルの本でレビューの評価も非常に高いです。私も読みましたが、英語も比較的容易なものでした。Vincent さんの記事はネットでたまにヒットしますが、非常に信頼がもてる記事を書いています。

posted with ヨメレバ

William S. Vincent 2018-02-22

◆ Django チュートリアル| MDN（チュートリアル）

まだ鋭意翻訳中ですが、初心者向けのページからテスト、デプロイ、セキュリティまで、非常に守備範囲の広いチュートリアルになっています。今後に期待。

developer.mozilla.org

初級者向け（★★）

◆ 『現場で使える Django の教科書《基礎編》』（書籍）

私の技術同人誌です。現場レベルの Django の知識を扱った日本語書籍はまだまだ少ないので貴重です。チュートリアル形式ではありませんが、コンポーネントごとの仕組みや書き方、ベストプラクティスまでを解説しています。

posted with ヨメレバ

横瀬明仁 NextPublishing Authors Press 2018-08-26

読みどころについては、ブログの過去記事で解説していますので、興味ある方はぜひ。

脱初級者〜中級者向け（★★★）

◆ 『現場で使える Django の教科書《実践編》』（書籍）

10月の技術書典で新刊として出した私の Django の薄い本の第二弾で、開発の現場で必要になる知識やよくある問題へのヒント・解決策を中心に、デプロイやセキュリティ、高速化などさらに実践的な内容に踏み込んでいます。ユニットテストについて解説した章もあります。

今時点では BOOTHという（技術同人誌を含めた）同人誌を多く扱ったオンラインショップでの販売のみになっていますが、現在鋭意、Amazon で電子版を販売する準備を進めています（今月上旬販売予定）。

Two Scoops of Django 1.11: Best Practices for the Django Web Framework (English Edition)

◆ 『Two Scoops of Django』（書籍）

世界的に有名な Django 本。だが英語だ。
ベストプラクティスが詰まっている本で、Django をイチから順にすべて解説した本ではありません。あと残念ながら対象バージョンが 1.11 ですが、信頼のおける非常に良い本です。

作者: Daniel Roy Greenfeld,Audrey Roy Greenfeld
出版社/メーカー: Two Scoops Press
発売日: 2017/10/11
メディア: Kindle版
この商品を含むブログを見る

過去記事でも、この本をオススメしています。興味がある方はこちらもどうぞ。

[Django] Heroku デプロイ方法 2018年版 - Qiita
[Django] ファイルアップロード機能の使い方 [基本設定編] - Qiita

その他のお役立ちサイト

ブログなどで、Django の信頼できる情報を提供してくれている方々を勝手に紹介します。

◇ narito ブログ

上でも紹介した、narito さんのブログ。かなり広範囲に渡って記事をアップしています。

narito.ninja

◇ okoppe8

Qiita でDjango といえば okoppe8 さんでしょう。かなり信頼できる記事をいくつも書いていて、非常に有用です。

◇ Djangoフレームワークのユーザーモデルと認証

tokibito さんのユーザーまわりの機能についてのスライド。非常によくまとめられています。

Djangoフレームワークのユーザーモデルと認証 from Shinya Okano

◇ Django における認証処理実装パターン

認証まわりについての c-bata さんの非常に有用な記事です。脱初級者向けに読んでおいたほうがよいでしょう。

nwpct1.hatenablog.com

◇ Djangoのテストの書き方とCircleCIを活用した継続的インテグレーション

codezine.jp

◇ Django 管理画面逆引きメモ

◇ Django のおすすめライブラリ

*7:django-docs localization

最後に

機械学習のおかげか、Python 界隈が非常に盛り上がってきています。Webアプリケーションも Python で一気通貫で作るとなると、Django や Flask、あるいは Tornado や Bottle、Pyramid という選択肢があり、ユーザー認証が必要となると Django が強力な選択肢になります。

「Django が難しい」と感じるのは、フルスタックである Django がカバーしている範囲が大きい（機能がテンコ盛りすぎる）からかと思いきや、そもそも Webアプリ開発の前に知らないといけない知識やスキルが多すぎるというのが原因のひとつであるようにも感じています。つまり、「Django の学習コストが高い」のではなく、「Django に至るまでの Webアプリケーションを含めたスキル全般に対する学習コストが高い」と言えるのではないでしょうか。

この記事では、Django をマスターするために必要な知識やスキルを整理し、その全体像となる学習ロードマップを示してみました。いかがでしたでしょうか？この記事が Django の初学者や初級者の方々のお役に少しでも立てれば幸いです。

学習法ではないかもしれませんが、Django（だけでなくさまざまなプロダクト）を習熟するために一番良い方法は「自分でちょっとしたサービスを作ってみる」だったりします。そういった場合には、チュートリアルを見ながら手を動かして何か作り始め、その延長で自分の作りたいサービスを作ってしまうというパターンがよいかもしれません。

*1:Qiita、はてなブログなど

*2:Progate、PyQなど

*3:Udemy、ドットインストール、paizaラーニングなど

*4:もくもく会、カンファレンスなど

*5:それでも黒い画面も Git も必要なので、非エンジニアにとってはまだまだハードルは低くないですが。。

*6:チュートリアルとは、基礎的なところから順を追って解説したもので、ひと通り終えることで基本的な操作を学べるようになっています。

↧

仕事で本格的に Django を使うなら『現場で使える Django の教科書《実践編》』がオススメ！

January 19, 2019, 10:07 pm

≫ Next: 技術書典6 で『現場で使える Django REST Framework の薄い本』を頒布します

≪ Previous: 初学者・初級者向け Django の学習ロードマップ

akiyoko です。

昨年10月の技術書典5で Django の技術同人誌シリーズの2作目となる新刊 『現場で使える Django の教科書《実践編》』を出してから数ヶ月経ちました。その間、Django 本の読書会をしたり、Amazon で電子版の販売を開始したり、年末のコミケに初参加してサークル「あきよこブログ」として本を再販したりするなど、いろいろとイベントが目白押しでした。

そうやって技術書典5 からの数ヶ月を忙しく過ごしたわけですが、ふと思い返すと私のブログで《実践編》の内容を紹介していなかったことに最近気づいたので、この記事で 『現場で使える Django の教科書《実践編》』の概要と読みどころについて紹介しておきたいと思います。

現在、《実践編》の紙の本はオンラインショップの BOOTHで、電子版は Amazon で販売中です。

◆ BOOTH（紙の本）

◆ Amazon（電子版）

posted with ヨメレバ

《実践編》の概要

本書は Python 製の Web アプリケーションフレームワーク「Django（ジャンゴ）」の解説書の第二弾で、Django を本格的に使っている／使おうとしている開発者に向けた本です。開発の現場で必要になる知識、よくある問題へのヒントや解決策を中心に、デプロイやセキュリティ、高速化などさらに実践的な内容にも踏み込んでいます。前作同様、開発現場に必携の一冊にすべく、様々なノウハウをこれでもかと詰め込みました。

《実践編》をひと言で表すと、「基礎のちょっと先に手を伸ばしてみようと考えている開発者に向けたステップアップ本」になっています。前作同様、Django プロジェクトの現場にあると嬉しい一冊になっているはずです。

対象読者

《実践編》の対象読者は、

Djang のことをもっと知りたい方
仕事の現場で本格的にDjangoを使いたい方

を想定しています。

Django 公式チュートリアルや Django Girls Tutorialでは物足りなかった方や、実践的な開発に不安のある方にも十分満足できる一冊になっているはずです。そしてもちろん、前作の《基礎編》を読み終えた方にはちょうど良いレベルのステップアップ本になっているでしょう。

なお、Django の基礎（全体像、コンポーネントごとの仕組みや基本的な実装方法など）については説明していません。それらについては、前作《基礎編》でベストプラクティスを交えて詳しく解説しています。

各章の読みどころを紹介

第2章：開発のヒント（認証まわりをサクッと実装）

Django を使った Webアプリ実装の第一歩として、まず「ユーザー認証まわり」から実装することが多かったりするのではないでしょうか。実は、Django 組み込みの認証システムを使うと、認証まわりの機能をサクッと実装することができます。そのことを知らずに、ログインやパスワード変更といった機能を自前で実装してしまったりするのは「DRY（Don’t repeat yourself）」の原則に反します。しかしながら、認証まわりのノウハウについてまるっと解説した本は（少なくとも日本語の書籍では）ありませんでした。

本章ではまず、最小限の実装でユーザー認証まわりの機能をひと揃えするための具体的な方法について解説をしています。

しかし実際の現場では、サクッと実装しただけでは問題がある場合があります。それは「仕様変更」です。Django デフォルトの認証の仕組みをそのまま利用できる場合はよいのですが、ちょっとカスタマイズしたいとなった場合に難易度が途端に跳ね上がるという点には注意が必要でしょう。たとえば、「ユーザー名ではなくメールアドレスとパスワードで認証できるようにしたい」といったニーズは日常茶飯事に発生します。このような場合にどのように改修すればよいのか、その改修ポイントや具体的なコードを載せています。

本章の最後ではさらに実践的なニーズのひとつである「ソーシャル連携認証」について解説をしています。これを読めば、「OAuth って何？」というレベルの方でも、ソーシャル連携認証の仕組みが分かるようになり、GitHub アカウントでソーシャル認証ログインできる Django サイトが実装できるようになります。

第3章：開発のヒント（Bootstrap 4 対応）

ところで皆さんは「味覇（ウェイパー）」という調味料をご存知ですか？

味覇(ウェイパー) 缶 500g

出版社/メーカー:廣記商行
メディア:食品&飲料
この商品を含むブログを見る

味覇は中華料理のベースの味付けに「とりあえず使っとけ」という感じで万能・安心・簡単に使える調味料なのですが、「Bootstrap は Webサイトのスタイルを下支えする味覇である」というブログ記事を見て思わず吹き出してしまったことがありました。

さて、業務で Webアプリを作る際、特にプロトタイプを作る段階では Bootstrapなどの CSSフレームワークをとりあえず入れてスタイルを「それ」っぽく整えておくのは常套手段ではないでしょうか。CSSフレームワークはデザインセンスの乏しいエンジニアの強い味方です。

第3章の前半では、Webアプリ開発の初めの一歩として押さえておくべき「Bootstrap 4 の導入方法」について書いています。Django に特化した話はほとんどありません。後半では、「django-bootstrap4」という Django パッケージを使って「Bootstrap 4」の適用をサポートする方法について解説しています。

第4章：開発のヒント（Ajax 対応と JSON レスポンス）

Django のビューでは通常のレスポンス以外に、JSONレスポンスを返すことができます。テンプレートの JavaScript から Ajax リクエストを送信して JSONレスポンスを受け取ることで画⾯全体を更新せずに⼀部の部品だけを書き換えることができるため、これを利用することで UI・UX のよい Web画面を制作することができます。

なお、Django から JSON を返す⼿段としては、「Django REST framework」と呼ばれる有名なパッケージを使う⽅法があります。REST でリクエストをしてJSON で受け取るような SPA やアプリのバックエンドとしてよく利⽤されています。しかしこの章で紹介する⽅法によって、Django REST framework を使わなくても簡単に JSON レスポンスが返せることがお分かりいただけると思います。

なお、JavaScript で Django に Ajaxリクエストを送信する際、またビューから JSONレスポンスを返す際にそれぞれちょっとした注意点があります。第4章の中盤ではそれらの注意点について具体的なコード例を交えて解説をしています。

章の終盤では、AjaxとJSONレスポンスを応用すればこんなアプリが作れるぞ！というちょっとしたアプリのコードを紹介しています。時系列データを保持した pandasの DataFrameを JSONレスポンスとして返し、テンプレート側では「Tabulator」という JavaScript のライブラリを利⽤して JSON を処理するというサンプルになっています。はっきり言って、ポエムです。

f:id:akiyoko:20181021163655p:plain:w450

第5章：開発のヒント（ファイルアップロード）

Django では、静的ファイルのうち、システム管理者を含めたユーザーが Webアプリケーションを利⽤してアップロードする CSV や PDF、画像などのファイルを「メディアファイル」と呼んでいます。

前作《基礎編》では「STATIC_ROOT」「STATICFILES_DIRS」「STATIC_URL」などの静的ファイル関連の設定について詳しく説明しましたが、本作では、メディアファイル（およびファイルアップロード）について、設定から実装、注意点に至るまで詳しく解説しています。

少し発展的な内容として、「django-storages」を使ってクラウドストレージにファイルアップロードする方法とその設定について記載しています。そのほか、ファイルアップロードを利用する際に便利に使える Django パッケージをいくつか紹介しています。

章の最後は、不正なファイルがアップロードされないためのセキュリティ対策について。ユーザーがアップロードしたファイルを他のユーザーに配信する場合は、ファイルの不正チェックが必須になるでしょう。

Django の最もハマりがちなポイントといえば「静的ファイル」でしょう。メディアファイルは静的ファイルと混同しやすく、ファイルアップロードの実装は簡単ですが仕様に少し癖があります。業務用 Webアプリではよく利用されるので一度全体を整理して把握しておきたいところです。

第6章：ユニットテスト

動くコードも大事ですが、現場においてはテストも同じくらい重要です。 Django では、以下に示すようなユニットテストのサポートが最初から用意されており、非常に充実しています。

test コマンド
テストランナー
標準の unittest.case.TestCase を継承した Django の TestCase クラス
Webテストクライアント

Django のユニットテストで押さえておくべき知識は、次の3点です。

① 慣例と命名ルール
② TestCase における各種メソッドの実行フロー
③ テストの実行方法

まず、慣例と命名ルールを押さえておかないと、テストランナーが自動で収集してくれなくなります。次に、Python 標準の unittest.case.TestCase を継承した TestCase には、テスト用のデータベース作成および削除、フィクスチャと呼ばれるファイルからのテストデータ生成、登録および変更したテストデータのロールバックなどの機能が追加されています。それらを含めた各種メソッドの実行フローや拡張ポイントを把握しないと、効率の良いテストケースを書くことはできません。Django 標準のユニットテストは test コマンドから実行できますが、その実行方法についても押さえておく必要があるでしょう。

また、多くのプロジェクトでは Coverage.pyを導入してカバレッジを計測します。カバレッジ・レポートを品質指標として利用できるほか、実際に実行されたコード行を可視化することでテストケースに抜け漏れがないか、あるいはテスト条件や実装方法に誤りがなかったかどうかを把握できるといったメリットもあります。

第7章：デプロイ

「デプロイ」とは、実際に利用する環境に Webアプリを配備（deployment）して、ユーザーから利用できる状態にすることを指します。特に、本番環境へのデプロイは「本番デプロイ」などと呼ばれます。

デプロイの工程には、サーバの調達から必要なソフトウェアのインストールやその設定、データベースの構築や初期データの投⼊、セキュリティの設定など、ありとあらゆる作業が含まれます。本章では、インフラエンジニアでない⽅にもできるだけ分かりやすいように、デプロイ⼿順を最初から最後まで一気通貫に説明していきます。具体的には、サーバに乗り込むための鍵ペアの作成から Let's encrypt による常時 SSL化の設定まで、かなーり詳しく書いています。全部で44ページ！世界で一番詳しい Django のデプロイ解説書を目指しました。

本章で構築するサーバ構成は、サーバ１台でリバースプロキシサーバ、アプリケーションサーバ、データベース、ファイルサーバなど全てをまかなうオールインワン構成です。シンプルで安上がりになる反⾯、可⽤性（冗⻑化）やスケールを考慮していない点には注意が必要です。

サービス： DigitalOcean（クラウド）
OS： Ubuntu 18.04
サービスマネージャ： systemd
データベース： MySQL 8.0 （またはPostgreSQL 10.5）
リバースプロキシサーバ： Nginx 1.14
WSGI サーバ： Gunicorn 19.9
Python： 3.6.5
Django： 2.1

なお、各ソフトウェアのバージョンはできる限り最新のものを利用しています。

第8章：セキュリティの TIPS

前章では本番デプロイについて書きましたが、本番公開時にどうしても気になるのがセキュリティの問題ですよね。いざ本番リリースしようとしたときに「これって公開しちゃって大丈夫なの？」と怖くなってしまうことはないでしょうか？

Djangoはフルスタック（全部入り）が大きな特徴のひとつですが、セキュリティ対策もその中にちゃんと含まれています。ただし、「適切に利用していれば」という条件付きです。というわけで、本章の前半は Django が提供しているセキュリティ対策についてのおさらいです。後半では、本番デプロイを想定したオリジナルの「セキュリティ・チェックリスト」を用意しました。ぜひ本番リリース時にお役立てください。

第9章：高速化のための TIPS

「Django は遅い」なんてもう言わせない！

最終章の9章では、簡単に実現できる高速化の具体策について解説しています。前章で説明したようにセキュリティまで「全部入り」の Django は悪く言えば重厚長大で、パフォーマンスは二の次であると言わざるを得ません。

ここで高速化の対策として解説しているのは二点です。一点目は、データベースのクエリ実行について。特定の画面のレスポンスが異常に遅い場合、クエリ実行に問題がある（クエリの本数が想定以上に多くなってしまう、いわゆる「N＋1」問題が発生している）場合がありますが、その対策について解説します。二点目は、Django にデフォルトで含まれている「キャッシュ」機能について、その使いどころをいくつか具体的に挙げています。アプリ次第では劇的に応答時間が短くなることもあるでしょう。

《実践編》の評価

SNS やブログ上での『現場で使える Django の教科書《実践編》』の評価を勝手に掲載させていただきます。

技術書典で買ったakiyokoさんのDjango実践編、今まさに知りたかった情報で目から鱗
— いろどり (@_centriv) 2018年10月8日

現場で使えるDjangoの教科書実践編読みました。認証周りやパフォーマンス出ない話がつらぽよなので、そこらへんをカバーしてて嬉しい。ソシャゲAPIサーバを作る用ではなさそうな雰囲気がありました
— izm (@izm) 2018年10月16日

まだ軽く全体に目を通した程度ですが基礎編に続き「もっと早くほしかった！」と思えるすばらしい内容です。デプロイの部分が手厚いのもよいですね。間違いなく今後あたらしいDjango製のアプリが世に公開される手助けになると思います😊じっくり読ませていただきます！
— Qtaro🌟🍫🍶 (@Daisuke_9taro) 2018年10月18日

BOOTHから購入させていただきましたが、Django開発者は手元にあると嬉しい1冊だとおもいます

丁寧に書かれていて、似たような他のモジュールを使う場合でも参考になる1冊でした◎#studeploy https://t.co/9SLm4ThLBu
— さきま / Curumi, inc. (@sakimyto) 2018年10月21日

会社で布教したらよいものだということで《基礎編》＋《実践編》紙の本2冊セットを今日会社で買いました。アイスの本はよい本だけど英語の壁が高かった・・・ https://t.co/HKqeSFevQ0
— okazaki jun (@dario_okazaki) 2018年12月4日

現場で使えるDjangoの教科書、配属1日目にデスクの上に置かれてて本当に現場で使われてんのねってなった https://t.co/q3gnrGk7At
— 夜戦 (@1plus1plus1plus) 2018年12月27日

Django開発日記エピソード2~Bibleとの遭遇~
特に、実践編の内容が激アツな件https://t.co/Btll7MGUoZ #スターウォーズ風開発日記
— kenji oda(おだちゃニズム) (@kenji_oda0618) 2018年12月30日

ks6088ts.github.io

まとめ

おかげさまで、前作の Django の技術同人誌『現場で使える Django の教科書《基礎編》』は まだまだ販売好調で、販売累計数は 2,500冊を超えています。こちらも Django プロジェクトの現場にあると嬉しい一冊ではありますが、どちらかというと、現場に入った新規参画者や新人に読んでほしい初心者・初級者向けの一冊になっていると思います。

◆『現場で使える Django の教科書《基礎編》』Amazon（電子版／ペーパーバック版）

作者:横瀬明仁
出版社/メーカー: NextPublishing Authors Press
発売日: 2018/08/26
メディア:オンデマンド (ペーパーバック)
この商品を含むブログを見る

基礎編を読み終えて、仕事でもっと本格的に使っていこうと考えているなら、今回紹介した『現場で使える Django の教科書《実践編》』が絶対オススメです。何かで詰まって半日無駄にするくらいなら、《実践編》を一冊買う方が絶対安いです。きっと役に立つ情報がたくさん載っていると思います。特に、デプロイや高速化、セキュリティ、認証、ユニットテストに関しては、これほどまとまった情報を提供しているところは他にはまだないと自負しています。

気になった方はこの機会に《実践編》をぜひどうぞ。

f:id:akiyoko:20190120144009p:plain

なお、紙の本で『現場で使える Django の教科書』シリーズの二冊（基礎編・実践編）をお得に手に入れたいという方には、BOOTH での二冊セット販売も用意しています。

↧

技術書典6 で『現場で使える Django REST Framework の薄い本』を頒布します

April 13, 2019, 3:07 pm

≫ Next: DjangoCongress JP 2019 で「現場で使える Django のセキュリティ対策」というタイトルで登壇してきました

≪ Previous: 仕事で本格的に Django を使うなら『現場で使える Django の教科書《実践編》』がオススメ！

akiyoko です。

本日いよいよ「技術書典6」が開催されますね。私は今回も「あきよこブログ」としてサークル参加します。これで3回連続3回目のサークル参加になります。

　あきよこブログ（技術書典6）

f:id:akiyoko:20190413231539p:plain:w400

過去2回で2冊の「Django の薄い本」を出してきましたが、今回の新刊も Django 関連本です。『現場で使える Django REST Framework の薄い本』というタイトルからお分かりの通り、「Django REST Framework（通称「DRF」）」に関する技術同人誌です。

Django REST Framework（DRF）って何？

「Django」は Python で Webアプリケーションを作成するためのフレームワークで、Webアプリケーションを作成する際に必要となるコンポーネント（部品）や API を多数提供しています。Django は多数の機能を提供しているものの、REST API バックエンド（REST API を提供する Webアプリケーション）を構築する際のさまざまなニーズに応えるには少し機能が足りず、いろいろと自前で実装しなければいけません。

そこで登場したのが、「Django REST Framework」（以降「DRF」と表記）です。DRF は、REST API バックエンドを構築することに特化したサードパーティ製の Django パッケージで、REST API を提供する際に必要となる機能や便利な機能を補完・拡充してくれる拡張パックのような役割を果たします。実際のプロジェクトでは、Webアプリケーションのベースとなる機能は Django を利用し、REST API に特化した機能は DRF を利用する、といった使い方をします。

f:id:akiyoko:20190413224931p:plain:w500

DRF 本を書いた理由

かく言う私も現在仕事で「DRF」を使っており、仕事の現場においては「素の Django」よりも「DRF」の方が使われているようにも感じています。しかしながら、DRF に関する日本語情報は Django よりも圧倒的に不足しています。日本語書籍については現在どこを探しても見つかりません。商業誌を待っていてもあと何年かは出ないだろうから、もし技術書典6に当選したら30ページくらいの本当に薄い本を書いてみようかなと思い立ったのが昨年末。これが地獄の始まりでした。。

それからどうなったか？

技術書典4から3回連続で技術同人誌を頒布していますが、今回が一番辛かったです。昨年末あたりから執筆のための調査を始めていて実質的な執筆は2月から開始したのですが、あれよあれよという間に30ページが50ページになり、70ページになり、最終的には表紙を含めて128ページの「薄くない本」に仕上がってしまったのでした。

毎回執筆内容を Git で管理していて今回からコミットコメントに執筆時間を加えることにしてみたのですが、今回の合計執筆時間は333時間になりました（会場価格は1,000円なので私の作業1時間あたり「3円」で買えてしまうということですね・・）。内容には満足しているものの、3月は生活のすべてを投げ打って執筆に没頭してしまいました。ご迷惑をお掛けした関係各所の皆さま、本当に申し訳ありませんでした。最後に、家族のサポートがなければこの本は世に出ていなかったということも付け加えさせてください。

どんな内容？

Django REST Framework（DRF）を現場で使う際に必要となる基礎知識についてまとめた技術同人誌で、本文124ページ、まるまる「Django REST Framework」に関する本です。なお、DRF は Django をベースにしている部分があるので Django についての解説は要所要所で書いているものの、Python についての解説は一切ありませんのでご注意ください。

前半は DRF の概要や全体像、コンポーネントごとの仕組みや使い方、セキュリティや認証などの基礎知識を座学で進めていきます。後半はチュートリアルおよび発展的な Tips という構成になっています。

後半のチュートリアルでは、Django も Django REST Framework も何にも分からないという方でもちょっとした SPA が作れるように、Django REST Framework と Vue.js を使った SPA のサンプルプロジェクトを2つ、簡単なものと少し難しめなものを用意しました。これを手本に写経すれば、REST API を使った Webアプリケーションの仕組みが何となく掴めるでしょう。

レビュアーとして、くろのて勉強会を主催をしている @crohacoさんにもご協力いただいたのですが、@crohaco さんからお墨付きをいただけました。DRF の勉強会ではお世話になりました。そしてレビューありがとうございました。

本のレビューをさせてもらいましたが、DRFやってる人、これからやる人は絶対読んだほうがいいです❗️
4/14 お忘れなく😆 https://t.co/TiXrZjHUJV
— くろ (@crohaco) 2019年4月10日

そのほか、Django 系イベントでいつも会う @kaizumakiさんや u1 さんにもレビューをしていただきました。ありがとうございました！

対象読者

対象読者としては、

Django は何となく分かるが、Django REST Framework は初めてという方
Django REST Framework のまとまった日本語情報を手に入れたい方
Django REST Framework ＋ Vue.js で SPA を構築したい方
現場で本格的に Django REST Framework を使いたい方

を想定しています。

最低限必要の知識としては「Django の仕組みが何となく理解できていること」です。Django 公式チュートリアルや Django Girls チュートリアルをひと通り終えたくらいであれば、何とか理解できるレベルになっているかと思います。拙著『現場で使える Django の教科書《基礎編》』を読み終えたくらいの知識があれば万全ですが、『現場で使える Django の教科書《実践編》』レベルの知識は不要でしょう。

作者:横瀬明仁
出版社/メーカー: NextPublishing Authors Press
発売日: 2018/08/26
メディア:オンデマンド (ペーパーバック)
この商品を含むブログを見る

作者:横瀬明仁
発売日: 2018/12/08
メディア: Kindle版
この商品を含むブログを見る

はじめに
第1章： Django REST Framework（DRF）の概要
第2章：モデル・シリアライザ・ビュー・URLconf の基本的な使い方
第3章： DRF とセキュリティ
第4章： DRF と認証
第5章：チュートリアルその1： DRF ＋ CDN 版 Vue.js で Cookie 認証付き SPA をスピード構築
第6章：チュートリアルその2： DRF ＋ Vue CLI 3 で JWT 認証付き SPA を本格構築
第7章：現場で使える Tips 集
おわりに

f:id:akiyoko:20190413231404p:plain:w300

頒布本情報

当日のお品書きを作りました。
お釣りがなるべく出ないように考慮した「会場特別価格」です。

f:id:akiyoko:20190413231539p:plain:w400

あと、既刊の『現場で使える Django の教科書《基礎編》』『現場で使える Django の教科書《実践編》』も持っていきます。

f:id:akiyoko:20190413231654p:plain:w400

f:id:akiyoko:20190413231728p:plain:w400

これらの既刊については、Amazon や BOOTH で電子版とペーパー版が絶賛販売中です。

◆ 現場で使える Django の教科書《基礎編》 - Amazon（電子版・ペーパー版）

作者:横瀬明仁
発売日: 2018/08/21
メディア: Kindle版
この商品を含むブログを見る

◆ 現場で使える Django の教科書《実践編》 - Amazon（電子版）

LNGOOR ワイヤレスプレゼンターレーザーポインター PPTスライド用リモート USB充電式リモートコントロールワイヤレスマウス操作 PowerPoint、Keynote、Googleスライド用リモート等対応収納パック付き(ブラック)

作者:横瀬明仁
発売日: 2018/12/08
メディア: Kindle版
この商品を含むブログを見る

◆ 現場で使える Django の教科書《実践編》 - BOOTH（ペーパー版）
現場で使える Django の教科書《実践編》【紙の本】（技術書典5バージョン） - あきよこブログ（akiyoko - BOOTH

頒布場所

頒布場所は「か63」の「あきよこブログ」です。
見本誌を置いてますので、立ち読みだけでもお気軽にどうぞ。

f:id:akiyoko:20190413232620p:plain

　あきよこブログ（技術書典6）

池袋サンシャインシティ2F、4/14（日） 11時オープンです。今回は、会場2時間は有料入場券（1,000円）が必要になっています。それでも午前中は混雑すると思いますのでご注意ください。

なお勝手ながら、当日13時までの有料入場者特典として、弊ブースにて『現場で使えるDjangoの教科書《実践編》』（紙の本）を会場特別価格からさらに500円引きさせていただきます（1,500円→1,000円）。（後払いアプリだと対応できないかもしれないので）現金払いのみでの割引とさせてください。

技術書典6の有料入場者特典！！

【か63 あきよこブログ】にて、当日13時まで『現場で使えるDjangoの教科書《実践編》』（紙の本）を会場特別価格からさらに500円引きします（1,500円→1,000円）https://t.co/dTFg6uJO6U

おいでませ～😉#技術書典 #有料入場者特典 pic.twitter.com/isnYy0M4vd
— akiyoko /か63@技術書典6/「現場で使えるDjangoの教科書」販売中 (@aki_yok) 2019年4月11日

最後に

ウチの奥さんに「そんなに寝てないと死ぬよ？」と何度も言われながら、ようやく今週の火曜にすべり込み入稿できました。表紙がモノクロだったので標準価格からのアップは免れましたが、カラーだったらアウトというギリギリっぷりでした。そんな感じで今回の執筆で気力体力ともに尽き果てました。今日の技術書典が終わったら昇天しているかもしれません。。

↧

DjangoCongress JP 2019 で「現場で使える Django のセキュリティ対策」というタイトルで登壇してきました

May 18, 2019, 10:06 pm

≫ Next: DRF を使うなら必読！『現場で使える Django REST Framework の教科書』を技術書典7 で頒布します

≪ Previous: 技術書典6 で『現場で使える Django REST Framework の薄い本』を頒布します

akiyoko です。

昨日の DjangoCongress JP 2019（Day 1 カンファレンスデー）で「現場で使える Django のセキュリティ対策」というタイトルで登壇してきました。その報告です。

発表資料はこちらにアップしています。

発表の動機

仕事の現場でもっと Django を使ってほしいという想いから、この発表を思い立ちました。Django 普及の突破口のひとつとして、まずはセキュリティの懸念を取り払うことが重要なのでは？と考えたのです。

Python が企業でも幅広く使われるようになったことや書籍が充実し始めたことで、日本でもようやく Django が注目されるようになりました。4月に待望のバージョン2系の LTS がリリースされ、ますます現場で Django が盛り上がることが予想されますが、導入検討の際にネックになるもののひとつに「セキュリティ」への懸念があります。私は現在、ある Django プロジェクトの立ち上げに携わっているのですが、そこで実際によく言われたのが「Django ってセキュリティ的にどうなん？」でした。日本では（特に SIer 界隈では）Django がまだあまり知られていないので、そのような疑問が出てくるのは当然といえば当然かもしれません。

一方の開発者からすると、フルスタック（全部入り）の Django にはデフォルトでセキュリティ対策も含まれていますが、そのあたりの理解が中途半端だと、リリースした Webアプリケーションが悪意ある攻撃者の格好の餌食になってしまいかねません。そうならないためにも、Django のセキュリティ事情については開発前から（もちろん開発中でも）きちんと把握しておきたいところです。

そこで今回、IPA（情報処理推進機構）が注意喚起情報として公表している「安全なウェブサイトの作り方」という冊子にまとめられた代表的な脆弱性の概要と、それらの脆弱性に対して Django では具体的にどのような対策をしているのかについて解説することにしました。これによって発注側企業においてはセキュリティの懸念が払拭され、一方の開発側企業においてはセキュリティ施策のヒントとして活用されることを期待しています。

対象者

対象者は、Django の導入を検討している方、および Django を使った Webアプリケーション開発者を想定しています。なお、Django 初級者の方にも十分理解できる内容になっていると思います。

Webアプリケーションの基本的な知識（特に Cookie を使ったセッション管理や HTTPヘッダなどの知識）があれば、セキュリティの知識についてはほぼゼロ（用語を何となく聞いたことがあるレベル）でも問題ありません。CSRF などの重要な、そして重要な割にあまりよく理解されていないものについては、「CSRF（しーさーふ）って何？」というレベルの人にも分かるように基本から解説しています。

ポイント

メインの話題として

① Webアプリケーションのセキュリティ対策って そもそも必要なの？
② 「これだけは絶対やっとけ」的な基準はある？
③ フルスタック（全部入り）の Django を使えば セキュリティ対策もまるっと万事解決？

の三点について話しました。
詳細についてはスライドをご覧ください。

発表の準備

昨年の LTでド緊張して失敗した苦い思い出があるので、今回はまず、心構えから入りました。事前に読んだのは、たまたま見つけたオリラジ中田さんの講演会ログです。要約すると、プレゼンでは「カンペを読まない」「言い訳しない」「練習をサボらない」の3つのタブーがあるということです。中でも、人前で練習をすることが「練習」でそれ以外は「練習」ではないというのはまさにその通りだと思い、リハーサルをなるべく多くこなそうと考えていました。

発表の内容については CFP を出した頃に目次レベルまで固めていたのですが、実際に発表資料を準備し始めたのは仕事の関係もあって GW の終盤からとなりました。しかしこれはちょっと遅すぎました。資料が完成したのは本番５日前。そこから２回、会社の Django 経験者やコンサルタントのメンバーの前、そして現プロジェクトメンバーの前でのリハーサルをおこないました。メンバーからのフィードバック、そして自身の反省から、資料がブラッシュアップされていき、話した方がよいこと・話さなくてよいことが明確になり、想定問答も明らかになって私にとっては良いこと尽くめでした。もっとリハーサルをしたかったのですが、何度も集まってもらうのもメンバーの負担になるのと、直前にフィードバックをもらっても反映できない、余計に混乱してしまうと感じたので、これが限界だったのかも知れません。あとはブツブツ独り言を繰り返し、本番の流れをイメージしていきました。

フィードバックの中で、「図を指差しで説明するよりもレーザーポインターでやった方がいい」と言われて急遽買ったのがこれ。パワポのページ送りもできます。本番前日の夕方に届きました。しかしこれが、当日あのような事件を引き起こすことになろうとは。。

出版社/メーカー: LNGOOR
メディア:オフィス用品
この商品を含むブログを見る

あと、GW 中盤に引いた風邪がずっと長引いていたので体調を整えるために前日夜にマッサージに行ったのですが、強かったのか余計に首を痛めてしまいました。

発表はどうだった？

「発表前にやることリスト」を作っていたので、それを淡々とこなすことで緊張はギリギリのところで抑えられていました。

しかし、プレゼン開始直後に事件が起きました。前日の動作チェックでは問題なかったレーザーポインターがページ送りができなくなり、直前に使用を諦めました。これで緊張のコップから水が少し溢れてしまいました。。

この事件がきっかけとなって冒頭の10分はガチガチでした。途中からあきらめの境地に至ってから割と話せるようになったと思いますが、そこで何とか踏み止まれたのも事前のリハーサルのおかげです。あれが無ければもうボロボロの結果になったに違いありません。協力してくださった皆さん、本当にありがとうございました。

session 2
Room 1 現場で使えるDjangoのセキュリティ対策／Akihito Yokose#djangocongress #サイボウズ pic.twitter.com/aVrSsqKhsY
— C.KaeDe (@chigusa_kaede) May 18, 2019

質問

想定よりも時間がかかってしまいましたが、発表は42分頃に終わりました。そこで出た質問について補足します。

Q．{% csrf_token %}タグを入れ忘れてしまうのを防ぐ方法はないのか？

POST リクエストを送信する form 要素に {% csrf_token %}タグを入れ忘れると、403 エラーが出ます。しかしながら、CsrfViewMiddleware を無効にするなり @csrf_exempt デコレータを利用したりすると、CSRF 検証はされずに脆弱性が露呈してしまいます。会場では、設定ファイルのセキュリティチェックをしてくれる「python manage.py check --deploy」を実行すれば CsrfViewMiddleware が無効化されていることをチェックできるかも知れないと回答しましたが、それを改めて検証してみました。

実際に CsrfViewMiddleware を「MIDDLEWARE」からコメントアウトして check コマンドを実行すると、期待通りに CsrfViewMiddleware が無効化されているという警告が出ました。

(venv) $ python manage.py check --deploy
...（略）...
?: (security.W003) You don't appear to be using Django's built-in cross-site request forgery protection via the middleware ('django.middleware.csrf.CsrfViewMiddleware' is not in your MIDDLEWARE). Enabling the middleware is the safest approach to ensure you don't leave any holes.

いい感じですね。

反響

いろいろと反響をいただきましたが、一番驚いたのがこれです。

“現場で使える Django のセキュリティ対策 / Django security measures for business (DjangoCon JP 2019) - Speaker Deck” https://t.co/RVDhmEMIUb
— 徳丸浩 (@ockeghem) 2019年5月18日

あの徳丸さんにTweetしてもろた！😲マジか！

徳丸さんは、私の発表でも紹介した Webアプリのセキュリティ対策の金字塔「徳丸本」こと『体系的に学ぶ安全なWebアプリケーションの作り方第2版』の著者です。現場でも必読書になっています。

体系的に学ぶ安全なWebアプリケーションの作り方第2版［リフロー版］　脆弱性が生まれる原理と対策の実践

作者:徳丸浩
出版社/メーカー: SBクリエイティブ
発売日: 2018/09/20
メディア: Kindle版
この商品を含むブログを見る

あと夕方頃に気付いたのがこちら。Speaker Deck のスライド資料が、はてなブックマークのホットエントリーに入っていたみたいです。

今日の DjangoCongress で発表したスライド資料が、はてなブックマークのホットエントリーに入ったみたいです 😆https://t.co/h1UAytQmED #djangocongress pic.twitter.com/1RmtvwABh9
— akiyoko /「現場で使えるDjangoの教科書」販売中 (@aki_yok) May 18, 2019

最後に

今年の DjangoCongress JP 2019（Day 1 カンファレンスデー）はセッションもパーティーも大盛況で、大御所イベントのような安定感がありました。これも、ずっと前からこの日のために動いてくれていたスタッフの皆さんの準備、運営、そして情熱のおかげです。本当にありがとうございました。昨年も参加させていただき、そして今年はセッション発表の機会をいただいて、このような素晴らしい場で発表側に回れたことは大変光栄に感じています。おかげさまで昨年のリベンジもできました。またたくさんの方にセッションを聴きにくださり、嬉しくそして心強かったです。機会があれば来年もチャレンジしてみたいと思います。

Django の薄い同人誌3冊の見本誌を会場に持っていっているので、興味ある方はお声掛けください。

今日は直接販売はしませんが、最後のじゃんけん大会に何冊か提供していますのでぜひご参加を😊#djangocongress pic.twitter.com/puWk8Uyx1y
— akiyoko /「現場で使えるDjangoの教科書」販売中 (@aki_yok) May 18, 2019

ビアパーティーのピンチョス！#djangocongress pic.twitter.com/Eqi38ICj4U
— akiyoko /「現場で使えるDjangoの教科書」販売中 (@aki_yok) May 18, 2019

↧

DRF を使うなら必読！『現場で使える Django REST Framework の教科書』を技術書典7 で頒布します

September 16, 2019, 8:33 pm

≫ Next: PyCharm で Django の開発をするなら絶対やっておくべき便利な設定

≪ Previous: DjangoCongress JP 2019 で「現場で使える Django のセキュリティ対策」というタイトルで登壇してきました

9月22日に開催される技術書典7に、「あきよこブログ」として 4回目のサークル参加をします。

みなさん安心してください、今回も Django 本ですよ 😁

新刊は『現場で使える Django REST Framework の教科書』です。

　あきよこブログ（技術書典7）

「Django REST Framework（通称 DRF）」にピンと来ない方がいるかもしれませんが、「Django」の上に乗っかった、API を作ることに特化したライブラリです。つまり DRF は、Python で REST API を作るためのフレームワークです。SPA（シングルページアプリケーション）やスマホアプリのバックエンドとして利用されることが多いです。Django も DRF も日本ではあまり知られていませんが、実は海外では結構有名です。

どんな内容？

技術書典6 で頒布した前作『現場で使える Django REST Framework の薄い本』にかなり大幅な加筆・改訂を加えて、「Django の教科書」シリーズとしてリニューアルしました。前作の124ページに対して、今作は204ページと大ボリュームの仕上がりになっています。

今のところ、同人誌を含めて日本でオンリーワンの「Django REST Framework」の日本語書籍になっています。

内容は、Django REST Framework を現場で使う際に必要となる基礎知識と発展的な Tips をまとめたものになっています。なお、Django REST Framework は Django をベースにしている部分があるので、Django についての解説に紙面を割いているところもあります。

対象読者

対象読者としては、

Django は何となく分かるが、Django REST Framework は初めてという方
Django REST Framework のまとまった日本語情報を手に入れたい方
Django REST Framework ＋ Vue.js で SPA を構築したい方
現場で本格的に Django REST Framework を使いたい方

を想定しています。

前作の薄い本と何が違うの？

ざっと挙げるとこんな違いがあります。

本文が204ページに大幅増（前作の124ページから1.6倍！）
DRF のコンポーネントの解説が充実
ユニットテストの章を新設
Tips（発展編）のトピック数が 5 ⇒ 13 に（ページ数は 11p ⇒ 31p）
各種ライブラリは最新バージョンに対応

一番の特徴は、コンポーネントの解説を充実させたことです。「モデル・シリアライザ・ビュー・URLconf」で1つの章になっていたのを、それぞれ独立した章として新設しました。ページ数では、モデル 1p ⇒ 18p、シリアライザ 8p ⇒ 18p、ビュー 14p ⇒ 25p、URLconf 5p ⇒ 8p とそれぞれ大幅に増えています。特に、シリアライザは DRF の中でも大きな部分を占めるので、図を増やしてイチから分かりやすい解説を目指しました。

あとは、Django 初心者に少し優しくなりました。特に、前作ではモデルについての説明を「Django と同じ。以上！」としていたのを、きちんと章立てをして解説しています。内容は『現場で使える Django の教科書《基礎編》』からのほぼ抜粋になりますが、スッキリとまとめ直した上で DRF 向けに修正を加えています。

全体としては、加筆を120ページほどおこなっています。

そして、「そこまで言われても、前作の薄い本買っちゃったしなぁ。どうしよう・・」と悩んでいるあなたに朗報です。

前作『～の薄い本』を技術書典7に持ってきていただいた方、先着50名に、なんとワンコイン（500円）で新刊を買えるサービスを実施します！

ただし、お一人様1冊限りでお願いします（薄い本にはスタンプを押させていただきますのでご了承ください）。

頒布本情報

既刊の『現場で使える Django の教科書《基礎編》』『現場で使える Django の教科書《実践編》』を含めて、「Django の教科書」シリーズが３冊揃っています。

なおいつものように「会場特別価格」です。

f:id:akiyoko:20190917121916p:plain:w300

f:id:akiyoko:20190917121947p:plain:w300

実は今回の技術書典に合わせて《実践編》を１年振りにリニューアルして、Django 2.2 対応等をおこないました。

BOOTHで品切れ状態だった『現場で使えるDjangoの教科書《実践編》』ですが、ご希望にお応えして技術書典7で再販します。https://t.co/c2QczAIzhS

この一週間ずっと改訂作業をしていました。
・Django 2.2 対応
・4ページ増（180ページ）
その他諸々。思った以上に大変だった😇#技術書典 #Django pic.twitter.com/jzSB2WQdkT
— akiyoko/お74C@技術書典7「現場で使えるDRFの教科書」 (@aki_yok) September 14, 2019

これらの既刊については、Amazon や BOOTH で電子版とペーパー版が販売中です。

◆ 現場で使える Django の教科書《基礎編》 - Amazon（電子版・ペーパー版）

作者:横瀬明仁
発売日: 2018/08/21
メディア: Kindle版
この商品を含むブログを見る

◆ 現場で使える Django の教科書《基礎編》 - BOOTH（ペーパー版）
現場で使える Django の教科書《基礎編》【紙の本】 - あきよこブログ（akiyoko blog） - BOOTH

◆ 現場で使える Django の教科書《実践編》 - Amazon（電子版）

作者:横瀬明仁
発売日: 2018/12/08
メディア: Kindle版
この商品を含むブログを見る

◆ 現場で使える Django の教科書《実践編》 - BOOTH（ペーパー版）
現場で使える Django の教科書《実践編》【紙の本】（技術書典6バージョン） - あきよこブログ（akiyoko - BOOTH

頒布場所

日時は 9/22（日）11時から17時まで、頒布場所は池袋サンシャインシティ3F 展示ホール「お74C」の「あきよこブログ」です。

見本誌を置いてますので、立ち読みだけでもお気軽にどうぞ。

f:id:akiyoko:20190917122645p:plain

　あきよこブログ（技術書典7）

最後に

余裕をもって始めたはずの執筆ですが、急遽、《実践編》の改訂と増版をしたのもあり、今回もギリギリの入稿になってしまいました。出すものは全部出した感があるので、自分なりにスッキリしています。技術書典当日は晴れやかに迎えられそうです！

↧

PyCharm で Django の開発をするなら絶対やっておくべき便利な設定

December 5, 2019, 2:31 pm

≫ Next: Django モデルのフィールドの「auto_now_add」「auto_now」オプションの挙動を詳しく調べてみた

≪ Previous: DRF を使うなら必読！『現場で使える Django REST Framework の教科書』を技術書典7 で頒布します

この投稿は「Django Advent Calendar 2019 - Qiita」 6日目の記事です。

Python 開発の IDE には「PyCharm」を激推ししている akiyoko です。
推しの理由は、以下の点が非常に有用だと感じているからです（JetBrains のステマじゃないですよん 😅）。

インストールしたそのままの状態で快適に使える
「venv」（仮想環境を作成するためのモジュール）や「pip」（パッケージ管理ツール）のコマンドの使い方が分からなくても、画面からポチポチと操作できる
コードジャンプ機能と自動整形機能を使うことで開発効率が著しく向上する
デバッグ実行を使うことでコード解析が捗る

中でもデバッグ実行が便利ですよね。ライブラリの中もどんどん潜ってデバッグ実行できるので、障害解析やコードの理解が格段に捗ります。

Django の開発をする際にももちろん PyCharm を愛用しています。プライベートでは有償版の PyCharm Professional Edition を利用していますが、仕事では無償版の PyCharm CE（Community Edition）を利用しています。

PyCharm の開発元 JetBrains の昨年の調査によると、Webアプリ開発をするときは 30〜40％くらいの方が PyCharm（有償版・無償版を合わせて）を利用しているとのこと。私の周りのつよつよ Pythonista の方でも PyCharm を愛用している人は多いです。

この記事を書くにあたって事前に統合開発環境（IDE）の利用状況をアンケートしてみたのですが、

Python で Webアプリケーション開発をしている方にアンケートです。

統合開発環境（IDE）は何を使っていますか？#Django
— akiyoko/ 『現場で使えるDjangoの教科書』著者 (@aki_yok) December 5, 2019

PyCharm の利用率が 30〜40％なのは JetBrains の調査と概ね合致します。
それにしても、VS Code の勢いがすごいですね！
Webアプリ開発ではフロントエンドまわりの面倒も見なくてはいけないことが多々あるので、JS まわりのサポートが弱い PyCharm CE（無償版）よりも、VS Code が選ばれるという状況があるのかなと感じました。皆さま、アンケートにご協力ありがとうございました 🙇‍♂️

前置きが長くなりましたが、ここから本題です。

有償版・無償版を問わず、PyCharm を利用して Django プロジェクトの開発をするなら「これだけはぜひ設定しておいてほしい」という便利な設定があります。

それは、「runserver」の実行（Run / Debug）設定です。

この設定をすることで、

ワンクリックで runserver のデバッグ実行が可能
runserver の実行で PyCharm のターミナルツールウィンドウを専有しない

というメリットが得られます。

runserver の実行（Run / Debug）設定

では、その設定方法です。*1

Django プロジェクトのひな型を作成する際に「startproject」コマンドを実行すると、管理コマンドを実行するための「manage.py」が自動生成されますよね。

その「manage.py」を右クリックし、「Create 'manage' ...」を選択します。なお、すでにこのプロジェクトで Run / Debug 設定をしたことがある場合は「manage.py」の右クリック時にこの選択肢が表示されないのでご注意ください（その場合は「Run」>「Edit Configurations...」メニューから Run / Debug の設定をおこなってください）。

f:id:akiyoko:20191203080923p:plain

Run / Debug 設定画面が表示されるので、「Parameters」に「runserver」と入力して、「OK」をクリックします。この際、「Name」には、分かりやすいようにたとえば「runserver」と入力しておけばよいでしょう。

f:id:akiyoko:20191203080931p:plain:w500

Run / Debug 設定を済ませると、ナビゲーションバーの右側に「runserver」との表示がされます。

f:id:akiyoko:20191203080957p:plain

「runserver」の右側の虫アイコンをクリックすればデバッグ実行が開始されます。

f:id:akiyoko:20191203081003p:plain:w400

デバッグ実行を開始すると、デバッグツールウィンドウ（Debug タブ）が起動してコンソールにログが出力されます。コードの途中にブレークポイントを置いておけば、コードが実行されたときにそこで中断されて変数などがデバッグができるようになります。

f:id:akiyoko:20191204003907p:plain

デバッグツールウィンドウの使い方については、公式ヘルプの「デバッグツールウィンドウ - ヘルプ | PyCharm」を参照してください。

いつもなら runserver を実行するのに

> python manage.py runserver

というコマンドをターミナルツールウィンドウ（Terminal タブ）を使って実行するところを、デバッグ実行はそれとは別のデバッグツールウィンドウ（Debug タブ）上で動作するため、ターミナルのウィンドウを専有することがありません。このため、makemigration、migrate、createsuperuser などの管理コマンドを実行するために、わざわざターミナル上で実行している runserver を停止して、その後 runserver を再実行する・・なんてことをする手間が不要になるのです。

これは便利ですよね〜 😚

おまけ ①

ここで、便利な裏技（？）をひとつ紹介します。

デバッグ実行中にブレークポイントでコードの実行を止めた状態ではデバッグツールウィンドウに「Debugger（デバッガ）」と「Console（コンソール）」という2つのタブが表示されます。ここで、「Console」タブをクリックして、Python ロゴのアイコン（Show Python Prompt）をクリックしてみてください。

f:id:akiyoko:20191205033219p:plain:w550

すると、任意の Python コードが、止めたコード内で実行できるようになります。
ハイ、便利〜 😆

おまけ ②

runserver 実行時にオプションを指定したい場合がありますよね。

そんな場合は、ナビゲーションバー右側の「runserver」をクリックし、「Edit Configurations...」を選択して Run / Debug の設定画面を開きます（「Run」>「Edit Configurations...」メニューからでも開くことができます）。

f:id:akiyoko:20191205041253p:plain:w500

「Parameters」に設定している「runserver」のところを「runserver --settings xxx」などと書き換えることで、実行時のオプションが指定可能です。

f:id:akiyoko:20191205041641p:plain

また、「Environment variables」から「DJANGO_SETTINGS_MODULE」などの環境変数を設定することも可能です。

おまけ ③

runserver の他によく利用する Django の管理コマンドとして、「test」（ユニットテストの実行）があります。

今回紹介した runserver の実行設定と同じようにワンクリックで Django プロジェクトのユニットテストを実行したい場合は、次のように「runserver」の設定をコピーするのが簡単です。

コピーしたら、「Parameters」を「test」に書き換えます（「Name」も適宜「test」などと書き換えます）。

f:id:akiyoko:20191205041944p:plain

あとは、「Run」アイコンか「Debug」アイコンをクリックするだけで Django プロジェクトのユニットテストが実行できるようになります。

f:id:akiyoko:20191205043241p:plain:w500

おまけ ④

ここまでくると、Coverage.py を利用したカバレッジもワンクリックで実行したいですよね。

こんな感じで Run / Debug 設定をすれば OK です。

f:id:akiyoko:20191205042003p:plain

f:id:akiyoko:20191205042020p:plain

ポイントは、「Script path」のところを「Module name」に変更してから、「coverage」と手入力するところですかね（仮想環境下にインストールされた coverage の絶対パスを「Script path」に指定してもよいですが）。もちろん、pip で coverage をインストールしておいてくださいね。

ちなみに、有償版の PyCharm Professional では、PyCharm に内蔵された独自のカバレッジ機能を使ってワンクリックでカバレッジを取得することができます。*2

まとめ

PyCharm で Django の開発をするなら、runserver の実行（Run / Debug）設定をやっておきましょう。

「manage.py」を右クリックして「Create 'manage' ...」を選択
Run / Debug 設定画面で「Parameters」に「runserver」と入力して「OK」

これだけです。ほんの5分足らず（もしかしたら1分くらいで？？）で設定は終わります。

runserver のデバッグ実行をポチッとワンクリック（ショートカットもあります）でスタートできる便利さを味わうと、もう PyCharm から離れられませんよ〜 😙

Enjoy Django & PyCharm !! 😉

f:id:akiyoko:20191206074253p:plain

明日は、nogisshさんの「Django Advent Calendar 2019 - Qiita」7日目の記事です。よろしくお願いします。

宣伝

Django の本を３冊書きました。Django 開発のお供にどうぞ。

現場で使える Django の教科書《基礎編》

Amazon（電子版／ペーパー版）

作者:横瀬明仁
発売日: 2018/08/21
メディア: Kindle版

BOOTH（ペーパー版）

現場で使える Django の教科書《実践編》

Amazon（電子版）

現場で使える Django REST Framework の教科書（Django の教科書シリーズ）

作者:横瀬明仁
発売日: 2018/12/08
メディア: Kindle版

BOOTH（ペーパー版）

現場で使える Django REST Framework の教科書

Amazon（電子版）

作者:横瀬明仁
発売日: 2019/09/23
メディア: Kindle版

BOOTH（ペーパー版）

*1:PyCharm のバージョンは Community Edition（無償版）の「2019.3」（現時点での最新バージョン）です。

*2:ビルトイン開発者用ツール - 機能 | PyCharm

↧

Django モデルのフィールドの「auto_now_add」「auto_now」オプションの挙動を詳しく調べてみた

May 21, 2020, 4:18 pm

≫ Next: 新刊『現場で使える Django 管理サイトのつくり方』頒布のお知らせ

≪ Previous: PyCharm で Django の開発をするなら絶対やっておくべき便利な設定

Django モデルに登録日時や更新日時のフィールドを付加する場合、「auto_now_add」オプションや「auto_now」オプションを利用すると便利です。それらのオプションの挙動について詳しく調べてみたので、まとめておきます。

f:id:akiyoko:20200521233958p:plain

TL;DR

フィールドの auto_now_add, auto_now オプションについて

登録時
・auto_now_add=True
・auto_now=True
更新時
・auto_now=True
のフィールドに現在日時が自動でセットされる。

ただし、任意の値をセットできない。https://t.co/jqOYzylLxj

freezegun を使うと簡単にテストできる。#Djangoメモ
— akiyoko/ 『現場で使えるDjangoの教科書』 (@aki_yok) May 21, 2020

挙動

たとえば、

shop/models.py

from django.db import models


classBook(models.Model):
    """本モデル"""classMeta:
        db_table = 'book'
        verbose_name = verbose_name_plural = '本'

    title = models.CharField('タイトル', max_length=255)
    price = models.PositiveIntegerField('価格', null=True, blank=True)
    created_at = models.DateTimeField('登録日時', auto_now_add=True)
    updated_at = models.DateTimeField('更新日時', auto_now=True)

    def__str__(self):
        return self.title

というフィールドがあるとすると、

登録時
「auto_now_add=True」のフィールド（created_at）に現在日時が自動的にセットされる
「auto_now=True」のフィールド（updated_at）に現在日時が自動的にセットされる
更新時
「auto_now=True」のフィールド（updated_at）に現在日時が自動的にセットされる

という挙動になります。

つまり、テストを書くとこういうことになります（参考までに freezegunと unittest.mockを使ったものを併記）。

shop/tests/test_models.py

from datetime import datetime
from unittest.mock import patch

from django.test import TestCase
from django.utils import timezone
from freezegun import freeze_time

from ..models import Book


classTestBook(TestCase):

    @freeze_time('2020-01-01 01:01:01')
    deftest_save_with_freezegun(self):
        book = Book(title='Django本', price=1500)
        # 登録
        book.save()

        # 登録日時・更新日時のどちらも値がセットされる
        self.assertEqual(book.created_at, datetime(2020, 1, 1, 1, 1, 1, tzinfo=timezone.utc))
        self.assertEqual(book.updated_at, datetime(2020, 1, 1, 1, 1, 1, tzinfo=timezone.utc))

        with(freeze_time('2020-02-02 02:02:02')):
            # 更新
            book.save()

        # 更新日時のみが更新される
        self.assertEqual(book.created_at, datetime(2020, 1, 1, 1, 1, 1, tzinfo=timezone.utc))
        self.assertEqual(book.updated_at, datetime(2020, 2, 2, 2, 2, 2, tzinfo=timezone.utc))

    @patch('django.utils.timezone.now',
           return_value=datetime(2020, 1, 1, 1, 1, 1, tzinfo=timezone.utc))
    deftest_save_with_mock(self, _mock_now):
        book = Book(title='Django本', price=1500)
        # 登録
        book.save()

        # 登録日時・更新日時のどちらも値がセットされる
        self.assertEqual(book.created_at, datetime(2020, 1, 1, 1, 1, 1, tzinfo=timezone.utc))
        self.assertEqual(book.updated_at, datetime(2020, 1, 1, 1, 1, 1, tzinfo=timezone.utc))

        _mock_now.return_value = datetime(2020, 2, 2, 2, 2, 2, tzinfo=timezone.utc)
        # 更新
        book.save()

        # 更新日時のみが更新される
        self.assertEqual(book.created_at, datetime(2020, 1, 1, 1, 1, 1, tzinfo=timezone.utc))
        self.assertEqual(book.updated_at, datetime(2020, 2, 2, 2, 2, 2, tzinfo=timezone.utc))

　
フィールドに現在日時が自動的にセットされる仕組みを見てみると、次のように、pre_save() で django.utils.timezone.now() が呼ばれています。

django.db.models.fields.DateTimeField.pre_save　*1

defpre_save(self, model_instance, add):
        if self.auto_now or (self.auto_now_add and add):
            value = timezone.now()
            setattr(model_instance, self.attname, value)
            return value
        else:
            returnsuper().pre_save(model_instance, add)

そして django.utils.timezone.now() では、Django の設定ファイルの「USE_TZ」が True の場合は datetime.datetime.utcnow() が呼ばれています。

django.utils.timezone.now　*2

defnow():
    """    Return an aware or naive datetime.datetime, depending on settings.USE_TZ."""if settings.USE_TZ:
        # timeit shows that datetime.now(tz=utc) is 24% slowerreturn datetime.utcnow().replace(tzinfo=utc)
    else:
        return datetime.now()

freezegun の freezegun.api.FakeDatetime が次のように datetime.datetime.now() や utcnow() などをモックしてくれているので、「auto_now_add」や「auto_now」にも適用できるのですね。よかった。

freezegun.api.FakeDatetime　*3

classFakeDatetime(with_metaclass(FakeDatetimeMeta, real_datetime, FakeDate)):

    ...（略）...

    @classmethoddefnow(cls, tz=None):
        now = cls._time_to_freeze() or real_datetime.now()
        if tz:
            result = tz.fromutc(now.replace(tzinfo=tz)) + cls._tz_offset()
        else:
            result = now + cls._tz_offset()
        return datetime_to_fakedatetime(result)

    ...（略）...

    @classmethoddefutcnow(cls):
        result = cls._time_to_freeze() or real_datetime.utcnow()
        return datetime_to_fakedatetime(result)

    ...（略）...

「auto_now_add」や「auto_now」を使うことによる弊害

便利でよいのですが、二点ほど弊害があります。

1．任意の値で更新できない

実例を挙げると、

>>> from shop.models import Book
>>> from datetime import datetime
>>> from django.utils import timezone
>>> book = Book()
>>> book.updated_at = datetime(2020, 1, 1, 1, 1, 1, tzinfo=timezone.utc)
>>> book.save()
>>> book.updated_at
datetime.datetime(2020, 5, 21, 6, 41, 7, 219328, tzinfo=<UTC>)

という感じで、保存時に現在日時で上書きされてしまいます。

（参考）www.ianlewis.org

しかしながら、登録日時や更新日時フィールドに「auto_now_add」および「auto_now」オプションを利用する場合、任意の値で更新したいユースケースとしてはユニットテストのときくらいでしょうから、実害はあまり無いと言えるかもしれません。
　

2．管理サイトの詳細画面で表示されない

「auto_now_add」もしくは「auto_now」オプションを利用すると、自動的に editable オプションが False になるので、管理サイトの詳細画面で表示されなくなります。

f:id:akiyoko:20200521232712p:plain

django.db.models.fields.DateField.__init__　*4

classDateField(DateTimeCheckMixin, Field):
    ...（略）...

    def__init__(self, verbose_name=None, name=None, auto_now=False,
                 auto_now_add=False, **kwargs):
        self.auto_now, self.auto_now_add = auto_now, auto_now_add
        if auto_now or auto_now_add:
            kwargs['editable'] = False
            kwargs['blank'] = Truesuper().__init__(verbose_name, name, **kwargs)

    ...（略）...

classDateTimeField(DateField):
    ...（略）...

    # __init__ is inherited from DateField

詳細画面にフィールドを表示するだけであれば（任意の値で登録・更新できないが）、ModelAdmin の「fields」と「readonly_fields」に同時に列挙することで対応は可能です。

shop/admin.py

from django.contrib import admin

from .models import Book


classBookAdmin(admin.ModelAdmin):
    fields = ('title', 'price', 'created_at', 'updated_at')
    readonly_fields = ('created_at', 'updated_at')


admin.site.register(Book, BookAdmin)

f:id:akiyoko:20200521233140p:plain

これらの弊害については一応解決策がありますが、ちょっと面倒です。あまりオススメしません。

stackoverflow.com

宣伝

Django の本を３冊書きました。Django 開発のお供にどうぞ。

現場で使える Django の教科書《基礎編》

★ Amazon（電子版／ペーパー版）

横瀬明仁／ NextPublishing Authors Press (2018/8/26)

★ BOOTH（ペーパー版）

現場で使える Django の教科書《実践編》

★ Amazon（電子版）

横瀬明仁／ Amazon Services International,Inc.

現場で使える Django REST Framework の教科書 (Django の教科書シリーズ)

★ BOOTH（ペーパー版）

現場で使える Django REST Framework の教科書

★ Amazon（電子版）

横瀬明仁／ Amazon Services International,Inc.