spm-yuan

Start a simple spm source server.

npm install spm-yuan
11 downloads in the last week
42 downloads in the last month

spm-yuan

一个简易的 Spm 源服务,以 Spm 插件的形式提供


使用

安装

请先安装 spm

$ npm install spm -g
$ npm install spm-yuan -g

启动源服务

在任意目录下,运行以下命令

$ spm yuan

这样一个 Spm 源服务就启动了,地址为 http://your.ip.address:3000 可以直接访问这个 URL 来查看当前源中的所有模块

使用源服务

要让 Spm 使用上一步启动的源,需要对其进行设置,改变源地址

$ spm config source:default.url http://your.ip.address:3000

配置源服务

可以使用 -p 参数配置端口号,默认为 3000

$ spm yuan -p 80

如果需要后台运行源服务,可以传递 -d 参数,这需要 https://github.com/Unitech/pm2 的支持,请先安装 pm2

$ npm install pm2 -g
$ spm yuan -d

后台运行源服务时默认会启动 CPU 内核数个线程,也可以使用 -w 参数定制

$ spm yuan -d -w 4

源服务默认会以 http://spmjs.org 为远程官方源,可以使用 -s 参数定制

$ spm yuan -s http://another-spmjs.org

镜像同步

从 0.5 版本开始支持远程镜像同步,类似 maven

如果当前的源服务找不到用户需要安装的模块,它会先尝试从远程官方源去下载并同步,然后再交给用户

可以使用上一节的 -s 参数配置远程官方源的地址

说明

  • 源服务使用 spm 安装缓存中的文件对外提供服务,启动前会先扫描缓存目录,并从官网下载一些相应的文件
  • 如果要搭建一个官方源的镜像,你需要先通过 spm install 安装所有官方源的模块,安装路径无所谓,因为只要安装过,安装缓存里会有相应的包
  • 只提供对 info/install/publish/unpublish/login 命令的支持
  • publish/unpublish 等操作前需要登录,用户信息配置在 ~/.spm/yuan_account.json 文件中

变动历史

2013-08-24 0.0.5

  • 使用 express 改写
  • 增加镜像同步的功能
  • 去除内置的多线程支持,改为依赖外部的 pm2 模块

2013-06-13 0.0.2

  • 增加一个静态页面用于方便地查看所有模块

2013-06-09 0.0.1

  • 改名为 spm-yuan,并入 spmjs
npm loves you