akiyoko blog

akiyoko の IT技術系ブログです

2018年の akiyoko blog 振り返り


f:id:akiyoko:20190105062315p:plain:w360

明けましておめでとうございます。
今年も、毎年恒例となっている昨年のブログの振り返りからスタートです。


ちなみに一昨年(2017年)の振り返りはこんな感じでした。

<過去記事>
akiyoko.hatenablog.jp


2018年の akiyoko blog 振り返り

昨年一年間にアップした記事の本数は 12本で、昨年の 37本から約3分の1 に激減してしまいました。その理由はズバリ、ほぼ一年中 Django の執筆をしていたからです。


カテゴリも「Django」の記事が9本、「技術同人誌」の記事は8本(重複あり)となっていて、ブログもまさに「Django の技術同人誌」一色となったのでした。


実は密かに昨年から、勉強会の参加ログを記事として残さないようにしていました。同じ勉強会(fin-py もくもく会 など)に何度も行くようになったのと、単に忙しくて記録を残す時間が取れなかったのが主な理由です。


ブログ記事ごとのアクセス数ランキング(akiyoko blog 2018年)

記事ごとのアクセス数ランキングです。2018年内のアクセス数(*1)ランキング上位 30本をリストアップしています。

なお昨年中に書いた記事 12本中、30位以内に入ったのは 5本でした。 *2


# 昨年比 タイトル 作成日 ポイント
1 「プロジェクトマネージャ試験」に一発合格するための三か条 - akiyoko blog 2014/10/26 116.9
2 PyCharm のオレオレ最強設定 - akiyoko blog 2017/03/10 83.1
3 初学者・初級者向け Django の学習ロードマップ - akiyoko blog 2018/12/01 71.5
4 pandas.DataFrame の列の抽出(射影)および行の抽出(選択)方法まとめ - akiyoko blog 2017/04/03 52.3
5 「一対一」「一対多」「多対多」のリレーションを分かりやすく説明する - akiyoko blog 2016/07/31 47.9
6 IPA「情報セキュリティマネジメント試験」に一夜漬けで合格するためのたった二つの勉強法 - akiyoko blog 2016/11/17 45.7
7 無料版 PyCharm で Django 開発環境を構築するまでの手順(「現場で使える 基礎 Django」本の補講その2) - akiyoko blog 2018/06/17 30.5
8 AppStore 登録前の iOSアプリを Ad-Hoc で配布してインストールする方法 - akiyoko blog 2014/08/23 28.5
9 Git で コミットを無かったことにする方法 (git revert の使い方) - akiyoko blog 2014/08/21 26.3
10 matplotlib のグラフに日本語を表示する方法(文字化け対応) - akiyoko blog 2017/04/11 23.8
11 Video.js を使って HLS形式の動画をストリーミング再生する - akiyoko blog 2015/08/11 23.1
12 Python でリストのソートまとめ - akiyoko blog 2014/09/26 22.0
13 Pandas の DataFrame の基本的な使い方 - akiyoko blog 2017/03/27 16.2
14 まだ CSV の文字化けで消耗してるの?(Excel で直接開いても文字化けしない CSVファイルを Python3 で作成するスマートな方法) - akiyoko blog 2017/12/09 16.1
15 Apple Developer Program の有効期限が切れてしまったときの対処方法 - akiyoko blog 2015/11/13 14.9
16 Mac の MySQL クライアントに「Sequel Pro」を使っているなら PostgreSQL クライアントは「PSequel」がオススメ - akiyoko blog 2016/07/29 14.5
17 Pythonで単回帰直線 - akiyoko blog 2013/06/16 11.5
18 「現場で使える 基礎 Django」ってどんな本? その読みどころをガッチリ解説 - akiyoko blog 2018/06/05 11.4
19 ベスト・オブ・Django本! - akiyoko blog 2016/12/05 11.0
20 Django ORM の select_related, prefetch_related の挙動を詳しく調べてみた - akiyoko blog 2016/08/03 10.7
21 Open BroadCaster Software (OBS) で YouTube ライブストリーミングを使った動画配信をする方法 - akiyoko blog 2016/01/26 9.8
22 Python, Django 界隈の単体テスト事情(unittest / nose / django-nose) - akiyoko blog 2015/01/01 9.5
23 pandas.DataFrame で時系列データの手習い - akiyoko blog 2017/04/10 9.3
24 iMovie の設定あれこれ - akiyoko blog 2016/02/01 9.3
25 Ansible 初心者なら、まずは Ansible Galaxy から始めてみよう - akiyoko blog 2015/12/06 9.2
26 見よ!これが Python製の WordPress風フルスタックCMSフレームワーク「Mezzanine(メザニン)」だ! - akiyoko blog 2015/12/23 9
27 Python で MagicMock を使う - akiyoko blog 2015/01/04 8.9
28 Python で Selenium WebDriver を使ったブラウザテストをする方法 - akiyoko blog 2014/04/29 8.4
29 技術書典5 で頒布される Django / Python の薄い本の情報を集めてみた - akiyoko blog 2018/10/06 8.2
30 仮想通貨税金計算サービス「BITCOINTAX」をリリースしました - akiyoko blog 2018/02/14 8.1


30記事のうち「Python」または「Django」に関係しているものが 19 もランクインしています。その中でも、pandas や matplotlib などのデータ分析系、「PyCharm のオレオレ最強設定 - akiyoko blog」や「無料版 PyCharm で Django 開発環境を構築するまでの手順(「現場で使える 基礎 Django」本の補講その2) - akiyoko blog」などの PyCharm 系の記事が強いなぁという印象です。


今見てみると、中には Python 2 をベースにしている古い記事もあったり、そもそも Python のバージョンを記事の中に明記していなかったりして不親切なものも多いなと感じます(書き換えたいけど時間がない・・)。



今年の目標

今年も akiyoko blog の目標は特にありません。

今執筆している本をきちんと出すことと、さらに Django を盛り上げていくのが、個人的な今年の目標です。今年もよろしくお願いします。

*1:純粋な PV数ではなく、作成日からの日数で割ったポイントで算出しています。

*2:作成日のところを黄色く塗っています。

技術書を執筆するために本当に大事なこと

この投稿は 「技術同人誌 Advent Calendar 2018 - Adventar」 の8日目の記事です。

はじめに

世の中には二種類の人間がいる。
書くのが得意な人間と、苦手な人間である。


私は後者の「書くのが苦手な人間」です。

「技術書典で本まで出しておいて何を言っているんだ」と言われるかもしれませんが、執筆中は、書くことが苦痛でたまりません。

学生の頃、夏休みの感想文(しかも2冊)を最終日までノータッチだったたことがあるくらい本の読み書きが苦手なのです(その後1日で2冊読んで感想文を2つ書き上げたのが私のベンチマーク・オブ・火事場のクソ力になっているのですが、それはまた別の話)。

そんな私がどうやって技術書典の同人誌(180ページ)を書き上げたかという「秘密」についてお話しします。

《宣伝》

技術書典5 の新刊『現場で使える Django の教科書《実践編》』(紙の本)が BOOTH で販売中です。
booth.pm

最近、電子版も出しました。

現場で使える Django の教科書《実践編》

現場で使える Django の教科書《実践編》


執筆に大事な3つの「コウ」

まず、執筆には次の三つの「コウ」が大事です。

  • 実行(ジッコウ)
  • 推敲(スイコウ)
  • 健康(ケンコウ)


「実行」は、まず書いてみること。
書かないことには何も始まりません。はじめの一行を書くこと。そこからすべては動き出します。


そして、「推敲」。
書いた文章は叩けば叩くほど、つまり赤入れすればするほど、強くなって蘇ってくる「サイヤ人」みたいなものだと常々感じています。「せっかく調べたからあれもこれも書き残しておこう」などとすぐに文章をテンコ盛りにしてしまうのが私の悪い癖です。削れば削るほど文章は良くなる、というのは自分の中ではほぼ真理です。


最後に、「健康」。
私の場合は日中は普通に仕事をしているので、執筆の時間はだいたい夜、〆切が近いと明け方までずっと執筆や推敲、技術検証やレビューなどをしていました。今振り返ると、1ヶ月半よく体がもったものだと思います。気力があるときは体を壊さないと言いますが、きっとそうだったのでしょう。しかしながら、日常的に健康な体をキープできないと執筆に大きな支障が出ます。ちょっとしたスキマ時間にも執筆できてしまう環境を作ってしまうと、出かけたり、運動したりする時間が失われてしまいます。執筆は短距離走ではなく、マラソンと捉えてスケジューリングするのがよいでしょう(自戒)。

そして一番大事なこと

上の3つももちろん大事なのですが、本の執筆に一番大事なのは「情熱」です。 これはもう疑いようがありません。

特に〆切が近づくと「あかん。。」「終わらん。。」「とりあえず Hulu でアニメ見よ。。」と何度も投げ出しそうになりますが、それをグッとこらえて机に向かわせるのは「これを絶対世に出すぞ!」と体の奥から湧き上がってくるパッションにほかなりません。そしてそのパッションは、「この本を待ち望んでいる人がいる!」と半ば勝手に思い込むこと、あるいはもっと俗っぽく「どうだ、すごいだろ!」と自慢したいということから湧き上がってきたりするのでしょう。

執筆は本当にツライです。自分で執筆してみてはじめて世に出ている本の裏側の苦労が分かるようになりました。きっとどんな本も著者の情熱がなければ生み出されないのでしょう。今ではそう信じています。

最後に

このように、本というものは著者のいろんな犠牲の上に作られた奇跡の一品です。だから Amazon のレビュry

4月の技術書典4で本を出してから8ヶ月ほど経ちますが、技術同人誌を書く前は想像もしていなかったことが今起こっています。

  • 同人誌をきっかけに仕事の依頼が来た
  • 商業誌の依頼が来た
  • 勉強会や読書会で講師をするようになった
  • クラシックを聴くようになった

最後のは、いつもだらだらと観ていたTVが執筆の邪魔になり、バックグラウンドミュージックとしてクラシックを聴くようになったという変化です。どうやら私はワルツが好きらしく、いい意味でどの曲も曲調が変わらないのがその理由だと分析しています。

久々のポエムでした。

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

この投稿は 「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は難しいと感じますか?」という問いに、4人に1人の方(全体の25%)が「Django は難しい」と回答しました。「簡単」と答えた方は10人に1人(9.8%)しかいませんでした。


f:id:akiyoko:20181201085304p:plain:w450
Q4.「Djangoは難しいと感じますか?」

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

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


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


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


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


オススメ教材リンク(ビフォー Django)

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

初学者向け(★)

《 Web技術 》

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


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

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


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 参考書です。


『Python3 入門ノート』(書籍)

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


『Pythonチュートリアル 第3版』(書籍)

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


初級者向け(★★)

《 Python 》

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


『Pythonエンジニア ファーストブック』(書籍)

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


脱初級者〜中級者向け(★★★)

《 インフラ 》

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

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


オススメ教材リンク(アフター Django)

初学者向け(★)

《 全体像 》

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


Djangoフレームワークの紹介(その他)

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


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

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

qiita.com


《 チュートリアル 》

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


Django Girls チュートリアル(チュートリアル)

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

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

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

はじめに · Django Girls Tutorial


公式チュートリアル(チュートリアル)

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

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


Python Django入門 (1)(ブログ)

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

qiita.com


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

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

paiza.jp


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

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

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


DjangoBrothers チュートリアル(チュートリアル)

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

www.djangobrothers.com


Python Django 超入門(書籍)

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


『Django for Beginners: Learn web development with Django 2.0』(書籍)

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


Django チュートリアル| MDN(チュートリアル)

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

developer.mozilla.org


初級者向け(★★)

『現場で使える Django の教科書《基礎編》』(書籍)

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

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

akiyoko.hatenablog.jp



脱初級者〜中級者向け(★★★)

『現場で使える Django の教科書《実践編》』(書籍)

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

現在、紙の本を BOOTH という(技術同人誌を含めた)同人誌を多く扱ったオンラインショップで、電子版を Amazon で販売中です。

《紙の本》
booth.pm

《電子版》


『Two Scoops of Django』(書籍)

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

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

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


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

akiyoko.hatenablog.jp


『どじゃんご本 #1』(書籍)

Python / Django 界隈で有名な jbking さんの Django の薄い本。REST framework についての解説もあり。そのほか、認証・認可、ページネーションの発展的な内容についても触れています。
しかしこんなにお安くていいんでしょうか?? 何かの間違いでは??

booth.pm


『実践レシピ おいしく使うDjango』(書籍)

Route 312 さんの技術書典5の新刊。ファイル操作、バックグラウンド処理についての章があり、詳しく書かれています。

booth.pm


その他のお役立ちサイト

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

narito ブログ

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

narito.ninja


okoppe8@Qiita

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

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


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

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


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

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

nwpct1.hatenablog.com


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

codezine.jp


Django 管理画面逆引きメモ

qiita.com


Django のおすすめライブラリ

qiita.com


最後に

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

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

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


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

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

*2:ProgatePyQなど

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

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

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

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

*7:django-docs localization

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

akiyoko です。

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


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



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


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


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


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

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

techbookfest.org



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



Python 関連

ス01:株式会社 インプレス(カブシキガイシャインプレス)

techbookfest.org

あ05:データリファインメント(データリファインメント)


Kaggleのチュートリアル第2版(108ページ / ¥1,000)

techbookfest.org

あ10:Secure旅団


俺らの愛したセキュリティ(¥1,000)

techbookfest.org

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


マスタリング docutils(32ページ)

techbookfest.org

う04:改善屋tech

techbookfest.org

え12:PEAKS


ゼロから創る暗号通貨(304ページ / ¥3,600)

techbookfest.org

え39:つばめさんチーム


趣味のPython(80ページ / ¥500)

techbookfest.org

お21:日経BP出版局

techbookfest.org

か04:仮面の人

techbookfest.org

か09:Thunder Claw


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

techbookfest.org

か19:なにココ


PyCharmのすすめ ~デプロイとデバッグ編~(¥500)

techbookfest.org

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

techbookfest.org

か49:KLab 株式会社


KLab Tech Book Vol. 2(76ページ / ¥500)

techbookfest.org

き07:eMbLog


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

techbookfest.org

き21:74th


Fabric & Invoke Quick Guide(8ページ / 無料)


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

techbookfest.org

く05:craft by SKDN


【委託】Hello worldカルタ(¥1,900)

techbookfest.org

く11:暗黙の型宣言


「改訂版」流体計算で覚えるPython3(第2版)(188ページ / ¥500)

techbookfest.org

け02:電脳律速


株とPytnonでお金儲けを目指す本2(42ページ / ¥500)


株とPytnonでお金儲けを目指す本(84ページ / ¥1,000)

techbookfest.org



Django 関連

f:id:akiyoko:20181006210430p:plain

う08:黒塗りのビール


黒ビール好きの【IonicとDjangoの本】(100ページ / ¥1,000)

techbookfest.org

か05:jbking


どじゃんご本#1(72ページ / ¥1,000)

techbookfest.org

か06:あきよこブログ


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


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

techbookfest.org

か07:みる会


Visual Studioで お気楽Web開発 Python + Django(48ページ / ¥300)

techbookfest.org

か08:Route 312


実践レシピ おいしく使うDjango(56ページ / ¥500)

techbookfest.org

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


nuxtとvuesaxとDjangoで作るモダンなサービスの作り方。tipsもあるよ!(28ページ / ¥500)

techbookfest.org


まとめ

Python 盛り上がれ。Django もっともっと盛り上がれ~!

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

akiyoko.hatenablog.jp

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

akiyoko です。

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




【2018/10/11 追記】
技術書典5に来れなかった方のために、オンラインショップの「BOOTH」にて紙の本を販売開始しました。これ以上の増刷や電子版の販売は現在のところ予定しておりませんので、この機会にぜひどうぞ。

booth.pm


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

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

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

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

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

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

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


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

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

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


表紙

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

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



f:id:akiyoko:20180930140739p:plain:w250

f:id:akiyoko:20181002010006p:plain:w250


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


目次

気になる目次は、



f:id:akiyoko:20180930140511p:plain:w250

f:id:akiyoko:20180930140547p:plain:w250




第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

本の厚さは(1円玉より大きい)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版 を出すための作業をしていたので、執筆期間は実質1ヶ月半くらいでしょうか。書き始めた頃はまさかこんなページ数になろうとは考えもしませんでした。9月は特に酷くて、毎日のように朝までボロボロになるまで書き続けていました(昼間は Django じゃない仕事があって何もできないので・・)。


頒布本情報

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

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

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

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


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

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

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

◆ Kindle(電子版)

現場で使える Django の教科書《基礎編》

現場で使える Django の教科書《基礎編》

◆ Kindle(ペーパーバック版)

現場で使える Django の教科書《基礎編》

現場で使える Django の教科書《基礎編》



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

techbookfest.org

f:id:akiyoko:20180930143251p:plain


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



「Django 島」について

そして、全国の Django 好きの皆さんに朗報!!
何と今回の技術書典5では、Django の薄い本(技術同人誌)が7冊(新刊5冊・既刊2冊)出る予定 です。皆さん、10/8(祝・月)は池袋に集合やで~!!


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

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

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

akiyoko です。

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

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


◆ Kindle(電子版)

現場で使える Django の教科書《基礎編》

現場で使える Django の教科書《基礎編》

◆ Kindle(ペーパーバック版)

現場で使える Django の教科書《基礎編》

現場で使える Django の教科書《基礎編》



改訂内容

技術書典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 で一度挫折したことがある方

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

目次

目次は次の通りです。
本文は全部で180ページです(目次およびあとがきを含む)。


第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選



f:id:akiyoko:20180930125128p:plain:w190

f:id:akiyoko:20180930125146p:plain:w190

f:id:akiyoko:20180930125206p:plain:w190



Amazon レビューより

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

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


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

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

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


まとめ

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

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


◆ Kindle(電子版)

現場で使える Django の教科書《基礎編》

現場で使える Django の教科書《基礎編》

◆ Kindle(ペーパーバック版)

現場で使える Django の教科書《基礎編》

現場で使える Django の教科書《基礎編》


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

techbookfest.org

speakerdeck.com

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

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

補講その2として今回は、「無料版 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

《2018/8/17 追記》
BOOTH で販売していた技術書典4バージョンの「現場で使える 基礎 Django」(紙の本)はおかげさまで完売いたしました。そしてこのたび、36ページの加筆(本文144⇒180ページ)、Django 2.1 対応などの改訂をおこなった「現場で使える Django の教科書《基礎編》」を Kindle Direct Publishing で出版することになりました。電子版と紙の本を予定しています。






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図の作成機能があるので、プロジェクトによってはニーズはあると思います。

akiyoko.hatenablog.jp


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

手順の解説

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

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

f:id:akiyoko:20180617162502p:plain


1.Python 3 をインストール

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


(参考)

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

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

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


2.PyCharm をインストール

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

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


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

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

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

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

Q.Python インタープリタのパスは何を設定すればよい?
A.macOS であれば「which python3」で表示されるパス (*12)、Windows であれば「where python」で表示されるパスを指定します。

Q.Django をローカルPC にインストールするのはなぜ?
A.以下の理由があります。

  • 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 の開発に取り組めますよね。あとはこの本を読んで勉強するだけですよね。

booth.pm


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

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

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


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

《過去記事》
akiyoko.hatenablog.jp