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

[Jason Madden]

  Branch: refs/heads/issue3
  Home:   https://github.com/zopefoundation/zope.interface
  Commit: 139bab56a722ac9f350c55f24e47b2decd1c2e1e
      https://github.com/zopefoundation/zope.interface/commit/139bab56a722ac9f350c55f24e47b2decd1c2e1e
  Author: Jason Madden <jamadden at gmail.com>
  Date:   2020-04-06 (Mon, 06 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: 1af83ef9f90aa7a558314892b72eec6d62263981
      https://github.com/zopefoundation/zope.interface/commit/1af83ef9f90aa7a558314892b72eec6d62263981
  Author: Jason Madden <jamadden at gmail.com>
  Date:   2020-04-06 (Mon, 06 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: 10eadd6305ee57910dbcc508b293f4bf0364fd84
      https://github.com/zopefoundation/zope.interface/commit/10eadd6305ee57910dbcc508b293f4bf0364fd84
  Author: Jason Madden <jamadden at gmail.com>
  Date:   2020-04-06 (Mon, 06 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/6385812540e9...10eadd6305ee