feat: add --with option to "pipx run" command

Closes #1607

Author: pabloyoyoista

changelog.d/1607.feature.md

@@ -0,0 +1 @@
+Add `--with` flag to `pipx run` to allow injecting dependencies

src/pipx/commands/run.py

@@ -14,6 +14,7 @@
 
 from pipx import paths
 from pipx.commands.common import package_name_from_spec
+from pipx.commands.inject import inject_dep
 from pipx.constants import TEMP_VENV_EXPIRATION_THRESHOLD_DAYS, WINDOWS
 from pipx.emojis import hazard
 from pipx.util import (
@@ -111,6 +112,7 @@ def run_script(
 def run_package(
     app: str,
     package_or_url: str,
+    dependencies: List[str],
     app_args: List[str],
     python: str,
     pip_args: List[str],
@@ -156,6 +158,7 @@ def run_package(
     _prepare_venv_cache(venv, bin_path, use_cache)
 
     if venv.has_app(app, app_filename):
+        # TODO: Should refactor and consider injecting here
         logger.info(f"Reusing cached venv {venv_dir}")
         venv.run_app(app, app_filename, app_args)
     else:
@@ -166,6 +169,7 @@ def run_package(
             app,
             app_filename,
             app_args,
+            dependencies,
             python,
             pip_args,
             venv_args,
@@ -177,6 +181,7 @@ def run_package(
 def run(
     app: str,
     spec: str,
+    dependencies: List[str],
     is_path: bool,
     app_args: List[str],
     python: str,
@@ -206,6 +211,7 @@ def run(
         run_package(
             package_name,
             package_or_url,
+            dependencies,
             app_args,
             python,
             pip_args,
@@ -222,6 +228,7 @@ def _download_and_run(
     app: str,
     app_filename: str,
     app_args: List[str],
+    dependencies: List[str],
     python: str,
     pip_args: List[str],
     venv_args: List[str],
@@ -275,6 +282,18 @@ def _download_and_run(
         # Let future _remove_all_expired_venvs know to remove this
         (venv_dir / VENV_EXPIRED_FILENAME).touch()
 
+    for dep in dependencies:
+        inject_dep(
+            venv_dir=venv_dir,
+            package_name=None,
+            package_spec=dep,
+            pip_args=pip_args,
+            verbose=verbose,
+            include_apps=False,
+            include_dependencies=False,
+            force=False,
+        )
+
     venv.run_app(app, app_filename, app_args)
 
 

src/pipx/main.py

@@ -267,6 +267,7 @@ def run_pipx_command(args: argparse.Namespace, subparsers: Dict[str, argparse.Ar
         commands.run(
             args.app_with_args[0],
             args.spec,
+            args.with_,
             args.path,
             args.app_with_args[1:],
             args.python,
@@ -845,6 +846,13 @@ def _add_run(subparsers: argparse._SubParsersAction, shared_parser: argparse.Arg
         action="store_true",
         help="Require app to be run from local __pypackages__ directory",
     )
+    p.add_argument(
+        "--with",
+        dest="with_",
+        action="append",
+        default=[],
+        help="Extra dependencies to add to the temporary environment",
+    )
     p.add_argument("--spec", help=SPEC_HELP)
     add_python_options(p)
     add_pip_venv_args(p)

tests/test_run.py

@@ -443,3 +443,10 @@ def test_run_local_path_entry_point(pipx_temp_env, caplog, root):
     run_pipx_cli_exit(["run", empty_project_path])
 
     assert "Using discovered entry point for 'pipx run'" in caplog.text
+
+
+@mock.patch("os.execvpe", new=execvpe_mock)
+def test_run_with(pipx_temp_env, capsys):
+    run_pipx_cli_exit(["run", "--with", "black", "pycowsay", "--help"])
+    captured = capsys.readouterr()
+    assert "injected package black into venv pycowsay" in captured.out