Publiez un module Deno en 3 étapes rapides

L’une des principales fonctionnalités de Deno est qu’il ne repose pas sur un serveur de packages centralisé comme Node.js l’a fait avec npm. N’importe qui peut publier un module sur son propre serveur et c’est très simple de les utiliser, grâce aux URL de résolution de Deno pour les modules. Voyons comment créer, publier et utiliser notre premier module Deno.

Que sont les modules Deno ?

Les modules Deno sont des éléments que vous pouvez télécharger et utiliser dans votre projet, similaires aux packages Node.js. Ils peuvent aller d’une fonction simple à quelque chose de complexe comme Oak, un framework middleware pour le module http de Deno.

Deno fournit un ensemble de modules standard tels que le module http qui sont examinés par l’équipe principale de Deno. Ceux-ci sont garantis pour fonctionner avec une version spécifique de Deno et vivre dans le même  référentiel denoland/deno où le code source Deno peut être trouvé.

Les modules standard sont hébergés sur deno.land/std et sont accessibles via des URL comme tous les autres modules ES compatibles Deno.

Mais Deno prend également en charge des modules tiers comme Oak que vous pouvez importer depuis n’importe quel emplacement sur le Web, comme GitHub, un serveur Web personnel ou un CDN comme pika.dev ou jspm.io.

Pour faciliter l’utilisation de modules tiers, Deno fournit des outils intégrés tels que deno infoet deno doc. De plus, le site Web de Deno fournit également une interface utilisateur Web pour afficher la documentation du module, disponible sur doc.deno.land.

Le site Web fournit également un service d’hébergement public simple pour les modules ES compatibles Deno qui peuvent être trouvés sur deno.land/x.

Écrire votre module Deno

Avant de publier, nous devons écrire notre module. Nous allons créer un simple pour inverser une séquence de mots. Si nous saisissons "C’est amusant", cela renverra "C’est amusant". Très simple. Créez un nouveau dossier et le fichier de votre module :

mkdir reverse-words
cd reverse-words
touch mod.ts

Modifiez mod.tsdans votre IDE ou l’éditeur de code de votre choix, j’utiliserai VS Code. Collez-y ceci :

Notez qu’il s’agit de code TypeScript . L’une des grandes fonctionnalités de Deno est qu’il prend en charge TypeScript de manière native. Étant donné qu’à l’étape suivante, nous publierons notre module Deno sur GitHub, vous voudrez peut-être ajouter un simple README.mdavec quelques informations à ce sujet.

Publiez votre module Deno

Une dernière étape avant de publier votre module au cas où vous souhaiteriez l’envoyer au référentiel de Deno consiste à vous assurer qu’il est formaté conformément à la norme de formatage de Deno. Pour ce faire, vous pouvez demander à Deno de formater votre code en exécutant :

deno fmt mod.ts

Nous allons publier le module sur GitHub et le télécharger à partir de là dans notre projet Deno. Courir:

git init
git add. git commit -m "Initial commit"

Créez un nouveau référentiel sur GitHub et laissez-le vide. GitHub vous donnera des instructions pour publier votre repo, similaire à

git remote add origin git@github.com:/.git   
git push -u origin master            

Cela publiera votre module sur GitHub. Succès! Maintenant, utilisons-le.

Utilisez votre module Deno

Écrivez un nouveau fichier index.tset ajoutez-y ceci :

import reverseWords from 'https://raw.githubusercontent.com/startfunction/reverse-words/master/mod.ts';

console.log( reverseWords( 'This is fun') );

Cela chargera le module que vous avez publié à l’étape précédente et l’utilisera pour inverser une chaîne et enregistrer son résultat. Nous pouvons exécuter ceci avec Deno :

deno run index.ts

il s’affichera

fun is This

À ton tour

Dans le cas de modules complexes avec de nombreux modules dépendants, vous pouvez utiliser le bundler de Deno qui compilera tout dans un seul module pour une publication plus facile. Avez-vous publié un module Deno ? Faites le nous savoir dans les commentaires! Et lisez nos autres articles sur Deno comme 10 excellentes ressources pour apprendre et travailler avec Deno.