この記事は、LISPっぽいけど一応Python その2 Advent Calendar 2015の5日目の記事です。

HyのREADMEに"Django + LISP"という一文があり、DjangoアプリをHyでも実装できるというコンセプトを示したソースコードが示されていますが、これだけでは何をどうすればいいか分からないので、startprojectするところからステップを追って解説します。

githubにレポジトリを作り、ステップごとにコミットを分けてpushしたので参考にしてください。

https://github.com/csakatoku/hellohy

`startproject`する

ひとまず普通のPythonでdjango-admin.py startprojectします。使用しているDjangoのバージョンは1.9です。

django-admin.py startproject hellohy

startprojectした段階のコミットがこれです。

https://github.com/csakatoku/hellohy/commit/d8e579c3199969196f325538299560fd5508cc28

`.py`を`.hy`に書き換える

すべてのプログラミング言語はLISPに至るので、出来る限りPythonコードを排除して、Hyで置き換えたいと思います。

プロジェクトの作成直後のコードをHyに書き換えたコミットがこれです。

https://github.com/csakatoku/hellohy/commit/9d59e77bb304521910a56add2f6926008da7fb45

少し躓いた点は以下の2つです。

manage.pyをHyに置き換えても、hy manage.hy runserverが動かなかったので、このファイルだけは諦めました。
Hyでモジュールを定義するには、起動スクリプト(この場合manage.py)にimport hyを入れる必要があるようです。
シングルクォートはHy(LISP)では特殊な意味を持つので、文字列はすべてダブルクォートに変更しました。

Pythonのimport x, from y import zのHyの変換の仕方は、ここを見れば一目瞭然です。

http://docs.hylang.org/en/latest/language/api.html#import

この段階で、manage.py以外のすべてのpyファイルを消しても、python manage.py runserverが動くようになり、実際にブラウザでもアクセスできます。

`app_template`を作成

startprojectの後はstartappでDjangoアプリケーション・モジュールを追加するのがDjangoの定番の流れですが、この段階でstartappしてもPythonモジュールが追加されるのは分かりきっていたので、先にアプリケーション・テンプレートを追加します。

それが、このコミットです。

https://github.com/csakatoku/hellohy/commit/91bdbc5bc13231585ef72ea2773d9a45226cb304

このapp_templateを使ってstartappを実行します。

python manage.py startapp --template=hellohy/app_template -ehy myapp

ポイントは、

--templateで独自のアプリケーション・テンプレートのディレクトリを指定する。
-eでテンプレートとして扱うファイルの拡張子を追加する。

ことです。

上記コマンドでmyappというアプリケーションを作り、myapp.views.topというごく単純なテンプレートを表示するビューを追加したコミットがこちらです。

https://github.com/csakatoku/hellohy/commit/ce9c5271d2fd8082ab8b8a3e0a244bf518d1870b

モデルを定義する

HyのチュートリアルにDjangoのモデルっぽいサンプルコードがありますが、この段階でそれが擬似コードではなく、実際に動くコードであるというのが確認できます。

モデルを足して、データベース上のデータを表示するようにしたコミットがこちらです。

https://github.com/csakatoku/hellohy/commit/496d2c4dd27baf5cddfa0c1a2040410711d54fb6

モデルの定義は以下のようになっています。

(import [django.db [models]]
        [django.utils.timezone :as timezone])

(defclass Topic [models.Model]
  [title (models.TextField)
   url (models.URLField)
   created_at (models.DateTimeField :default timezone.now)])

Topicとは何らかのニュースのタイトルをソースのURLを表したオブジェクトと考えてください。重要なのは次の点です。

defclassは最新開発版のHyの構文を使っています。
クラスプロパティはdefclassマクロの3番目の引数にリストで与えます
Pythonのキーワード引数models.DateTimeField(default=timezone.now)は(models.DateTimeField :default timezone.now)のように表現します。

モデルを定義した後に、makemigrations, migrateする手順は通常のDjangoと同じです。

ビューを実装する

上で定義したTopicオブジェクトを複数件取得してテンプレートをレンダリングする例です。

(import [django.shortcuts [render]]
        [myapp.models [Topic]])

(defn top [req]
  (def topics (-> (Topic.objects.all)
                  (.order_by "-id")))
  (render req "top.html" {"topics" topics}))

プライマリキーでオブジェクトを取得してテンプレートをレンダリングする例。

(import [django.shortcuts [render]]
        [django.http [Http404]]
        [myapp.models [Topic]])

(defn topic_detial [req topic_id]
  (def topic (try
              (Topic.objects.get :pk topic_id)
              (except [e Topic.DoesNotExist] (raise Http404))))
  (render req "topics/topic_detail.html" {"topic" topic}))

以下のコミットで一覧と詳細のビューを追加するところまで実装しています。

https://github.com/csakatoku/hellohy/commit/e8d254ce09c3fb9fadecfb3bdb8ccf74453230dc

ユニットテスト

Djangoを使うことのメリットにユニットテストがしやすいということがあると思うので、今回もユニットテストを足しておくことにしましょう。

それが、このコミットです。

https://github.com/csakatoku/hellohy/commit/1808d0d9d1ca41ecd1aee9e1abd0322307111f42

本当はこのtests.hyだけでユニットテストが実行できればよかったのですが、テストランナーが.hyを見つけてくれなかったので、裏技のような感じになってしまいますが、同名の空の.pyファイルを足しています。

この裏技は何とかしたいと思いますが、とりあえずテストは通っています。

$ python manage.py test myapp
Creating test database for alias 'default'...
....
----------------------------------------------------------------------
Ran 4 tests in 0.051s

OK
Destroying test database for alias 'default'...

最後に

HyでDjangoアプリを実装していく手順を紹介しました。

ご自身でも試してもらえればお分かりになると思いますが、HyでもDjangoのパワーを100%引き出せそうなので、すべてのプログラミング言語はLISPに至るというのを実感できますね。

次回はHyで書いたDjangoアプリを実環境にデプロイする方法を通じて、Hyの可能性を探っていきたいと思います。