Improve error message for dependencies on incompatible Python resolves

[Eric-Arellano]

Closes #14864.

This code is written generically so that we can hook it up to JVM easily.

[ci skip-rust]

[Eric-Arellano]

bad depencencies w/ single root (test):

NoCompatibleResolveException: The target src/python/pants/util/strutil_test.py:tests uses the `resolve` `python-default`, but some of its dependencies are not compatible with that resolve:

  * src/python/pants/util/osutil_test.py:tests (another)

All dependencies must work with the same `resolve`. To fix this, either change the `resolve=` field on those dependencies to `python-default`, or change the `resolve=` of the target src/python/pants/util/strutil_test.py:tests. If those dependencies should work with multiple resolves, use the `parametrize` mechanism with the `resolve=` field or manually create multiple targets for the same entity.

For more information, see https://www.pantsbuild.org/v2.13/docs/python-third-party-dependencies#multiple-lockfiles.

bad dependencies w/ multiple roots (check):

NoCompatibleResolveException: The inputted targets use the `resolve` `python-default`, but some of their dependencies are not compatible with that resolve.

Input targets:

  * src/python/pants/util/dirutil_test.py:tests
  * src/python/pants/util/strutil_test.py:tests

Bad dependencies:

  * src/python/pants/util/osutil_test.py:tests (another)

All dependencies must work with the same `resolve`. To fix this, either change the `resolve=` field on those dependencies to `python-default`, or change the `resolve=` of the input targets. If those dependencies should work with multiple resolves, use the `parametrize` mechanism with the `resolve=` field or manually create multiple targets for the same entity.

For more information, see https://www.pantsbuild.org/v2.13/docs/python-third-party-dependencies#multiple-lockfiles.

repl with bad input roots:

NoCompatibleResolveException: The input targets did not have a resolve in common.

another:
  * src/python/pants/util/osutil_test.py:tests

python-default:
  * src/python/pants/util/strutil_test.py:tests

Targets used together must use the same resolve, set by the `resolve` field. For more information on 'resolves' (lockfiles), see https://www.pantsbuild.org/v2.13/docs/python-third-party-dependencies#multiple-lockfiles.

To work around this, choose which resolve you want to use from above. Then, run `./pants peek :: | jq -r '.[] | select(.resolve == "example") | .["address"]' | xargs ./pants repl`, where you replace "example" with the resolve name, and possibly replace the specs `::` with what you were using before. If the resolve is the `[python].default_resolve`, use `select(.resolve == "example" or .resolve == null)`. These queries will result in opening a REPL with only targets using the desired resolve.

[stuhood]

Looks great: thanks!