Update $rsearch() args. Fix $lower() example. Add to .gitignore.

Author: rdswift

.gitignore

@@ -8,3 +8,4 @@
 __pycache__/
 /_locale/**/*.mo
 /_locale/gettext/.doctrees
+/**/.pytest_cache

_locale/ca/LC_MESSAGES/functions/func_rsearch.po

@@ -7,11 +7,11 @@ msgid ""
 msgstr ""
 "Project-Id-Version: MusicBrainz Picard v2.11.0rc1\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-01-11 23:26+0100\n"
+"POT-Creation-Date: 2025-08-04 18:11-0600\n"
 "PO-Revision-Date: 2025-07-02 17:20+0000\n"
 "Last-Translator: Marc Riera <[email protected]>\n"
-"Language-Team: Catalan <https://translations.metabrainz.org/projects/"
-"picard-docs/functionsfunc_rsearch/ca/>\n"
+"Language-Team: Catalan <https://translations.metabrainz.org/projects/picard-"
+"docs/functionsfunc_rsearch/ca/>\n"
 "Language: ca\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
@@ -24,7 +24,8 @@ msgid "$rsearch"
 msgstr "$rsearch"
 
 #: ../../functions/func_rsearch.rst:8
-msgid "Usage: **$rsearch(text,pattern)**"
+#, fuzzy
+msgid "Usage: **$rsearch(text,pattern[,group])**"
 msgstr "Ús: **$rsearch(text,patró)**"
 
 #: ../../functions/func_rsearch.rst:9
@@ -36,21 +37,57 @@ msgid "**Description:**"
 msgstr "**Descripció:**"
 
 #: ../../functions/func_rsearch.rst:13
-msgid "Regular expression search. This function will return the first matching group specified by ``pattern`` from ``text``.  For more information about regular expressions, please see the `article on Wikipedia <https://wikipedia.org/wiki/Regular_expression>`_."
+msgid ""
+"Regular expression search. This function will return the first matching "
+"group specified by ``pattern`` from ``text``.  For more information about "
+"regular expressions, please see the `article on Wikipedia <https://wikipedia."
+"org/wiki/Regular_expression>`_."
 msgstr ""
 
 #: ../../functions/func_rsearch.rst:17
-msgid "If a marked subexpression is defined using parentheses within the search pattern, only the pattern captured by the subexpression will be returned.  If more than one marked subexpression is defined and matched, only the pattern captured by the first subexpression will be returned. If more than one marked subexpression is defined and not all are matched, an empty string will be returned.  If no subexpression is specified, then the pattern captured by the whole search expression will be returned."
+msgid ""
+"If a marked subexpression is defined using parentheses within the search "
+"pattern, only the pattern captured by the subexpression will be returned.  "
+"If more than one marked subexpression is defined and matched, only the "
+"pattern captured by the first subexpression will be returned. If more than "
+"one marked subexpression is defined and not all are matched, an empty string "
+"will be returned.  If no subexpression is specified, then the pattern "
+"captured by the whole search expression will be returned."
+msgstr ""
+
+#: ../../functions/func_rsearch.rst:24
+msgid ""
+"If the optional ``group`` parameter is not provided or is empty, return the "
+"first capture group which matched something (including the empty string) or "
+"the entire match."
+msgstr ""
+
+#: ../../functions/func_rsearch.rst:28
+msgid ""
+"If ``group`` is an integer, return the capture group in the position "
+"matching this integer. Otherwise, return the capture group named ``group``, "
+"sans surrounding whitespace."
+msgstr ""
+
+#: ../../functions/func_rsearch.rst:33
+msgid ""
+"When entering regular expressions into Picard scripts you have to escape a "
+"backslash \"\\\\\", dollar sign \"$\", comma \",\" and the left and right "
+"parentheses \"(\" and \")\" in order to force Picard to not interpret them "
+"as part of the script command.  This is done by inserting a backslash before "
+"the character to be escaped.  For example, the regular expression "
+"``^\\s*([0-9,\\.]*)$`` would have to be entered as ``^\\\\s*\\([0-9\\,\\"
+"\\.]*\\)\\$``."
 msgstr ""
 
-#: ../../functions/func_rsearch.rst:26
-msgid "When entering regular expressions into Picard scripts you have to escape a backslash \"\\\\\", dollar sign \"$\", comma \",\" and the left and right parentheses \"(\" and \")\" in order to force Picard to not interpret them as part of the script command.  This is done by inserting a backslash before the character to be escaped.  For example, the regular expression ``^\\s*([0-9,\\.]*)$`` would have to be entered as ``^\\\\s*\\([0-9\\,\\\\.]*\\)\\$``."
+#: ../../functions/func_rsearch.rst:41
+msgid "The ``group`` argument was added in Picard v2.14."
 msgstr ""
 
-#: ../../functions/func_rsearch.rst:32
+#: ../../functions/func_rsearch.rst:43
 msgid "**Example:**"
 msgstr "**Exemple:**"
 
-#: ../../functions/func_rsearch.rst:34
+#: ../../functions/func_rsearch.rst:45
 msgid "The following statements will return the values indicated:"
 msgstr "Les instruccions següents retornaran els valors indicats:"

_locale/de/LC_MESSAGES/functions/func_rsearch.po

@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: MusicBrainz Picard v2.6.3\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-01-11 23:26+0100\n"
+"POT-Creation-Date: 2025-08-04 18:11-0600\n"
 "PO-Revision-Date: 2023-08-26 10:27+0000\n"
 "Last-Translator: Philipp Wolfer <[email protected]>\n"
 "Language-Team: German <https://translations.metabrainz.org/projects/picard-"
@@ -23,7 +23,7 @@ msgid "$rsearch"
 msgstr ""
 
 #: ../../functions/func_rsearch.rst:8
-msgid "Usage: **$rsearch(text,pattern)**"
+msgid "Usage: **$rsearch(text,pattern[,group])**"
 msgstr ""
 
 #: ../../functions/func_rsearch.rst:9
@@ -53,7 +53,21 @@ msgid ""
 "captured by the whole search expression will be returned."
 msgstr ""
 
-#: ../../functions/func_rsearch.rst:26
+#: ../../functions/func_rsearch.rst:24
+msgid ""
+"If the optional ``group`` parameter is not provided or is empty, return the "
+"first capture group which matched something (including the empty string) or "
+"the entire match."
+msgstr ""
+
+#: ../../functions/func_rsearch.rst:28
+msgid ""
+"If ``group`` is an integer, return the capture group in the position "
+"matching this integer. Otherwise, return the capture group named ``group``, "
+"sans surrounding whitespace."
+msgstr ""
+
+#: ../../functions/func_rsearch.rst:33
 msgid ""
 "When entering regular expressions into Picard scripts you have to escape a "
 "backslash \"\\\\\", dollar sign \"$\", comma \",\" and the left and right "
@@ -64,10 +78,14 @@ msgid ""
 "\\.]*\\)\\$``."
 msgstr ""
 
-#: ../../functions/func_rsearch.rst:32
+#: ../../functions/func_rsearch.rst:41
+msgid "The ``group`` argument was added in Picard v2.14."
+msgstr ""
+
+#: ../../functions/func_rsearch.rst:43
 msgid "**Example:**"
 msgstr "**Beispiel:**"
 
-#: ../../functions/func_rsearch.rst:34
+#: ../../functions/func_rsearch.rst:45
 msgid "The following statements will return the values indicated:"
 msgstr "Die folgenden Ausdrücke geben den angegebenen Wert zurück:"

_locale/fr/LC_MESSAGES/functions/func_rsearch.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: MusicBrainz Picard v2.3.2\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-01-11 23:26+0100\n"
+"POT-Creation-Date: 2025-08-04 18:11-0600\n"
 "PO-Revision-Date: 2021-10-06 18:03+0000\n"
 "Last-Translator: Bob Swift <[email protected]>\n"
 "Language-Team: French <https://translate.uploadedlobster.com/projects/picard-"
@@ -26,7 +26,8 @@ msgid "$rsearch"
 msgstr "$rsearch"
 
 #: ../../functions/func_rsearch.rst:8
-msgid "Usage: **$rsearch(text,pattern)**"
+#, fuzzy
+msgid "Usage: **$rsearch(text,pattern[,group])**"
 msgstr "Utilisation: **$rsearch(texte,motif)**"
 
 #: ../../functions/func_rsearch.rst:9
@@ -68,7 +69,21 @@ msgstr ""
 "n'est spécifiée, le modèle capturé par l'expression de recherche entière "
 "sera retourné."
 
-#: ../../functions/func_rsearch.rst:26
+#: ../../functions/func_rsearch.rst:24
+msgid ""
+"If the optional ``group`` parameter is not provided or is empty, return the "
+"first capture group which matched something (including the empty string) or "
+"the entire match."
+msgstr ""
+
+#: ../../functions/func_rsearch.rst:28
+msgid ""
+"If ``group`` is an integer, return the capture group in the position "
+"matching this integer. Otherwise, return the capture group named ``group``, "
+"sans surrounding whitespace."
+msgstr ""
+
+#: ../../functions/func_rsearch.rst:33
 msgid ""
 "When entering regular expressions into Picard scripts you have to escape a "
 "backslash \"\\\\\", dollar sign \"$\", comma \",\" and the left and right "
@@ -87,11 +102,15 @@ msgstr ""
 "``^\\s*([0-9,\\.]*)$`` doit être saisie comme ``^\\\\s*\\([0-9\\,\\\\.]*\\)\\"
 "$``."
 
-#: ../../functions/func_rsearch.rst:32
+#: ../../functions/func_rsearch.rst:41
+msgid "The ``group`` argument was added in Picard v2.14."
+msgstr ""
+
+#: ../../functions/func_rsearch.rst:43
 msgid "**Example:**"
 msgstr "**Exemple:**"
 
-#: ../../functions/func_rsearch.rst:34
+#: ../../functions/func_rsearch.rst:45
 msgid "The following statements will return the values indicated:"
 msgstr "Les instructions suivantes renverront les valeurs indiquées :"
 

_locale/gettext/functions/func_rsearch.pot

@@ -6,9 +6,9 @@
 #, fuzzy
 msgid ""
 msgstr ""
-"Project-Id-Version: MusicBrainz Picard v2.11.0rc1\n"
+"Project-Id-Version: MusicBrainz Picard v2.13.3\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-01-11 23:26+0100\n"
+"POT-Creation-Date: 2025-08-04 18:11-0600\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <[email protected]>\n"
@@ -21,7 +21,7 @@ msgid "$rsearch"
 msgstr ""
 
 #: ../../functions/func_rsearch.rst:8
-msgid "Usage: **$rsearch(text,pattern)**"
+msgid "Usage: **$rsearch(text,pattern[,group])**"
 msgstr ""
 
 #: ../../functions/func_rsearch.rst:9
@@ -40,14 +40,26 @@ msgstr ""
 msgid "If a marked subexpression is defined using parentheses within the search pattern, only the pattern captured by the subexpression will be returned.  If more than one marked subexpression is defined and matched, only the pattern captured by the first subexpression will be returned. If more than one marked subexpression is defined and not all are matched, an empty string will be returned.  If no subexpression is specified, then the pattern captured by the whole search expression will be returned."
 msgstr ""
 
-#: ../../functions/func_rsearch.rst:26
+#: ../../functions/func_rsearch.rst:24
+msgid "If the optional ``group`` parameter is not provided or is empty, return the first capture group which matched something (including the empty string) or the entire match."
+msgstr ""
+
+#: ../../functions/func_rsearch.rst:28
+msgid "If ``group`` is an integer, return the capture group in the position matching this integer. Otherwise, return the capture group named ``group``, sans surrounding whitespace."
+msgstr ""
+
+#: ../../functions/func_rsearch.rst:33
 msgid "When entering regular expressions into Picard scripts you have to escape a backslash \"\\\\\", dollar sign \"$\", comma \",\" and the left and right parentheses \"(\" and \")\" in order to force Picard to not interpret them as part of the script command.  This is done by inserting a backslash before the character to be escaped.  For example, the regular expression ``^\\s*([0-9,\\.]*)$`` would have to be entered as ``^\\\\s*\\([0-9\\,\\\\.]*\\)\\$``."
 msgstr ""
 
-#: ../../functions/func_rsearch.rst:32
+#: ../../functions/func_rsearch.rst:41
+msgid "The ``group`` argument was added in Picard v2.14."
+msgstr ""
+
+#: ../../functions/func_rsearch.rst:43
 msgid "**Example:**"
 msgstr ""
 
-#: ../../functions/func_rsearch.rst:34
+#: ../../functions/func_rsearch.rst:45
 msgid "The following statements will return the values indicated:"
 msgstr ""

_locale/lt/LC_MESSAGES/functions/func_rsearch.po

@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: MusicBrainz Picard v2.11.0rc1\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-01-11 23:26+0100\n"
+"POT-Creation-Date: 2025-08-04 18:11-0600\n"
 "PO-Revision-Date: 2025-04-04 21:55+0000\n"
 "Last-Translator: Vaclovas Intas <[email protected]>\n"
 "Language-Team: Lithuanian <https://translations.metabrainz.org/projects/"
@@ -26,7 +26,7 @@ msgid "$rsearch"
 msgstr ""
 
 #: ../../functions/func_rsearch.rst:8
-msgid "Usage: **$rsearch(text,pattern)**"
+msgid "Usage: **$rsearch(text,pattern[,group])**"
 msgstr ""
 
 #: ../../functions/func_rsearch.rst:9
@@ -38,21 +38,57 @@ msgid "**Description:**"
 msgstr "**Aprašas:**"
 
 #: ../../functions/func_rsearch.rst:13
-msgid "Regular expression search. This function will return the first matching group specified by ``pattern`` from ``text``.  For more information about regular expressions, please see the `article on Wikipedia <https://wikipedia.org/wiki/Regular_expression>`_."
+msgid ""
+"Regular expression search. This function will return the first matching "
+"group specified by ``pattern`` from ``text``.  For more information about "
+"regular expressions, please see the `article on Wikipedia <https://wikipedia."
+"org/wiki/Regular_expression>`_."
 msgstr ""
 
 #: ../../functions/func_rsearch.rst:17
-msgid "If a marked subexpression is defined using parentheses within the search pattern, only the pattern captured by the subexpression will be returned.  If more than one marked subexpression is defined and matched, only the pattern captured by the first subexpression will be returned. If more than one marked subexpression is defined and not all are matched, an empty string will be returned.  If no subexpression is specified, then the pattern captured by the whole search expression will be returned."
+msgid ""
+"If a marked subexpression is defined using parentheses within the search "
+"pattern, only the pattern captured by the subexpression will be returned.  "
+"If more than one marked subexpression is defined and matched, only the "
+"pattern captured by the first subexpression will be returned. If more than "
+"one marked subexpression is defined and not all are matched, an empty string "
+"will be returned.  If no subexpression is specified, then the pattern "
+"captured by the whole search expression will be returned."
+msgstr ""
+
+#: ../../functions/func_rsearch.rst:24
+msgid ""
+"If the optional ``group`` parameter is not provided or is empty, return the "
+"first capture group which matched something (including the empty string) or "
+"the entire match."
+msgstr ""
+
+#: ../../functions/func_rsearch.rst:28
+msgid ""
+"If ``group`` is an integer, return the capture group in the position "
+"matching this integer. Otherwise, return the capture group named ``group``, "
+"sans surrounding whitespace."
+msgstr ""
+
+#: ../../functions/func_rsearch.rst:33
+msgid ""
+"When entering regular expressions into Picard scripts you have to escape a "
+"backslash \"\\\\\", dollar sign \"$\", comma \",\" and the left and right "
+"parentheses \"(\" and \")\" in order to force Picard to not interpret them "
+"as part of the script command.  This is done by inserting a backslash before "
+"the character to be escaped.  For example, the regular expression "
+"``^\\s*([0-9,\\.]*)$`` would have to be entered as ``^\\\\s*\\([0-9\\,\\"
+"\\.]*\\)\\$``."
 msgstr ""
 
-#: ../../functions/func_rsearch.rst:26
-msgid "When entering regular expressions into Picard scripts you have to escape a backslash \"\\\\\", dollar sign \"$\", comma \",\" and the left and right parentheses \"(\" and \")\" in order to force Picard to not interpret them as part of the script command.  This is done by inserting a backslash before the character to be escaped.  For example, the regular expression ``^\\s*([0-9,\\.]*)$`` would have to be entered as ``^\\\\s*\\([0-9\\,\\\\.]*\\)\\$``."
+#: ../../functions/func_rsearch.rst:41
+msgid "The ``group`` argument was added in Picard v2.14."
 msgstr ""
 
-#: ../../functions/func_rsearch.rst:32
+#: ../../functions/func_rsearch.rst:43
 msgid "**Example:**"
 msgstr "**Pavyzdys:**"
 
-#: ../../functions/func_rsearch.rst:34
+#: ../../functions/func_rsearch.rst:45
 msgid "The following statements will return the values indicated:"
 msgstr "Toliau pateikti teiginiai grąžins nurodytas reikšmes:"