cgql

cgql

Un langage de requête inspiré de GraphQL pour le transfert de données entre Clojure et ClojureScript.

Clause de non-responsabilité

Ce projet est né de ma quête pour apprendre le Clojure. J’aime l’idée et je prévois de la développer davantage dans les mois à venir. Au stade actuel, c'est beaucoup trop brut pour être utilisé dans un projet autre que pour le plaisir. Toutes suggestions et commentaires sont les bienvenus !

Histoire

Je fais de la gestion de produits depuis des années maintenant. Pour exercer mes compétences en programmation rouillées, j'ai décidé d'apprendre quelque chose de nouveau. J'ai entendu beaucoup de bonnes choses à propos de Clojure, en particulier de la partie ClojureScript, donc le choix a été facile. J'ai décidé de l'apprendre, mais créer une autre application de liste de tâches ne me semblait pas attrayant. GraphQL était une autre chose que je n'ai pas pu essayer en travaillant sur le front-end, j'ai donc décidé de l'implémenter dans Clojure comme exercice. Bientôt, j'ai réalisé que la grandeur de Clojure pouvait donner quelque chose de beaucoup plus élégant (si vous vous limitez à Clojure uniquement) et maintenant, 10 à 12 itérations plus tard, j'ai beaucoup de fonctionnalités regroupées dans une très petite quantité de code.

Ce qu'il peut faire

• Décrivez votre API et liez l'implémentation dans une carte simple
• Générer des documents par cette carte
• Valider les demandes et les réponses à l'aide des modules (clojure.spec)
• Prend en charge l'imbrication illimitée et les références aux requêtes
• Prend en charge le contexte du serveur à demander (par exemple les sessions)
• Prend en charge la sérialisation et la désérialisation automatiques dans toute structure Clojure native utilisant edn. Vous pouvez même obtenir des structures personnalisées avec « cljs.reader/register-tag-parser ! »

(oui, tout ça en environ 350 lignes de code, avec commentaires)

Comment le lire

Le code principal se trouve dans le fichier "core.cljc" et un exemple de son utilisation se trouve dans le fichier "cgql-demo.cljc".

Ensuite

1. Écrivez un projet animalier en utilisant ceci pour vérifier les hypothèses (pas de listes de tâches !) sur la convivialité.
2. Avec la connaissance du projet, effectuez les modifications requises et couvrez-les par des tests.
3. Documentez et utilisez davantage.

De grandes choses non mises en œuvre (mais pourraient le devenir un jour)

1. Être capable de générer des valeurs sans serveur en utilisant des générateurs de spécifications.
2. Générateur de documents
3. Traducteur vers GrapgQL pour les applications iOS pauvres qui n'ont pas de moyen d'exécuter Clojure facilement.