[Checkins] [zopefoundation/zope.interface] e83014: Add more cross refs to documentation and fix a cou...

[Jason Madden]

  Branch: refs/heads/issue3
  Home:   https://github.com/zopefoundation/zope.interface
  Commit: e83014eb97a2ea1347a7287257dc22093311b10d
      https://github.com/zopefoundation/zope.interface/commit/e83014eb97a2ea1347a7287257dc22093311b10d
  Author: Jason Madden <jamadden at gmail.com>
  Date:   2020-04-03 (Fri, 03 Apr 2020)

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

  Log Message:
  -----------
  Add more cross refs to documentation and fix a couple sphinx warnings about duplicates in the index.


  Commit: 1f38cab4e810434a8aac9553fcc1e42d0316c0e4
      https://github.com/zopefoundation/zope.interface/commit/1f38cab4e810434a8aac9553fcc1e42d0316c0e4
  Author: Jason Madden <jamadden at gmail.com>
  Date:   2020-04-03 (Fri, 03 Apr 2020)

  Changed paths:
    M docs/README.rst
    M docs/api/declarations.rst
    M src/zope/interface/interfaces.py

  Log Message:
  -----------
  Add documentation for taggedValue and invariant.


  Commit: 6385812540e9564db558d9a2b86b0f65ba427281
      https://github.com/zopefoundation/zope.interface/commit/6385812540e9564db558d9a2b86b0f65ba427281
  Author: Jason Madden <jamadden at gmail.com>
  Date:   2020-04-03 (Fri, 03 Apr 2020)

  Changed paths:
    M CHANGES.rst
    M docs/README.rst
    M docs/api/declarations.rst
    M src/zope/interface/__init__.py
    M src/zope/interface/_zope_interface_coptimizations.c
    M src/zope/interface/common/__init__.py
    M src/zope/interface/interface.py
    M src/zope/interface/interfaces.py
    M src/zope/interface/tests/test_adapter.py
    M src/zope/interface/tests/test_declarations.py
    M src/zope/interface/tests/test_interface.py

  Log Message:
  -----------
  Let interface 'subclasses' override __adapt__.

Cooperate with InterfaceClass to ensure there is no performance penalty for this. Fixes #3

+-------------------------------------------------------------+----------------+------------------------------+------------------------------+
| Benchmark                                                   | bench_master38 | bench_issue3                 | bench_issue3_opt             |
+=============================================================+================+==============================+==============================+
| call interface (provides; deep)                             | 369 ns         | 454 ns: 1.23x slower (+23%)  | not significant              |
+-------------------------------------------------------------+----------------+------------------------------+------------------------------+
| call interface (provides; wide)                             | 373 ns         | 457 ns: 1.22x slower (+22%)  | 365 ns: 1.02x faster (-2%)   |
+-------------------------------------------------------------+----------------+------------------------------+------------------------------+
| call interface (no alternate, no conform, not provided)     | 671 ns         | 760 ns: 1.13x slower (+13%)  | 636 ns: 1.06x faster (-5%)   |
+-------------------------------------------------------------+----------------+------------------------------+------------------------------+
| call interface (alternate, no conform, not provided)        | 395 ns         | 494 ns: 1.25x slower (+25%)  | not significant              |
+-------------------------------------------------------------+----------------+------------------------------+------------------------------+
| call interface (no alternate, valid conform, not provided)  | 250 ns         | not significant              | 227 ns: 1.10x faster (-9%)   |
+-------------------------------------------------------------+----------------+------------------------------+------------------------------+
| call interface (alternate, invalid conform, not provided)   | 348 ns         | 424 ns: 1.22x slower (+22%)  | not significant              |
+-------------------------------------------------------------+----------------+------------------------------+------------------------------+


Compare: https://github.com/zopefoundation/zope.interface/compare/e83014eb97a2%5E...6385812540e9