Publique um módulo Deno em 3 etapas rápidas

Um dos principais recursos do Deno é que ele não depende de um servidor de pacotes centralizado como o Node.js fez com o npm. Qualquer um pode publicar um módulo em seu próprio servidor e é muito simples usá-los, graças ao Deno resolvendo URLs para módulos. Vamos ver como criar, publicar e usar nosso primeiro módulo Deno.

O que são módulos Deno?

Os módulos Deno são partes que você pode baixar e usar em seu projeto, semelhantes aos pacotes Node.js. Eles podem variar de uma função simples a algo complexo como Oak, uma estrutura de middleware para o módulo http do Deno.

O Deno fornece um conjunto de módulos padrão, como o módulo http, que são revisados ​​pela equipe principal do Deno. Estes são garantidos para trabalhar junto com uma versão específica do Deno e viver no mesmo  repositório denoland/deno onde o código-fonte do Deno pode ser encontrado.

Os módulos padrão estão hospedados em deno.land/std e podem ser acessados ​​via URLs como todos os outros módulos ES compatíveis com Deno.

Mas o Deno também suporta módulos de terceiros como Oak que você pode importar de qualquer local na web, como GitHub, um servidor web pessoal ou um CDN como pika.dev ou jspm.io.

Para facilitar o consumo de módulos de terceiros, o Deno fornece algumas ferramentas integradas como deno infoe deno doc. Além disso, o site da Deno também fornece uma interface do usuário da web para visualização da documentação do módulo, disponível em doc.deno.land.

O site também fornece um serviço de hospedagem pública simples para módulos ES compatíveis com Deno que podem ser encontrados em deno.land/x.

Escrevendo seu módulo Deno

Antes de publicar, precisamos escrever nosso módulo. Vamos criar um simples para reverter uma sequência de palavras. Se inserirmos “This is fun" ele retornará “fun is This”. Muito simples. Crie uma nova pasta e o arquivo para o seu módulo nela:

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

Edite mod.tsem seu IDE ou editor de código de sua preferência, usarei o VS Code. Cole isso nele:

Observe que este é o código TypeScript. Um dos grandes recursos do Deno é que ele suporta TypeScript nativamente. Como na próxima etapa publicaremos nosso módulo Deno no GitHub, talvez você queira adicionar um simples README.mdcom algumas informações sobre ele.

Publique seu módulo Deno

Um passo final antes de publicar seu módulo, caso você esteja interessado em enviá-lo para o repositório do Deno, é garantir que ele esteja formatado de acordo com o padrão de formatação do Deno. Para fazer isso, você pode dizer ao Deno para formatar seu código executando:

deno fmt mod.ts

Vamos publicar o módulo no GitHub e baixá-lo de lá em nosso projeto Deno. Corre:

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

Crie um novo repositório no GitHub e deixe-o vazio. O GitHub fornecerá instruções para publicar seu repositório, semelhante a

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

Isso publicará seu módulo no GitHub. Sucesso! Agora vamos usá-lo.

Use seu módulo Deno

Escreva um novo arquivo index.tse adicione isso nele:

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

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

Isso carregará o módulo que você publicou na etapa anterior e o usará para reverter uma string e registrar seu resultado. Podemos executar isso com Deno:

deno run index.ts

ele irá exibir

fun is This

Sua vez

No caso de módulos complexos com muitos módulos dependentes, você pode querer usar o bundler do Deno que compilará tudo em um único módulo para facilitar a publicação. Você publicou um módulo Deno? Deixe-nos saber nos comentários! E leia nossos outros artigos sobre o Deno como 10 ótimos recursos para aprender e trabalhar com o Deno.