diff --git a/src/pip/_internal/commands/inspect.py b/src/pip/_internal/commands/inspect.py index 0efb9723673..f719f623489 100644 --- a/src/pip/_internal/commands/inspect.py +++ b/src/pip/_internal/commands/inspect.py @@ -1,3 +1,4 @@ +import logging from optparse import Values from typing import Any, Dict, List @@ -12,6 +13,8 @@ from pip._internal.utils.compat import stdlib_pkgs from pip._internal.utils.urls import path_to_url +logger = logging.getLogger(__name__) + class InspectCommand(Command): """ @@ -44,6 +47,11 @@ def add_options(self) -> None: self.parser.insert_option_group(0, self.cmd_opts) def run(self, options: Values, args: List[str]) -> int: + logger.warning( + "pip inspect is currently an experimental command. " + "The output format may change in a future release without prior warning." + ) + cmdoptions.check_list_path_option(options) dists = get_environment(options.path).iter_installed_distributions( local_only=options.local, diff --git a/tests/functional/test_inspect.py b/tests/functional/test_inspect.py index 18abf1a46f6..464bdbaa11e 100644 --- a/tests/functional/test_inspect.py +++ b/tests/functional/test_inspect.py @@ -28,7 +28,7 @@ def test_inspect_basic(simple_script: PipTestEnvironment) -> None: """ Test default behavior of inspect command. """ - result = simple_script.pip("inspect") + result = simple_script.pip("inspect", allow_stderr_warning=True) report = json.loads(result.stdout) installed = report["installed"] assert len(installed) == 4