view README.rst @ 52130:8b791764fc52

typing: suppress bogus pytype errors in `mercurial/wireprotov1peer.py`

Fixes:

    File "/mnt/c/Users/Matt/hg/mercurial/wireprotov1peer.py", line 100, in result:
        No attribute '_peerexecutor' on unsentfuture [attribute-error]
    File "/mnt/c/Users/Matt/hg/mercurial/wireprotov1peer.py", line 278, in close:
        No attribute 'shutdown' on None [attribute-error]
    Called from (traceback):
      line 123, in __exit__
    File "/mnt/c/Users/Matt/hg/mercurial/wireprotov1peer.py", line 278, in close:
        No attribute 'shutdown' on None [attribute-error]
      In Optional[concurrent.futures.thread.ThreadPoolExecutor]

We drop the zope decorator on `peerexecutor`, because otherwise it triggers this
error:

    File "/tmp/mercurial-ci/mercurial/wireprotov1peer.py", line 111, in <module>:
        Invalid type annotation  [invalid-annotation]
      Must be constant

Not sure why, because the decorated classes usually get typed as `Any`, which
would also be fine here.

Mercurial
=========

Mercurial is a fast, easy to use, distributed revision control tool
for software developers.

Basic install::

 $ make            # see install targets
 $ make install    # do a system-wide install
 $ hg debuginstall # sanity-check setup
 $ hg              # see help

Running without installing::

 $ make local      # build for inplace usage
 $ ./hg --version  # should show the latest version

See https://mercurial-scm.org/ for detailed installation
instructions, platform-specific notes, and Mercurial user information.

Notes for packagers
===================

Mercurial ships a copy of the python-zstandard sources. This is used to
provide support for zstd compression and decompression functionality. The
module is not intended to be replaced by the plain python-zstandard nor
is it intended to use a system zstd library. Patches can result in hard
to diagnose errors and are explicitly discouraged as unsupported
configuration.