annotate tests/artifacts/PURPOSE @ 45034:b1a1702262c9 stable

py3: fix crash when server address is 0.0.0.0 (issue6362)

`socket.getfqdn()` assumes that the name is passed as `str` on Python 3 and
always returns `str` in this case. Mercurial passed `bytes` (but still expected
a `str` result), which worked by chance in many cases, except for e.g.
b'0.0.0.0', which was returned unchanged, breaking later code.

Instead of calling `socket.getfqdn()`, we can also use `self.server_name` from
the base `HTTPServer` class, which already stores the FQDN of the locally-bound
socket name (see `BaseHTTPServer.py` in the Python 2 stdlib and
`http/server.py` in the Python 3 stdlib).

This directory is meant to cache artifacts useful for tests (such as bundle).

Those artifacts need to be cached because they are slow to regenerate on each
test but too large to be tracked within the repository. They are not expected
to change between each run and can be cached.

The `./scripts/` contains code to generate the artifact while the `cache`
directory contains resulting artifact.