From d15d5b771bbfff7887b5abe8479f189aff56d2fa Mon Sep 17 00:00:00 2001
From: ivuorinen <ivuorinen@users.noreply.github.com>
Date: Fri, 12 Sep 2025 00:18:39 +0000
Subject: [PATCH] Update cheatsheets

---
 tldr/poetry-about   | 14 ++++++++++++++
 tldr/poetry-check   | 22 ++++++++++++++++++++++
 tldr/poetry-debug   | 22 ++++++++++++++++++++++
 tldr/poetry-python  | 26 ++++++++++++++++++++++++++
 tldr/poetry-version | 27 +++++++++++++++++++++++++++
 tldr/repomix        | 41 +++++++++++++++++++++++++++++++++++++++++
 6 files changed, 152 insertions(+)
 create mode 100644 tldr/poetry-about
 create mode 100644 tldr/poetry-check
 create mode 100644 tldr/poetry-debug
 create mode 100644 tldr/poetry-python
 create mode 100644 tldr/poetry-version
 create mode 100644 tldr/repomix

diff --git a/tldr/poetry-about b/tldr/poetry-about
new file mode 100644
index 00000000..dae62a25
--- /dev/null
+++ b/tldr/poetry-about
@@ -0,0 +1,14 @@
+---
+syntax: markdown
+tags: [tldr, common]
+source: https://github.com/tldr-pages/tldr.git
+---
+# poetry about
+
+> Get information about Poetry, an application to manage Python packages and dependencies.
+> See also: `asdf`.
+> More information: <https://python-poetry.org/docs/cli/#about>.
+
+- Display global information about Poetry, including the current version:
+
+`poetry about`
diff --git a/tldr/poetry-check b/tldr/poetry-check
new file mode 100644
index 00000000..26326213
--- /dev/null
+++ b/tldr/poetry-check
@@ -0,0 +1,22 @@
+---
+syntax: markdown
+tags: [tldr, common]
+source: https://github.com/tldr-pages/tldr.git
+---
+# poetry check
+
+> Manage Poetry file validation and consistency.
+> See also: `asdf`.
+> More information: <https://python-poetry.org/docs/cli/#check>.
+
+- Check validation and consistency between `pyproject.toml` and `poetry.lock` for Poetry:
+
+`poetry check`
+
+- Verify that `poetry.lock` exists:
+
+`poetry check --lock`
+
+- Fail if warnings are reported:
+
+`poetry check --strict`
diff --git a/tldr/poetry-debug b/tldr/poetry-debug
new file mode 100644
index 00000000..ef84c22f
--- /dev/null
+++ b/tldr/poetry-debug
@@ -0,0 +1,22 @@
+---
+syntax: markdown
+tags: [tldr, common]
+source: https://github.com/tldr-pages/tldr.git
+---
+# poetry-debug
+
+> Debug issues with your Poetry project.
+> See also: `asdf`.
+> More information: <https://python-poetry.org/docs/cli/#debug>.
+
+- Show debug info about Poetry and your project's virtual environment:
+
+`poetry debug info`
+
+- Attempt to resolve your project dependencies:
+
+`poetry debug resolve`
+
+- Show supported packaging tags for your project's active virtual environment:
+
+`poetry debug tags`
diff --git a/tldr/poetry-python b/tldr/poetry-python
new file mode 100644
index 00000000..f38255c7
--- /dev/null
+++ b/tldr/poetry-python
@@ -0,0 +1,26 @@
+---
+syntax: markdown
+tags: [tldr, common]
+source: https://github.com/tldr-pages/tldr.git
+---
+# poetry-python
+
+> Manage Python versions through Poetry.
+> See also: `asdf`.
+> More information: <https://python-poetry.org/docs/cli/#python>.
+
+- Install the specified Python version:
+
+`poetry python install {{3.13.1}}`
+
+- List all Python versions managed by System or Poetry:
+
+`poetry python list`
+
+- List all Python versions managed by Poetry:
+
+`poetry python list --managed`
+
+- Remove the specified Python version (if managed by Poetry):
+
+`poetry python remove {{3.13.1}}`
diff --git a/tldr/poetry-version b/tldr/poetry-version
new file mode 100644
index 00000000..aab6bb08
--- /dev/null
+++ b/tldr/poetry-version
@@ -0,0 +1,27 @@
+---
+syntax: markdown
+tags: [tldr, common]
+source: https://github.com/tldr-pages/tldr.git
+---
+# poetry version
+
+> Manage Poetry project version.
+> Assumes the following project stages: `patch`, `minor`, `major`, `prepatch`, `preminor`, `premajor`, `prerelease`.
+> See also: `asdf`.
+> More information: <https://python-poetry.org/docs/cli/#version>.
+
+- Output the current version:
+
+`poetry version {{[-s|--short]}}`
+
+- Set project to a specific phase:
+
+`poetry version {{stage}}`
+
+- Increment the project to the next prerelease phase:
+
+`poetry version --next-phase`
+
+- Test project stage function without writing to `pyproject.toml`:
+
+`poetry version {{stage}} --dry-run`
diff --git a/tldr/repomix b/tldr/repomix
new file mode 100644
index 00000000..a134cbd8
--- /dev/null
+++ b/tldr/repomix
@@ -0,0 +1,41 @@
+---
+syntax: markdown
+tags: [tldr, common]
+source: https://github.com/tldr-pages/tldr.git
+---
+# repomix
+
+> Pack a Github repository into an AI-friendly file.
+> More information: <https://github.com/yamadashy/repomix>.
+
+- Output custom format:
+
+`repomix {{[-o|--output]}} {{path/to/file}} --style {{xml|markdown|plain}}`
+
+- Send output to `stdout`:
+
+`repomix --stdout > {{path/to/file}}`
+
+- Send output to `stdout`, then pipe into another program:
+
+`repomix --stdout | {{less}}`
+
+- Output with compression:
+
+`repomix --compress`
+
+- Process specific files:
+
+`repomix --include "{{src/**/*.ts}}" --ignore "{{**/*.test.ts}}"`
+
+- Pack a repository from a branch:
+
+`repomix --remote {{https://github.com/user/repo/tree/main}}`
+
+- Pack a repository at a specific commit:
+
+`repomix --remote {{https://github.com/user/repo/commit/836abcd7335137228ad77feb28655d85712680f1}}`
+
+- Pack repository using shorthand:
+
+`repomix --remote {{user/repo}}`