##Tiny - The tiniest possible web framework. Inspired by Flask, Bottle, and Itty.

To Install:

pip install tiny

To create a simple app:

import tiny, os

# Creates the app object.
app = tiny.TinyApp()

# Sets the path for the app to find HTML templates.
app.set_template_path(os.path.abspath('templates'))

## Routing ###

@app.route('/')
def index(request):
    """Defines the index view, accessible at '/'."""
    
    # Creates a response comprised of the content of index.html and rendered template variables.
    content = tiny.TinyResponse(app.render('index.html', template_var="Hello world"))

    # Whatever is returned in a view will display on the page.
    return content # Hello world

## HTTP Errors ##

@app.route('/505')
def error(request):

    content = tiny.TinyResponse('HTTP Version Not Supported', 505)
    return content

if __name__ == '__main__':
    tiny.run_app(app) # Will be accessible at localhost:8080 by default.

To create a template:

<!-- index.html -->

{{ template_var }}

To run the test suite:

python tests/tests.py

>> ......
>> ----------------------------------------------------------------------
>> Ran 6 tests in 0.001s
>>
>> OK

• To Do:

  1. Implement WSGI interface
  2. Parse HTTP GET request
  3. Set up basic routing in request handler
  4. Handle non-GET requests
  5. Parse queries more cleanly
  6. Handle requests more intelligently
  7. Handle responses more intelligently
  8. Make decorator for creating URLs
  9. Store HTTP statuses somewhere
  10. Move matching URLs into its own method
  11. Refactor rendering template method to be cleaner/more general

• Overall Plan

  1. WSGI Server
  2. Request Handling
  3. Response Handling
  4. Routing
  5. Errors
  6. Tests