cgql

cgql

Eine von GraphQL inspirierte Abfragesprache für die Datenübertragung zwischen Clojure und ClojureScript.

Haftungsausschluss

Dieses Projekt entstand aus meiner Suche nach dem Erlernen des Clojure. Die Idee gefällt mir und ich habe vor, sie in den nächsten Monaten weiterzuentwickeln. Zum jetzigen Zeitpunkt ist es viel zu roh, um es in einem anderen Projekt als zum Spaß zu verwenden. Alle Vorschläge und Rückmeldungen sind willkommen!

Geschichte

Ich beschäftige mich nun schon seit Jahren mit dem Produktmanagement. Um meine eingerosteten Programmierkenntnisse zu trainieren, beschloss ich, etwas Neues zu lernen. Ich habe viel Gutes über Clojure gehört, insbesondere über ClojureScript, daher fiel mir die Wahl leicht. Ich beschloss, es zu lernen, aber es schien mir nicht reizvoll, eine andere To-Do-Listen-App zu erstellen. GraphQL war eine weitere Sache, die ich während der Arbeit am Frontend nicht ausprobieren konnte, also beschloss ich, es als Übung in Clojure zu implementieren. Bald wurde mir klar, dass die Größe von Clojure etwas viel Eleganteres hervorbringen kann (wenn man sich nur auf Clojure beschränkt), und jetzt, 10-12 Iterationen später, habe ich ziemlich viele Funktionen in einer sehr kleinen Menge Code verpackt.

Was es kann

• Beschreiben Sie Ihre API- und Bindungsimplementierung in einer einfachen Karte
• Generieren Sie Dokumente anhand dieser Karte
• Validieren Sie Anfragen und Antworten mithilfe von (clojure.spec)-Modulen
• Unterstützt unbegrenzte Verschachtelung und Verweise auf Abfragen
• Unterstützt Serverkontext zum Anfordern (z. B. Sitzungen)
• Unterstützt die automatische Serialisierung und Deserialisierung in jeder nativen Clojure-Struktur mithilfe von edn. Mit „cljs.reader/register-tag-parser!“ können Sie sogar benutzerdefinierte Strukturen erhalten.

(Ja, das alles in etwa 350 Zeilen Code, mit Kommentaren)

Wie man es liest

Der Hauptcode befindet sich in der Datei „core.cljc“ und ein Beispiel für seine Verwendung befindet sich in der Datei „cgql-demo.cljc“.

Als nächstes

1. Schreiben Sie damit ein Lieblingsprojekt, um Annahmen (keine To-Do-Listen!) zur Benutzerfreundlichkeit zu überprüfen.
2. Nehmen Sie mit den Erkenntnissen aus dem Projekt erforderliche Änderungen vor und decken Sie sie mit Tests ab.
3. Dokumentieren und nutzen Sie mehr.

Große Dinge wurden nicht umgesetzt (aber vielleicht eines Tages)

1. In der Lage sein, Werte ohne Server mithilfe von Generatoren für Spezifikationen zu generieren.
2. Dokumentengenerator
3. Übersetzer für GrapgQL für schlechte iOS-Anwendungen, die Clojure nicht einfach ausführen können.