From 68bff76d900f57bcbcf67d7e5a8a46e997aa75c3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Mike=20F=C3=A4hrmann?= <mike_faehrmann@web.de>
Date: Thu, 19 Sep 2024 13:50:52 +0200
Subject: [PATCH] [formatter] implement 'L' conversion

---
 docs/formatting.md      | 10 ++++++++--
 gallery_dl/formatter.py |  1 +
 test/test_formatter.py  |  3 +++
 3 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/docs/formatting.md b/docs/formatting.md
index 1e695bf2..97801653 100644
--- a/docs/formatting.md
+++ b/docs/formatting.md
@@ -76,6 +76,12 @@ Conversion specifiers allow to *convert* the value to a different form or type.
     <td><code>{tags!j}</code></td>
     <td><code>["sun", "tree", "water"]</code></td>
 </tr>
+<tr>
+    <td align="center"><code>L</code></td>
+    <td>Return the <a href="https://docs.python.org/3/library/functions.html#len" rel="nofollow">length</a> of a value</td>
+    <td><code>{foo!L}</code></td>
+    <td><code>7</code></td>
+</tr>
 <tr>
     <td align="center"><code>t</code></td>
     <td>Trim a string, i.e. remove leading and trailing whitespace characters</td>
@@ -84,13 +90,13 @@ Conversion specifiers allow to *convert* the value to a different form or type.
 </tr>
 <tr>
     <td align="center"><code>T</code></td>
-    <td>Convert a <code>datetime</code> object to a unix timestamp</td>
+    <td>Convert a <code>datetime</code> object to a Unix timestamp</td>
     <td><code>{date!T}</code></td>
     <td><code>1262304000</code></td>
 </tr>
 <tr>
     <td align="center"><code>d</code></td>
-    <td>Convert a unix timestamp to a <code>datetime</code> object</td>
+    <td>Convert a Unix timestamp to a <code>datetime</code> object</td>
     <td><code>{created!d}</code></td>
     <td><code>2010-01-01 00:00:00</code></td>
 </tr>
diff --git a/gallery_dl/formatter.py b/gallery_dl/formatter.py
index b50bd643..e662c34e 100644
--- a/gallery_dl/formatter.py
+++ b/gallery_dl/formatter.py
@@ -485,6 +485,7 @@ _CONVERSIONS = {
     "C": string.capwords,
     "j": util.json_dumps,
     "t": str.strip,
+    "L": len,
     "T": util.datetime_to_timestamp_string,
     "d": text.parse_timestamp,
     "U": text.unescape,
diff --git a/test/test_formatter.py b/test/test_formatter.py
index 38c22ab9..f1d752da 100644
--- a/test/test_formatter.py
+++ b/test/test_formatter.py
@@ -67,6 +67,9 @@ class TestFormatter(unittest.TestCase):
         self._run_test("{l!j}", '["a", "b", "c"]')
         self._run_test("{dt!j}", '"2010-01-01 00:00:00"')
         self._run_test("{a!g}", "hello-world")
+        self._run_test("{a!L}", 11)
+        self._run_test("{l!L}", 3)
+        self._run_test("{d!L}", 3)
 
         with self.assertRaises(KeyError):
             self._run_test("{a!q}", "hello world")