diff options
author | Michele Simionato <michele.simionato@gmail.com> | 2018-05-12 05:28:52 +0200 |
---|---|---|
committer | Michele Simionato <michele.simionato@gmail.com> | 2018-05-12 05:28:52 +0200 |
commit | 52923c38b03ffd900c684db551d85c2a954bface (patch) | |
tree | d2ba6cf07f806c2c291c6efb12828b84caa4f253 | |
parent | ab5a43ee1ed0d26f7b3b8f8d414325b9976f73f2 (diff) | |
download | python-decorator-git-52923c38b03ffd900c684db551d85c2a954bface.tar.gz |
Moved the README
-rw-r--r--[l---------] | README.rst | 90 | ||||
-rw-r--r-- | docs/README.rst | 89 |
2 files changed, 89 insertions, 90 deletions
diff --git a/README.rst b/README.rst index cffceba..ad72633 120000..100644 --- a/README.rst +++ b/README.rst @@ -1 +1,89 @@ -docs/README.rst
\ No newline at end of file +Decorator module +================= + +:Author: Michele Simionato +:E-mail: michele.simionato@gmail.com +:Requires: Python from 2.6 to 3.6 +:Download page: http://pypi.python.org/pypi/decorator +:Installation: ``pip install decorator`` +:License: BSD license + +Installation +------------- + +If you are lazy, just perform + + `$ pip install decorator` + +which will install just the module on your system. + +If you prefer to install the full distribution from source, including +the documentation, clone the `GitHub repo`_ or download the tarball_, unpack it and run + + `$ pip install .` + +in the main directory, possibly as superuser. + +.. _tarball: http://pypi.python.org/pypi/decorator +.. _GitHub repo: https://github.com/micheles/decorator + +Testing +-------- + +If you have the source code installation you can run the tests with + + `$ python src/tests/test.py -v` + +or (if you have setuptools installed) + + `$ python setup.py test` + +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. It is safe even to copy the module `decorator.py` over +an existing one, since we kept backward-compatibility for a long time. + +Repository +--------------- + +The project is hosted on GitHub. You can look at the source here: + + https://github.com/micheles/decorator + +Documentation +--------------- + +The documentation has been moved to http://decorator.readthedocs.io/en/latest/ +You can download a PDF version of it from http://media.readthedocs.org/pdf/decorator/latest/decorator.pdf + +For the impatient +----------------- + +Here is an example of how to define a family of decorators tracing slow +operations: + +.. code-block:: python + + from decorator import decorator + + @decorator + def warn_slow(func, timelimit=60, *args, **kw): + t0 = time.time() + result = func(*args, **kw) + dt = time.time() - t0 + if dt > timelimit: + logging.warn('%s took %d seconds', func.__name__, dt) + else: + logging.info('%s took %d seconds', func.__name__, dt) + return result + + @warn_slow # warn if it takes more than 1 minute + def preprocess_input_files(inputdir, tempdir): + ... + + @warn_slow(timelimit=600) # warn if it takes more than 10 minutes + def run_calculation(tempdir, outdir): + ... + +Enjoy! + diff --git a/docs/README.rst b/docs/README.rst deleted file mode 100644 index ad72633..0000000 --- a/docs/README.rst +++ /dev/null @@ -1,89 +0,0 @@ -Decorator module -================= - -:Author: Michele Simionato -:E-mail: michele.simionato@gmail.com -:Requires: Python from 2.6 to 3.6 -:Download page: http://pypi.python.org/pypi/decorator -:Installation: ``pip install decorator`` -:License: BSD license - -Installation -------------- - -If you are lazy, just perform - - `$ pip install decorator` - -which will install just the module on your system. - -If you prefer to install the full distribution from source, including -the documentation, clone the `GitHub repo`_ or download the tarball_, unpack it and run - - `$ pip install .` - -in the main directory, possibly as superuser. - -.. _tarball: http://pypi.python.org/pypi/decorator -.. _GitHub repo: https://github.com/micheles/decorator - -Testing --------- - -If you have the source code installation you can run the tests with - - `$ python src/tests/test.py -v` - -or (if you have setuptools installed) - - `$ python setup.py test` - -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. It is safe even to copy the module `decorator.py` over -an existing one, since we kept backward-compatibility for a long time. - -Repository ---------------- - -The project is hosted on GitHub. You can look at the source here: - - https://github.com/micheles/decorator - -Documentation ---------------- - -The documentation has been moved to http://decorator.readthedocs.io/en/latest/ -You can download a PDF version of it from http://media.readthedocs.org/pdf/decorator/latest/decorator.pdf - -For the impatient ------------------ - -Here is an example of how to define a family of decorators tracing slow -operations: - -.. code-block:: python - - from decorator import decorator - - @decorator - def warn_slow(func, timelimit=60, *args, **kw): - t0 = time.time() - result = func(*args, **kw) - dt = time.time() - t0 - if dt > timelimit: - logging.warn('%s took %d seconds', func.__name__, dt) - else: - logging.info('%s took %d seconds', func.__name__, dt) - return result - - @warn_slow # warn if it takes more than 1 minute - def preprocess_input_files(inputdir, tempdir): - ... - - @warn_slow(timelimit=600) # warn if it takes more than 10 minutes - def run_calculation(tempdir, outdir): - ... - -Enjoy! - |