releasing 1.2.0

[keighrim]

Overview

This version is minor release with addition of a new cli (describe), lots of in-line documentation updates, and deprecation of some "getter" methods

Additions

• mmif describe command to summarize views and annotations of a give MMIF file (basic mmif describe command #339).

Changes

• "list-like" objects in MMIF (DataList, DocumentsList, ViewsList, AnnotationsList) - get() method is now deprecated (make .get() and indexing ([]) more pythonic #295). Use their parent containers' get methods

mmif.views.get(some_view_id)  # will show deprecation warning as of 1.1.3 (note that there's no 1.1.3, we moved from 1.1.2 to 1.2.0)
# instead use 
mmif.get(some_view_id)
# same for view.annotations.get(ann_id) ==> view.get(ann_id)

• comparing two Mmif objects no longer depends on buggy deepdiff library, and handled more robustly (Checking for equality on Mmif instances fails #311)
• many outdated documentation updates