poetry-{cache, list, lock, show}: add page (#18229)

Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com>
Co-authored-by: Dylan <145150333+dmmqz@users.noreply.github.com>

Author: 3 people

pages/common/poetry-cache.md

@@ -0,0 +1,17 @@
+# poetry cache
+
+> Manage Poetry's cache.
+> See also: `asdf`.
+> More information: <https://python-poetry.org/docs/cli/#cache>.
+
+- Display Poetry's available caches:
+
+`poetry cache list`
+
+- Remove all packages from a cache (e.g.: PyPI):
+
+`poetry cache clear PyPI --all`
+
+- Remove a specific package from a cache (Note: must be in format `cache:package:version`):
+
+`poetry cache clear {{pypi}}:{{requests}}:{{2.24.0}}`

pages/common/poetry-list.md

@@ -0,0 +1,13 @@
+# poetry list
+
+> List available Poetry commands.
+> See also: `asdf`.
+> More information: <https://python-poetry.org/docs/cli/#list>.
+
+- List all available Poetry commands:
+
+`poetry list`
+
+- List commands for a specific namespace:
+
+`poetry list {{namespace}}`

pages/common/poetry-lock.md

@@ -0,0 +1,13 @@
+# poetry lock
+
+> Lock dependencies in `pyproject.toml` (without installing them).
+> See also: `asdf`.
+> More information: <https://python-poetry.org/docs/cli/#lock>.
+
+- Lock dependencies from the current directory's `pyproject.toml` file:
+
+`poetry lock`
+
+- Regenerate the existing lock file:
+
+`poetry lock --regenerate`

pages/common/poetry-show.md

@@ -0,0 +1,37 @@
+# poetry show
+
+> Show details of packages in your Poetry project.
+> See also: `asdf`.
+> More information: <https://python-poetry.org/docs/cli/#show>.
+
+- Display all packages:
+
+`poetry show`
+
+- Show details of a specific package:
+
+`poetry show {{package_name}}`
+
+- Show details as a dependency tree:
+
+`poetry show {{[-t|--tree]}}`
+
+- Only show top-level packages (those explicitly defined in `pyproject.toml`):
+
+`poetry show {{[-T|--top-level]}}`
+
+- Show outdated packages:
+
+`poetry show {{[-o|--outdated]}}`
+
+- Show the latest versions for all packages:
+
+`poetry show {{[-l|--latest]}}`
+
+- Exclude a specific dependency group/s:
+
+`poetry show --without {{group1,group2,...}}`
+
+- Only show a specific dependency group/s:
+
+`poetry show --only {{group1,group2,...}}`