Resolve "Migration guide pyotb 1.5.4 --> 2.0.0"

Closes #104 (closed)

I took the liberty to add OTBObject.summarize() for backward compatibility purpose, and also convenience (this way the API is more flexible). However I am open to discuss its non-return, not a big deal.

Basically this MR consists in new decorators (in deprecated.py) for the depreciation of methods, arguments, and the otbObject class. Flashy color warning appear to suggest user to replace arguments names, when it's backward compatible, and exception are thrown (DepreciationWarning) when it's not. I have brought back the App.__getattr__ only to throw a DepreciationWarning explaining how to migrate, when the App.app attribute exists.

Maybe I have missed a few old attributes. With the decorators we can add them for depreciation easily.

to do

• add warnings and depreciation decorators in code
• write a note on migration in documentation

pyotb/__init__.py

@@ -4,7 +4,8 @@ __version__ = "2.0.0.dev4"
 
 from .helpers import logger, set_logger_level
 from .apps import *
-from .core import App, Input, Output, get_nbchannels, get_pixel_type, summarize
+from .core import App, Input, Output, get_nbchannels, get_pixel_type, summarize, OTBObject
+
 from .functions import (  # pylint: disable=redefined-builtin
     all,
     any,