cgql

cgql

Язык запросов на основе GraphQL для передачи данных между Clojure и ClojureScript.

Отказ от ответственности

Этот проект родился как мое стремление изучить Clojure. Мне нравится эта идея, и я планирую развивать ее дальше в ближайшие месяцы. На данном этапе он слишком сырой, чтобы его можно было использовать в каких-либо проектах, кроме развлечения. Любые предложения и отзывы приветствуются!

История

Я занимаюсь управлением продуктами уже много лет. Чтобы потренировать свои заржавевшие навыки программирования, я решил изучить что-то новое. Я слышал много хороших отзывов о Clojure, особенно о его части ClojureScript, поэтому выбор был простым. Я решил изучить это, но создание еще одного приложения со списком дел мне не показалось привлекательным. GraphQL — это еще одна вещь, которую мне не удалось опробовать во время работы над интерфейсом, поэтому я решил реализовать ее в Clojure в качестве упражнения. Вскоре я понял, что величие Clojure может привести к чему-то гораздо более элегантному (если вы ограничитесь только Clojure), и теперь, спустя 10-12 итераций, у меня есть довольно много функций, упакованных в очень небольшой объем кода.

Что он может сделать

• Опишите свой API и привяжите реализацию на одной простой карте.
• Генерировать документы по этой карте
• Проверка запросов и ответов с помощью модулей (clojure.spec).
• Поддерживает неограниченное количество вложений и ссылок на запросы.
• Поддерживает контекст сервера для запроса (например, сеансы)
• Поддерживает автоматическую сериализацию и десериализацию в любой собственной структуре Clojure с использованием edn. Вы даже можете получить собственные структуры с помощью cljs.reader/register-tag-parser!

(да, все это примерно в 350 строках кода с комментариями)

Как это читать

Основной код находится внутри файла «core.cljc», а пример его использования — в файле «cgql-demo.cljc».

Дальше

1. Напишите какой-нибудь домашний проект, используя это для проверки предположений (никаких списков дел!) об удобстве использования.
2. Имея знания по проекту, внесите необходимые изменения и покройте тестами.
3. Документируйте и используйте больше.

Великие вещи не реализованы (но могут быть однажды)

1. Возможность генерировать значения без сервера, используя генераторы для спецификаций.
2. Генератор документов
3. Переводчик на GrapgQL для тех бедных приложений iOS, у которых нет возможности легко запускать Clojure.