From e4583f5eb335307eee3e128bbf884a4953647cd1 Mon Sep 17 00:00:00 2001
From: Girdhar Agrawal <girdharagrawalbro@gmail.com>
Date: Thu, 16 Oct 2025 23:01:40 +0530
Subject: [PATCH] poetry-run: add page

---
 pages/common/poetry-run.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 pages/common/poetry-run.md

diff --git a/pages/common/poetry-run.md b/pages/common/poetry-run.md
new file mode 100644
index 00000000000000..f9938f9c6c967f
--- /dev/null
+++ b/pages/common/poetry-run.md
@@ -0,0 +1,28 @@
+# poetry run
+
+> Execute a command in the Poetry virtual environment.
+> More information: <https://python-poetry.org/docs/cli/#run>.
+
+- Run a Python script in the virtual environment:
+
+`poetry run python {{script.py}}`
+
+- Run a command in the virtual environment:
+
+`poetry run {{command}}`
+
+- Run pytest in the virtual environment:
+
+`poetry run pytest`
+
+- Run a Python module as a script:
+
+`poetry run python -m {{module_name}}`
+
+- Run a custom script defined in `pyproject.toml`:
+
+`poetry run {{script_name}}`
+
+- Display help:
+
+`poetry run --help`