Опубликуйте модуль Deno за 3 быстрых шага

Одной из основных особенностей Deno является то, что он не полагается на централизованный сервер пакетов, как Node.js с npm. Любой может опубликовать модуль на своем собственном сервере, и их очень просто использовать благодаря тому, что Deno разрешает URL-адреса для модулей. Давайте посмотрим, как создать, опубликовать и использовать наш первый модуль Deno.

Что такое модули Deno?

Модули Deno — это части, которые вы можете загрузить и использовать в своем проекте, подобно пакетам Node.js. Они могут варьироваться от простой функции до чего-то сложного, такого как Oak, среда промежуточного программного обеспечения для http-модуля Deno.

Deno предоставляет набор стандартных модулей, таких как модуль http, которые проверяются основной командой Deno. Они гарантированно работают вместе с определенной версией Deno и находятся в том же репозитории denoland/deno, где можно найти исходный код Deno.

Стандартные модули размещены по адресу deno.land/std, и к ним можно получить доступ через URL-адреса, как и ко всем другим модулям ES, совместимым с Deno.

Но Deno также поддерживает сторонние модули, такие как Oak, которые вы можете импортировать из любого места в Интернете, например GitHub, личного веб-сервера или CDN, например pika.dev или jspm.io.

Чтобы упростить использование сторонних модулей, Deno предоставляет несколько встроенных инструментов, таких как deno infoи deno doc. Кроме того, веб-сайт Deno также предоставляет веб-интерфейс для просмотра документации модуля, доступной по адресу doc.deno.land.

Веб-сайт также предоставляет простую услугу общедоступного хостинга для модулей ES, совместимых с Deno, которые можно найти по адресу deno.land/x.

Написание вашего модуля Deno

Перед публикацией нам нужно написать наш модуль. Мы собираемся создать простую обратную последовательность слов. Если мы введем «Это весело», он вернет «весело это Это». Очень просто. Создайте новую папку и файл для вашего модуля в ней:

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

Редактируйте mod.tsв своей IDE или редакторе кода по выбору, я буду использовать VS Code. Вставьте в него это:

Обратите внимание, что это код TypeScript . Одной из замечательных особенностей Deno является то, что он изначально поддерживает TypeScript. Поскольку на следующем шаге мы опубликуем наш модуль Deno на GitHub, вы можете добавить простой файл README.mdс некоторой информацией о нем.

Опубликуйте свой модуль Deno

Последний шаг перед публикацией вашего модуля, если вы хотите отправить его в репозиторий Deno, — убедиться, что он отформатирован в соответствии со стандартом форматирования Deno. Для этого вы можете указать Deno отформатировать ваш код, запустив:

deno fmt mod.ts

Мы собираемся опубликовать модуль на GitHub и загрузить его оттуда в наш проект Deno. Бежать:

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

Создайте новый репозиторий на GitHub и оставьте его пустым. GitHub даст вам инструкции по публикации вашего репозитория, аналогичные

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

Это опубликует ваш модуль на GitHub. Успех! Теперь давайте использовать его.

Используйте свой модуль Deno

Напишите новый файл index.tsи добавьте в него это:

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

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

Это загрузит модуль, который вы опубликовали на предыдущем шаге, и будет использовать его для реверсирования строки и регистрации ее результата. Мы можем запустить это с помощью Deno:

deno run index.ts

он будет отображать

fun is This

Твоя очередь

В случае сложных модулей со многими зависимыми модулями вы можете использовать сборщик Deno, который скомпилирует все в один модуль для упрощения публикации. Вы опубликовали модуль Deno? Дайте нам знать об этом в комментариях! И прочтите другие наши статьи о Deno, например, 10 отличных ресурсов для обучения и работы с Deno.