cgql

cgql

Clojure と ClojureScript 間のデータ転送用の GraphQL からインスピレーションを得たクエリ言語。

免責事項

このプロジェクトは、Clojure を学ぶという私の探求として生まれました。私はこのアイデアが気に入ったので、今後数か月でさらに開発する予定です。現段階では、楽しみ以外のプロジェクトで使用するにはあまりにも生々しいです。ご提案やフィードバックは大歓迎です。

話

私はもう何年もプロダクトマネジメントの仕事をしています。錆びついたプログラミング スキルを発揮するために、何か新しいことを学ぶことにしました。 Clojure、特にその一部である ClojureScript については良いことをたくさん聞いていたので、選択は簡単でした。私はそれを学ぶことに決めましたが、別のToDoリストアプリを実行することは私には魅力的に思えませんでした。 GraphQL は、フロントエンドの作業中に試せなかったもう 1 つの機能だったので、演習として Clojure に実装することにしました。すぐに、Clojure の素晴らしさにより、(Clojure だけに限定するのであれば) はるかにエレガントなものが得られることに気付き、10 ～ 12 回の反復を経て、非常に多くの機能が非常に少量のコードに詰め込まれたようになりました。

何ができるのか

• API を記述し、1 つの単純なマップで実装をバインドします
• そのマップに基づいてドキュメントを生成する
• (clojure.spec) モジュールを使用してリクエストとレスポンスを検証する
• 無制限のネストとクエリへの参照をサポート
• リクエストするサーバーコンテキストをサポート (セッションなど)
• edn を使用したネイティブ Clojure 構造での自動シリアル化と逆シリアル化をサポートします。 「cljs.reader/register-tag-parser!」を使用してカスタム構造を取得することもできます。

(そう、これらすべてはコメント付きで約 350 行のコードに含まれています)

読み方

メインコードは「core.cljc」ファイル内にあり、その使用例は「cgql-demo.cljc」ファイル内にあります。

次は

1. これを使用してペットプロジェクトを作成し、ユーザビリティに関する前提条件 (To-Do リストはありません!) を検証します。
2. プロジェクトから得た知識を基に、必要な変更を行い、テストでカバーします。
3. 文書化してさらに活用しましょう。

素晴らしい機能はまだ実装されていません (ただし、いつか実装されるかもしれません)

1. スペック用のジェネレーターを使用するサーバーなしで値を生成できること。
2. ドキュメントジェネレーター
3. Clojure を簡単に実行する方法がない貧弱な iOS アプリケーション向けの GrapgQL へのトランスレーター。