.. -*- coding: utf-8 -*-

project logilab-aspects
=======================
:creation date: 2006/11/06

aspect oriented programming in python

aspects is a python module that enables Aspect Oriented Programming in Python.
For now, it provides a set of ready-to-use aspects and an easy way to create
your own aspects. The current possibilities are still a bit limited, but it will
soon provide a more exhaustive way to define and use more complex aspects.

version 0.1.4
-------------
:publication date: 2005/12/28
:expected date: n/a

version 0.2.0
-------------
:expected date: n/a

ticket #2865: nice traceback
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
:type: enhancement
:state: open

Avoir des beaux tracebacks quand une erreur se produit dans la méthode aspectée.
(Actuellement, on a le traceback de l'exception en double). Par exemple ::
Traceback (most recent call last): File "contract_example.py", line 188, in ?
run() File "contract_example.py", line 158, in run stack.push(1) File
".../cvs_work/soft_public/logilab/aspects/weaver.py", line 222, in wrapper ret_v
= aspect.around(wobj, context, *args, **kwargs) File
".../cvs_work/soft_public/logilab/aspects/core.py", line 92, in around return
self._proceed(wobj, wclass, met_name, *args, **kwargs) File
".../cvs_work/soft_public/logilab/aspects/core.py", line 99, in _proceed return
method.im_func(wobj, *args, **kwargs) File "contract_example.py", line 105, in
push raise Exception("heheheheh") Exception: ('heheheheh', ' File
".../cvs_work/soft_public/logilab/aspects/core.py", line 92, in around\n return
self._proceed(wobj, wclass, met_name, *args, **kwargs)\n File
".../cvs_work/soft_public/logilab/aspects/core.py", line 99, in _proceed\n
return method.im_func(wobj, *args, **kwargs)\n File "contract_example.py", line
105, in push\n raise Exception("heheheheh")\n')

ticket #2871: explore possible relations with epydoc
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
:type: enhancement
:state: open

quand je vois ":type param:" dans epydoc, je pense aux contrats. peut-être que
ça pourrait constituer une syntaxe alternative ?

ticket #5581: change syntax for contracts
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
:type: enhancement
:state: open

Using :invariants:, :precondition:, :postcondition: as epydoc wants it would
make documentation generation easier http://epydoc.sourceforge.net/fields.html