# Uliweb 简介
## 它是什么
Uliweb是一个全栈式的Python Web Framework,它有三个主要设计目标:可重用性,可配 置性和可替换性。所有的功能都是围绕着这些目标。
这个项目是由Limodou <mailto:limodou@gmail.com>发起并创建的。
## License
Uliweb按照BSD协议进行发布。
## 基础组件
它并不完全是从头写的一个东西,我目前使用了一些库,如:
- [Werkzeug](http://werkzeug.pocoo.org/) 用它来进行框架的核心处理,比如:
- URL Mapping,Debug,Request, Response 等。
- [SqlAlchemy](http://www.sqlalchemy.org) 基于它封装了Uliorm,可以使用ORM对
- 数据库进行处理。
还有一些比较小的引用,如:
- template 是从 [tornado](http://mdp.cti.depaul.edu/) 改造来的(从0.4开始,在此之前是基于 [web2py](http://mdp.cti.depaul.edu/) )
- 部分处理代码从 [Django](http://www.djangoproject.com/) 中借鉴
另外还有一些是自已新造的,如:
- Form处理,可以用来生成HTML代码和对上传的数据进行校验
- i18n处理,包括对模板的处理
- Cache 和 Session 模块
- Uliorm,是在SqlAlchemy基础之上进行的封装,同时参考了GAE中的datastore的代码
- 框架的处理代码,这块不可能不自已造了
- 插件机制,从Ulipad中移植并进行了改造
## 功能特点
项目组织管理
- 采用MVT模型开发。
- 分散开发统一管理。采用App方式的项目组织。每个App有自已的配置文件,templates目录,
- static目录。使得Uliweb的App重用非常方便。同时在使用上却可以将所有App看成一个整体, 可以相互引用静态文件和模板。缺省是所有App都是生效的,也可以指定哪些App是生效的。 所有生效App的配置文件在启动时会统一进行处理,最终合成一个完整的配置视图。
URL处理
- 灵活强大的URL映射。采用Werkzeug的Routing模块,可以非常方便地定义URL,并与View函数
进行绑定。同时可以根据view函数反向生成URL。支持URL参数定义,支持缺省URL定义,如:
` appname/view_module/function_name `
View与Template
- View模板的自动套用。当view返回dict对象时,自动根据view函数的名字查找对应的模板。
- 目前View方法支持一般函数和类的方式。
- 环境方式运行。每个view函数在运行时会处于一个环境下,因此你不必写许多的import,许多
- 对象可以直接使用,比如request, response等。可以大大减少代码量。
- 模板中可以直接嵌入Python代码,不需要考虑缩近,只要在块结束时使用pass。支持模板的
- include和继承。
ORM
- 类Django和GAE的datastore,可以支持自动建表,同时提供命令行工具进行数据的备分,装入,建表等处理。
- Model可配置化,因此可以实现Model的替换
- 提供多数据库连接的支持
- 支持alembic的数据库迁移处理
i18n
- 支持代码和模板中的i18n处理
- 支持浏览器语言和cookie的自动选择,动态切换语言
- 提供命令行工具可以自动提取po文件,可以以App为单位或整个项目为单位。并在处理时自动将
- 所有语言文件进行合并处理。当发生修改时,再次提取可以自动进行合并。
扩展
- plugin扩展。这是一种插件处理机制。Uliweb已经预设了一些调用点,这些调用点会在特殊的地方
- 被执行。你可以针对这些调用点编写相应的处理,并且将其放在settings.py中,当Uliweb在启动 时会自动对其进行采集,当程序运行到调用点位置时,自动调用对应的插件函数。
- middleware扩展。它与Django的机制完全类似。你可以在配置文件中配置middleware类。每个
- middleware可以处理请求和响应对象。
- views模块的初始化处理。在views模块中,如果你写了一个名为__begin__的函数,它将在执行
- 要处理的view函数之前被处理,它相当于一个入口。因此你可以在这里面做一些模块级别的处理, 比如检查用户的权限。因此建议你根据功能将view函数分到不同的模块中。
命令行工具
- 可以自动创始初始工作环境,自动包含必要的目录结构,文件和代码
- 静态文件导出,可以将所有生效的App下的static导出到一个统一的目录
- 除了有项目组命令工具外,还提供APP专属命令工具,如ORM
部署
- 支持GAE部署
- 支持Apache下的mod_wsgi部署
- 支持uwsgi部署
- 支持dotcloud部署
- 支持sae部署
开发
- 提供开发服务器,并当代码修改时自动装载修改的模块
- 提供debug功能,可以查看出错的代码,包括模板中的错误
## 社区
- 邮件列表 http://groups.google.com/group/uliweb
- QQ讨论组 162487035
## 链接
- Uliweb 项目主页 https://github.com/limodou/uliweb
- Uliweb-doc 文档项目 [http://github.com/limodou/uliweb-doc](http://github.com/limodou/uliweb-doc)
- Uliweb-doc 在线文档查看链接 [http://limodou.github.com/uliweb-doc/](http://limodou.github.com/uliweb-doc/)
- plugs Uliweb apps收集项目 https://github.com/limodou/plugs