Denoify: For NPM module authors that would like to support Deno but don't want to write a port

栏目: IT技术 · 发布时间: 4年前

内容简介:WARNING: This is a pre-release that might be broken in some ways. Stay tuned.

Denoify: For NPM module authors that would like to support Deno but don't want to write a port

Support Deno and release on NPM with a single codebase.

WARNING: This is a pre-release that might be broken in some ways. Stay tuned.

What it is

This tool takes as input a TypeScript codebase that was meant to target node and/or the web and spits out a modified version of the source files that are ready to be deployed as a Deno module.

Denoify does for Deno what browserify does for the browser.

What it isn't

A way to import node modules in Deno projects. For that purpose you can try CommonJS module Loading

Motivations

  • Although it is quite easy to port a module to Deno it is a chore to maintain two codebase.
  • Wouldn't it be great to have a tool able to make all the major NPM modules available to Deno?

Example of modules using Denoify

Modules that have been made cross-runtime using Denoify:

Will it work with my module ?

At this stage of it's development, Denoify set quite restrictive requirements:

  • Does your users need to have @types/node installed to use your module ? If yes then, unfortunately, your module is not denoifiable as it is. Even if you are allowed to use (some, not all) node builtins such as fs , path or event you will need to remove all Node reference from your exposed API before you can use Denoify. You can't for example expose a class that extends EventEmitter or if you do you will have to export a type definition for EventEmitter .
  • You will need to provide a Deno polyfill for each of your project dependencies that are not known by Denoify. Here is the list of modules for which Denoify has already a polyfill for.

    Note that Denoify work recursively meaning that you can fork your dependencies repo and Denoify them yourself.

    However, depending on how deep your dependency tree goes it might not be feasible.

  • Is your module a vanilla JS project? If yes you will have to port it into TypeScript first.

Roadmap to 1.0

These are the milestone that, when achieved, will enable Denoify to work transparently on most NPM modules:

  • Supporting all node builtins, everything on this list should be checked ( help more than welcome ).
  • Supporting require() and fs ( synchronously or not ) for dynamically accessing files of the project ( files that sits in the node_modules directory in Node ). Note that fs for the most part is already functional but the problem arises when trying to access files that are not present on the disk. In Deno unlike in Node, the packages files are not present on the disk at runtime. Fetching them synchronously is not a satisfactory solution for obvious reasons. We can do it the way Browserify is doing it but this approach works only if the paths can be analyzed statically. The solution would be to provide a way for the user to define the files that are susceptible to be accessed synchronously at runtime or by default pre-loading everything in a single files if the project is using require or fs .
  • The changes are currently performed with RegExp, we need to use the TypeScript compiler API if we want the tool to be fully reliable. ts-morph seems to be a good option here.
  • Support Javascript projects and automatically bundle types from DefinitelyTyped ( also applicable for @types/node ).
  • Automatically Denoify dependencies ( require all the previous milestone ).

GUIDES

Setting up on an existing project

Check out this repo to see in practice how to set up Denoify in your project.

Starting a project from scratch

Denoify: For NPM module authors that would like to support Deno but don't want to write a port

denoify_ci is a template repo that automate the boring and tedious tasks of:

  • Filling up the package.json
  • Setting up Typescript and Denoify .
  • Writing a README.md with decent presentation and instructions on how to install/import your module.
  • Testing on multiples Node and Deno version before publishing.
  • Maintaining a CHANGELOG
  • Publishing on NPM and deno.land/x ( via GitHub releases ).

以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,也希望大家多多支持 码农网

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

修改代码的艺术

修改代码的艺术

Michael Feathers / 刘未鹏 / 人民邮电出版社 / 2007-09-25 / 59.00元

我们都知道,即使是最训练有素的开发团队,也不能保证始终编写出清晰高效的代码。如果不积极地修改、挽救,随着时间流逝,所有软件都会不可避免地渐渐变得复杂、难以理解,最终腐化、变质。因此,理解并修改已经编写好的代码,是每一位程序员每天都要面对的工作,也是开发程序新特性的基础。然而,与开发新代码相比,修改代码更加令人生畏,而且长期以来缺乏文献和资料可供参考。 本书是继《重构》和《重构与模式》之后探讨......一起来看看 《修改代码的艺术》 这本书的介绍吧!

MD5 加密
MD5 加密

MD5 加密工具

XML 在线格式化
XML 在线格式化

在线 XML 格式化压缩工具

Markdown 在线编辑器
Markdown 在线编辑器

Markdown 在线编辑器