Update cheatsheets

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]}}`

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}}`
 

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\}\}}}"`

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}}`

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}}`

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: <https://python-poetry.org/docs/cli/#add>.
+
+- 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}}`

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: <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}}`

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: <https://python-poetry.org/docs/cli/#list>.
+
+- List all available Poetry commands:
+
+`poetry list`
+
+- List commands for a specific namespace:
+
+`poetry list {{namespace}}`

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: <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`

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: <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,...}}`

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}}`