wpstudio
/
hiring-test-one
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Browse Source

upgrade koa-route.. docs..

master
Lloyd Brookes 9 years ago
parent
b3de999e4d
commit
4be3ba4a3e
5 changed files with 71 additions and 34 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Unified View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 49
      README.md
  2. 3
      bin/cli.js
  3. 2
      example/rewrite/.local-web-server.json
  4. 49
      jsdoc2md/README.hbs
  5. 2
      package.json

49
README.md
View File

@ -37,13 +37,13 @@ $ ws --spa index.html
By default, typical SPA urls (e.g. `/user/1`, `/login`) would return `404 Not Found` as a file does not exist with that path. By marking `index.html` as the SPA you create this rule: By default, typical SPA urls (e.g. `/user/1`, `/login`) would return `404 Not Found` as a file does not exist with that path. By marking `index.html` as the SPA you create this rule:
*If a static file at the requested path exists (e.g. `/css/style.css`) then serve it, if it does not (e.g. `/login`) then serve the SPA and handle the route client-side.*
*If a static file at the requested path exists (e.g. `/css/style.css`) then serve it, if it does not (e.g. `/login`) then serve the specified SPA and handle the route client-side.*
### Access Control ### Access Control
By default, access to all files is allowed (including dot files). Use `--forbid` to establish a blacklist: By default, access to all files is allowed (including dot files). Use `--forbid` to establish a blacklist:
```sh ```sh
$ ws --forbid .json .yml
$ ws --forbid '*.json' '*.yml'
serving at http://localhost:8000 serving at http://localhost:8000
``` ```
@ -51,48 +51,65 @@ serving at http://localhost:8000
### URL rewriting ### URL rewriting
Your application requested `/css/style.css` but it's stored at `/build/css/style.css`. Create a rewrite rule:
Your application requested `/css/style.css` but it's stored at `/build/css/style.css`. To avoid a 404 you need a rewrite rule:
```sh ```sh
$ ws --rewrite "/css/style.css -> /build/css/style.css"
$ ws --rewrite '/css/style.css -> /build/css/style.css'
``` ```
Or, more generally (matching any stylesheet path under `/css`):
Or, more generally (matching any stylesheet under `/css`):
```sh ```sh
$ ws --rewrite "/css/:stylesheet -> /build/css/:stylesheet"
$ ws --rewrite '/css/:stylesheet -> /build/css/:stylesheet'
``` ```
If a deep structure is involved it may be easier to mount the entire contents of `/build/css` to the `/css` path: (matches any stylesheet path under `/css`, `/css/a`, `/css/a/b` etc.)
With a deep CSS directory structure it may be easier to mount the entire contents of `/build/css` to the `/css` path:
```sh ```sh
$ ws --rewrite "/css/* -> /build/css/$1"
$ ws --rewrite '/css/* -> /build/css/$1'
``` ```
this rewrites `/css/a` as `/build/css/a`, `/css/a/b/c` as `/build/css/a/b/c` etc.
#### Proxied rewrite
If the `to` address contains a hostname local-web-server will act as a proxy - the remote resource will be fetched and returned
#### Proxied requests
If the `to` URL contains a remote host, local-web-server will act as a proxy - fetching and responding with the remote resource.
Mount the npm registry locally:
```sh
$ ws --rewrite '/npm/* -> http://registry.npmjs.org/$1'
```
Map local requests for repo data to the Github API:
```sh ```sh
$ ws --rewrite "/api => http://api.example.com/api" \
"/npm => http://registry.npmjs.com" \
"/user/:project/repo -> https://api.github.com/repos/:project"
$ ws --rewrite '/projects/:user/repos/:name -> https://api.github.com/repos/:user/:name'
``` ```
### Stored config ### Stored config
Always use this port and blacklist? Persist it to the config:
Always use this port and blacklist? Persist it to `package.json`:
```json ```json
{ {
"name": "example", "name": "example",
"version": "1.0.0", "version": "1.0.0",
"local-web-server": { "local-web-server": {
"port": 8100, "port": 8100,
"forbid": "\\.json$"
"forbid": "*.json"
} }
} }
``` ```
.. or `.local-web-server.json`
```json
{
"port": 8100,
"forbid": "*.json"
}
```
### Logging ### Logging
By default, local-web-server outputs a simple, dynamic statistics view. To see traditional web server logs, use `--log-format`: By default, local-web-server outputs a simple, dynamic statistics view. To see traditional web server logs, use `--log-format`:
@ -102,6 +119,8 @@ serving at http://localhost:8000
::1 - - [16/Nov/2015:11:16:52 +0000] "GET / HTTP/1.1" 200 12290 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/48.0.2562.0 Safari/537.36" ::1 - - [16/Nov/2015:11:16:52 +0000] "GET / HTTP/1.1" 200 12290 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/48.0.2562.0 Safari/537.36"
``` ```
[morgan](https://github.com/expressjs/morgan)
### Mock Responses ### Mock Responses
*Coming soon*. *Coming soon*.

3
bin/cli.js
View File

@ -12,7 +12,6 @@ const usage = cli.getUsage(cliOptions.usageData)
const stored = loadConfig('local-web-server') const stored = loadConfig('local-web-server')
const options = collectOptions() const options = collectOptions()
// TODO --config show the merged options
// TODO summary line on server launch // TODO summary line on server launch
if (options.misc.help) { if (options.misc.help) {
@ -20,7 +19,7 @@ if (options.misc.help) {
process.exit(0) process.exit(0)
} }
if (options.misc.config) { if (options.misc.config) {
console.log(JSON.stringify(stored, null, ' '))
console.log(JSON.stringify(options.server, null, ' '))
process.exit(0) process.exit(0)
} }

2
example/rewrite/.local-web-server.json
View File

@ -2,6 +2,6 @@
"rewrite": [ "rewrite": [
{ "from": "/css/*", "to": "/build/styles/$1" }, { "from": "/css/*", "to": "/build/styles/$1" },
{ "from": "/npm/*", "to": "http://registry.npmjs.org/$1" }, { "from": "/npm/*", "to": "http://registry.npmjs.org/$1" },
{ "from": "/gh/:user/repo/:name", "to": "https://api.github.com/repos/:user/:name" }
{ "from": "/projects/:user/repos/:name", "to": "https://api.github.com/repos/:user/:name" }
] ]
} }

49
jsdoc2md/README.hbs
View File

@ -37,13 +37,13 @@ $ ws --spa index.html
By default, typical SPA urls (e.g. `/user/1`, `/login`) would return `404 Not Found` as a file does not exist with that path. By marking `index.html` as the SPA you create this rule: By default, typical SPA urls (e.g. `/user/1`, `/login`) would return `404 Not Found` as a file does not exist with that path. By marking `index.html` as the SPA you create this rule:
*If a static file at the requested path exists (e.g. `/css/style.css`) then serve it, if it does not (e.g. `/login`) then serve the SPA and handle the route client-side.*
*If a static file at the requested path exists (e.g. `/css/style.css`) then serve it, if it does not (e.g. `/login`) then serve the specified SPA and handle the route client-side.*
### Access Control ### Access Control
By default, access to all files is allowed (including dot files). Use `--forbid` to establish a blacklist: By default, access to all files is allowed (including dot files). Use `--forbid` to establish a blacklist:
```sh ```sh
$ ws --forbid .json .yml
$ ws --forbid '*.json' '*.yml'
serving at http://localhost:8000 serving at http://localhost:8000
``` ```
@ -51,48 +51,65 @@ serving at http://localhost:8000
### URL rewriting ### URL rewriting
Your application requested `/css/style.css` but it's stored at `/build/css/style.css`. Create a rewrite rule:
Your application requested `/css/style.css` but it's stored at `/build/css/style.css`. To avoid a 404 you need a rewrite rule:
```sh ```sh
$ ws --rewrite "/css/style.css -> /build/css/style.css"
$ ws --rewrite '/css/style.css -> /build/css/style.css'
``` ```
Or, more generally (matching any stylesheet path under `/css`):
Or, more generally (matching any stylesheet under `/css`):
```sh ```sh
$ ws --rewrite "/css/:stylesheet -> /build/css/:stylesheet"
$ ws --rewrite '/css/:stylesheet -> /build/css/:stylesheet'
``` ```
If a deep structure is involved it may be easier to mount the entire contents of `/build/css` to the `/css` path: (matches any stylesheet path under `/css`, `/css/a`, `/css/a/b` etc.)
With a deep CSS directory structure it may be easier to mount the entire contents of `/build/css` to the `/css` path:
```sh ```sh
$ ws --rewrite "/css/* -> /build/css/$1"
$ ws --rewrite '/css/* -> /build/css/$1'
``` ```
this rewrites `/css/a` as `/build/css/a`, `/css/a/b/c` as `/build/css/a/b/c` etc.
#### Proxied rewrite
If the `to` address contains a hostname local-web-server will act as a proxy - the remote resource will be fetched and returned
#### Proxied requests
If the `to` URL contains a remote host, local-web-server will act as a proxy - fetching and responding with the remote resource.
Mount the npm registry locally:
```sh
$ ws --rewrite '/npm/* -> http://registry.npmjs.org/$1'
```
Map local requests for repo data to the Github API:
```sh ```sh
$ ws --rewrite "/api => http://api.example.com/api" \
"/npm => http://registry.npmjs.com" \
"/user/:project/repo -> https://api.github.com/repos/:project"
$ ws --rewrite '/projects/:user/repos/:name -> https://api.github.com/repos/:user/:name'
``` ```
### Stored config ### Stored config
Always use this port and blacklist? Persist it to the config:
Always use this port and blacklist? Persist it to `package.json`:
```json ```json
{ {
"name": "example", "name": "example",
"version": "1.0.0", "version": "1.0.0",
"local-web-server": { "local-web-server": {
"port": 8100, "port": 8100,
"forbid": "\\.json$"
"forbid": "*.json"
} }
} }
``` ```
.. or `.local-web-server.json`
```json
{
"port": 8100,
"forbid": "*.json"
}
```
### Logging ### Logging
By default, local-web-server outputs a simple, dynamic statistics view. To see traditional web server logs, use `--log-format`: By default, local-web-server outputs a simple, dynamic statistics view. To see traditional web server logs, use `--log-format`:
@ -102,6 +119,8 @@ serving at http://localhost:8000
::1 - - [16/Nov/2015:11:16:52 +0000] "GET / HTTP/1.1" 200 12290 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/48.0.2562.0 Safari/537.36" ::1 - - [16/Nov/2015:11:16:52 +0000] "GET / HTTP/1.1" 200 12290 "-" "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/48.0.2562.0 Safari/537.36"
``` ```
[morgan](https://github.com/expressjs/morgan)
### Mock Responses ### Mock Responses
*Coming soon*. *Coming soon*.

2
package.json
View File

@ -40,7 +40,7 @@
"koa-etag": "^2.1.0", "koa-etag": "^2.1.0",
"koa-morgan": "^0.4.0", "koa-morgan": "^0.4.0",
"koa-rewrite": "^1.1.1", "koa-rewrite": "^1.1.1",
"koa-route": "^2.4.2",
"koa-route": "^3",
"koa-send": "^3.1.0", "koa-send": "^3.1.0",
"koa-serve-index": "^1.1.0", "koa-serve-index": "^1.1.0",
"koa-static": "^1.5.2", "koa-static": "^1.5.2",

Write Preview
Loading…
Cancel
Save