api: add random integer number in evaluation of expressions with "random:min,max"

1 files changed, 142 insertions, 5 deletions

diff --git a/po/pl.po b/po/pl.po
index 1393e630c..4f1db9f21 100644
--- a/po/pl.po
+++ b/po/pl.po
@@ -22,7 +22,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: WeeChat\n"
 "Report-Msgid-Bugs-To: flashcode@flashtux.org\n"
-"POT-Creation-Date: 2021-08-01 10:24+0200\n"
+"POT-Creation-Date: 2021-08-03 19:41+0200\n"
 "PO-Revision-Date: 2021-07-10 16:01+0200\n"
 "Last-Translator: Krzysztof Korościk <soltys@soltys.info>\n"
 "Language-Team: Polish <kde-i18n-doc@kde.org>\n"
@@ -1653,6 +1653,141 @@ msgstr ""
 "[-n|-s] [-d] <wyrażenie> || [-n] [-d [-d]] -c <wyrażenie1> <operator> "
 "<wyrażenie2>"
 
+#, fuzzy
+#| msgid ""
+#| "        -n: display result without sending it to buffer (debug mode)\n"
+#| "        -s: split expression before evaluating it (many commands can be "
+#| "separated by semicolons)\n"
+#| "        -d: display debug output after evaluation (with two -d: more "
+#| "verbose debug)\n"
+#| "        -c: evaluate as condition: use operators and parentheses, return "
+#| "a boolean value (\"0\" or \"1\")\n"
+#| "expression: expression to evaluate, variables with format ${variable} are "
+#| "replaced (see below); many commands can be separated by semicolons\n"
+#| "  operator: a logical or comparison operator:\n"
+#| "            - logical operators:\n"
+#| "                &&   boolean \"and\"\n"
+#| "                ||   boolean \"or\"\n"
+#| "            - comparison operators:\n"
+#| "                ==   equal\n"
+#| "                !=   not equal\n"
+#| "                <=   less or equal\n"
+#| "                <    less\n"
+#| "                >=   greater or equal\n"
+#| "                >    greater\n"
+#| "                =~   is matching POSIX extended regex\n"
+#| "                !~   is NOT matching POSIX extended regex\n"
+#| "                ==*  is matching mask, case sensitive (wildcard \"*\" is "
+#| "allowed)\n"
+#| "                !!*  is NOT matching mask, case sensitive (wildcard \"*\" "
+#| "is allowed)\n"
+#| "                =*   is matching mask, case insensitive (wildcard \"*\" "
+#| "is allowed)\n"
+#| "                !*   is NOT matching mask, case insensitive (wildcard \"*"
+#| "\" is allowed)\n"
+#| "                ==-  is included, case sensitive\n"
+#| "                !!-  is NOT included, case sensitive\n"
+#| "                =-   is included, case insensitive\n"
+#| "                !-   is NOT included, case insensitive\n"
+#| "\n"
+#| "An expression is considered as \"true\" if it is not NULL, not empty, and "
+#| "different from \"0\".\n"
+#| "The comparison is made using floating point numbers if the two "
+#| "expressions are valid numbers, with one of the following formats:\n"
+#| "  - integer (examples: 5, -7)\n"
+#| "  - floating point number (examples: 5.2, -7.5, 2.83e-2)\n"
+#| "  - hexadecimal number (examples: 0xA3, -0xA3)\n"
+#| "To force a string comparison, you can add double quotes around each "
+#| "expression, for example:\n"
+#| "  50 > 100      ==> 0\n"
+#| "  \"50\" > \"100\"  ==> 1\n"
+#| "\n"
+#| "Some variables are replaced in expression, using the format ${variable}, "
+#| "variable can be, by order of priority:\n"
+#| "  1. the string itself without evaluation (format: \"raw:xxx\")\n"
+#| "  2. an evaluated sub-string (format: \"eval:xxx\")\n"
+#| "  3. an evaluated condition (format: \"eval_cond:xxx\")\n"
+#| "  4. a string with escaped chars (format: \"esc:xxx\" or \"\\xxx\")\n"
+#| "  5. a string with chars to hide (format: \"hide:char,string\")\n"
+#| "  6. a string with max chars (format: \"cut:max,suffix,string\" or \"cut:"
+#| "+max,suffix,string\")\n"
+#| "     or max chars displayed on screen (format: \"cutscr:max,suffix,string"
+#| "\" or \"cutscr:+max,suffix,string\")\n"
+#| "  7. a reversed string (format: \"rev:xxx\" or \"revscr:xxx\")\n"
+#| "  8. a repeated string (format: \"repeat:count,string\")\n"
+#| "  9. length of a string (format: \"length:xxx\" or \"lengthscr:xxx\")\n"
+#| "  10. a color (format: \"color:xxx\", see \"Plugin API reference\", "
+#| "function \"color\")\n"
+#| "  11. a modifier (format: \"modifier:name,data,string\")\n"
+#| "  12. an info (format: \"info:name,arguments\", arguments are optional)\n"
+#| "  13. a base 16/32/64 encoded/decoded string (format: \"base_encode:base,"
+#| "xxx\" or \"base_decode:base,xxx\")\n"
+#| "  14. current date/time (format: \"date\" or \"date:format\")\n"
+#| "  15. an environment variable (format: \"env:XXX\")\n"
+#| "  16. a ternary operator (format: \"if:condition?value_if_true:"
+#| "value_if_false\")\n"
+#| "  17. result of an expression with parentheses and operators + - * / // % "
+#| "** (format: \"calc:xxx\")\n"
+#| "  18. a translated string (format: \"translate:xxx\")\n"
+#| "  19. an option (format: \"file.section.option\")\n"
+#| "  20. a local variable in buffer\n"
+#| "  21. a hdata name/variable (the value is automatically converted to "
+#| "string), by default \"window\" and \"buffer\" point to current window/"
+#| "buffer.\n"
+#| "Format for hdata can be one of following:\n"
+#| "  hdata.var1.var2...: start with a hdata (pointer must be known), and ask "
+#| "variables one after one (other hdata can be followed)\n"
+#| "  hdata[list].var1.var2...: start with a hdata using a list/pointer/"
+#| "pointer name, for example:\n"
+#| "    ${buffer[gui_buffers].full_name}: full name of first buffer in linked "
+#| "list of buffers\n"
+#| "    ${plugin[weechat_plugins].name}: name of first plugin in linked list "
+#| "of plugins\n"
+#| "  hdata[pointer].var1.var2...: start with a hdata using a pointer, for "
+#| "example:\n"
+#| "    ${buffer[0x1234abcd].full_name}: full name of the buffer with this "
+#| "pointer (can be used in triggers)\n"
+#| "    ${buffer[my_pointer].full_name}: full name of the buffer with this "
+#| "pointer name (can be used in triggers)\n"
+#| "For name of hdata and variables, please look at \"Plugin API reference\", "
+#| "function \"weechat_hdata_get\".\n"
+#| "\n"
+#| "Examples (simple strings):\n"
+#| "  /eval -n ${raw:${info:version}}                ==> ${info:version}\n"
+#| "  /eval -n ${eval_cond:${window.win_width}>100}  ==> 1\n"
+#| "  /eval -n ${info:version}                       ==> 0.4.3\n"
+#| "  /eval -n ${env:HOME}                           ==> /home/user\n"
+#| "  /eval -n ${weechat.look.scroll_amount}         ==> 3\n"
+#| "  /eval -n ${sec.data.password}                  ==> secret\n"
+#| "  /eval -n ${window}                             ==> 0x2549aa0\n"
+#| "  /eval -n ${window.buffer}                      ==> 0x2549320\n"
+#| "  /eval -n ${window.buffer.full_name}            ==> core.weechat\n"
+#| "  /eval -n ${window.buffer.number}               ==> 1\n"
+#| "  /eval -n ${\\t}                                 ==> <tab>\n"
+#| "  /eval -n ${hide:-,${relay.network.password}}   ==> --------\n"
+#| "  /eval -n ${cut:3,+,test}                       ==> tes+\n"
+#| "  /eval -n ${cut:+3,+,test}                      ==> te+\n"
+#| "  /eval -n ${date:%H:%M:%S}                      ==> 07:46:40\n"
+#| "  /eval -n ${if:${info:term_width}>80?big:small} ==> big\n"
+#| "  /eval -n ${rev:Hello}                          ==> olleH\n"
+#| "  /eval -n ${repeat:5,-}                         ==> -----\n"
+#| "  /eval -n ${length:test}                        ==> 4\n"
+#| "  /eval -n ${calc:(5+2)*3}                       ==> 21\n"
+#| "  /eval -n ${base_encode:64,test}                ==> dGVzdA==\n"
+#| "  /eval -n ${base_decode:64,dGVzdA==}            ==> test\n"
+#| "  /eval -n ${translate:Plugin}                   ==> Extension\n"
+#| "\n"
+#| "Examples (conditions):\n"
+#| "  /eval -n -c ${window.buffer.number} > 2 ==> 0\n"
+#| "  /eval -n -c ${window.win_width} > 100   ==> 1\n"
+#| "  /eval -n -c (8 > 12) || (5 > 2)         ==> 1\n"
+#| "  /eval -n -c (8 > 12) && (5 > 2)         ==> 0\n"
+#| "  /eval -n -c abcd =~ ^ABC                ==> 1\n"
+#| "  /eval -n -c abcd =~ (?-i)^ABC           ==> 0\n"
+#| "  /eval -n -c abcd =~ (?-i)^abc           ==> 1\n"
+#| "  /eval -n -c abcd !~ abc                 ==> 0\n"
+#| "  /eval -n -c abcd =* a*d                 ==> 1\n"
+#| "  /eval -n -c abcd =- bc                  ==> 1"
 msgid ""
 "        -n: display result without sending it to buffer (debug mode)\n"
 "        -s: split expression before evaluating it (many commands can be "
@@ -1727,10 +1862,11 @@ msgid ""
 "\")\n"
 "  17. result of an expression with parentheses and operators + - * / // % ** "
 "(format: \"calc:xxx\")\n"
-"  18. a translated string (format: \"translate:xxx\")\n"
-"  19. an option (format: \"file.section.option\")\n"
-"  20. a local variable in buffer\n"
-"  21. a hdata name/variable (the value is automatically converted to "
+"  18. a random integer number (format: \"random:min,max\")\n"
+"  19. a translated string (format: \"translate:xxx\")\n"
+"  20. an option (format: \"file.section.option\")\n"
+"  21. a local variable in buffer\n"
+"  22. a hdata name/variable (the value is automatically converted to "
 "string), by default \"window\" and \"buffer\" point to current window/"
 "buffer.\n"
 "Format for hdata can be one of following:\n"
@@ -1772,6 +1908,7 @@ msgid ""
 "  /eval -n ${repeat:5,-}                         ==> -----\n"
 "  /eval -n ${length:test}                        ==> 4\n"
 "  /eval -n ${calc:(5+2)*3}                       ==> 21\n"
+"  /eval -n ${random:0,10}                        ==> 3\n"
 "  /eval -n ${base_encode:64,test}                ==> dGVzdA==\n"
 "  /eval -n ${base_decode:64,dGVzdA==}            ==> test\n"
 "  /eval -n ${translate:Plugin}                   ==> Extension\n"