plac-tik-fork / decorator /

Filename Size Date modified Message
..
src
4.4 KB
60 B
696 B
2.2 KB
87.0 KB
128.8 KB
34.9 KB
82.8 KB
122.7 KB
33.7 KB
9.5 KB
1.6 KB
Decorator module
=================


:Author: Michele Simionato
:E-mail: michele.simionato@gmail.com
:Requires: Python 2.4+
:Download page: http://pypi.python.org/pypi/decorator
:Installation: ``easy_install decorator``
:License: BSD license

Installation
-------------

If you are lazy, just perform

$ easy_install decorator

which will install just the module on your system. Notice that
Python 3 requires the easy_install version of the distribute_ project.

If you prefer to install the full distribution from source, including
the documentation, download the tarball_, unpack it and run

$ python setup.py install

in the main directory, possibly as superuser.

.. _tarball: http://pypi.python.org/pypi/decorator
.. _distribute: http://packages.python.org/distribute/

Testing
--------

For Python 2.5, 2.6, 2.7 run

$ python documentation.py

for Python 3.X run

$ python documentation3.py

You will see a few innocuous errors with Python 2.5, because some
inner details such as the introduction of the ArgSpec namedtuple and
Thread.__repr__ changed. You may safely ignore them. 

You cannot run the tests in Python 2.4, since there is a test using
the with statement, but the decorator module is expected to work
anyway (it has been used in production with Python 2.4 for years). My
plan is to keep supporting all Python versions >= 2.4 in the core
module, but I will keep the documentation and the tests updated only
for the latest Python versions in both the 2.X and 3.X branches.

Finally, notice that you may run into trouble if in your system there
is an older version of the decorator module; in such a case remove the
old version.

Documentation
--------------

There are various versions of the documentation:

-  `HTML version (Python 2)`_ 
-  `PDF version (Python 2)`_ 

-  `HTML version (Python 3)`_ 
-  `PDF version (Python 3)`_ 

.. _HTML version (Python 2): http://micheles.googlecode.com/hg/decorator/documentation.html
.. _PDF version (Python 2): http://micheles.googlecode.com/hg/decorator/documentation.pdf
.. _HTML version (Python 3): http://micheles.googlecode.com/hg/decorator/documentation3.html
.. _PDF version (Python 3): http://micheles.googlecode.com/hg/decorator/documentation3.pdf
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.