From 370df82bda3bafa6ae1550562756c8b2eddc54e8 Mon Sep 17 00:00:00 2001 From: ivuorinen Date: Sun, 28 Sep 2025 00:21:14 +0000 Subject: [PATCH] Update cheatsheets --- tldr/agg | 8 ++++++++ tldr/licensor | 2 +- tldr/linux/playerctl | 8 ++++---- tldr/linux/ss | 4 ++-- tldr/magick | 4 ++++ tldr/poetry-add | 30 ++++++++++++++++++++++++++++++ tldr/poetry-cache | 22 ++++++++++++++++++++++ tldr/poetry-list | 18 ++++++++++++++++++ tldr/poetry-lock | 18 ++++++++++++++++++ tldr/poetry-show | 42 ++++++++++++++++++++++++++++++++++++++++++ tldr/reuse | 2 +- 11 files changed, 150 insertions(+), 8 deletions(-) create mode 100644 tldr/poetry-add create mode 100644 tldr/poetry-cache create mode 100644 tldr/poetry-list create mode 100644 tldr/poetry-lock create mode 100644 tldr/poetry-show diff --git a/tldr/agg b/tldr/agg index f8515f69..6d7c5fa1 100644 --- a/tldr/agg +++ b/tldr/agg @@ -11,3 +11,11 @@ source: https://github.com/tldr-pages/tldr.git - Create a GIF: `agg {{path/to/demo.cast}} {{path/to/demo.gif}}` + +- Create a GIF that is 80 columns wide and 25 rows in height: + +`agg --cols 80 --rows 25 {{path/to/demo.cast}} {{path/to/demo.gif}}` + +- Display help: + +`agg {{[-h|--help]}}` diff --git a/tldr/licensor b/tldr/licensor index 4b0877ab..b04e24eb 100644 --- a/tldr/licensor +++ b/tldr/licensor @@ -20,7 +20,7 @@ source: https://github.com/tldr-pages/tldr.git `licensor {{MIT}} "{{Bobby Tables}}" > {{LICENSE}}` -- Specify licence exceptions with a WITH expression: +- Specify license exceptions with a WITH expression: `licensor "{{Apache-2.0 WITH LLVM-exception}}" > {{LICENSE}}` diff --git a/tldr/linux/playerctl b/tldr/linux/playerctl index d4d39be2..277d85d3 100644 --- a/tldr/linux/playerctl +++ b/tldr/linux/playerctl @@ -22,16 +22,16 @@ source: https://github.com/tldr-pages/tldr.git - List all players: -`playerctl --list-all` +`playerctl {{[-l|--list-all]}}` - Send a command to a specific player: -`playerctl --player {{player_name}} {{play-pause|next|previous|...}}` +`playerctl {{[-p|--player]}} {{player_name}} {{play-pause|next|previous|...}}` - Send a command to all players: -`playerctl --all-players {{play-pause|next|previous|...}}` +`playerctl {{[-a|--all-players]}} {{play-pause|next|previous|...}}` - Display metadata about the current track: -`playerctl metadata --format "{{Now playing: \{\{artist\}\} - \{\{album\}\} - \{\{title\}\}}}"` +`playerctl metadata {{[-f|--format]}} "{{Now playing: \{\{artist\}\} - \{\{album\}\} - \{\{title\}\}}}"` diff --git a/tldr/linux/ss b/tldr/linux/ss index 0aa9191e..89d05aa7 100644 --- a/tldr/linux/ss +++ b/tldr/linux/ss @@ -36,6 +36,6 @@ source: https://github.com/tldr-pages/tldr.git `ss {{[-4t|--ipv4 --tcp]}} src {{192.168/16}}` -- Kill IPv4 or IPv6 Socket Connection with destination IP 192.168.1.17 and destination port 8080: +- Kill IPv4 or IPv6 Socket Connection with a specific destination IP and port: -`ss {{[-K|--kill]}} dst {{192.168.1.17}} dport = {{8080}}` +`ss {{[-K|--kill]}} dst {{ip_address}} dport = {{port}}` diff --git a/tldr/magick b/tldr/magick index 8734dc55..6e94c236 100644 --- a/tldr/magick +++ b/tldr/magick @@ -18,6 +18,10 @@ source: https://github.com/tldr-pages/tldr.git `magick {{path/to/input_image.jpg}} -resize {{100x100}} {{path/to/output_image.jpg}}` +- Resize an image by a percentage: + +`magick {{path/to/input_image.png}} -resize {{50}}% {{path/to/output_image.png}}` + - Create a GIF out of all JPEG images in the current directory: `magick {{*.jpg}} {{path/to/images.gif}}` diff --git a/tldr/poetry-add b/tldr/poetry-add new file mode 100644 index 00000000..daf8a8ba --- /dev/null +++ b/tldr/poetry-add @@ -0,0 +1,30 @@ +--- +syntax: markdown +tags: [tldr, common] +source: https://github.com/tldr-pages/tldr.git +--- +# poetry add + +> Add required packages to the `pyproject.toml` file in Poetry. +> See also: `asdf`. +> More information: . + +- Add required packages: + +`poetry add {{package_name}}` + +- Add required packages to a specific group of dependencies: + +`poetry add {{package_name}} --group {{group_name}}` + +- Add a specific version of a package: + +`poetry add {{package_name}}=={{version}}` + +- Add a specific version of a package equal to or earlier than a given version: + +`poetry add {{package_name}}<={{version}}` + +- Add a specific version of a package equal to or later than a given version: + +`poetry add {{package_name}}>={{version}}` diff --git a/tldr/poetry-cache b/tldr/poetry-cache new file mode 100644 index 00000000..2d356f52 --- /dev/null +++ b/tldr/poetry-cache @@ -0,0 +1,22 @@ +--- +syntax: markdown +tags: [tldr, common] +source: https://github.com/tldr-pages/tldr.git +--- +# poetry cache + +> Manage Poetry's cache. +> See also: `asdf`. +> More information: . + +- 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}}` diff --git a/tldr/poetry-list b/tldr/poetry-list new file mode 100644 index 00000000..f0b24a33 --- /dev/null +++ b/tldr/poetry-list @@ -0,0 +1,18 @@ +--- +syntax: markdown +tags: [tldr, common] +source: https://github.com/tldr-pages/tldr.git +--- +# poetry list + +> List available Poetry commands. +> See also: `asdf`. +> More information: . + +- List all available Poetry commands: + +`poetry list` + +- List commands for a specific namespace: + +`poetry list {{namespace}}` diff --git a/tldr/poetry-lock b/tldr/poetry-lock new file mode 100644 index 00000000..b7b959c4 --- /dev/null +++ b/tldr/poetry-lock @@ -0,0 +1,18 @@ +--- +syntax: markdown +tags: [tldr, common] +source: https://github.com/tldr-pages/tldr.git +--- +# poetry lock + +> Lock dependencies in `pyproject.toml` (without installing them). +> See also: `asdf`. +> More information: . + +- Lock dependencies from the current directory's `pyproject.toml` file: + +`poetry lock` + +- Regenerate the existing lock file: + +`poetry lock --regenerate` diff --git a/tldr/poetry-show b/tldr/poetry-show new file mode 100644 index 00000000..6a75b927 --- /dev/null +++ b/tldr/poetry-show @@ -0,0 +1,42 @@ +--- +syntax: markdown +tags: [tldr, common] +source: https://github.com/tldr-pages/tldr.git +--- +# poetry show + +> Show details of packages in your Poetry project. +> See also: `asdf`. +> More information: . + +- 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,...}}` diff --git a/tldr/reuse b/tldr/reuse index 6c73dc33..6a5b47b3 100644 --- a/tldr/reuse +++ b/tldr/reuse @@ -20,7 +20,7 @@ source: https://github.com/tldr-pages/tldr.git `reuse annotate {{[-c|--copyright]}} "{{your_name}} <{{your_email}}>" --fallback-dot-license {{path/to/file}}` -- Add licence information to file: +- Add license information to file: `reuse annotate {{[-l|--license]}} {{spdx_identifier}} --fallback-dot-license {{path/to/file}}`