README.md

Microalg

Langage et environnements dédiés à l’algorithmique.

Site officiel

MicroAlg est une sorte de pseudo-code en français et exécutable sur machine. C’est un langage embarqué dans PicoLisp. Donc :

• c’est un Lisp, donc il n’y a pas de syntaxe à apprendre, juste des commandes,
• elle peut tourner sur plusieurs plates-formes :
  • Javascript (navigateurs ou NodeJS) grâce à EmuLisp,
  • là où PicoLisp (ASM, C) peut tourner nativement,
  • la JVM grâce à Ersatz PicoLisp (une implémentation en Java de PicoLisp, par l’auteur de PicoLisp),
• il est toujours possible si on se sent limité par ce langage, d’utiliser directement PicoLisp dans du code MicroAlg voir par exemple le fichier de tests microalg_tests.malg.

Voir le site officiel pour plus de détails, dont le code est dans ce dépôt.

Installation

Il est possible d’installer MicroAlg sur sa machine ou sur son site.

Voir le fichier INSTALL.md.

Fichiers

Listés dans l’ordre où ils apparaissent sur GitHub.

• dev : différents outils pour les développeurs
• editeurs : fichiers pour l’intégration avec différents éditeurs
  • scite : pour SciTE
    • SciTEGlobal.properties : configuration recommandée et/ou obligatoire pour l’intégration
    • malg.api : contient les signatures des commandes pour les infos-bulles
    • malg_abbrev.properties : permettra de mettre en place une structure en trois ou quatre touches (juste pour voir, relativement vide pour l’instant)
    • malg-*-scite.bat : exécutables permettant d’interpréter un .malg sous Windows et depuis SciTE
    • microalg.lua : le cœur de l’intégration avec l’éditeur (lexer, couleurs, commande pour l’exécution du fichier en cours…)
• emulisp : implémentation de Picolisp en JS (voir le dépôt semi-officiel, mais attention, la version utilisée ici est une version expérimentale, qui guide le développement de la version semie-officielle)
  • pil-njs* script pour lancer EmuLisp sur Node
  • pil-rjs* script pour lancer EmuLisp sur Rhino
• ersatz : implémentation de Picolisp en Java, par le créateur de PicoLisp
  • pil-j* script pour lancer Ersatz
• exemples : quelques fichiers .malg (MicroAlg) ou .l (PicoLisp) en exemples, qui servent aussi pour les tests
• features : tests de fonctionnalité pour les interpréteurs, rédigés en Gherkin
  • cli.py fait le lien entre les mots-clef des tests Gherkin et les actions à prendre pour exécuter concrètement ces tests
• install_scripts : scripts d’installation :
  • fix_lettuce.sh : permet d’utiliser lettuce avec du texte comprenant des accents
  • install_picolisp.sh : pour l’interpréteur officiel de PicoLisp écrit en assembleur et C (d’où peut-être le répertoire picolisp qui traîne)
• jar contient quelques archives Java
  • js.jar Rhino, l’implémentation de Javascript en Java par Mozilla
• lib : quelques fichiers mi-.l mi-.malg
  • xml.l : bibliothèque en PicoLisp pour la génération de XML
• pde/microalg/microalg.pde : pour la sortie graphique, avec Processing ou Processing.js
• pde/microalg.out/ : fichiers générés par Processing
• visuels : divers fichiers graphiques comme par exemple le logo
• web : des fichiers de complément pour les .html de ce projet
  • blockly : un extrait des fichiers du projet permettant de programmer avec des pièces de puzzle (Blockly)
  • blockly_microalg.js : les blocs Blockly et leur générateur, correspondant aux mots-clés prédéfinis de MicroAlg
  • css-ninja-tree : pour afficher le code sous forme d’arbre en HTML/CSS
  • ide_injections.js : contient de quoi intégrer MicroAlg dans une page
  • jquery.terminal* : pour la console ou REPL (site officiel)
  • parenedit.* : pour les parenthèses de couleur
  • jquery.textcomplete.* : pour les suggestions
  • processing.*.min.js : Processing pour le web
  • showdown.* : (github)
  • showup.* : (github)
  • style.css : la feuille de style
  • svg-tree-drawer : pour la visualisation du code sous forme d’arbre en SVG
  • tabIndent.js : pour indenter et désindenter avec la touche TAB
• .gitattributes : fichier de configuration du dépôt git, surtout utilisé pour GitHub
• .gitignore : spécification des fichiers non versionnés intentionnellement
• .travis.yml : spécification des tests automatisés via Travis
• INSTALL.md : documentation complète concernant les différentes manières d’installer MicroAlg.
• LICENSE : la licence
• README.md : ce fichier (j’ai toujours rêvé d’écrire ça)
• doc.html : la documentation de MicroAlg
• faq.html : la foire aux questions de MicroAlg
• ide.html : un IDE web de fortune, accessible ici
• malg : exécutable permettant d’interpréter un .malg avec PicoLisp (ASM/C)
• malg-clj.bat : exécutable permettant d’interpréter un .malg avec MicroAlg-clj (Clojure), mais le .jar n’est pas fourni car réservé aux utilisateurs avancés
• malg-j : exécutable permettant d’interpréter un .malg avec Ersatz (Java)
• malg-j.bat : exécutable permettant d’interpréter un .malg avec Ersatz (Java) sous Windows
• malg-j-repl.bat : exécutable permettant de travailler avec une console interactive avec Ersatz (Java) sous Windows
• malg-njs : exécutable permettant d’interpréter un .malg avec Node et Emulisp
• malg-njs.bat : exécutable permettant d’interpréter un .malg avec Node et Emulisp sous Windows
• malg-njs-repl.bat : exécutable permettant de travailler avec une console interactive avec Node et Emulisp sous Windows
• malg-rjs : exécutable permettant d’interpréter un .malg avec Rhino et Emulisp
• malg-rjs.bat : exécutable permettant d’interpréter un .malg avec Rhino et Emulisp sous Windows
• malg-rjs-repl.bat : exécutable permettant de travailler avec une console interactive avec Rhino et Emulisp sous Windows
• microalg.l : implémentation de MicroAlg en PicoLisp, le cœur de ce projet
• microalg_export*
  • microalg_export.l : fonctions PicoLisp préparant l’export en général
  • microalg_export_arbreninja.l : reprogrammation de MicroAlg pour la visualisation sous forme d’arbre en HTML/CSS
  • microalg_export_arbresvg.l : reprogrammation de MicroAlg pour la visualisation sous forme d’arbre graphique
  • microalg_export_arbretxt.l : reprogrammation de MicroAlg pour la visualisation sous forme d’arbre textuel
  • microalg_export_blockly.l : reprogrammation de MicroAlg pour la mise en place de blocs correspondant à un programme
  • microalg_export_casio.l : reprogrammation de MicroAlg pour l’export d’un programme vers le langage des Casio
  • microalg_export_javascript.l : reprogrammation de MicroAlg pour l’export d’un programme vers JavaScript
  • microalg_export_microalg.l : reprogrammation de MicroAlg pour l’export d’un programme vers MicroAlg
  • microalg_export_processing.l : reprogrammation de MicroAlg pour l’export d’un programme vers Processing
  • microalg_export_python.l : reprogrammation de MicroAlg pour l’export d’un programme vers Python
  • microalg_export_ti.l : reprogrammation de MicroAlg pour l’export d’un programme vers le langage des TI
• microalg_tests* :
  • microalg_tests.malg : les tests des commandes MicroAlg testables avec PicoLisp/MicroAlg seulement
  • microalg_tests.sh : de quoi lancer les tests sur toutes les plates-formes possibles, features non comprises
  • microalg_tests_*.bat : de quoi lancer les tests avec Windows
  • microalg_tests_*.sh : de quoi lancer les tests autrement qu’avec Windows
  • microalg_tests_features.sh : de quoi lancer les tests de fonctionnalité
• tuto*.html : pages web interactives pour apprendre MicroAlg, et plus généralement à faire ses premiers pas en algorithmique et en programmation
  • tuto.html : le tuto historique
  • tuto_blocs.html : le tuto avec les blocs (inachevé par manque de blocs)
  • tuto_graphique.html : le tuto sur les commandes ayant une sortie graphique, dont la tortue
  • tuto_rapide.html : le tuto pour les programmeurs avertis