weiyu 0.2.1

Licenses

• GPLv3+

• Public domain for examples/

The project contains code from other libraries; copyright notices are attached to the respective source files.

• helpers/regex_helper.py: Taken from Django, BSD-licensed.

• helpers/metaprogramming.py: Contains code from formencode, PSF-licensed. Also contains user-contributed code from StackOverflow which is licensed under cc-by-sa 3.0 according to StackOverflow policy.

Installation

weiyu is registered in PyPI, but for the moment directly installing from the official repository is recommended as the development is constantly in flux. Also you get the full set of examples this way.

To install from the official repo:

$ git clone https://github.com/xen0n/weiyu.git
$ cd weiyu/
(installing using distribute)
$ ./setup.py develop
(or manually setting up the link)
$ pwd > /path/to/your/site-packages/weiyu.pth

To install via pip:

$ pip install weiyu

Both will not install most of the dependencies. While the deps can be controlled individually using flags like weiyu[mako,riak,redis], requirements files have been provided to allow quick install of all possible dependencies.:

$ pip install -r requirements.txt

Known issues

• gevent-socketio integration is not directly usable on PyPy. However, with the latest version of PyPy and some hacks, the performance can become really awesome!

• The NoSQL DB mapper is somewhat lacking in capabilities, help appreciated.

Community

• Mailing list

  • weiyu-cn at groups.google.com (Main language: Chinese)

Why the name?

The name comes from Lin Jiang Xian (trad: 臨江仙/simp: 临江仙) by Yan Jidao, a poet of the Song dynasty. The referenced sentence is 去年春恨卻來時，落花人獨立，微雨燕雙飛. Its pronunciation is like “WE-you”, if not using the correct vowel for “yu”.

Examples

Some examples are provided in the examples/ directory. Check them out to get a feeling of working with weiyu.