add deprecation layer for 2.0

[sjsrey]

#161

See the mapping of old to new here.

[sjsrey]

Work in progress is here

[sjsrey]

I think most of the old methods are now covered by deprecation warnings in 2.0.

One class that I don't see mapped to a new version is spatial,SpatialDivergence @knaaptime is this correct that we are dropping this in 2.0 or did I miss a mapping to a new class?

[sjsrey]

TODO

• document what modules/functions need to be removed when 2.2.0 is released
• Removal
  • network
  • spatial
  • aspatial
• Modify
  • init.py
  • util.py

Notes

The deprecation pattern we are using doesn't play nicely when a deprecated class is used as a parent/ancestor class to a class that, in turn, will be decorated for deprecation. The call to super will throw an error.

A fix for this is to duplicate the class that will be decorated and give it a UD ending as done here.
The original class is then decorated for deprecation, while the UD class is used in any offspring classes.

[knaaptime]

awesome, thank you!

One class that I don't see mapped to a new version is spatial,SpatialDivergence @knaaptime is this correct that we are dropping this in 2.0 or did I miss a mapping to a new class?

musta missed it on accident. It collapses into multigroup.MultiDivergence

[knaaptime]

resolved by #161