Kent OHASHI lagenorhynque

GraphQL API in Clojure

(defprofile lagénorhynque
  :aliases      [カマイルカ🐬]

今年9月のShibuya.lisp lispmeetup #68で「Interceptors: Into the Core of Pedestal」と題してClojureのサービス/API開発ライブラリ"Pedestal"を簡単に紹介する発表をしました。

最近、Webアプリ開発の仕事でプロジェクトの基盤構築にDuct、API機能開発にPedestalという構成でClojureによるREST APIを開発していて、個人的にもなかなか便利だと感じています。

そこで今回はこのPedestalについて、ちょうど日本語情報も見当たらないので簡単にまとめてみます。

ClojureによるWeb開発のサーバサイドで注目度の高い(マイクロ)フレームワークとしてDuctがあります。

ちょうど1年前の2017年12月に私自身初めてDuctによる簡単なREST APIを試作してみて、その過程をAdvent Calendar記事にしたことがありました。

今回は主にClojure言語のことを知っていてWebアプリ開発に興味のある方向けに、英語も含めてドキュメントのとても少ないDuctというフレームワークがどのようなものなのか、技術的な詳細に踏み込んだ解説を試みます。

ちなみに、執筆時点で参照/動作確認した各種ライブラリのバージョンは、サンプルプロジェクト"hello-duct"のproject.cljの通りです(Duct最新安定版0.11.2のテンプレートのまま)。

(defprofile lagénorhynque
 :name "Kent OHASHI"

(defprofile lagénorhynque

(defprofile lagénorhynque

	lagenorhynchus@lagenorhynque-mbp:code$ mkdir hy-playground
	lagenorhynchus@lagenorhynque-mbp:code$ cd hy-playground/
	lagenorhynchus@lagenorhynque-mbp:hy-playground$ pipenv install hy
	Creating a virtualenv for this project…
	Pipfile: /Users/lagenorhynchus/code/hy-playground/Pipfile
	Using /usr/local/Cellar/pipenv/2018.11.26/libexec/bin/python3.7 (3.7.2) to create virtualenv…
	⠇ Creating virtual environment...Already using interpreter /usr/local/Cellar/pipenv/2018.11.26/libexec/bin/python3.7
	Using real prefix '/usr/local/Cellar/python/3.7.2/Frameworks/Python.framework/Versions/3.7'
	New python executable in /Users/lagenorhynchus/.local/share/virtualenvs/hy-playground-K-WGms8b/bin/python3.7
	Also creating executable in /Users/lagenorhynchus/.local/share/virtualenvs/hy-playground-K-WGms8b/bin/python

	(t/deftest test-list-users
	(with-system [sys (helper/test-system)]
	(with-db-data [sys {:user db-data/user}]
	(t/testing "ユーザの一覧が取得できる"
	(t/testing "ユーザ名指定あり"
	(let [{:keys [status body]}
	(helper/http-post sys "/graphql"
	(venia/graphql-query
	{:venia/queries [[:users {:name "曜"}
	[:id

	{:deps {selmer {:mvn/version "1.12.3"}}
	:paths ["scripts"]}