summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichele Simionato <michele.simionato@gmail.com>2019-03-16 07:48:55 +0100
committerMichele Simionato <michele.simionato@gmail.com>2019-03-16 07:48:55 +0100
commitd804bae697123fafec2af4b66a6220c2b80f6e97 (patch)
tree962bda35c2b7f2e88af3e09e759427cd724047b3
parentab1cbff0217c0f3db18b6f6a5061e8d955b5f29e (diff)
downloadpython-decorator-git-d804bae697123fafec2af4b66a6220c2b80f6e97.tar.gz
Restored .rst README
-rw-r--r--README.md89
-rw-r--r--setup.py2
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!
diff --git a/setup.py b/setup.py
index ec408b1..7533762 100644
--- a/setup.py
+++ b/setup.py
@@ -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',