gh-59022: Added tests for `pkgutil.extend_path` (#59022) (GH-121673)

This adds tests for the documented behaviour of `pkgutil.extend_path`
regarding different argument types as well as for `*.pkg` files.