|
|
[![NPM version](https://badge.fury.io/js/local-web-server.png)](http://badge.fury.io/js/local-web-server) [![Dependency Status](https://david-dm.org/75lb/local-web-server.png)](https://david-dm.org/75lb/local-web-server) ![Analytics](https://ga-beacon.appspot.com/UA-27725889-12/local-web-server/README.md?pixel)
local-web-server ================ Fires up a simple, static web server on a given port. A pure Javascript (and more reliable) alternative to `$ python -mSimpleHTTPServer 8000`.
Use for local web development or file sharing (directory browsing enabled). Plays well with Google Chrome Workspaces.
Install ------- Install [Node.js](http://nodejs.org), then run
```sh $ npm install -g local-web-server ```
*Linux/Mac users may need to run the above with `sudo`*
Usage ----- ``` usage: ws [--directory|-d <directory>] [--port|-p <port>] [--log-format|-f dev|default|short|tiny] ```
From the folder you wish to serve, run: ```sh $ ws serving at http://localhost:8000 ```
If you wish to serve a different directory, run: ```sh $ ws -d ~/mysite/ serving ~/mysite at http://localhost:8000 ```
If you wish to override the default port (8000), use `--port` or `-p`: ```sh $ ws --port 9000 serving at http://localhost:9000 ```
Use a built-in or custom [Connect logger format](http://www.senchalabs.org/connect/logger.html) with `--log-format`: ```sh $ ws --log-format short ```
Use with Logstalgia ------------------- The "default" log-format is compatible with [logstalgia](http://code.google.com/p/logstalgia/).
If you wrote your log output to disk, like so: ```sh $ ws --log-format default > web.log ```
Then you could visualise in logstalgia with: ```sh $ logstalgia web.log ```
Alternatively, pipe directly from ws into logstalgia for real-time visualisation: ```sh $ ws --log-format default | logstalgia - ```
Use with glTail --------------- To use with [glTail](http://www.fudgie.org), write your log to disk using the "default" format: ```sh $ ws -f default > web.log ```
Then specify this file in your glTail config:
```yaml servers: dev: host: localhost source: local files: /Users/Lloyd/Documents/MySite/web.log parser: apache color: 0.2, 0.2, 1.0, 1.0 ```
[![NPM](https://nodei.co/npm-dl/local-web-server.png?months=3)](https://nodei.co/npm/local-web-server/)
|