打包发布自己的nodejs包

下午的时候写了一篇关于一个不成熟的模板引擎的博客,觉得还是不太够,然后就封装了起来,做成了一款开发包。最后为了尝试一下如何发布自己的包,就又完善了一下。做此文以记之。

查看详情

初衷

说来也不是什么高大上的东西,就是个简单的字符串格式化的实现。灵感还是源自Python。写过Python代码的应该都知道字符串类有这么一个方法。

string = "hello {}".format("郭璞")  # hello 郭璞
string = "hello {username}".format(username="郭璞") # hello 郭璞

然后对于其他语言来说,比如C, Nodejs,Java等也都有类似的实现,但是不是很好用,尤其是记忆一大串什么%s, %d, %f,之类的,一点都不好玩了。

当然了,你也可以不用这些字符串格式化的方法,单纯的使用字符串相加的方式。比如:

str = "Hello" + username + ", are you " +anothername+ "?"; 

这还是变量很少的情况,试想一下。如果你有20个变量要与字符串进行拼接,那该是个什么工作量。不出错还好,一旦出错,骂街的❤都有了。况且在Node中,单引号和双引号都可以正常的表示字符串对象,这只能让你的字符串拼接显得更加举步维艰

功能

下面给个小例子,一定能让你眼前一亮

const str_format = require('str-format');

var str = "Hello {}!Welcome to {address}!\nAre you come from {} or {china.beijing}.";
var params = ['游客', {address: "冰雹工作室"}, '朝阳区', {china: {beijing: '北京'}}];
var result = str_format.format(str, params);
console.log(result);

运行一下代码,会有如下结果。

Hello 游客!Welcome to 冰雹工作室!
Are you come from 朝阳区 or 北京.

就跟Python中原生处理字符串格式化一样,这样写起来字符串就会变得很方便啦。

使用

使用它很方便,有这么两种方式:

npm

npm install str-format --save

然后就可以在你的代码中使用如下语法来使用它了。

var str_format = require('str-format');

local module

第二种就是当作本地包来使用,具体可以这么做:

https://github.com/guoruibiao/have-fun-in-node/tree/master/str-format
下载完整代码,然后通过本地引用的方式来加载。

var str_format = require('./str-format/index');

这样也能使用这个模块的相关功能了。

打包发布

回到正题,下面讲讲我的打包发布的流程。

目录

创建好一个目录,我的目录结构如下:

E:\Code\Nodejs\learn\my-work\string\str-format>tree /f .
卷 文档 的文件夹 PATH 列表
卷序列号为 0000-4823
E:\CODE\NODEJS\LEARN\MY-WORK\STRING\STR-FORMAT
    index.js     # 功能模块
    package.json # npm init 命令生成的文件
    README.md    # Markdown语法描述的模块信息

没有子文件夹

package.json

如上面目录中看到的package.json文件,其是由npm init命令生成的。在这个目录下打开命令行输入

npm init

然后根据终端里面的提示信息进行填写即可。

发布

发布之前确保自己有npm的账号。如果没有,就到
https://www.npmjs.com/signup
来注册即可。

注册完毕之后就可以使用npm publish来发布你的包了。
进入到模块的目录下,输入命令npm publish,如果出现下面的信息,则说明你需要一个登录会话,通过npm adduser进行登录即可。

E:\Code\Nodejs\learn\my-work\string\str-format>npm publish
npm ERR! Windows_NT 10.0.10586
npm ERR! argv "D:\\Software\\Nodejs\\node.exe" "D:\\Software\\Nodejs\\node_modules\\npm\\bin\\npm-cli.js" "publish"
npm ERR! node v6.10.2
npm ERR! npm  v3.10.10
npm ERR! code ENEEDAUTH

npm ERR! need auth auth required for publishing
npm ERR! need auth You need to authorize this machine using `npm adduser`

npm ERR! Please include the following file with any support request:
npm ERR!     E:\Code\Nodejs\learn\my-work\string\str-format\npm-debug.log

有了登录的会话之后就可以发布了。如下:

E:\Code\Nodejs\learn\my-work\string\str-format>npm adduser
Username: marksinoberg
Password:
Email: (this IS public) 1064319632@qq.com
Logged in as marksinoberg on https://registry.npmjs.org/.

E:\Code\Nodejs\learn\my-work\string\str-format>npm publish
+ str-format@1.0.0

这样我便发不了自己的第一个模块了。

取消发布

取消发布的前提也需要在登录会话下进行。

npm unpublish

如果不成功,或许需要强制取消。

npm unpublish --force

取消发布之后,如果要再次发布,那么需要改变一下版本号。比如我之前是1.0.0,如果我取消发布之后想再发布一次,那么版本号就需要变一下了。比如可以是1.0.1。没什么严格的要求,但是版本号默认递增顺序。

E:\Code\Nodejs\learn\my-work\string\str-format>npm publish
+ str-format@1.0.1

核实

发布完成之后就可以到下面的网址进行搜索,看看你的包到底发布成功了没有。
https://www.npmjs.com/package/package

查找包

查看详情内容,默认显示书写的README.md文件的内容。

查看详情

后话

需要注意的是在字符串中也有不能出现的类型,这跟Python保持了一致。

数组类型

const str_format = require('str-format');

var str = "Hello {}!Welcome to {address}!\nAre you come from {} or {china.beijing}.";
var params = ['游客', {address: "冰雹工作室"}, ['朝阳区', '海淀区'], {china: {beijing: '北京'}}];
var result = str_format.format(str, params);
console.log(result);

结果只会匹配第一个数据项:

Hello 游客!Welcome to 冰雹工作室!
Are you come from 朝阳区 or 北京

大致就是这样了,第一版比较仓促,后序功能可能会慢慢的进行添加的。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 175,966评论 25 709
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 135,833评论 19 139
  • 什么是 NPM npm之于Node,就像pip之于Python,gem之于Ruby,composer之于PHP。 ...
    ihoey阅读 11,390评论 2 36
  • 不见去年梁上燕,海棠枝下檐户。花自如雨起春暮,夕阳影里,笑靥群芳妒。 莫惜春归无觅处,今朝去后还复。桃花掩映落英语...
    St黄不二阅读 1,702评论 0 0
  • 你存在我的世界里 每次从图书馆回来寝室 视力太高的缘故吧 一眼就看到了你 你还很小很小 若不留心谁人知道你存在 欲...
    丛中笑_38ea阅读 2,415评论 0 0

友情链接更多精彩内容