Comment organiser, tester, documenter et emballer un projet Clojure
-
09-10-2019 - |
Question
J'ai appris un peu Clojure, et j'ai actuellement un seul fichier qui .clj
d'édition I dans un éditeur de texte et que j'exécuter sur la ligne de commande.
Où puis-je trouver un guide sur les aspects pratiques de la mise à l'échelle jusqu'à ce programmes / grandes bibliothèques?
- Comment dois-je disposer de plusieurs fichiers
.clj
sur le système de fichiers? - Comment organiser et exécuter le code de test?
- Comment dois-je documenter le programme / bibliothèque?
- Comment dois-je emballer?
Je suis à la recherche d'informations sur les aspects pratiques sur l'extension des petits scripts pour quelque chose de réel.
La solution
Je recommande d'utiliser Leiningen . Exécution
$ lein new myproject
va créer un nouveau dossier appelé myproject
dans votre répertoire de travail courant avec un défaut squelette structure.
A l'intérieur du nouveau generatedmyproject
dossier que vous trouverez (entre autres) un dossier nommé src
pour le code source de Clojure et un dossier nommé test
pour vos tests (Leiningen va générer un test à défaut par défaut).
Leiningen vous permet d'exécuter vos tests avec lein test
.
Vous pouvez emballer votre projet en tant que fichier jar avec lein jar
ou créer un uberjar (un pot exécutable avec toutes les dépendances comprises) avec lein uberjar
.
Pour générer la documentation Je recommande autodoc qui intègre bien avec Leiningen.
Autres conseils
Si vous utilisez Netbeans, il y a un plugin Clojure qui pourrait vous être utile.
Création d'un projet Clojure avec elle crée un groupe de dossiers: paquets source, qui contient un paquet par défaut appelé com.yourcompany, paquets de test, bibliothèques, qui contient le .jar pour Clojure et un lien vers le JDK, et les bibliothèques de test , qui contient JUnit.