def apps(p):
p(html.h2('Weby Apps'))
p(html.h3('Philosophy'))
with p(html.ul()):
p(html.li('Everything is an app. Simple. Each dynamic page is an app. Url dispatching/routing is an app. Serving static pages is an app.'))
p(html.h3('Design'))
p(html.p('An app is any callable which takes a request object as input, and returns a special iterator as output.'))
p(html.p('Weby request object are the same as the standard WebOb request objects designed by Ian Bicking. They are almost identical to Django and other Python web framework request objects.'))
p(html.p('The iterator that returned by the app must begin with a 2-tuple of the (1) status code, and (2) a list of HTTP headers. The rest of the iterator are unicode strings of the content of the HTTP response. Here is a simple example:'))
p(html.pre_code('''
def hello_world(req):
yield 200, ['Content-Type: text/html']
yield u'<html>Hello, %s</html>' % req.params.get('name', '')
'''))
p(html.p('Of course, most apps will yield 200 responses. You may not want to type yield out all of the time. Finally, you probably want an easier way to manage HTTP headers. We can decorate the request to make it easier to use:'))
p(html.pre_code('''
@weby.page()
def hello_world(req, page):
page(u'<html>Hello, %s</html>' % req.params.get('name', ''))
'''))
p(html.p('Or equivalently, using the weby template helper html library:'))
p(html.pre_code('''
@weby.page()
def hello_world(req, page):
page(html.html(u'Hello, %s' % req.params.get('name', '')))
'''))
p(html.p('Of course, in real code, you should call a separate template function, which of course returns a unicode string:'))
p(html.pre_code('''
@weby.page()
def hello_world(req, page):
name = req.params.get('name', '')
page(template_hello_world(name))
'''))
p(html.p('The decorator accumulates the response for the page, and then yields the correct iterator after your app returns. See the ' + html.code('WebyPage') + ' documentation for more information about what you can do. For example, you can use ' + html.code('page.redirect') + ' to send an HTTP 302 Redirect to another page'))
def templates(p):
p(html.h2('Weby Templates'))
p(html.h3('Philosophy'))
with p(html.ul()):
p(html.li('Learn as few new things as possible. You know Python. You know HTML. You should not have to learn a new template language.'))
p(html.li('Use the full power of Python. Easily create loops, use temporary variables, build filters, and import partials,'))
p(html.li('Separate presentation from logic. For best practices, explicitly pass only the necessary variables. Enforce this by convention, not by crippling power.'))
p(html.h3('Design'))
p(html.p('Weby templates are very simple. '))
p(html.pre_code('''
@weby.template()
def template_print_name(p, name):
p(u'Hello, %s' % name)
'''))
p(html.p('The function ' + html.code('template_print_name') +
' returns an'
' iterator of unicode strings.'))
p(html.p('The ' + html.code('weby.template') + ' decorator'
' adds a template'
' accumulator as the first argument, then returns'
' the accumulated array of strings at the end.'
' You can make an equivalent template function'
' without the decorator, but it will require some'
' repetitive code:'))
p(html.pre_code('''
def template_print_name(name):
t = []
t.append(u'Hello, %s' % name)
return t
'''))
p(html.p('Also, the '
' accumulator only takes unicode strings to enforce'
' correctness in your application code. Weby helps'
' you avoid unicode errors.'))
p(html.p('Also, if you pass the template accumulator a'
' 2-tuple, then it will return a context manager'
' for use with the ' + html.code('with') + ''
' statement. For example, '))
p(html.pre_code(html.h('''
@weby.template()
def template_print_name(p, name):
with p((u'<div>',u'</div>')):
p(u'Hello, %s' % name)
''')))
p(html.p('which is just syntactic sugar for'))
p(html.pre_code(html.h('''
@weby.template()
def template_print_name(p, name):
p(u'<div>')
p(u'Hello, %s' % name)
p(u'</div>')
''')))
p(html.p('Weby has many libraries to make this even'
' easier. Weby has libraries for writing'
' XML, RSS, and HTML templates:'))
p(html.pre_code('''
from weby.templates.helpers import html
@weby.template()
def template_print_name(p, name):
with p(html.div()):
p(u'Hello, %s' % name)
'''))
p(html.p('Every html tag has a predictable function in Weby\'s'
' html library. Also, each one can take an attribute'
' dictionary. The library always returns unicode'
' strings, so you can nest them easily.'))
p(html.pre_code('''
from weby.templates.helpers import html
@weby.template()
def template_print_name(p, name):
with p(html.html()):
with p(html.body()):
with p(html.div({'id':'hello'})):
p(html.p('Hello, %s' % name,
{'style':'font-weight:bold;'}))
with p(html.ul()):
for i in xrange(3):
p(html.li(html.a('Hello, %s' % i,
{'href':'/'})))
'''))
p(html.p('This generates the following html'))
p(html.pre_code(html.h('''
<html>
<body>
<div id="hello">
<p style="font-weight:bold;">Hello, Weby</p>
</div>
<ul>
<li><a href="/">Hello, 0</a></li>
<li><a href="/">Hello, 1</a></li>
<li><a href="/">Hello, 2</a></li>
</ul>
</body>
</html>
''')))