koatty 3.11.4-2 → 3.11.6

package/LICENSE

@@ -1,29 +1,29 @@
-BSD 3-Clause License
-
-Copyright (c) 2020, Koatty
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
-
-1. Redistributions of source code must retain the above copyright notice, this
-   list of conditions and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the above copyright notice,
-   this list of conditions and the following disclaimer in the documentation
-   and/or other materials provided with the distribution.
-
-3. Neither the name of the copyright holder nor the names of its
-   contributors may be used to endorse or promote products derived from
-   this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+BSD 3-Clause License
+
+Copyright (c) 2020, Koatty
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -1,168 +1,177 @@
-# koatty
-
-Koa2 + Typescript + IOC = koatty. 
-
-Use Typescript's decorator implement IOC and AOP.
-
-[![Version npm](https://img.shields.io/npm/v/koatty.svg?style=flat-square)](https://www.npmjs.com/package/koatty)[![npm Downloads](https://img.shields.io/npm/dm/koatty.svg?style=flat-square)](https://npmcharts.com/compare/koatty?minimal=true)
-
-## New features 
-
-* HTTP、HTTPS、HTTP2、gRPC、WebSocket server.
-* Support loading environment configuration, parsing command line parameters (process.argv) and environment variables (process.env)
-* `@ExceptionHandler()` Register global exception handling
-* graceful shutdown and pre-exit event
-* custom decorator based on app events
-
-
-## Documentation
-
-[koatty_doc_CN](https://koatty.org/) （In progress💪）
-
-
-## Installation CLI tools
-
-```shell
-npm i -g koatty_cli
-```
-
-## Quick Start
-
-### 1.Create Project
-
-```shell
-kt new projectName
-
-```
-
-### 2. Install deps
-
-```
-cd ./projectName
-
-npm i
-```
-
-### 3. Start up
-
-```
-npm run dev
-
-// or
-npm start
-```
-
-## Code style
-
-default Controller:
-
-```javascript
-import { Controller, Autowired, GetMapping, RequestBody, PathVariable,
- PostMapping, RequestMapping, RequestMethod, Valid, Output } from "koatty";
-import { TestDTO } from "../model/dto/TestDTO";
-import { TestService } from "../service/TestService";
-import { App } from "../App";
-
-@Controller()
-export class IndexController {
-    app: App;
-    ctx: KoattyContext;
-
-    @Autowired()
-    private testService: TestService;
-
-    /**
-     * constructor
-     *
-     */
-    constructor(ctx: KoattyContext) {
-        this.ctx = ctx;
-    }
-
-    @RequestMapping("/:name", RequestMethod.ALL)
-    async default(@PathVariable("name") @Valid("IsNotEmpty") name: string) {
-        try {
-            const info = await this.testService.sayHello(name);
-            return Output.ok(this.ctx, "success", info);
-        } catch (err: Error) {
-            return Output.fail(this.ctx, err.message));
-        }
-    }
-
-    @PostMapping("/test")
-    @Validated() //need DTOClass
-    test(@RequestParam() params: TestDTO) {
-        return Output.ok(this.ctx, "test", params);
-    }
-}
-```
-
-## How to do Unit Testing
-
->only support `jest` UT framework now 
-
-```javascript
-import request from 'supertest';
-import { ExecBootStrap } from 'koatty';
-import { App } from '../src/App';
-
-describe('UT example', () => {
-
-  let server: any;
-  beforeAll(async () => {
-    jest.useFakeTimers();
-    const appInstance = await ExecBootStrap()(App);
-    server = await appInstance.listen();
-  });
-
-  afterAll(done => {
-    server.close();
-    done();
-  });
-
-  it('request', async () => {
-    const rsp = await request(server).get('/');
-    expect(rsp.status).toBe(200);
-  });
-});
-
-```
-
-## How to debug
-
-if you use vscode , edit the `.vscode/launch.json` , like this: 
-```
-{
-    "version": "0.2.0",
-    "configurations": [
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "TS Program",
-            "args": [
-                "${workspaceRoot}/src/App.ts" 
-            ],
-            "runtimeArgs": [
-                "--nolazy",
-                "-r",
-                "ts-node/register"
-            ],
-            "sourceMaps": true,
-            "cwd": "${workspaceRoot}",
-            "protocol": "inspector",
-            "outputCapture": "std",
-            "internalConsoleOptions": "neverOpen"
-        }
-    ]
-}
-```
-Select `TS Program` to debug run. Try to call `http://localhost:3000/` .
-
-## Example
-
-Check out the [quick start example][quick-example].
-
-[quick-example]: https://github.com/Koatty/koatty_template
-
-
-
+# koatty
+
+Koa2 + Typescript + IOC = koatty. 
+
+Use Typescript's decorator implement IOC and AOP.
+
+[![Version npm](https://img.shields.io/npm/v/koatty.svg?style=flat-square)](https://www.npmjs.com/package/koatty)[![npm Downloads](https://img.shields.io/npm/dm/koatty.svg?style=flat-square)](https://npmcharts.com/compare/koatty?minimal=true)
+
+## New features 
+
+* HTTP、HTTPS、HTTP2、gRPC、WebSocket server.
+* Support loading environment configuration, parsing command line parameters (process.argv) and environment variables (process.env)
+* `@ExceptionHandler()` Register global exception handling
+* graceful shutdown and pre-exit event
+* custom decorator based on app events
+
+
+## Documentation
+
+[koatty_doc_CN](https://koatty.org/) （In progress💪）
+
+
+## Installation CLI tools
+
+```shell
+npm i -g koatty_cli
+```
+
+## Quick Start
+
+### 1.Create Project
+
+```shell
+kt new projectName
+
+```
+
+### 2. Install deps
+
+```
+cd ./projectName
+
+npm i
+```
+
+### 3. Start up
+
+```
+npm run dev
+
+// or
+npm start
+```
+
+## Code style
+
+default Controller:
+
+```javascript
+import { Controller, Autowired, GetMapping, RequestBody, PathVariable,
+ PostMapping, RequestMapping, RequestMethod, Valid, Output } from "koatty";
+import { TestDTO } from "../model/dto/TestDTO";
+import { TestService } from "../service/TestService";
+import { App } from "../App";
+
+@Controller()
+export class IndexController {
+    app: App;
+    ctx: KoattyContext;
+
+    @Autowired()
+    private testService: TestService;
+
+    /**
+     * constructor
+     *
+     */
+    constructor(ctx: KoattyContext) {
+        this.ctx = ctx;
+    }
+
+    @GetMapping('/')
+    index() {
+        return Output.ok("Hello, koatty!");
+    }
+
+    @RequestMapping("/:name", RequestMethod.ALL)
+    async default(@PathVariable("name") @Valid("IsNotEmpty") name: string) {
+        try {
+            const info = await this.testService.sayHello(name);
+            return Output.ok(this.ctx, "success", info);
+        } catch (err: Error) {
+            return Output.fail(this.ctx, err.message));
+        }
+    }
+
+    @PostMapping("/test")
+    @Validated() //need DTOClass
+    test(@RequestParam() params: TestDTO) {
+        return Output.ok(this.ctx, "test", params);
+    }
+}
+```
+
+## How to do Unit Testing
+
+>only support `jest` UT framework now 
+
+```javascript
+import request from 'supertest';
+import { ExecBootStrap } from 'koatty';
+import { App } from '../src/App';
+
+describe('UT example', () => {
+
+  let app: KoattyApplication;
+  beforeAll(async () => {
+    jest.useFakeTimers();
+    // test env
+    process.env.KOATTY_ENV = 'ts-node';
+    app = await ExecBootStrap()(App);
+    // app.use(async (ctx: any) => {
+    //   ctx.body = 'Hello, World!';
+    // });
+  });
+
+  afterAll(done => {
+    done();
+    jest.clearAllMocks();
+  });
+
+  it('request', async () => {
+    const res = await request(app.callback()).get('/');
+    expect(res.status).toBe(200);
+  });
+});
+
+```
+
+## How to debug
+
+if you use vscode , edit the `.vscode/launch.json` , like this: 
+```
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "type": "node",
+            "request": "launch",
+            "name": "TS Program",
+            "args": [
+                "${workspaceRoot}/src/App.ts" 
+            ],
+            "runtimeArgs": [
+                "--nolazy",
+                "-r",
+                "ts-node/register"
+            ],
+            "sourceMaps": true,
+            "cwd": "${workspaceRoot}",
+            "protocol": "inspector",
+            "outputCapture": "std",
+            "internalConsoleOptions": "neverOpen"
+        }
+    ]
+}
+```
+Select `TS Program` to debug run. Try to call `http://localhost:3000/` .
+
+## Example
+
+Check out the [quick start example][quick-example].
+
+[quick-example]: https://github.com/Koatty/koatty_template
+
+
+

package/dist/LICENSE

@@ -1,29 +1,29 @@
-BSD 3-Clause License
-
-Copyright (c) 2020, Koatty
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are met:
-
-1. Redistributions of source code must retain the above copyright notice, this
-   list of conditions and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the above copyright notice,
-   this list of conditions and the following disclaimer in the documentation
-   and/or other materials provided with the distribution.
-
-3. Neither the name of the copyright holder nor the names of its
-   contributors may be used to endorse or promote products derived from
-   this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
-FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+BSD 3-Clause License
+
+Copyright (c) 2020, Koatty
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.