Il s'agit d'un serveur de langue pour les documents de langage de flux de travail communs.
(Cliquez pour la galerie de capture d'écran de fonctionnalité)
runBenten est écrit à l'aide de Python3 et développé contre VS Code. Le composant de serveur de langue fonctionnera avec n'importe quel éditeur / IDE qui offre une prise en charge du serveur de langue. La mise en évidence de la syntaxe n'est actuellement disponible que pour l'extension de code vs. L'extension VS Code est écrite en dactylographie.
Recherchez "Benten" sur le marché. Le nom de l'extension du client est Rabix / Benten. Suivez la méthode habituelle pour installer l'extension.
Si vous n'avez pas installé le serveur Benten séparément (voir ci-dessous), le client tentera de trouver et de télécharger une version de serveur correspondante à partir de la page GitHub Release.
Benten nécessite Python 3.7 ou version ultérieure
Si vous installez à partir de Source, vous aurez besoin de Git sur votre système
Une façon intéressante d'installer benten dans un ENV virtuel (l'isoler de votre système Python) et de pouvoir l'appeler comme exécutable régulier est d'utiliser pipx
pip3 install pipx # in case you don't have pipx
pipx ensurepath # ensures CLI application directory is on your $PATH
Maintenant, vous pouvez installer Benten avec
pipx install benten
Si vous avez déjà installé Benten, vous pouvez le mettre à niveau
pipx upgrade benten
Si votre installation Python de base est antérieure à 3,7, vous pouvez dire pipx d'utiliser 3,7 pour Benten
pipx install benten --python python3.7
Notes:
pipx installe les exécutables dans $HOME/.local/bin ( %HOMEPATH%.localbin pour Windows). Cela doit être ajouté à votre variable Env de chemin. pipx ensurepath fait cela pour vouspipx install peut être effectuée à partir d'un autre environnement virtuel. Ceci est utile lorsque vous avez une version globale incompatible de Python que vous souhaitez garder mais que vous souhaitez toujours installer Benten. Vous pouvez créer un Env virtual avec Python> 3.7 et invoquer les commandes d'installation à partir de là. sudo apt install python3-pip python3-venv
Si vous essayez de réinstaller ou de mettre à jour le serveur sur Windows avec le serveur en cours d'exécution (par exemple parce que vous avez en cours d'exécution de code vs), vous devrez fermer le serveur (par exemple en sortant vs du code) avant de mettre à jour.
Pour installer à partir de la branche maîtresse
pipx install git+https://github.com/rabix/benten.git
Pour installer à partir de développer une succursale (ou une autre branche):
pipx install git+https://github.com/rabix/benten.git@develop
Ou, si vous avez cloné le référentiel et que vous souhaitez jouer avec le code du serveur lui-même:
pipx install -e benten # benten is the name of the directory with the cloned code
Voir cette page s'il vous plaît.
Le survol d'une expression affichera le résultat de l'évaluation ou des erreurs rencontrées. Benten génère automatiquement les entrées de processus, les sorties et les sorties intermédiaires (si le processus est un flux de travail). Notez que ce sont toutes des données d'échantillons générées au hasard destinées à la vérification rapide des expressions.
Les données d'échantillons sont générées automatiquement à la demande lorsqu'une évaluation est demandée. Les exemples de données générées sont également stockées dans un fichier à gratter. Ce fichier à gratter est accessible en cliquant sur "Accédez à la définition" en fonction de toute expression. Normalement, ce fichier est juste écrasé à chaque fois avec des données fraîches générées au hasard.
Si vous souhaitez personnaliser certaines des exemples de données (par exemple, vous avez des cas de test spécifiques que vous souhaitez vérifier lorsque vous codez le workflow) si vous ajoutez la chaîne (exactement)
#custom
À la première ligne de l'exemple de fichier de données, Benten cessera d'écraser le fichier et d'utiliser le contenu de ce fichier personnalisé à la place.
Une fois que vous avez ajouté cette ligne à l'exemple de fichier de données, Benten ne remplacera plus ce fichier. Si vous souhaitez que les données de test soient régénérées (par exemple, vous avez modifié le schéma d'entrée de la CWL), vous devez supprimer cette première ligne sentinelle et Benten régénera l'entrée.
Benten s'attache à votre éditeur de texte régulier et offre une aide par le biais de validations automatique et de validations de documents, de sorte que la plupart de ses fonctionnalités sont exposées naturellement via l'interface utilisateur régulière de l'éditeur, et un tutoriel spécialisé n'est pas nécessaire, mais certains conseils et astuces utiles sont répertoriés sur cette page.
Voir la documentation de développement
Apache 2.0
Peter Amstutz pour la formule Pyinstaller et la fonction de téléchargement automatique sur l'extension du code vs.
Peter van Heusden pour la distribution Benten Conda.
Le code de communication client-serveur de bas niveau est tiré du serveur de langage Python de SourceGraph (maintenant défunt), tout comme le code client VS Code (qui était basé à l'origine du code d'exemple de Microsoft). L'aperçu CWL utilise Vis.js
Saraswati est la déesse hindoue de l'apprentissage et de la connaissance et il y a longtemps, elle a visité le Japon, où elle est connue sous le nom de Benzaiten ( Benten pour faire court) et son sitar s'est transformé en biwa japonais mais elle a gardé certains de ses nombreux armes.
Benzaiten est la déesse de tout ce qui coule: l'eau, le temps, les mots, la parole, l'éloquence, la musique et par extension, la connaissance. Par conséquent, Benten est une déesse appropriée pour les développeurs de flux de travail scientifiques.
Références