install report: added experimental status warning

pypa · Jul 14, 2022 · 0cc7a39 · 0cc7a39
1 parent 19564a2
commit 0cc7a39
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/src/pip/_internal/commands/install.py b/src/pip/_internal/commands/install.py
@@ -371,6 +371,12 @@ def run(self, options: Values, args: List[str]) -> int:
             )
 
             if options.json_report_file:
+                logger.warning(
+                    "--report is currently an experimental option. "
+                    "The output format may change in a future release "
+                    "without prior warning."
+                )
+
                 report = InstallationReport(requirement_set.requirements_to_install)
                 if options.json_report_file == "-":
                     print_json(data=report.to_dict())