Commencez avec Crystal

Cristal est un générateur de code open source pour tout langage de programmation, framework, CMS et même base de données, il permet de combiner et d'unifier à la fois la configuration et le code, ce qui en fait un outil parfait pour optimiser les temps de développement dans n'importe quel projet.

Sa philosophie est Une entrée - Toute sortie, ce qui signifie une seule entrée - n'importe quelle sortie, et c'est Cristal gère comme données d'entrée des choses aussi simples qu'un JSON, XML ou YAML nous donnant ainsi la possibilité d'utiliser n'importe lequel d'entre eux pour générer du code pour les deux PHP, Python, Java, Rails, Django, Ruby Oui Node.js pour n'en nommer que quelques-uns.

Puisque nous savons ce que nous pouvons faire avec CristalVoyons comment nous l'installons dans notre environnement et mettons cet outil puissant en service.

Installation de cristal

À installer Crystal nous devons avoir dans notre environnement Node.js et son gestionnaire de paquets NMP, une fois que nous aurons vérifié ces exigences, nous allons exécuter la commande suivante pour installer Cristal:

 npm installer crystal-cli -g

Une fois notre installation terminée nous exécutons la commande cristal -v pour vérifier la version du même et vérifier que tout s'est bien passé.

AGRANDIR

Initialisation du cristal

Une fois notre générateur de code installé, nous allons initialiser un nouveau projet de type Cristal. Pour cela, nous allons créer un nouveau répertoire et à l'intérieur, nous allons exécuter la commande suivante :

 initialisation de cristal

Une fois la commande exécutée, Crystal nous demandera d'ajouter des données pour le fichier de configuration, telles que le nom, la description, l'auteur, entre autres.

AGRANDIR

Une fois que nous aurons rempli ces informations, cette commande initialisera notre projet et générera dans le chemin.cristal / notre fichier de configuration config.yml qui devrait ressembler à ceci :

 nom : first_steps_crystal description : Tutoriel montrant l'utilisation de Crystal auteur : nom : Jonathan Acosta email : [email protected] url : www.solvetic.com copyright : '2015'

Ceci est un fichier avec la notation YAML, qui conserve une certaine similitude avec JSON en termes de structure et de facilité de lecture des données qu'il contient. Ayant déjà préparé notre projet pour utiliser les avantages de Cristal Passons à la génération de notre premier code.

Générer notre code

Pour générer du code, Cristal utilise certains éléments qui permettent de réaliser cette tâche, l'un de ces éléments est le Spécifications ou spécifications et sont celles qui permettent de définir les données d'entrée et ainsi de générer une sortie.

Tout ce que nous voulons définir pour être inclus dans notre génération doit être sous notre élément les sorties, où nous devons spécifier à la fois le générateur et les spécifications. Ce qui est responsable du générateur, c'est d'indiquer qu'il doit être généré, par exemple un PHP, Rubis, Un paquet de PÉPIN, un fichier Grognement ou même un fichier readme, qui sera le premier exemple que nous ferons.

outre SpécificationsIl est important d'importer les modules, qui sont ceux qui auront les fonctionnalités pour chaque générateur, spécification, etc. Pour cela nous devons inclure cette ligne dans notre fichier config.yml :

 importations : crystal / readme : ~ 0.2.2

De cette façon, il est beaucoup plus facile de garder une trace des modules que nous voulons inclure dans notre projet, une fois que nous avons ajouté cette ligne, nous n'avons plus qu'à mettre à jour notre projet avec la commande suivante :

 mise à jour du cristal

Cette commande mettra à jour notre projet et installera les modules que nous avons spécifiés dans le importations. Une fois cela fait nous pouvons générer nos sorties, pour cela nous ajouterons les spécifications et le générateur comme suit :

 sorties : - générateur : readme.ReadmeGenerator spec : nom : Readme version : 1.2.3 description : Ceci est un test d'un fichier Readme

Déjà avec notre dossier config.yml terminé, nous n'avons plus qu'à exécuter la commande construire pour générer notre code, en l'occurrence notre fichier Lisez-moi.

Voyons à quoi ressemble notre fichier Lisez-moi généré avec Cristal.

Avec cela, nous avons eu notre première approche avec cet outil puissant, qui en quelques secondes peut générer du code pour les langages que nous voulons, y compris les frameworks et les bases de données, unifiant à la fois les connaissances et les efforts et réduisant considérablement les temps de développement dans nos projets.