view tests/artifacts/PURPOSE @ 50093:ce60c8d4ac87

typing: add type hints to argument checking functions in cmdutil

These might be surprising, since they can take strings instead of bytes.  The
way `AnyStr` works is that it must be all bytes or all str for any given
invocation.

The wildcard here will be the `opts` that get passed in- if the type is unknown
and defaults to `Any`, there's no enforcement that the dict key type matches the
additional args.  But a lot of uses should be using `**opts` from the command
method, which has a str key.  The uses of these methods in this module are now
typed because their internals force a specific type, and it can't just be
inferred from the caller.

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.