[Checkins] [zopefoundation/zope.interface] a825e5: Make verification errors more readable and useful.

[Jason Madden]

  Branch: refs/heads/master
  Home:   https://github.com/zopefoundation/zope.interface
  Commit: a825e5f29e98c8c84076600323ffe791531ac765
      https://github.com/zopefoundation/zope.interface/commit/a825e5f29e98c8c84076600323ffe791531ac765
  Author: Jason Madden <jamadden at gmail.com>
  Date:   2020-02-07 (Fri, 07 Feb 2020)

  Changed paths:
    M CHANGES.rst
    M docs/verify.rst
    M src/zope/interface/exceptions.py
    M src/zope/interface/interface.py
    M src/zope/interface/tests/test_exceptions.py
    M src/zope/interface/tests/test_interface.py
    M src/zope/interface/verify.py

  Log Message:
  -----------
  Make verification errors more readable and useful.

Eliminate the trailing newlines and blank spaces (the code called them
"a stupid artifact").

Include the name of the defining interface (so the user can easily look up
any requirements on the attribute) and, for methods, the expected
signature (no more guessing about how many arguments are required!).

This is implemented by giving Attribute and Method useful reprs and strs.
Previously, they just had the defaults.

Fixes #170


  Commit: e8a4da9d5e48d036c2280be009f75b6416054a12
      https://github.com/zopefoundation/zope.interface/commit/e8a4da9d5e48d036c2280be009f75b6416054a12
  Author: Jason Madden <jamadden at gmail.com>
  Date:   2020-02-07 (Fri, 07 Feb 2020)

  Changed paths:
    M docs/verify.rst
    M src/zope/interface/verify.py

  Log Message:
  -----------
  Also document the not-a-method case.


  Commit: 83f4f556991d6fc98eb26fcf918c657224cd05bf
      https://github.com/zopefoundation/zope.interface/commit/83f4f556991d6fc98eb26fcf918c657224cd05bf
  Author: Jason Madden <jamadden at gmail.com>
  Date:   2020-02-08 (Sat, 08 Feb 2020)

  Changed paths:
    M CHANGES.rst
    M docs/README.rst
    M docs/verify.rst
    M src/zope/interface/interfaces.py
    M src/zope/interface/verify.py

  Log Message:
  -----------
  Add warning to change note about string changes breaking doctests.

Also tweak documentation to DRY for verifyObject/verifyClass.


  Commit: d6343eeaa7f67838db9de82974898b80938a7aef
      https://github.com/zopefoundation/zope.interface/commit/d6343eeaa7f67838db9de82974898b80938a7aef
  Author: Jason Madden <jamadden at gmail.com>
  Date:   2020-02-08 (Sat, 08 Feb 2020)

  Changed paths:
    M CHANGES.rst
    M docs/README.rst
    M docs/verify.rst
    M src/zope/interface/exceptions.py
    M src/zope/interface/interface.py
    M src/zope/interface/interfaces.py
    M src/zope/interface/tests/test_exceptions.py
    M src/zope/interface/tests/test_interface.py
    M src/zope/interface/verify.py

  Log Message:
  -----------
  Merge pull request #173 from zopefoundation/issue170

Make verification errors more readable and useful.


Compare: https://github.com/zopefoundation/zope.interface/compare/cc537c613ba6...d6343eeaa7f6