# puer

**Repository Path**: mirrors_leecade/puer

## Basic Information

- **Project Name**: puer
- **Description**: puer  --- a simple,extensible static server 
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-09
- **Last Updated**: 2026-02-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

#Puer 
Puer(普洱)，一个非常简单、但易于扩展的前端开发的静态服务器，整体围绕AutoReload功能，css更新样式，其他刷新html。 F5已经足够好用但是远远还满足不了我。


##优点

* __无环境要求__(除了node，前端不装node该批评)----针对[F5](http://www.getf5.com/ "F5官方网站") 还记得liunx下 air蛋疼的安装么. 
* __无侵入__ :
  1. 不需要修改任何原有页面或脚本等资源; 
  2. 不需要安装浏览器插件 ---- 针对 [LiveReload](http://livereload.com/) 而言。
* __无依赖__ :
  1. 与编辑器无关(无论你是[__vimer__](https://github.com/carlhuda/janus)还是[__sublimer__](http://www.sublimetext.com/))
  2. 与浏览器无关(ie6、mobile...沾socket.io的光) 
  3. 与系统无关(这个其实是废话..) ---- 嗯. LiveReload给Mac的高帅富用的。
  4. 与库无关,---- 针对[seajs](https://seajs.org)的autoreload插件.
* __自定义的脚本插件__:设置简单路由规则、(为了迎合广大的[expresser](http://expressjs.com/),虽然基本没用express的功能，但还是依赖了它，方便自定义功能扩展)添加mock数据真正实现__前后端分离__的开发 
* __API支持__: 写个编辑器插件?
* 天然支持markdown的预览哦，也autoreload的哦。。。

##缺点
* 无gui，基于命令行。(算不算缺点?)
* 由于针对于本地开发，我基本没有做任何缓存之类的优化，因为我相信:
>一切不以实现、需求为基石的性能问题都是纸老虎_. 

##安装 
`npm -g install puer`

当然你也可以fork一份自己折腾:

`git clone https://github.com/leeluolee/puer`


##使用
###命令行
__90%__的情况下, 你应该是这样用的...
```bash
cd path/to/your/static/dir #到你想去地方
puer #泡一杯普洱

```
或许你想更__深入__一点...
```bash
luobo(master) ✗> puer --help

Usage:  puer [options...]

Options:
  -a,--addon <file>     your addon's path
  -p,--port <port>      server's listen port, 8000 default
  -d,--dir <dir>        your customer working dir. default current dir 
     --no-reload        close  auto-reload feature,(not recommended)
     --no-launch        close the auto launch feature
  -m,--matches <regexp> some regexp to define your watching file 
                        reg string should escape to convert to regexp,each reg joined by ','
  -e,--excludes <regexp>  excludes file under watching
  -h,--help             help list

```
或许你想扩展功能(Addon)..., 举个例子让你的静态服务器支持less的样式外链(不是简单的插入parser script哦)
```less
var less = require('less');
var fs = require("fs")
var path = require("path")
/**
 * [exports description]
 * @param  {[type]} app     express(connect) instance
 * @param  {[type]} server  http server instance
 * @param  {[type]} options 见下表
                    # listener port
                    port:8000
                    # auto-reload  
                    reload:true
                    # working folder
                    dir:process.cwd()
                    # autemate launch browser
                    launch:true
                    # plugins (generally, will be some route-rules, see src/addons folder to get help)
                    addon:null
                    # ignored watching type
                    matches:['\\.(js|css|html|htm|xhtml|md|markdown|txt|hbs|jade)$']
                    # add watching file *tips:excludes has a priority higher than ex 
                    excludes:['node_modules']
  这些初始参数会与命令行传入的参数进行合并
 *
 */
module.exports = function(app, server , options){
  app.get(/(.*\.less)/, function(req, res){
    file = fs.readFileSync(path.join(options.dir,req.params[0]),"utf8")
    if(!file) return ""
    less.render(file, function (e, css) {
      res.setHeader("Content-Type", "text/css")
        res.setHeader("Content-Length", Buffer.byteLength (css)) 
        res.send(css)
    });
  })
}


```
其实就是加入了一些路由规则而已,具体测试请看test目录

###API
```js
//前提你已经安装了puer
var puer =require("puer")
puer(options) //具体看上面的例子

```




##FAQ
####为什么取名Puer(普洱)？

喜欢云南，喜欢喝普洱, 最后...没发现拼音跟英文一样么， 好记。

####为什么做这个东西？

一直想基于nodejs想做一个类似grunt的大而全的构建工具。无奈要追赶的对手太强大，而平时工作基本还是简单的切页面写Demo原型(当然对我这种浮躁的人来讲，这也正好是打底子的工作)，没有实践就没有思考也很难有灵感, 而切页面时有强烈的需求要一个静态server,结果那个构建工具做了一点点就拆出了这个Puer。

####为什么代码这么烂？
coffeescript新兵 node api也不熟 基本都得翻手册写 见谅