Initial specification

Author: kylef

LICENSE

@@ -0,0 +1,23 @@
+Copyright (c) 2014, Kyle Fuller
+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. 
+
+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 OWNER 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.
+

README.md

@@ -0,0 +1,38 @@
+# Nest - Swift Web Server Gateway Interface
+
+Nest provides a minimal interface between web servers supporting Swift and  web applications or frameworks. It’s designed to prevent tight coupling between web servers and web applications or frameworks. To enable the use of any framework or application with any server.
+
+## Quick Links
+
+- [Specification](Specification.md)
+
+## Rationale and Goals
+
+The primary goal of Nest is to enable the use of any framework or application with any server. To prevent tight coupling between web servers and web applications or frameworks.
+
+Nest provides a minimal interface supporting every feature in HTTP. It must be extremely simple, and easy to implement for both servers and web applications.
+
+The interface must not make use any external frameworks and only depend on core Swift language features.
+
+## Example Application
+
+A simple Hello World web application using the Nest interface:
+
+```swift
+func application(env:[String:AnyObject]) -> (String, [(String, String)], String) {
+    return ("200 OK", [("Content-Type", "text/plain")], "Hello World")
+}
+```
+
+## Testing
+
+Along with providing a specification, Nest also provides a test suite to ensure that a server correctly follows the specification, and to aid development of web servers.
+
+## Implementations
+
+There are no current implementations.
+
+## License
+
+Nest is licensed under the BSD license. See [LICENSE](LICENSE) for more information.
+

Specification.md

@@ -0,0 +1,44 @@
+---
+Version: 0.1.0
+---
+
+# Nest Specification
+
+There are two components that make up the Nest interface, the “server” or “gateway” component, and the “application” or “framework” component.
+
+The server component invokes the function that is provided by the application.
+
+## Application
+
+A Nest application is a simple Swift function that takes exactly one argument, the environment. It returns a tuple (the response) containing exactly three values, the status, headers and the body.
+
+The full type of the application function is as follows:
+
+```swift
+([String:AnyObject]) -> (String, [(String, String)], String)
+```
+
+### Environment
+
+- `REQUEST_METHOD`
+- `PATH_INFO`
+
+### The Response
+
+#### Status (`String`)
+
+This is an HTTP status. It must be a string containing a 3-digit integer result code followed by a reason phrase. For example, `200 OK`.
+
+#### Headers (`[(String, String)]`)
+
+The headers is an array of tuples containing the key and value for each HTTP header for the server to send in the returned order.
+
+#### Body (`String`)
+
+The body must be a String.
+
+## Server
+
+The server or gateway invokes the applications function once for each request
+from a client.
+