init commit

Author: leafcoder

LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 leafcoder
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -1,2 +1,40 @@
-# litefs
-使用 Python 从零开始构建一个 Web 服务器框架。 开发 Litefs 的是为了实现一个能快速、安全、灵活的构建 Web 项目的服务器框架。 litefs 是一个高性能的 Http 服务器。Litefs 具有高稳定性、丰富的功能、系统消耗低的特点。
+
+1. 快速启动
+==============
+
+1.1 启动脚本
+---------------
+
+    import sys
+    sys.dont_write_bytecode = True
+
+    import litefs
+    litefs = litefs.Litefs(
+        address='0.0.0.0:8080', webroot='./site', debug=True
+    )
+    litefs.run(timeout=2.)
+
+将上面的代码保存为 run.py 文件。
+
+1.2 页面脚本
+---------------
+
+在网站目录（注：启动脚本中 webroot 的目录）中，添加一个后缀名为 **.py** 的文件，如 example.py，代码如下：
+
+    def handler(self):
+        self.start_response(200, headers=[])
+        return 'Hello world!'
+
+    or
+
+    def handler(self):
+        return 'Hello world!'
+
+1.3 启动网站
+-----------
+
+    $ python run.py
+    Server is running at 0.0.0.0:8080
+    Hit Ctrl-C to quit.
+
+运行启动脚本后，访问 http://0.0.0.0:8080/example，您会看到 `Hello world!`。

example.py

@@ -0,0 +1,10 @@
+#!/usr/bin/python
+
+import sys
+sys.dont_write_bytecode = True
+
+import litefs
+litefs = litefs.Litefs(
+    address='localhost:9090', webroot='./site', debug=True
+)
+litefs.run(timeout=2.)