Skip to main content

Swinf is a simple micro-framework for small web application and has no dependencies other than the Python Standard Liberaty.

Project description

Swinf is a simple micro-framework for small web application and has no dependencies other than the Python Standard Liberaty.

It offers a built-in HTTP Server, and a simple route binding mechanism.

Commands

run command : swinf-admin.py startproject newproject and swinf will create a project directory.

Inside current project directory, there are a main.py and three subdirectories:

controller:

containing controllers.

view:

containing view template files.

subdirecties:

    static/: contains static files

    static/images: images here

    static/style: css files here

    static/script: js files here

    static/files: other static files here

model:

you can put your database controlling code here.

You can add some controllers in controller directory and run main.py, and it will work.

Template

Currently, swinf have a simple template engine called SimpleTemplate.

the tpl syntax follows below

<!-- in a tpl file -->

{%
# multiline code

def bold_wrapper(txt):
    return "<b>" + txt + "</b>"
endef
%}

%% # sigleline code
%% if name:
<h1> hello {{name}}!</h1>
%% else:
<h1> Hello World!</h1>
%% endif

<ul>
%% for i in range(100):
    <li>no: {{i}}</li>
%% endfor
</ul>

To use the template, you can use code like below:

from swinf.template import template
# pass tpl source
html = template("<h1>hello {{name}}", name='world')

# pass a tpl file
html = template(path='index.tpl', name='world')

Example

In swinf, there is no urls.py-like config file, instead, there are two simple route-config ways:

  • A Bottle.py like route binding mechanism
from swinf.swinf import run
from swinf.selector import route

# a simple controller
@route('/hello/:name')
def hello(name):
    return '<h1>Hello %s!</h1>' % name.title()

run(host='localhost', port=8080)
  • Much simpler route binding mechanism
# module1.py
from swinf.selector import handler

# --------- your code here -----------

@handler("GET")
def hello():
    return '<h1>Hello</h1>'

@handler("GET")
def world():
    return '<h1>World</h1>'

This will will automatically bind route /module1/hello to handler controller.module1.hello and /module1/world to handler controller.module1.world.

You don’t have to add routes manully.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
swinf-0.0.5.tar.gz (29.1 kB) Copy SHA256 hash SHA256 Egg 2.7

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page