npm-scope

npm-scope

描述

所有的 npm packages 都有一个名字。一些 packages 名字也会有一个 scope ,scope 命名遵循普通 package 名字(URL-安全字符,不以 . 或 _ 开头),scope 中的 packages 使用时要以 @ 符开头,后面跟 / ,例如:

@somescope/somepackagename

npm-scope 是一种将一些互相有关联的包组合在一起的方式,同时 npm 处理这些 packages 的方式也不同。

每个 npm 用户/组织 都有自己的范围,只有你自己可以在你的 scope 中添加 packages ,这意味着你不用担心自己 packages 的名字跟别人冲突。因此,npm-scope 是一些组织发布官方 packages 最好的方式。

npm-scope 从 npm@2 开始支持。Unscoped packages 和 scoped packages 可以互相依赖。

安装 scoped packages

scoped packages 会被安装到二级文件夹中,例如,某个 Unscoped packages 被安装至 node_modules/packagename ,scoped packages 则会被安装至 node_modules/@myorg/packagename 。@myorg 是个文件夹,可以包含任意数量的 scoped packages 。

一个 scoped package 通过下面的命令安装:

npm install @myorg/mypackage

或者在 package.json 中:

"dependencies": {
  "@myorg/mypackage": "^1.3.0"
}

注意:如果在安装 scoped packages 过程中省略 @ 符号,npm 将尝试从 GitHub 中安装。

引入 scoped packages

由于 scoped packages 被安装在一个 scope 文件夹中,所以你在代码中引用它时,需要包含 scope 的名字,例如:

require('@myorg/mypackage')

发布 scoped packages

从 npm@2(2015-04-19) 开始,scoped packages 就可以被发布到 任何 registry 中。

你也可以将 scope 和某个 registry 进行关联,见下文。

将 public scoped packages 发布至 npm registry

npm publish @myorg/mypackage --access public

将 private scoped packages 发布至 npm registry

要将 private scoped packages 发布到 npm registry ,你必须先拥有一个 npm Private Modules (私有模块)的账户。

然后你可以 用 npm publish 或者 npm publish --access restricted 发布 scoped packages ,发布后的 scoped package 将出现在 npm registry 中,但是时受限的。你可以在 npmjs.com website 或者 使用 npm access 改变权限。

将一个 scope 和 一个 registry 关联

scope 可以和 单独的 registry 相关联。这允许你无缝地使用一个混合私有 registry 和 npm registry 的 package 。

你可以在登录时将 scope 和 一个 registry 关联,例如:

npm login --registry=http://reg.example.com --scope=@myco

一个 registry 可以有多个 scope ,但是一个 scope 只能关联一个 registry 。

你也可以使用 npm config 将一个 scope 和 一个 registry 进行关联:

npm config set @myco:registry http://reg.example.com

一旦 scope 与 registry 相关联,scope下的 packages 在这个 registry 中请求请求下载。同时也会被发布到这个 registry 中。

原文地址

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 220,295评论 6 512
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,928评论 3 396
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 166,682评论 0 357
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,209评论 1 295
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,237评论 6 397
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,965评论 1 308
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,586评论 3 420
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,487评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 46,016评论 1 319
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,136评论 3 340
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,271评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,948评论 5 347
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,619评论 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,139评论 0 23
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,252评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,598评论 3 375
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,267评论 2 358

推荐阅读更多精彩内容

  • NPM官方文档写的十分良心,此篇我做一些比较常用功能的积累,有些地方是翻译,有些地方省略可以去官文看。 NPM是什...
    宋乐怡阅读 2,408评论 0 2
  • NPM是什么? npm是世界上最大的软件注册表, npm由3个独立的部分组成: 网站:开发者查找包,设置参数以及...
    Xyaleo阅读 561评论 0 1
  • 描述 npm从以下来源获取配置值,按优先级排序: 命令行标记 在命令行上放置--foo bar设置foo配置参数为...
    竹天亮阅读 44,156评论 0 8
  • 我觉得所有程序员都在努力的学习阅读英语吧,毕竟英语阅读没问题,我们才能更好的阅读文档,为了给大家更快的学习效率,所...
    王月_92f2阅读 1,276评论 0 0
  • 我们通常通过 npm 来安装和使用开源的模块。但是,通常我们有些私有的模块,不想通过npm发布,但是又想在一些项目...
    wavesnow阅读 3,583评论 1 5