diff options
| author | Michele Simionato <michele.simionato@gmail.com> | 2019-03-16 07:48:55 +0100 |
|---|---|---|
| committer | Michele Simionato <michele.simionato@gmail.com> | 2019-03-16 07:48:55 +0100 |
| commit | d804bae697123fafec2af4b66a6220c2b80f6e97 (patch) | |
| tree | 962bda35c2b7f2e88af3e09e759427cd724047b3 | |
| parent | ab1cbff0217c0f3db18b6f6a5061e8d955b5f29e (diff) | |
| download | python-decorator-git-d804bae697123fafec2af4b66a6220c2b80f6e97.tar.gz | |
Restored .rst README
| -rw-r--r-- | README.md | 89 | ||||
| -rw-r--r-- | setup.py | 2 |
2 files changed, 1 insertions, 90 deletions
diff --git a/README.md b/README.md deleted file mode 100644 index 217877a..0000000 --- a/README.md +++ /dev/null @@ -1,89 +0,0 @@ -Decorator module -================= - -The goal of the decorator module is to make it easy to define -signature-preserving function decorators and decorator factories. -It also includes an implementation of multiple dispatch and other niceties -(please check the docs). It is released under a two-clauses -BSD license, i.e. basically you can do whatever you want with it but I am not -responsible. - -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]( -https://github.com/micheles/decorator) or download the -[tarball](http://pypi.python.org/pypi/decorator), unpack it and run - -``$ pip install .`` - -in the main directory, possibly as superuser. - -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 GitHub: https://raw.githubusercontent.com/micheles/decorator/master/docs/documentation.md - -From there you can get a PDF version by simply using the print -functionality of your browser. - -For the impatient ------------------ - -Here is an example of how to define a family of decorators tracing slow -operations: - -```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! @@ -9,7 +9,7 @@ if __name__ == '__main__': setup(name='decorator', version=VERSION, description='Better living through Python with decorators', - long_description=open('README.md').read(), + long_description=open('README.rst').read(), author='Michele Simionato', author_email='michele.simionato@gmail.com', url='https://github.com/micheles/decorator', |
