From 345624bc38c5015c42b67978c755008ad840e1ec Mon Sep 17 00:00:00 2001
From: Robin Matz <robin.s.matz@gmail.com>
Date: Sun, 17 Dec 2023 07:47:10 +0100
Subject: [PATCH 1/2] Release version 4.1

---
 .github/workflows/generate-changelog.yml      |   2 +-
 Mainframe3270/version.py                      |   2 +-
 dist/robotframework-mainframe3270-4.1.tar.gz  | Bin 0 -> 22445 bytes
 doc/Mainframe3270.html                        |   4 +-
 doc/Mainframe3270.xml                         | 218 ++++++++++++++++--
 .../PKG-INFO                                  |   6 +-
 6 files changed, 211 insertions(+), 21 deletions(-)
 create mode 100644 dist/robotframework-mainframe3270-4.1.tar.gz

diff --git a/.github/workflows/generate-changelog.yml b/.github/workflows/generate-changelog.yml
index 5530f8a..6a3217c 100644
--- a/.github/workflows/generate-changelog.yml
+++ b/.github/workflows/generate-changelog.yml
@@ -12,6 +12,6 @@ jobs:
       - uses: actions/checkout@v2
 
       - name: Run Changelog CI
-        uses: saadmk11/changelog-ci@v1.1.1
+        uses: saadmk11/changelog-ci@v1.1.2
         with:
           config_file: changelog-ci-config.yaml
diff --git a/Mainframe3270/version.py b/Mainframe3270/version.py
index aaff102..fe8be31 100644
--- a/Mainframe3270/version.py
+++ b/Mainframe3270/version.py
@@ -1 +1 @@
-VERSION = "4.0"
+VERSION = "4.1"
diff --git a/dist/robotframework-mainframe3270-4.1.tar.gz b/dist/robotframework-mainframe3270-4.1.tar.gz
new file mode 100644
index 0000000000000000000000000000000000000000..47888857c09b4b2221213fb9bc523af292dcd6a5
GIT binary patch
literal 22445
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

literal 0
HcmV?d00001

diff --git a/doc/Mainframe3270.html b/doc/Mainframe3270.html
index 8968118..3049f78 100644
--- a/doc/Mainframe3270.html
+++ b/doc/Mainframe3270.html
@@ -6,7 +6,7 @@
 <meta http-equiv="Pragma" content="no-cache">
 <meta http-equiv="Expires" content="-1">
 <meta http-equiv="X-UA-Compatible" content="IE=edge">
-<meta content="Robot Framework 6.1 (Python 3.10.9 on win32)" name="Generator">
+<meta content="Robot Framework 6.1.1 (Python 3.10.12 on win32)" name="Generator">
 <link rel="icon" type="image/x-icon" href="data:image/x-icon;base64,AAABAAEAEBAAAAEAIABoBAAAFgAAACgAAAAQAAAAIAAAAAEAIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKcAAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAAqAAAAAAAAAAAAAAAAAAAALIAAAD/AAAA4AAAANwAAADcAAAA3AAAANwAAADcAAAA3AAAANwAAADcAAAA4AAAAP8AAACxAAAAAAAAAKYAAAD/AAAAuwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAC/AAAA/wAAAKkAAAD6AAAAzAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAN8AAAD/AAAA+gAAAMMAAAAAAAAAAgAAAGsAAABrAAAAawAAAGsAAABrAAAAawAAAGsAAABrAAAADAAAAAAAAADaAAAA/wAAAPoAAADDAAAAAAAAAIsAAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAANEAAAAAAAAA2gAAAP8AAAD6AAAAwwAAAAAAAAAAAAAAMgAAADIAAAAyAAAAMgAAADIAAAAyAAAAMgAAADIAAAAFAAAAAAAAANoAAAD/AAAA+gAAAMMAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADaAAAA/wAAAPoAAADDAAAAAAAAADwAAAB8AAAAAAAAAGAAAABcAAAAAAAAAH8AAABKAAAAAAAAAAAAAAAAAAAA2gAAAP8AAAD6AAAAwwAAAAAAAADCAAAA/wAAACkAAADqAAAA4QAAAAAAAAD7AAAA/wAAALAAAAAGAAAAAAAAANoAAAD/AAAA+gAAAMMAAAAAAAAAIwAAAP4AAAD/AAAA/wAAAGAAAAAAAAAAAAAAAMkAAAD/AAAAigAAAAAAAADaAAAA/wAAAPoAAADDAAAAAAAAAAAAAAAIAAAAcAAAABkAAAAAAAAAAAAAAAAAAAAAAAAAEgAAAAAAAAAAAAAA2gAAAP8AAAD7AAAAywAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAN4AAAD/AAAAqwAAAP8AAACvAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAALIAAAD/AAAAsgAAAAAAAAC5AAAA/wAAAMoAAADAAAAAwAAAAMAAAADAAAAAwAAAAMAAAADAAAAAwAAAAMkAAAD/AAAAvAAAAAAAAAAAAAAAAAAAAKwAAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAA/wAAAP8AAAD/AAAArQAAAAAAAAAAwAMAAIABAAAf+AAAP/wAAD/8AAAgBAAAP/wAAD/8AAA//AAAJIwAADHEAAA//AAAP/wAAB/4AACAAQAAwAMAAA==">
 <style media="all" type="text/css">
 :root {
@@ -1180,7 +1180,7 @@
 jQuery.extend({highlight:function(e,t,n,r){if(e.nodeType===3){var i=e.data.match(t);if(i){var s=document.createElement(n||"span");s.className=r||"highlight";var o=e.splitText(i.index);o.splitText(i[0].length);var u=o.cloneNode(true);s.appendChild(u);o.parentNode.replaceChild(s,o);return 1}}else if(e.nodeType===1&&e.childNodes&&!/(script|style)/i.test(e.tagName)&&!(e.tagName===n.toUpperCase()&&e.className===r)){for(var a=0;a<e.childNodes.length;a++){a+=jQuery.highlight(e.childNodes[a],t,n,r)}}return 0}});jQuery.fn.unhighlight=function(e){var t={className:"highlight",element:"span"};jQuery.extend(t,e);return this.find(t.element+"."+t.className).each(function(){var e=this.parentNode;e.replaceChild(this.firstChild,this);e.normalize()}).end()};jQuery.fn.highlight=function(e,t){var n={className:"highlight",element:"span",caseSensitive:false,wordsOnly:false};jQuery.extend(n,t);if(e.constructor===String){e=[e]}e=jQuery.grep(e,function(e,t){return e!=""});e=jQuery.map(e,function(e,t){return e.replace(/[-[\]{}()*+?.,\\^$|#\s]/g,"\\$&")});if(e.length==0){return this}var r=n.caseSensitive?"":"i";var i="("+e.join("|")+")";if(n.wordsOnly){i="\\b"+i+"\\b"}var s=new RegExp(i,r);return this.each(function(){jQuery.highlight(this,s,n.element,n.className)})}
 </script>
 <script type="text/javascript">
-libdoc = {"specversion": 2, "name": "Mainframe3270", "doc": "<p>Mainframe3270 is a library for Robot Framework based on the <a href=\"https://pypi.org/project/py3270/\">py3270 project</a>, a Python interface to x3270, an IBM 3270 terminal emulator. It provides an API to a x3270 or s3270 subprocess.</p>\n<h2 id=\"Installation\">Installation</h2>\n<p>To use this library, you must have the <a href=\"http://x3270.bgp.nu/download.html\">x3270 project</a> installed and included in your PATH. On Windows, you can install wc3270 and add \"C:\\Program Files\\wc3270\" to your PATH in the Environment Variables.</p>\n<h2 id=\"Example\">Example</h2>\n<pre>\n<b>*</b> Settings <b>*</b>\nLibrary           Mainframe3270\n\n<b>*</b> Test Cases <b>*</b>\nExample\n    Open Connection    Hostname    LUname\n    Change Wait Time    0.4 seconds\n    Change Wait Time After Write    0.4 seconds\n    Set Screenshot Folder    C:\\\\Temp\\\\IMG\n    ${value}    Read    3    10    17\n    Page Should Contain String    ENTER APPLICATION\n    Wait Field Detected\n    Write Bare    applicationname\n    Send Enter\n    Take Screenshot\n    Close Connection\n</pre>\n<h2 id=\"Concurrent Connections\">Concurrent Connections</h2>\n<p>The library allows you to have multiple sessions open at the same time. Each session opened by <a href=\"#Open%20Connection\" class=\"name\">Open Connection</a> or <a href=\"#Open%20Connection%20From%20Session%20File\" class=\"name\">Open Connection From Session File</a> will return an index that can be used to reference it when switching between connections using the <a href=\"#Switch%20Connection\" class=\"name\">Switch Connection</a> keyword. The indices start from 1 and are incremented by each newly opened connection. Calling <span class=\"name\">Close All Connection</span> will reset the index counter to 1.</p>\n<p>Additionally, you can provide aliases to your sessions when opening a connection, and switch the connection using that alias instead of the index.</p>\n<p>It is worth noting that the connection that was opened last is always the current connection.</p>\n<pre>\n<b>*</b> Test Cases <b>*</b>\nConcurrent Sessions\n    ${index_1}    Open Connection    Hostname    # this is the current connection\n    Write Bare    First String\n    ${index_2}    Open Connection    Hostname    alias=second    # 'second' is now the current connection\n    Write Bare    Second String\n    Switch Connection    ${index_1}    # swtiching the connection using the index\n    Page Should Contain String    First String\n    Switch Connection    second    # switchting the ocnnection using the alias\n    Page Should Contain String    Second String\n    [Teardown]    Close All Connections\n</pre>\n<h2 id=\"Changing the emulator model (experimental)\">Changing the emulator model (experimental)</h2>\n<p>By default, the library uses the emulator model 2, which is 24 rows by 80 columns. You can, however, change the model globally when <a href=\"#Importing\" class=\"name\">importing</a> the library with the <span class=\"name\">model</span> argument set to the model of your choice.</p>\n<p>The basic models are 2, 3, 4, and 5. These models differ in their screen size as illustrated in this table:</p>\n<table border=\"1\">\n<tr>\n<td><b>3270 Model</b></td>\n<td><b>Rows</b></td>\n<td><b>Columns</b></td>\n</tr>\n<tr>\n<td>2</td>\n<td>24</td>\n<td>80</td>\n</tr>\n<tr>\n<td>3</td>\n<td>32</td>\n<td>80</td>\n</tr>\n<tr>\n<td>4</td>\n<td>43</td>\n<td>80</td>\n</tr>\n<tr>\n<td>5</td>\n<td>27</td>\n<td>132</td>\n</tr>\n</table>\n<p>They can be combined with the 3278 (monochrome green-screen) or 3279 (color) prefix, e.g. 3278-2 or 3279-2.</p>\n<p>In addition to that, there is a -E suffix that indicates support for the <a href=\"https://x3270.miraheze.org/wiki/3270_data_stream_protocol#extended\">x3270 extended data stream</a>.</p>\n<p>You can find more information on emulator models on the <a href=\"https://x3270.miraheze.org/wiki/3270_models\">x3270 wiki</a>.</p>\n<p>In addition to setting the model globally, you can also set the model on the individual emulator basis by providing the model arguments to the <a href=\"#Open%20Connection\" class=\"name\">Open Connection</a> or <a href=\"#Open%20Connection%20From%20Session%20File\" class=\"name\">Open Connection From Session File</a> keywords.</p>\n<p>Here is an example for setting the emulator in the Open Connection keyword:</p>\n<pre>\nOpen Connection    pub400.com    extra_args=[\"-xrm\", \"*model: 4\"]\n</pre>\n<p>And this is how you would set the emulator model in the Open Connection From Session File keyword:</p>\n<pre>\nOpen Connection From Session File    /path/to/session/file\n</pre>\n<p>Where the content of the session file would be</p>\n<pre>\n*hostname: pub400.com\n*model: 4\n</pre>\n<p>Note that this is an experimental feature, so not all models might work as expected.</p>", "version": "4.0", "generated": "2023-06-15T16:57:59+00:00", "type": "LIBRARY", "scope": "SUITE", "docFormat": "HTML", "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\__init__.py", "lineno": 24, "tags": [], "inits": [{"name": "__init__", "args": [{"name": "visible", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "True", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "visible: bool = True"}, {"name": "timeout", "type": {"name": "timedelta", "typedoc": "timedelta", "nested": [], "union": false}, "types": ["timedelta"], "typedocs": {"timedelta": "timedelta"}, "defaultValue": "0:00:30", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = 0:00:30"}, {"name": "wait_time", "type": {"name": "timedelta", "typedoc": "timedelta", "nested": [], "union": false}, "types": ["timedelta"], "typedocs": {"timedelta": "timedelta"}, "defaultValue": "0:00:00.500000", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "wait_time: timedelta = 0:00:00.500000"}, {"name": "wait_time_after_write", "type": {"name": "timedelta", "typedoc": "timedelta", "nested": [], "union": false}, "types": ["timedelta"], "typedocs": {"timedelta": "timedelta"}, "defaultValue": "0:00:00", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "wait_time_after_write: timedelta = 0:00:00"}, {"name": "img_folder", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": ".", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "img_folder: str = ."}, {"name": "run_on_failure_keyword", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": "Take Screenshot", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "run_on_failure_keyword: str = Take Screenshot"}, {"name": "model", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": "2", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "model: str = 2"}], "doc": "<p>By default the emulator visibility is set to visible=True. In this case test cases are executed using wc3270 (Windows) or x3270 (Linux/MacOSX). You can change this by setting visible=False. Then test cases are run using ws3720 (Windows) or s3270 (Linux/MacOS). This is useful when test cases are run in a CI/CD-pipeline and there is no need for a graphical user interface.</p>\n<p>Timeout, waits and screenshot folder are set on library import as shown above. However, they can be changed during runtime. To modify the <code>wait_time</code>, see <a href=\"#Change%20Wait%20Time\" class=\"name\">Change Wait Time</a>, to modify the <code>img_folder</code>, see <a href=\"#Set%20Screenshot%20Folder\" class=\"name\">Set Screenshot Folder</a>, and to modify the <code>timeout</code>, see the <a href=\"#Change%20Timeout\" class=\"name\">Change Timeout</a> keyword. Timeouts support all available Robot Framework <a href=\"https://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#time-format\">time formats</a>.</p>\n<p>By default, Mainframe3270 will take a screenshot on failure. You can overwrite this to run any other keyword by setting the <code>run_on_failure_keyword</code> option. If you pass <code>None</code> to this argument, no keyword will be run. To change the <code>run_on_failure_keyword</code> during runtime, see <a href=\"#Register%20Run%20On%20Failure%20Keyword\" class=\"name\">Register Run On Failure Keyword</a>.</p>", "shortdoc": "By default the emulator visibility is set to visible=True. In this case test cases are executed using wc3270 (Windows) or x3270 (Linux/MacOSX). You can change this by setting visible=False. Then test cases are run using ws3720 (Windows) or s3270 (Linux/MacOS). This is useful when test cases are run in a CI/CD-pipeline and there is no need for a graphical user interface.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\__init__.py", "lineno": 121}], "keywords": [{"name": "Change Timeout", "args": [{"name": "seconds", "type": {"name": "timedelta", "typedoc": "timedelta", "nested": [], "union": false}, "types": ["timedelta"], "typedocs": {"timedelta": "timedelta"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "seconds: timedelta"}], "doc": "<p>Change the timeout for connection in seconds.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Change Timeout</td>\n<td>3 seconds</td>\n</tr>\n</table>", "shortdoc": "Change the timeout for connection in seconds.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\wait_and_timeout.py", "lineno": 13}, {"name": "Change Wait Time", "args": [{"name": "wait_time", "type": {"name": "timedelta", "typedoc": "timedelta", "nested": [], "union": false}, "types": ["timedelta"], "typedocs": {"timedelta": "timedelta"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "wait_time: timedelta"}], "doc": "<p>To give time for the mainframe screen to be \"drawn\" and receive the next commands, a \"wait time\" has been created, which by default is set to 0.5 seconds. This is a sleep applied AFTER the following keywords:</p>\n<ul>\n<li><a href=\"#Execute%20Command\" class=\"name\">Execute Command</a></li>\n<li><a href=\"#Send%20Enter\" class=\"name\">Send Enter</a></li>\n<li><a href=\"#Send%20PF\" class=\"name\">Send PF</a></li>\n<li><a href=\"#Write\" class=\"name\">Write</a></li>\n<li><a href=\"#Write%20In%20Position\" class=\"name\">Write in position</a></li>\n</ul>\n<p>If you want to change this value, just use this keyword passing the time in seconds.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Change Wait Time</td>\n<td>0.5</td>\n</tr>\n<tr>\n<td>Change Wait Time</td>\n<td>200 milliseconds</td>\n</tr>\n<tr>\n<td>Change Wait Time</td>\n<td>0:00:01.500</td>\n</tr>\n</table>", "shortdoc": "To give time for the mainframe screen to be \"drawn\" and receive the next commands, a \"wait time\" has been created, which by default is set to 0.5 seconds. This is a sleep applied AFTER the following keywords:", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\wait_and_timeout.py", "lineno": 23}, {"name": "Change Wait Time After Write", "args": [{"name": "wait_time_after_write", "type": {"name": "timedelta", "typedoc": "timedelta", "nested": [], "union": false}, "types": ["timedelta"], "typedocs": {"timedelta": "timedelta"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "wait_time_after_write: timedelta"}], "doc": "<p>To give the user time to see what is happening inside the mainframe, a \"wait time after write\" has been created, which by default is set to 0 seconds. This is a sleep applied AFTER sending a string in these keywords:</p>\n<ul>\n<li><a href=\"#Write\" class=\"name\">Write</a></li>\n<li><a href=\"#Write%20Bare\" class=\"name\">Write Bare</a></li>\n<li><a href=\"#Write%20In%20Position\" class=\"name\">Write in position</a></li>\n<li><a href=\"#Write%20Bare%20In%20Position\" class=\"name\">Write Bare in position</a></li>\n</ul>\n<p>If you want to change this value, just use this keyword passing the time in seconds.</p>\n<p>Note: This keyword is useful for debug purpose</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Change Wait Time After Write</td>\n<td>1</td>\n</tr>\n<tr>\n<td>Change Wait Time After Write</td>\n<td>0.5 seconds</td>\n</tr>\n<tr>\n<td>Change Wait Time After Write</td>\n<td>0:00:02</td>\n</tr>\n</table>", "shortdoc": "To give the user time to see what is happening inside the mainframe, a \"wait time after write\" has been created, which by default is set to 0 seconds. This is a sleep applied AFTER sending a string in these keywords:", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\wait_and_timeout.py", "lineno": 43}, {"name": "Close All Connections", "args": [], "doc": "<p>Close all currently opened connections and reset the index counter to 1.</p>", "shortdoc": "Close all currently opened connections and reset the index counter to 1.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\connection.py", "lineno": 208}, {"name": "Close Connection", "args": [], "doc": "<p>Close the current connection.</p>", "shortdoc": "Close the current connection.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\connection.py", "lineno": 201}, {"name": "Delete Char", "args": [{"name": "ypos", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "int", "typedoc": "integer", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["int", "None"], "typedocs": {"int": "integer", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ypos: int | None = None"}, {"name": "xpos", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "int", "typedoc": "integer", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["int", "None"], "typedocs": {"int": "integer", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "xpos: int | None = None"}], "doc": "<p>Delete the character under the cursor. If you want to delete a character that is in another position, simply pass the coordinates <code>ypos</code> / <code>xpos</code>.</p>\n<p>Coordinates are 1 based, as listed in the status area of the terminal.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Delete Char</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>Delete Char</td>\n<td>ypos=9</td>\n<td>xpos=25</td>\n</tr>\n</table>", "shortdoc": "Delete the character under the cursor. If you want to delete a character that is in another position, simply pass the coordinates ``ypos`` / ``xpos``.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\commands.py", "lineno": 24}, {"name": "Delete Field", "args": [{"name": "ypos", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "int", "typedoc": "integer", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["int", "None"], "typedocs": {"int": "integer", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ypos: int | None = None"}, {"name": "xpos", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "int", "typedoc": "integer", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["int", "None"], "typedocs": {"int": "integer", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "xpos: int | None = None"}], "doc": "<p>Delete the entire content of a field at the current cursor location and positions the cursor at beginning of field. If you want to delete a field that is in another position, simply pass the coordinates <code>ypos</code> / <code>xpos</code> of any part in the field.</p>\n<p>Coordinates are 1 based, as listed in the status area of the terminal.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Delete Field</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>Delete Field</td>\n<td>ypos=12</td>\n<td>xpos=6</td>\n</tr>\n</table>", "shortdoc": "Delete the entire content of a field at the current cursor location and positions the cursor at beginning of field. If you want to delete a field that is in another position, simply pass the coordinates ``ypos`` / ``xpos`` of any part in the field.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\commands.py", "lineno": 39}, {"name": "Execute Command", "args": [{"name": "cmd", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "cmd: str"}], "doc": "<p>Execute a <a href=\"http://x3270.bgp.nu/wc3270-man.html#Actions\">x3270 command</a>.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Execute Command</td>\n<td>Enter</td>\n</tr>\n<tr>\n<td>Execute Command</td>\n<td>Home</td>\n</tr>\n<tr>\n<td>Execute Command</td>\n<td>Tab</td>\n</tr>\n<tr>\n<td>Execute Command</td>\n<td>PF(1)</td>\n</tr>\n</table>", "shortdoc": "Execute a [http://x3270.bgp.nu/wc3270-man.html#Actions|x3270 command].", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\commands.py", "lineno": 11}, {"name": "Move Next Field", "args": [], "doc": "<p>Move the cursor to the next input field. Equivalent to pressing the Tab key.</p>", "shortdoc": "Move the cursor to the next input field. Equivalent to pressing the Tab key.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\commands.py", "lineno": 63}, {"name": "Move Previous Field", "args": [], "doc": "<p>Move the cursor to the previous input field. Equivalent to pressing the Shift+Tab keys.</p>", "shortdoc": "Move the cursor to the previous input field. Equivalent to pressing the Shift+Tab keys.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\commands.py", "lineno": 70}, {"name": "Open Connection", "args": [{"name": "host", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "host: str"}, {"name": "LU", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "LU: str | None = None"}, {"name": "port", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": "23", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "port: int = 23"}, {"name": "extra_args", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "List", "typedoc": "list", "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}], "union": false}, {"name": "PathLike", "typedoc": "Path", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["List[str]", "PathLike", "None"], "typedocs": {"List": "list", "str": "string", "PathLike": "Path", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "extra_args: List[str] | PathLike | None = None"}, {"name": "alias", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "alias: str | None = None"}], "doc": "<p>Create a connection to an IBM3270 mainframe with the default port 23. To establish a connection, only the hostname is required. Optional parameters include logical unit name (LU) and port.</p>\n<p>Additional configuration data can be provided through the <span class=\"name\">extra_args</span> parameter. <span class=\"name\">extra_args</span> accepts either a list or a path to a file containing <a href=\"https://x3270.miraheze.org/wiki/Category:Command-line_options\">x3270 command line options</a>.</p>\n<p>Entries in the argfile can be on one line or multiple lines. Lines starting with \"#\" are considered comments. Arguments containing whitespace must be enclosed in single or double quotes.</p>\n<pre>\n# example_argfile_oneline.txt\n-accepthostname myhost.com\n</pre>\n<pre>\n# example_argfile_multiline.txt\n-xrm \"wc3270.acceptHostname: myhost.com\"\n# this is a comment\n-charset french\n-port 992\n</pre>\n<p>Please ensure that the arguments provided are available for your specific x3270 application and version. Refer to the <a href=\"https://x3270.miraheze.org/wiki/Wc3270/Command-line_options\">wc3270 command line options</a> for a subset of available options.</p>\n<p>Note: If you specify the port with the <span class=\"name\">-port</span> command-line option in <span class=\"name\">extra_args</span> (or use the -xrm resource command for it), it will take precedence over the <span class=\"name\">port</span> argument provided in the <a href=\"#Open%20Connection\" class=\"name\">Open Connection</a> keyword.</p>\n<p>This keyword returns the index of the opened connection, which can be used to reference the connection when switching between connections using the <a href=\"#Switch%20Connection\" class=\"name\">Switch Connection</a> keyword. For more information on opening and switching between multiple connections, please refer to the <a href=\"#Concurrent%20Connections\" class=\"name\">Concurrent Connections</a> section.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Open Connection</td>\n<td>Hostname</td>\n<td></td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>Open Connection</td>\n<td>Hostname</td>\n<td>LU=LUname</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>Open Connection</td>\n<td>Hostname</td>\n<td>port=992</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>@{extra_args}</td>\n<td>Create List</td>\n<td>-accepthostname</td>\n<td>myhost.com</td>\n<td>-cafile</td>\n<td>${CURDIR}/cafile.crt</td>\n</tr>\n<tr>\n<td>Append To List</td>\n<td>${extra_args}</td>\n<td>-port</td>\n<td>992</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>Open Connection</td>\n<td>Hostname</td>\n<td>extra_args=${extra_args}</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>Open Connection</td>\n<td>Hostname</td>\n<td>extra_args=${CURDIR}/argfile.txt</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>Open Connection</td>\n<td>Hostname</td>\n<td>alias=my_first_connection</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n</table>", "shortdoc": "Create a connection to an IBM3270 mainframe with the default port 23. To establish a connection, only the hostname is required. Optional parameters include logical unit name (LU) and port.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\connection.py", "lineno": 16}, {"name": "Open Connection From Session File", "args": [{"name": "session_file", "type": {"name": "PathLike", "typedoc": "Path", "nested": [], "union": false}, "types": ["PathLike"], "typedocs": {"PathLike": "Path"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "session_file: PathLike"}, {"name": "alias", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "alias: str | None = None"}], "doc": "<p>Create a connection to an IBM3270 mainframe using a <a href=\"https://x3270.miraheze.org/wiki/Session_file\">session file</a>.</p>\n<p>The session file contains <a href=\"https://x3270.miraheze.org/wiki/Category:Resources\">resources (settings)</a> for a specific host session.</p>\n<p>The only mandatory setting required to establish the connection is the <a href=\"https://x3270.miraheze.org/wiki/Hostname_resource\">hostname resource</a>.</p>\n<p>This keyword is an alternative to <a href=\"#Open%20Connection\" class=\"name\">Open Connection</a>. Please note that the Robot-Framework-Mainframe-3270-Library currently only supports model \"2\". Specifying any other model will result in a failure.</p>\n<p>For more information on session file syntax and detailed examples, please consult the <a href=\"https://x3270.miraheze.org/wiki/Session_file\">x3270 wiki</a>.</p>\n<p>This keyword returns the index of the opened connection, which can be used to reference the connection when switching between connections using the <a href=\"#Switch%20Connection\" class=\"name\">Switch Connection</a> keyword. For more information on opening and switching between multiple connections, please refer to the <a href=\"#Concurrent%20Connections\" class=\"name\">Concurrent Connections</a> section.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Open Connection From Session File</td>\n<td>${CURDIR}/session.wc3270</td>\n</tr>\n</table>\n<p>where the content of <span class=\"name\">session.wc3270</span> is:</p>\n<pre>\nwc3270.hostname: myhost.com:23\nwc3270.model: 2\n</pre>", "shortdoc": "Create a connection to an IBM3270 mainframe using a [https://x3270.miraheze.org/wiki/Session_file|session file].", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\connection.py", "lineno": 120}, {"name": "Page Should Contain All Strings", "args": [{"name": "list_string", "type": {"name": "List", "typedoc": "list", "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}], "union": false}, "types": ["List[str]"], "typedocs": {"List": "list", "str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "list_string: List[str]"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}, {"name": "error_message", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error_message: str | None = None"}], "doc": "<p>Assert that all the strings in a given list exist on the mainframe screen.</p>\n<p>The assertion is case-sensitive. If you want it to be case-insensitive, you can pass the argument ignore_case=True.</p>\n<p>You can change the exception message by setting a custom string to error_message.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Page Should Contain All Strings</td>\n<td>${list_of_string}</td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Contain All Strings</td>\n<td>${list_of_string}</td>\n<td>ignore_case=True</td>\n</tr>\n<tr>\n<td>Page Should Contain All Strings</td>\n<td>${list_of_string}</td>\n<td>error_message=New error message</td>\n</tr>\n</table>", "shortdoc": "Assert that all the strings in a given list exist on the mainframe screen.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 117}, {"name": "Page Should Contain Any String", "args": [{"name": "list_string", "type": {"name": "List", "typedoc": "list", "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}], "union": false}, "types": ["List[str]"], "typedocs": {"List": "list", "str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "list_string: List[str]"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}, {"name": "error_message", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error_message: str | None = None"}], "doc": "<p>Assert that one of the strings in a given list exists on the mainframe screen.</p>\n<p>The assertion is case-sensitive. If you want it to be case-insensitive, you can pass the argument ignore_case=True.</p>\n<p>You can change the exception message by setting a custom string to error_message.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Page Should Contain Any String</td>\n<td>${list_of_string}</td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Contain Any String</td>\n<td>${list_of_string}</td>\n<td>ignore_case=True</td>\n</tr>\n<tr>\n<td>Page Should Contain Any String</td>\n<td>${list_of_string}</td>\n<td>error_message=New error message</td>\n</tr>\n</table>", "shortdoc": "Assert that one of the strings in a given list exists on the mainframe screen.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 64}, {"name": "Page Should Contain Match", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}, {"name": "error_message", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error_message: str | None = None"}], "doc": "<p>Assert that the text displayed on the mainframe screen matches the given pattern.</p>\n<p>Pattern matching is similar to matching files in a shell, and it is always case-sensitive. In the pattern, * matches anything and ? matches any single character.</p>\n<p>Note that for this keyword the entire screen is considered a string. So if you want to search for the string \"something\" and it is somewhere other than at the beginning or end of the screen, it should be reported as follows: <b>*something*</b></p>\n<p>The assertion is case-sensitive. If you want it to be case-insensitive, you can pass the argument ignore_case=True.</p>\n<p>You can change the exception message by setting a custom string to error_message.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Page Should Contain Match</td>\n<td><b>*something*</b></td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Contain Match</td>\n<td><b>*so???hing*</b></td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Contain Match</td>\n<td><b>*someTHING*</b></td>\n<td>ignore_case=True</td>\n</tr>\n<tr>\n<td>Page Should Contain Match</td>\n<td><b>*something*</b></td>\n<td>error_message=New error message</td>\n</tr>\n</table>", "shortdoc": "Assert that the text displayed on the mainframe screen matches the given pattern.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 229}, {"name": "Page Should Contain String", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}, {"name": "error_message", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error_message: str | None = None"}], "doc": "<p>Assert that a given string exists on the mainframe screen.</p>\n<p>The assertion is case-sensitive. If you want it to be case-insensitive, you can pass the argument ignore_case=True.</p>\n<p>You can change the exception message by setting a custom string to error_message.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Page Should Contain String</td>\n<td>something</td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Contain String</td>\n<td>someTHING</td>\n<td>ignore_case=True</td>\n</tr>\n<tr>\n<td>Page Should Contain String</td>\n<td>something</td>\n<td>error_message=New error message</td>\n</tr>\n</table>", "shortdoc": "Assert that a given string exists on the mainframe screen.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 13}, {"name": "Page Should Contain String X Times", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}, {"name": "number", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "number: int"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}, {"name": "error_message", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error_message: str | None = None"}], "doc": "<p>Asserts that the entered string appears the desired number of times on the mainframe screen.</p>\n<p>The assertion is case-sensitive. If you want it to be case-insensitive, you can pass the argument ignore_case=True.</p>\n<p>You can change the exception message by setting a custom string to error_message.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Page Should Contain String X Times</td>\n<td>something</td>\n<td>3</td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Contain String X Times</td>\n<td>someTHING</td>\n<td>3</td>\n<td>ignore_case=True</td>\n</tr>\n<tr>\n<td>Page Should Contain String X Times</td>\n<td>something</td>\n<td>3</td>\n<td>error_message=New error message</td>\n</tr>\n</table>", "shortdoc": "Asserts that the entered string appears the desired number of times on the mainframe screen.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 168}, {"name": "Page Should Match Regex", "args": [{"name": "regex_pattern", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "regex_pattern: str"}], "doc": "<p>Fails if string does not match pattern as a regular expression. Regular expression check is implemented using the Python <a href=\"https://docs.python.org/2/library/re.html\">re module</a>. Python's regular expression syntax is derived from Perl, and it is thus also very similar to the syntax used, for example, in Java, Ruby and .NET.</p>\n<p>Backslash is an escape character in the test data, and possible backslashes in the pattern must thus be escaped with another backslash (e.g. \\\\d\\\\w+).</p>", "shortdoc": "Fails if string does not match pattern as a regular expression. Regular expression check is implemented using the Python [https://docs.python.org/2/library/re.html|re module]. Python's regular expression syntax is derived from Perl, and it is thus also very similar to the syntax used, for example, in Java, Ruby and .NET.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 201}, {"name": "Page Should Not Contain All Strings", "args": [{"name": "list_string", "type": {"name": "List", "typedoc": "list", "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}], "union": false}, "types": ["List[str]"], "typedocs": {"List": "list", "str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "list_string: List[str]"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}, {"name": "error_message", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error_message: str | None = None"}], "doc": "<p>Fails if one of the strings in a given list exists on the mainframe screen. If one of the string are found, the keyword will raise an exception.</p>\n<p>The assertion is case-sensitive. If you want it to be case-insensitive, you can pass the argument ignore_case=True.</p>\n<p>You can change the exception message by setting a custom string to error_message.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Page Should Not Contain All Strings</td>\n<td>${list_of_string}</td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Not Contain All Strings</td>\n<td>${list_of_string}</td>\n<td>ignore_case=True</td>\n</tr>\n<tr>\n<td>Page Should Not Contain All Strings</td>\n<td>${list_of_string}</td>\n<td>error_message=New error message</td>\n</tr>\n</table>", "shortdoc": "Fails if one of the strings in a given list exists on the mainframe screen. If one of the string are found, the keyword will raise an exception.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 138}, {"name": "Page Should Not Contain Any String", "args": [{"name": "list_string", "type": {"name": "List", "typedoc": "list", "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}], "union": false}, "types": ["List[str]"], "typedocs": {"List": "list", "str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "list_string: List[str]"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}, {"name": "error_message", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error_message: str | None = None"}], "doc": "<p>Assert that none of the strings in a given list exists on the mainframe screen. If one or more of the string are found, the keyword will raise an exception.</p>\n<p>The assertion is case-sensitive. If you want it to be case-insensitive, you can pass the argument ignore_case=True.</p>\n<p>You can change the exception message by setting a custom string to error_message.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Page Should Not Contain Any Strings</td>\n<td>${list_of_string}</td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Not Contain Any Strings</td>\n<td>${list_of_string}</td>\n<td>ignore_case=True</td>\n</tr>\n<tr>\n<td>Page Should Not Contain Any Strings</td>\n<td>${list_of_string}</td>\n<td>error_message=New error message</td>\n</tr>\n</table>", "shortdoc": "Assert that none of the strings in a given list exists on the mainframe screen. If one or more of the string are found, the keyword will raise an exception.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 95}, {"name": "Page Should Not Contain Match", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}, {"name": "error_message", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error_message: str | None = None"}], "doc": "<p>Assert that the text displayed on the mainframe screen does NOT match the given pattern.</p>\n<p>Pattern matching is similar to matching files in a shell, and it is always case-sensitive. In the pattern, * matches anything and ? matches any single character.</p>\n<p>Note that for this keyword the entire screen is considered a string. So if you want to search for the string \"something\" and it is somewhere other than at the beginning or end of the screen, it should be reported as follows: <b>*something*</b></p>\n<p>The assertion is case-sensitive. If you want it to be case-insensitive, you can pass the argument ignore_case=True.</p>\n<p>You can change the exception message by setting a custom string to error_message.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Page Should Not Contain Match</td>\n<td><b>*something*</b></td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Not Contain Match</td>\n<td><b>*so???hing*</b></td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Not Contain Match</td>\n<td><b>*someTHING*</b></td>\n<td>ignore_case=True</td>\n</tr>\n<tr>\n<td>Page Should Not Contain Match</td>\n<td><b>*something*</b></td>\n<td>error_message=New error message</td>\n</tr>\n</table>", "shortdoc": "Assert that the text displayed on the mainframe screen does NOT match the given pattern.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 265}, {"name": "Page Should Not Contain String", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}, {"name": "error_message", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error_message: str | None = None"}], "doc": "<p>Assert that a given string does NOT exist on the mainframe screen.</p>\n<p>The assertion is case-sensitive. If you want it to be case-insensitive, you can pass the argument ignore_case=True.</p>\n<p>You can change the exception message by setting a custom string to error_message.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Page Should Not Contain String</td>\n<td>something</td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Not Contain String</td>\n<td>someTHING</td>\n<td>ignore_case=True</td>\n</tr>\n<tr>\n<td>Page Should Not Contain String</td>\n<td>something</td>\n<td>error_message=New error message</td>\n</tr>\n</table>", "shortdoc": "Assert that a given string does NOT exist on the mainframe screen.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 39}, {"name": "Page Should Not Match Regex", "args": [{"name": "regex_pattern", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "regex_pattern: str"}], "doc": "<p>Fails if string does match pattern as a regular expression. Regular expression check is implemented using the Python <a href=\"https://docs.python.org/2/library/re.html\">re module</a>. Python's regular expression syntax is derived from Perl, and it is thus also very similar to the syntax used, for example, in Java, Ruby and .NET.</p>\n<p>Backslash is an escape character in the test data, and possible backslashes in the pattern must thus be escaped with another backslash (e.g. \\\\d\\\\w+).</p>", "shortdoc": "Fails if string does match pattern as a regular expression. Regular expression check is implemented using the Python [https://docs.python.org/2/library/re.html|re module]. Python's regular expression syntax is derived from Perl, and it is thus also very similar to the syntax used, for example, in Java, Ruby and .NET.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 215}, {"name": "Read", "args": [{"name": "ypos", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "ypos: int"}, {"name": "xpos", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "xpos: int"}, {"name": "length", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "length: int"}], "doc": "<p>Get a string of <code>length</code> at screen coordinates <code>ypos</code> / <code>xpos</code>.</p>\n<p>Coordinates are 1 based, as listed in the status area of the terminal.</p>\n<p>Example for read a string in the position y=8 / x=10 of a length 15:</p>\n<table border=\"1\">\n<tr>\n<td>${value}</td>\n<td>Read</td>\n<td>8</td>\n<td>10</td>\n<td>15</td>\n</tr>\n</table>", "shortdoc": "Get a string of ``length`` at screen coordinates ``ypos`` / ``xpos``.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\read_write.py", "lineno": 11}, {"name": "Read All Screen", "args": [], "doc": "<p>Read the current screen and returns all content in one string.</p>\n<p>This is useful if your automation scripts should take different routes depending on a message shown on the screen.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${screen}</td>\n<td>Read All Screen</td>\n</tr>\n<tr>\n<td>IF</td>\n<td>'certain text' in '''${screen}'''</td>\n</tr>\n<tr>\n<td></td>\n<td>Do Something</td>\n</tr>\n<tr>\n<td>ELSE</td>\n<td></td>\n</tr>\n<tr>\n<td></td>\n<td>Do Something Else</td>\n</tr>\n<tr>\n<td>END</td>\n<td></td>\n</tr>\n</table>", "shortdoc": "Read the current screen and returns all content in one string.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\read_write.py", "lineno": 22}, {"name": "Register Run On Failure Keyword", "args": [{"name": "keyword", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "keyword: str"}], "doc": "<p>This keyword lets you change the keyword that runs on failure during test execution. The default is <a href=\"#Take%20Screenshot\" class=\"name\">Take Screenshot</a>, which is set on library import.</p>\n<p>You can set <code>None</code> to this keyword, if you do not want to run any keyword on failure.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Register Run On Failure Keyword</td>\n<td>None</td>\n<td># no keyword is run on failure</td>\n</tr>\n<tr>\n<td>Register Run On Failure Keyword</td>\n<td>Custom Keyword</td>\n<td># Custom Keyword is run on failure</td>\n</tr>\n</table>", "shortdoc": "This keyword lets you change the keyword that runs on failure during test execution. The default is `Take Screenshot`, which is set on library import.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\__init__.py", "lineno": 179}, {"name": "Send Enter", "args": [], "doc": "<p>Send an Enter to the screen.</p>", "shortdoc": "Send an Enter to the screen.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\commands.py", "lineno": 55}, {"name": "Send PF", "args": [{"name": "pf", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "pf: str"}], "doc": "<p>Send a Program Function to the screen.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Send PF</td>\n<td>3</td>\n</tr>\n</table>", "shortdoc": "Send a Program Function to the screen.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\commands.py", "lineno": 77}, {"name": "Set Screenshot Folder", "args": [{"name": "path", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "path: str"}], "doc": "<p>Set a folder to keep the html files generated by the <a href=\"#Take%20Screenshot\" class=\"name\">Take Screenshot</a> keyword.</p>\n<p>Note that the folder needs to exist before running your automation scripts. Else the images will be stored in the <code>${OUTPUT DIR}</code> set by robotframework.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Set Screenshot Folder</td>\n<td>C:\\\\Temp\\\\Images</td>\n</tr>\n</table>", "shortdoc": "Set a folder to keep the html files generated by the `Take Screenshot` keyword.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\screenshot.py", "lineno": 12}, {"name": "Switch Connection", "args": [{"name": "alias_or_index", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "int", "typedoc": "integer", "nested": [], "union": false}], "union": true}, "types": ["str", "int"], "typedocs": {"str": "string", "int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "alias_or_index: str | int"}], "doc": "<p>Switch the current connection to the one identified by index or alias. Indices are returned from and aliases can be optionally provided to the <a href=\"#Open%20Connection\" class=\"name\">Open Connection</a> and <a href=\"#Open%20Connection%20From%20Session%20File\" class=\"name\">Open Connection From Session File</a> keywords.</p>\n<p>For more information on opening and switching between multiple connections, please refer to the <a href=\"#Concurrent%20Connections\" class=\"name\">Concurrent Connections</a> section.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td>Open Connection</td>\n<td>Hostname</td>\n<td>alias=first</td>\n<td></td>\n</tr>\n<tr>\n<td>Open Connection</td>\n<td>Hostname</td>\n<td>alias=second</td>\n<td># second is now the current connection</td>\n</tr>\n<tr>\n<td>Switch Connection</td>\n<td>first</td>\n<td></td>\n<td># first is now the current connection</td>\n</tr>\n</table>", "shortdoc": "Switch the current connection to the one identified by index or alias. Indices are returned from and aliases can be optionally provided to the `Open Connection` and `Open Connection From Session File` keywords.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\connection.py", "lineno": 185}, {"name": "Take Screenshot", "args": [{"name": "height", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": "410", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "height: int = 410"}, {"name": "width", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": "670", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "width: int = 670"}, {"name": "filename_prefix", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": "screenshot", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "filename_prefix: str = screenshot"}], "doc": "<p>Generate a screenshot of the IBM 3270 Mainframe in a html format. The default folder is the log folder of RobotFramework, if you want change see the <a href=\"#Set%20Screenshot%20Folder\" class=\"name\">Set Screenshot Folder</a>.</p>\n<p>The Screenshot is printed in an iframe log, with the values of height=410 and width=670, you can change these values by passing them to the keyword.</p>\n<p>The file name prefix can be set, the default is \"screenshot\".</p>\n<p>The full file path is returned.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${filepath}</td>\n<td>Take Screenshot</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>${filepath}</td>\n<td>Take Screenshot</td>\n<td>height=500</td>\n<td>width=700</td>\n</tr>\n<tr>\n<td>Take Screenshot</td>\n<td>height=500</td>\n<td>width=700</td>\n<td></td>\n</tr>\n<tr>\n<td>Take Screenshot</td>\n<td>filename_prefix=MyScreenshot</td>\n<td></td>\n<td></td>\n</tr>\n</table>", "shortdoc": "Generate a screenshot of the IBM 3270 Mainframe in a html format. The default folder is the log folder of RobotFramework, if you want change see the `Set Screenshot Folder`.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\screenshot.py", "lineno": 28}, {"name": "Wait Field Detected", "args": [], "doc": "<p>Wait until the screen is ready, the cursor has been positioned on a modifiable field, and the keyboard is unlocked.</p>\n<p>Sometimes the server will \"unlock\" the keyboard but the screen will not yet be ready.  In that case, an attempt to read or write to the screen will result in a 'E' keyboard status because we tried to read from a screen that is not ready yet.</p>\n<p>Using this method tells the client to wait until a field is detected and the cursor has been positioned on it.</p>", "shortdoc": "Wait until the screen is ready, the cursor has been positioned on a modifiable field, and the keyboard is unlocked.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\wait_and_timeout.py", "lineno": 65}, {"name": "Wait Until String", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}, {"name": "timeout", "type": {"name": "timedelta", "typedoc": "timedelta", "nested": [], "union": false}, "types": ["timedelta"], "typedocs": {"timedelta": "timedelta"}, "defaultValue": "0:00:05", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = 0:00:05"}], "doc": "<p>Wait until a string exists on the mainframe screen to perform the next step. If the string does not appear in 5 seconds, the keyword will raise an exception. You can define a different timeout.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Wait Until String</td>\n<td>something</td>\n<td></td>\n</tr>\n<tr>\n<td>Wait Until String</td>\n<td>something</td>\n<td>10</td>\n</tr>\n<tr>\n<td>Wait Until String</td>\n<td>something</td>\n<td>15 s</td>\n</tr>\n<tr>\n<td>Wait Until String</td>\n<td>something</td>\n<td>0:00:15</td>\n</tr>\n</table>", "shortdoc": "Wait until a string exists on the mainframe screen to perform the next step. If the string does not appear in 5 seconds, the keyword will raise an exception. You can define a different timeout.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\wait_and_timeout.py", "lineno": 80}, {"name": "Write", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}], "doc": "<p>Send a string <b>and Enter</b> to the screen at the current cursor location.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Write</td>\n<td>something</td>\n</tr>\n</table>", "shortdoc": "Send a string *and Enter* to the screen at the current cursor location.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\read_write.py", "lineno": 39}, {"name": "Write Bare", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}], "doc": "<p>Send only the string to the screen at the current cursor location.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Write Bare</td>\n<td>something</td>\n</tr>\n</table>", "shortdoc": "Send only the string to the screen at the current cursor location.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\read_write.py", "lineno": 48}, {"name": "Write Bare In Position", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}, {"name": "ypos", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "ypos: int"}, {"name": "xpos", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "xpos: int"}], "doc": "<p>Send only the string to the screen at screen coordinates <code>ypos</code> / <code>xpos</code>.</p>\n<p>Coordinates are 1 based, as listed in the status area of the terminal.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Write Bare in Position</td>\n<td>something</td>\n<td>9</td>\n<td>11</td>\n</tr>\n</table>", "shortdoc": "Send only the string to the screen at screen coordinates ``ypos`` / ``xpos``.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\read_write.py", "lineno": 69}, {"name": "Write In Position", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}, {"name": "ypos", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "ypos: int"}, {"name": "xpos", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "xpos: int"}], "doc": "<p>Send a string <b>and Enter</b> to the screen at screen coordinates <code>ypos</code> / <code>xpos</code>.</p>\n<p>Coordinates are 1 based, as listed in the status area of the terminal.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Write in Position</td>\n<td>something</td>\n<td>9</td>\n<td>11</td>\n</tr>\n</table>", "shortdoc": "Send a string *and Enter* to the screen at screen coordinates ``ypos`` / ``xpos``.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\read_write.py", "lineno": 57}], "dataTypes": {"enums": [], "typedDicts": []}, "typedocs": [{"type": "Standard", "name": "boolean", "doc": "<p>Strings <code>TRUE</code>, <code>YES</code>, <code>ON</code> and <code>1</code> are converted to Boolean <code>True</code>, the empty string as well as strings <code>FALSE</code>, <code>NO</code>, <code>OFF</code> and <code>0</code> are converted to Boolean <code>False</code>, and the string <code>NONE</code> is converted to the Python <code>None</code> object. Other strings and other accepted values are passed as-is, allowing keywords to handle them specially if needed. All string comparisons are case-insensitive.</p>\n<p>Examples: <code>TRUE</code> (converted to <code>True</code>), <code>off</code> (converted to <code>False</code>), <code>example</code> (used as-is)</p>", "usages": ["__init__", "Page Should Contain All Strings", "Page Should Contain Any String", "Page Should Contain Match", "Page Should Contain String", "Page Should Contain String X Times", "Page Should Not Contain All Strings", "Page Should Not Contain Any String", "Page Should Not Contain Match", "Page Should Not Contain String"], "accepts": ["string", "integer", "float", "None"]}, {"type": "Standard", "name": "integer", "doc": "<p>Conversion is done using Python's <a href=\"https://docs.python.org/library/functions.html#int\">int</a> built-in function. Floating point numbers are accepted only if they can be represented as integers exactly. For example, <code>1.0</code> is accepted and <code>1.1</code> is not.</p>\n<p>Starting from RF 4.1, it is possible to use hexadecimal, octal and binary numbers by prefixing values with <code>0x</code>, <code>0o</code> and <code>0b</code>, respectively.</p>\n<p>Starting from RF 4.1, spaces and underscores can be used as visual separators for digit grouping purposes.</p>\n<p>Examples: <code>42</code>, <code>-1</code>, <code>0b1010</code>, <code>10 000 000</code>, <code>0xBAD_C0FFEE</code></p>", "usages": ["Delete Char", "Delete Field", "Open Connection", "Page Should Contain String X Times", "Read", "Switch Connection", "Take Screenshot", "Write Bare In Position", "Write In Position"], "accepts": ["string", "float"]}, {"type": "Standard", "name": "list", "doc": "<p>Strings must be Python <a href=\"https://docs.python.org/library/stdtypes.html#list\">list</a> literals. They are converted to actual lists using the <a href=\"https://docs.python.org/library/ast.html#ast.literal_eval\">ast.literal_eval</a> function. They can contain any values <code>ast.literal_eval</code> supports, including lists and other containers.</p>\n<p>If the type has nested types like <code>list[int]</code>, items are converted to those types automatically. This in new in Robot Framework 6.0.</p>\n<p>Examples: <code>['one', 'two']</code>, <code>[('one', 1), ('two', 2)]</code></p>", "usages": ["Open Connection", "Page Should Contain All Strings", "Page Should Contain Any String", "Page Should Not Contain All Strings", "Page Should Not Contain Any String"], "accepts": ["string", "Sequence"]}, {"type": "Standard", "name": "None", "doc": "<p>String <code>NONE</code> (case-insensitive) is converted to Python <code>None</code> object. Other values cause an error.</p>", "usages": ["Delete Char", "Delete Field", "Open Connection", "Open Connection From Session File", "Page Should Contain All Strings", "Page Should Contain Any String", "Page Should Contain Match", "Page Should Contain String", "Page Should Contain String X Times", "Page Should Not Contain All Strings", "Page Should Not Contain Any String", "Page Should Not Contain Match", "Page Should Not Contain String"], "accepts": ["string"]}, {"type": "Standard", "name": "Path", "doc": "<p>Strings are converted <a href=\"https://docs.python.org/library/pathlib.html\">Path</a> objects. On Windows <code>/</code> is converted to <code>\\</code> automatically.</p>\n<p>Examples: <code>/tmp/absolute/path</code>, <code>relative/path/to/file.ext</code>, <code>name.txt</code></p>", "usages": ["Open Connection", "Open Connection From Session File"], "accepts": ["string", "PurePath"]}, {"type": "Standard", "name": "string", "doc": "<p>All arguments are converted to Unicode strings.</p>", "usages": ["__init__", "Execute Command", "Open Connection", "Open Connection From Session File", "Page Should Contain All Strings", "Page Should Contain Any String", "Page Should Contain Match", "Page Should Contain String", "Page Should Contain String X Times", "Page Should Match Regex", "Page Should Not Contain All Strings", "Page Should Not Contain Any String", "Page Should Not Contain Match", "Page Should Not Contain String", "Page Should Not Match Regex", "Register Run On Failure Keyword", "Send PF", "Set Screenshot Folder", "Switch Connection", "Take Screenshot", "Wait Until String", "Write", "Write Bare", "Write Bare In Position", "Write In Position"], "accepts": ["Any"]}, {"type": "Standard", "name": "timedelta", "doc": "<p>Strings are expected to represent a time interval in one of the time formats Robot Framework supports:</p>\n<ul>\n<li>a number representing seconds like <code>42</code> or <code>10.5</code></li>\n<li>a time string like <code>1 hour 2 seconds</code> or <code>1h 2s</code></li>\n<li>a \"timer\" string like <code>01:02</code> (1 minute 2 seconds) or <code>01:00:03</code> (1 hour 3 seconds)</li>\n</ul>\n<p>Integers and floats are considered to be seconds.</p>\n<p>See the <a href=\"https://robotframework.org/robotframework/\">Robot Framework User Guide</a> for more details about the supported time formats.</p>", "usages": ["__init__", "Change Timeout", "Change Wait Time", "Change Wait Time After Write", "Wait Until String"], "accepts": ["string", "integer", "float"]}]}
+libdoc = {"specversion": 2, "name": "Mainframe3270", "doc": "<p>Mainframe3270 is a library for Robot Framework based on the <a href=\"https://pypi.org/project/py3270/\">py3270 project</a>, a Python interface to x3270, an IBM 3270 terminal emulator. It provides an API to a x3270 or s3270 subprocess.</p>\n<h2 id=\"Installation\">Installation</h2>\n<p>To use this library, you must have the <a href=\"http://x3270.bgp.nu/download.html\">x3270 project</a> installed and included in your PATH. On Windows, you can install wc3270 and add \"C:\\Program Files\\wc3270\" to your PATH in the Environment Variables.</p>\n<h2 id=\"Example\">Example</h2>\n<pre>\n<b>*</b> Settings <b>*</b>\nLibrary           Mainframe3270\n\n<b>*</b> Test Cases <b>*</b>\nExample\n    Open Connection    Hostname    LUname\n    Change Wait Time    0.4 seconds\n    Change Wait Time After Write    0.4 seconds\n    Set Screenshot Folder    C:\\\\Temp\\\\IMG\n    ${value}    Read    3    10    17\n    Page Should Contain String    ENTER APPLICATION\n    Wait Field Detected\n    Write Bare    applicationname\n    Send Enter\n    Take Screenshot\n    Close Connection\n</pre>\n<h2 id=\"Concurrent Connections\">Concurrent Connections</h2>\n<p>The library allows you to have multiple sessions open at the same time. Each session opened by <a href=\"#Open%20Connection\" class=\"name\">Open Connection</a> or <a href=\"#Open%20Connection%20From%20Session%20File\" class=\"name\">Open Connection From Session File</a> will return an index that can be used to reference it when switching between connections using the <a href=\"#Switch%20Connection\" class=\"name\">Switch Connection</a> keyword. The indices start from 1 and are incremented by each newly opened connection. Calling <span class=\"name\">Close All Connection</span> will reset the index counter to 1.</p>\n<p>Additionally, you can provide aliases to your sessions when opening a connection, and switch the connection using that alias instead of the index.</p>\n<p>It is worth noting that the connection that was opened last is always the current connection.</p>\n<pre>\n<b>*</b> Test Cases <b>*</b>\nConcurrent Sessions\n    ${index_1}    Open Connection    Hostname    # this is the current connection\n    Write Bare    First String\n    ${index_2}    Open Connection    Hostname    alias=second    # 'second' is now the current connection\n    Write Bare    Second String\n    Switch Connection    ${index_1}    # swtiching the connection using the index\n    Page Should Contain String    First String\n    Switch Connection    second    # switchting the ocnnection using the alias\n    Page Should Contain String    Second String\n    [Teardown]    Close All Connections\n</pre>\n<h2 id=\"Changing the emulator model (experimental)\">Changing the emulator model (experimental)</h2>\n<p>By default, the library uses the emulator model 2, which is 24 rows by 80 columns. You can, however, change the model globally when <a href=\"#Importing\" class=\"name\">importing</a> the library with the <span class=\"name\">model</span> argument set to the model of your choice.</p>\n<p>The basic models are 2, 3, 4, and 5. These models differ in their screen size as illustrated in this table:</p>\n<table border=\"1\">\n<tr>\n<td><b>3270 Model</b></td>\n<td><b>Rows</b></td>\n<td><b>Columns</b></td>\n</tr>\n<tr>\n<td>2</td>\n<td>24</td>\n<td>80</td>\n</tr>\n<tr>\n<td>3</td>\n<td>32</td>\n<td>80</td>\n</tr>\n<tr>\n<td>4</td>\n<td>43</td>\n<td>80</td>\n</tr>\n<tr>\n<td>5</td>\n<td>27</td>\n<td>132</td>\n</tr>\n</table>\n<p>They can be combined with the 3278 (monochrome green-screen) or 3279 (color) prefix, e.g. 3278-2 or 3279-2.</p>\n<p>In addition to that, there is a -E suffix that indicates support for the <a href=\"https://x3270.miraheze.org/wiki/3270_data_stream_protocol#extended\">x3270 extended data stream</a>.</p>\n<p>You can find more information on emulator models on the <a href=\"https://x3270.miraheze.org/wiki/3270_models\">x3270 wiki</a>.</p>\n<p>In addition to setting the model globally, you can also set the model on the individual emulator basis by providing the model arguments to the <a href=\"#Open%20Connection\" class=\"name\">Open Connection</a> or <a href=\"#Open%20Connection%20From%20Session%20File\" class=\"name\">Open Connection From Session File</a> keywords.</p>\n<p>Here is an example for setting the emulator in the Open Connection keyword:</p>\n<pre>\nOpen Connection    pub400.com    extra_args=[\"-xrm\", \"*model: 4\"]\n</pre>\n<p>And this is how you would set the emulator model in the Open Connection From Session File keyword:</p>\n<pre>\nOpen Connection From Session File    /path/to/session/file\n</pre>\n<p>Where the content of the session file would be</p>\n<pre>\n*hostname: pub400.com\n*model: 4\n</pre>\n<p>Note that this is an experimental feature, so not all models might work as expected.</p>", "version": "4.0", "generated": "2023-12-17T06:36:42+00:00", "type": "LIBRARY", "scope": "SUITE", "docFormat": "HTML", "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\__init__.py", "lineno": 24, "tags": [], "inits": [{"name": "__init__", "args": [{"name": "visible", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "True", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "visible: bool = True"}, {"name": "timeout", "type": {"name": "timedelta", "typedoc": "timedelta", "nested": [], "union": false}, "types": ["timedelta"], "typedocs": {"timedelta": "timedelta"}, "defaultValue": "0:00:30", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = 0:00:30"}, {"name": "wait_time", "type": {"name": "timedelta", "typedoc": "timedelta", "nested": [], "union": false}, "types": ["timedelta"], "typedocs": {"timedelta": "timedelta"}, "defaultValue": "0:00:00.500000", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "wait_time: timedelta = 0:00:00.500000"}, {"name": "wait_time_after_write", "type": {"name": "timedelta", "typedoc": "timedelta", "nested": [], "union": false}, "types": ["timedelta"], "typedocs": {"timedelta": "timedelta"}, "defaultValue": "0:00:00", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "wait_time_after_write: timedelta = 0:00:00"}, {"name": "img_folder", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": ".", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "img_folder: str = ."}, {"name": "run_on_failure_keyword", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": "Take Screenshot", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "run_on_failure_keyword: str = Take Screenshot"}, {"name": "model", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": "2", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "model: str = 2"}], "doc": "<p>By default the emulator visibility is set to visible=True. In this case test cases are executed using wc3270 (Windows) or x3270 (Linux/MacOSX). You can change this by setting visible=False. Then test cases are run using ws3720 (Windows) or s3270 (Linux/MacOS). This is useful when test cases are run in a CI/CD-pipeline and there is no need for a graphical user interface.</p>\n<p>Timeout, waits and screenshot folder are set on library import as shown above. However, they can be changed during runtime. To modify the <code>wait_time</code>, see <a href=\"#Change%20Wait%20Time\" class=\"name\">Change Wait Time</a>, to modify the <code>img_folder</code>, see <a href=\"#Set%20Screenshot%20Folder\" class=\"name\">Set Screenshot Folder</a>, and to modify the <code>timeout</code>, see the <a href=\"#Change%20Timeout\" class=\"name\">Change Timeout</a> keyword. Timeouts support all available Robot Framework <a href=\"https://robotframework.org/robotframework/latest/RobotFrameworkUserGuide.html#time-format\">time formats</a>.</p>\n<p>By default, Mainframe3270 will take a screenshot on failure. You can overwrite this to run any other keyword by setting the <code>run_on_failure_keyword</code> option. If you pass <code>None</code> to this argument, no keyword will be run. To change the <code>run_on_failure_keyword</code> during runtime, see <a href=\"#Register%20Run%20On%20Failure%20Keyword\" class=\"name\">Register Run On Failure Keyword</a>.</p>", "shortdoc": "By default the emulator visibility is set to visible=True. In this case test cases are executed using wc3270 (Windows) or x3270 (Linux/MacOSX). You can change this by setting visible=False. Then test cases are run using ws3720 (Windows) or s3270 (Linux/MacOS). This is useful when test cases are run in a CI/CD-pipeline and there is no need for a graphical user interface.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\__init__.py", "lineno": 121}], "keywords": [{"name": "Change Timeout", "args": [{"name": "seconds", "type": {"name": "timedelta", "typedoc": "timedelta", "nested": [], "union": false}, "types": ["timedelta"], "typedocs": {"timedelta": "timedelta"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "seconds: timedelta"}], "doc": "<p>Change the timeout for connection in seconds.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Change Timeout</td>\n<td>3 seconds</td>\n</tr>\n</table>", "shortdoc": "Change the timeout for connection in seconds.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\wait_and_timeout.py", "lineno": 13}, {"name": "Change Wait Time", "args": [{"name": "wait_time", "type": {"name": "timedelta", "typedoc": "timedelta", "nested": [], "union": false}, "types": ["timedelta"], "typedocs": {"timedelta": "timedelta"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "wait_time: timedelta"}], "doc": "<p>To give time for the mainframe screen to be \"drawn\" and receive the next commands, a \"wait time\" has been created, which by default is set to 0.5 seconds. This is a sleep applied AFTER the following keywords:</p>\n<ul>\n<li><a href=\"#Execute%20Command\" class=\"name\">Execute Command</a></li>\n<li><a href=\"#Send%20Enter\" class=\"name\">Send Enter</a></li>\n<li><a href=\"#Send%20PF\" class=\"name\">Send PF</a></li>\n<li><a href=\"#Write\" class=\"name\">Write</a></li>\n<li><a href=\"#Write%20In%20Position\" class=\"name\">Write in position</a></li>\n</ul>\n<p>If you want to change this value, just use this keyword passing the time in seconds.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Change Wait Time</td>\n<td>0.5</td>\n</tr>\n<tr>\n<td>Change Wait Time</td>\n<td>200 milliseconds</td>\n</tr>\n<tr>\n<td>Change Wait Time</td>\n<td>0:00:01.500</td>\n</tr>\n</table>", "shortdoc": "To give time for the mainframe screen to be \"drawn\" and receive the next commands, a \"wait time\" has been created, which by default is set to 0.5 seconds. This is a sleep applied AFTER the following keywords:", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\wait_and_timeout.py", "lineno": 23}, {"name": "Change Wait Time After Write", "args": [{"name": "wait_time_after_write", "type": {"name": "timedelta", "typedoc": "timedelta", "nested": [], "union": false}, "types": ["timedelta"], "typedocs": {"timedelta": "timedelta"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "wait_time_after_write: timedelta"}], "doc": "<p>To give the user time to see what is happening inside the mainframe, a \"wait time after write\" has been created, which by default is set to 0 seconds. This is a sleep applied AFTER sending a string in these keywords:</p>\n<ul>\n<li><a href=\"#Write\" class=\"name\">Write</a></li>\n<li><a href=\"#Write%20Bare\" class=\"name\">Write Bare</a></li>\n<li><a href=\"#Write%20In%20Position\" class=\"name\">Write in position</a></li>\n<li><a href=\"#Write%20Bare%20In%20Position\" class=\"name\">Write Bare in position</a></li>\n</ul>\n<p>If you want to change this value, just use this keyword passing the time in seconds.</p>\n<p>Note: This keyword is useful for debug purpose</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Change Wait Time After Write</td>\n<td>1</td>\n</tr>\n<tr>\n<td>Change Wait Time After Write</td>\n<td>0.5 seconds</td>\n</tr>\n<tr>\n<td>Change Wait Time After Write</td>\n<td>0:00:02</td>\n</tr>\n</table>", "shortdoc": "To give the user time to see what is happening inside the mainframe, a \"wait time after write\" has been created, which by default is set to 0 seconds. This is a sleep applied AFTER sending a string in these keywords:", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\wait_and_timeout.py", "lineno": 43}, {"name": "Close All Connections", "args": [], "doc": "<p>Close all currently opened connections and reset the index counter to 1.</p>", "shortdoc": "Close all currently opened connections and reset the index counter to 1.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\connection.py", "lineno": 208}, {"name": "Close Connection", "args": [], "doc": "<p>Close the current connection.</p>", "shortdoc": "Close the current connection.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\connection.py", "lineno": 201}, {"name": "Delete Char", "args": [{"name": "ypos", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "int", "typedoc": "integer", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["int", "None"], "typedocs": {"int": "integer", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ypos: int | None = None"}, {"name": "xpos", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "int", "typedoc": "integer", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["int", "None"], "typedocs": {"int": "integer", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "xpos: int | None = None"}], "doc": "<p>Delete the character under the cursor. If you want to delete a character that is in another position, simply pass the coordinates <code>ypos</code> / <code>xpos</code>.</p>\n<p>Coordinates are 1 based, as listed in the status area of the terminal.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Delete Char</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>Delete Char</td>\n<td>ypos=9</td>\n<td>xpos=25</td>\n</tr>\n</table>", "shortdoc": "Delete the character under the cursor. If you want to delete a character that is in another position, simply pass the coordinates ``ypos`` / ``xpos``.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\commands.py", "lineno": 25}, {"name": "Delete Field", "args": [{"name": "ypos", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "int", "typedoc": "integer", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["int", "None"], "typedocs": {"int": "integer", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ypos: int | None = None"}, {"name": "xpos", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "int", "typedoc": "integer", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["int", "None"], "typedocs": {"int": "integer", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "xpos: int | None = None"}], "doc": "<p>Delete the entire content of a field at the current cursor location and positions the cursor at beginning of field. If you want to delete a field that is in another position, simply pass the coordinates <code>ypos</code> / <code>xpos</code> of any part in the field.</p>\n<p>Coordinates are 1 based, as listed in the status area of the terminal.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Delete Field</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>Delete Field</td>\n<td>ypos=12</td>\n<td>xpos=6</td>\n</tr>\n</table>", "shortdoc": "Delete the entire content of a field at the current cursor location and positions the cursor at beginning of field. If you want to delete a field that is in another position, simply pass the coordinates ``ypos`` / ``xpos`` of any part in the field.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\commands.py", "lineno": 40}, {"name": "Execute Command", "args": [{"name": "cmd", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "cmd: str"}], "doc": "<p>Execute a <a href=\"http://x3270.bgp.nu/wc3270-man.html#Actions\">x3270 command</a>.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Execute Command</td>\n<td>Enter</td>\n</tr>\n<tr>\n<td>Execute Command</td>\n<td>Home</td>\n</tr>\n<tr>\n<td>Execute Command</td>\n<td>Tab</td>\n</tr>\n<tr>\n<td>Execute Command</td>\n<td>PF(1)</td>\n</tr>\n</table>", "shortdoc": "Execute a [http://x3270.bgp.nu/wc3270-man.html#Actions|x3270 command].", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\commands.py", "lineno": 12}, {"name": "Get Current Position", "args": [{"name": "mode", "type": {"name": "ResultMode", "typedoc": "ResultMode", "nested": [], "union": false}, "types": ["ResultMode"], "typedocs": {"ResultMode": "ResultMode"}, "defaultValue": "As_Tuple", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "mode: ResultMode = As_Tuple"}], "doc": "<p>Returns the current cursor position. The coordinates are 1 based.</p>\n<p>By default, this keyword returns a tuple of integers. However, if you specify the <span class=\"name\">mode</span> with the value <code>\"As Dict\"</code> (case-insensitive), a dictionary in the form of <code>{\"xpos\": int, \"ypos\": int}</code> is returned.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Get Cursor Position</td>\n<td></td>\n<td># Returns a position like (1, 1)</td>\n</tr>\n<tr>\n<td>Get Cursor Position</td>\n<td>As Dict</td>\n<td># Returns a position like {\"xpos\": 1, \"ypos\": 1}</td>\n</tr>\n</table>", "shortdoc": "Returns the current cursor position. The coordinates are 1 based.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\commands.py", "lineno": 88}, {"name": "Get String Positions", "args": [{"name": "string", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "string: str"}, {"name": "mode", "type": {"name": "ResultMode", "typedoc": "ResultMode", "nested": [], "union": false}, "types": ["ResultMode"], "typedocs": {"ResultMode": "ResultMode"}, "defaultValue": "As_Tuple", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "mode: ResultMode = As_Tuple"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}], "doc": "<p>Returns a list of tuples of ypos and xpos for the position where the <a href=\"#type-string\" class=\"name\">string</a> was found, or an empty list if it was not found.</p>\n<p>If you specify the <span class=\"name\">mode</span> with the value <span class=\"name\">\"As Dict\"</span> (case-insensitive), a list of dictionaries in the form of <code>[{\"xpos\": int, \"ypos\": int}]</code> is returned.</p>\n<p>If <span class=\"name\">ignore_case</span> is set to <span class=\"name\">True</span>, then the search is done case-insensitively.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${positions}</td>\n<td>Get String Positions</td>\n<td>Abc</td>\n<td></td>\n<td># Returns a list like [(1, 8)]</td>\n</tr>\n<tr>\n<td>${positions}</td>\n<td>Get String Positions</td>\n<td>Abc</td>\n<td>As Dict</td>\n<td># Returns a list like [{\"ypos\": 1, \"xpos\": 8}]</td>\n</tr>\n</table>", "shortdoc": "Returns a list of tuples of ypos and xpos for the position where the `string` was found, or an empty list if it was not found.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\read_write.py", "lineno": 47}, {"name": "Get String Positions Only After", "args": [{"name": "ypos", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "ypos: int"}, {"name": "xpos", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "xpos: int"}, {"name": "string", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "string: str"}, {"name": "mode", "type": {"name": "ResultMode", "typedoc": "ResultMode", "nested": [], "union": false}, "types": ["ResultMode"], "typedocs": {"ResultMode": "ResultMode"}, "defaultValue": "As_Tuple", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "mode: ResultMode = As_Tuple"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}], "doc": "<p>Returns a list of tuples of ypos and xpos for the position where the <a href=\"#type-string\" class=\"name\">string</a> was found, but only after the specified ypos/xpos coordinates. If it is not found an empty list is returned.</p>\n<p>If you specify the <span class=\"name\">mode</span> with the value <span class=\"name\">\"As Dict\"</span> (case-insensitive), a list of dictionaries in the form of <code>[{\"xpos\": int, \"ypos\": int}]</code> is returned.</p>\n<p>If <span class=\"name\">ignore_case</span> is set to <span class=\"name\">True</span>, then the search is done case-insensitively.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${positions}</td>\n<td>Get String Positions Only After</td>\n<td>5</td>\n<td>4</td>\n<td>Abc</td>\n<td></td>\n<td># Returns a list like [(5, 5)]</td>\n</tr>\n<tr>\n<td>${positions}</td>\n<td>Get String Positions Only After</td>\n<td>5</td>\n<td>4</td>\n<td>Abc</td>\n<td>As Dict</td>\n<td># Returns a list like [{\"ypos\": 5, \"xpos\": 5}]</td>\n</tr>\n</table>", "shortdoc": "Returns a list of tuples of ypos and xpos for the position where the `string` was found, but only after the specified ypos/xpos coordinates. If it is not found an empty list is returned.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\read_write.py", "lineno": 64}, {"name": "Get String Positions Only Before", "args": [{"name": "ypos", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "ypos: int"}, {"name": "xpos", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "xpos: int"}, {"name": "string", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "string: str"}, {"name": "mode", "type": {"name": "ResultMode", "typedoc": "ResultMode", "nested": [], "union": false}, "types": ["ResultMode"], "typedocs": {"ResultMode": "ResultMode"}, "defaultValue": "As_Tuple", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "mode: ResultMode = As_Tuple"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}], "doc": "<p>Returns a list of tuples of ypos and xpos for the position where the <a href=\"#type-string\" class=\"name\">string</a> was found, but only before the specified ypos/xpos coordinates. If it is not found an empty list is returned.</p>\n<p>If you specify the <span class=\"name\">mode</span> with the value <span class=\"name\">\"As Dict\"</span> (case-insensitive), a list of dictionaries in the form of <code>[{\"xpos\": int, \"ypos\": int}]</code> is returned.</p>\n<p>If <span class=\"name\">ignore_case</span> is set to <span class=\"name\">True</span>, then the search is done case-insensitively.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${positions}</td>\n<td>Get String Positions Only Before</td>\n<td>11</td>\n<td>20</td>\n<td>Abc</td>\n<td></td>\n<td># Returns a list like [(11, 19)]</td>\n</tr>\n<tr>\n<td>${positions}</td>\n<td>Get String Positions Only Before</td>\n<td>11</td>\n<td>20</td>\n<td>Abc</td>\n<td>As Dict</td>\n<td># Returns a list like [{\"ypos\": 11, \"xpos\": 19}]</td>\n</tr>\n</table>", "shortdoc": "Returns a list of tuples of ypos and xpos for the position where the `string` was found, but only before the specified ypos/xpos coordinates. If it is not found an empty list is returned.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\read_write.py", "lineno": 90}, {"name": "Move Cursor To", "args": [{"name": "ypos", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "ypos: int"}, {"name": "xpos", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "xpos: int"}], "doc": "<p>Moves the cursor to the specified ypos/xpos position. The coordinates are 1 based. This keyword raises an error if the specified values exceed the Mainframe screen dimensions.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Move Cursor To</td>\n<td>1</td>\n<td>5</td>\n</tr>\n</table>", "shortdoc": "Moves the cursor to the specified ypos/xpos position. The coordinates are 1 based. This keyword raises an error if the specified values exceed the Mainframe screen dimensions.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\commands.py", "lineno": 103}, {"name": "Move Next Field", "args": [], "doc": "<p>Move the cursor to the next input field. Equivalent to pressing the Tab key.</p>", "shortdoc": "Move the cursor to the next input field. Equivalent to pressing the Tab key.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\commands.py", "lineno": 64}, {"name": "Move Previous Field", "args": [], "doc": "<p>Move the cursor to the previous input field. Equivalent to pressing the Shift+Tab keys.</p>", "shortdoc": "Move the cursor to the previous input field. Equivalent to pressing the Shift+Tab keys.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\commands.py", "lineno": 71}, {"name": "Open Connection", "args": [{"name": "host", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "host: str"}, {"name": "LU", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "LU: str | None = None"}, {"name": "port", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": "23", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "port: int = 23"}, {"name": "extra_args", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "List", "typedoc": "list", "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}], "union": false}, {"name": "PathLike", "typedoc": "Path", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["List[str]", "PathLike", "None"], "typedocs": {"List": "list", "str": "string", "PathLike": "Path", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "extra_args: List[str] | PathLike | None = None"}, {"name": "alias", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "alias: str | None = None"}], "doc": "<p>Create a connection to an IBM3270 mainframe with the default port 23. To establish a connection, only the hostname is required. Optional parameters include logical unit name (LU) and port.</p>\n<p>Additional configuration data can be provided through the <span class=\"name\">extra_args</span> parameter. <span class=\"name\">extra_args</span> accepts either a list or a path to a file containing <a href=\"https://x3270.miraheze.org/wiki/Category:Command-line_options\">x3270 command line options</a>.</p>\n<p>Entries in the argfile can be on one line or multiple lines. Lines starting with \"#\" are considered comments. Arguments containing whitespace must be enclosed in single or double quotes.</p>\n<pre>\n# example_argfile_oneline.txt\n-accepthostname myhost.com\n</pre>\n<pre>\n# example_argfile_multiline.txt\n-xrm \"wc3270.acceptHostname: myhost.com\"\n# this is a comment\n-charset french\n-port 992\n</pre>\n<p>Please ensure that the arguments provided are available for your specific x3270 application and version. Refer to the <a href=\"https://x3270.miraheze.org/wiki/Wc3270/Command-line_options\">wc3270 command line options</a> for a subset of available options.</p>\n<p>Note: If you specify the port with the <span class=\"name\">-port</span> command-line option in <span class=\"name\">extra_args</span> (or use the -xrm resource command for it), it will take precedence over the <span class=\"name\">port</span> argument provided in the <a href=\"#Open%20Connection\" class=\"name\">Open Connection</a> keyword.</p>\n<p>This keyword returns the index of the opened connection, which can be used to reference the connection when switching between connections using the <a href=\"#Switch%20Connection\" class=\"name\">Switch Connection</a> keyword. For more information on opening and switching between multiple connections, please refer to the <a href=\"#Concurrent%20Connections\" class=\"name\">Concurrent Connections</a> section.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Open Connection</td>\n<td>Hostname</td>\n<td></td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>Open Connection</td>\n<td>Hostname</td>\n<td>LU=LUname</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>Open Connection</td>\n<td>Hostname</td>\n<td>port=992</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>@{extra_args}</td>\n<td>Create List</td>\n<td>-accepthostname</td>\n<td>myhost.com</td>\n<td>-cafile</td>\n<td>${CURDIR}/cafile.crt</td>\n</tr>\n<tr>\n<td>Append To List</td>\n<td>${extra_args}</td>\n<td>-port</td>\n<td>992</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>Open Connection</td>\n<td>Hostname</td>\n<td>extra_args=${extra_args}</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>Open Connection</td>\n<td>Hostname</td>\n<td>extra_args=${CURDIR}/argfile.txt</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>Open Connection</td>\n<td>Hostname</td>\n<td>alias=my_first_connection</td>\n<td></td>\n<td></td>\n<td></td>\n</tr>\n</table>", "shortdoc": "Create a connection to an IBM3270 mainframe with the default port 23. To establish a connection, only the hostname is required. Optional parameters include logical unit name (LU) and port.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\connection.py", "lineno": 16}, {"name": "Open Connection From Session File", "args": [{"name": "session_file", "type": {"name": "PathLike", "typedoc": "Path", "nested": [], "union": false}, "types": ["PathLike"], "typedocs": {"PathLike": "Path"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "session_file: PathLike"}, {"name": "alias", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "alias: str | None = None"}], "doc": "<p>Create a connection to an IBM3270 mainframe using a <a href=\"https://x3270.miraheze.org/wiki/Session_file\">session file</a>.</p>\n<p>The session file contains <a href=\"https://x3270.miraheze.org/wiki/Category:Resources\">resources (settings)</a> for a specific host session.</p>\n<p>The only mandatory setting required to establish the connection is the <a href=\"https://x3270.miraheze.org/wiki/Hostname_resource\">hostname resource</a>.</p>\n<p>This keyword is an alternative to <a href=\"#Open%20Connection\" class=\"name\">Open Connection</a>. Please note that the Robot-Framework-Mainframe-3270-Library currently only supports model \"2\". Specifying any other model will result in a failure.</p>\n<p>For more information on session file syntax and detailed examples, please consult the <a href=\"https://x3270.miraheze.org/wiki/Session_file\">x3270 wiki</a>.</p>\n<p>This keyword returns the index of the opened connection, which can be used to reference the connection when switching between connections using the <a href=\"#Switch%20Connection\" class=\"name\">Switch Connection</a> keyword. For more information on opening and switching between multiple connections, please refer to the <a href=\"#Concurrent%20Connections\" class=\"name\">Concurrent Connections</a> section.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Open Connection From Session File</td>\n<td>${CURDIR}/session.wc3270</td>\n</tr>\n</table>\n<p>where the content of <span class=\"name\">session.wc3270</span> is:</p>\n<pre>\nwc3270.hostname: myhost.com:23\nwc3270.model: 2\n</pre>", "shortdoc": "Create a connection to an IBM3270 mainframe using a [https://x3270.miraheze.org/wiki/Session_file|session file].", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\connection.py", "lineno": 120}, {"name": "Page Should Contain All Strings", "args": [{"name": "list_string", "type": {"name": "List", "typedoc": "list", "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}], "union": false}, "types": ["List[str]"], "typedocs": {"List": "list", "str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "list_string: List[str]"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}, {"name": "error_message", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error_message: str | None = None"}], "doc": "<p>Assert that all the strings in a given list exist on the mainframe screen.</p>\n<p>The assertion is case-sensitive. If you want it to be case-insensitive, you can pass the argument ignore_case=True.</p>\n<p>You can change the exception message by setting a custom string to error_message.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Page Should Contain All Strings</td>\n<td>${list_of_string}</td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Contain All Strings</td>\n<td>${list_of_string}</td>\n<td>ignore_case=True</td>\n</tr>\n<tr>\n<td>Page Should Contain All Strings</td>\n<td>${list_of_string}</td>\n<td>error_message=New error message</td>\n</tr>\n</table>", "shortdoc": "Assert that all the strings in a given list exist on the mainframe screen.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 117}, {"name": "Page Should Contain Any String", "args": [{"name": "list_string", "type": {"name": "List", "typedoc": "list", "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}], "union": false}, "types": ["List[str]"], "typedocs": {"List": "list", "str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "list_string: List[str]"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}, {"name": "error_message", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error_message: str | None = None"}], "doc": "<p>Assert that one of the strings in a given list exists on the mainframe screen.</p>\n<p>The assertion is case-sensitive. If you want it to be case-insensitive, you can pass the argument ignore_case=True.</p>\n<p>You can change the exception message by setting a custom string to error_message.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Page Should Contain Any String</td>\n<td>${list_of_string}</td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Contain Any String</td>\n<td>${list_of_string}</td>\n<td>ignore_case=True</td>\n</tr>\n<tr>\n<td>Page Should Contain Any String</td>\n<td>${list_of_string}</td>\n<td>error_message=New error message</td>\n</tr>\n</table>", "shortdoc": "Assert that one of the strings in a given list exists on the mainframe screen.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 64}, {"name": "Page Should Contain Match", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}, {"name": "error_message", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error_message: str | None = None"}], "doc": "<p>Assert that the text displayed on the mainframe screen matches the given pattern.</p>\n<p>Pattern matching is similar to matching files in a shell, and it is always case-sensitive. In the pattern, * matches anything and ? matches any single character.</p>\n<p>Note that for this keyword the entire screen is considered a string. So if you want to search for the string \"something\" and it is somewhere other than at the beginning or end of the screen, it should be reported as follows: <b>*something*</b></p>\n<p>The assertion is case-sensitive. If you want it to be case-insensitive, you can pass the argument ignore_case=True.</p>\n<p>You can change the exception message by setting a custom string to error_message.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Page Should Contain Match</td>\n<td><b>*something*</b></td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Contain Match</td>\n<td><b>*so???hing*</b></td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Contain Match</td>\n<td><b>*someTHING*</b></td>\n<td>ignore_case=True</td>\n</tr>\n<tr>\n<td>Page Should Contain Match</td>\n<td><b>*something*</b></td>\n<td>error_message=New error message</td>\n</tr>\n</table>", "shortdoc": "Assert that the text displayed on the mainframe screen matches the given pattern.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 229}, {"name": "Page Should Contain String", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}, {"name": "error_message", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error_message: str | None = None"}], "doc": "<p>Assert that a given string exists on the mainframe screen.</p>\n<p>The assertion is case-sensitive. If you want it to be case-insensitive, you can pass the argument ignore_case=True.</p>\n<p>You can change the exception message by setting a custom string to error_message.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Page Should Contain String</td>\n<td>something</td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Contain String</td>\n<td>someTHING</td>\n<td>ignore_case=True</td>\n</tr>\n<tr>\n<td>Page Should Contain String</td>\n<td>something</td>\n<td>error_message=New error message</td>\n</tr>\n</table>", "shortdoc": "Assert that a given string exists on the mainframe screen.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 13}, {"name": "Page Should Contain String X Times", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}, {"name": "number", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "number: int"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}, {"name": "error_message", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error_message: str | None = None"}], "doc": "<p>Asserts that the entered string appears the desired number of times on the mainframe screen.</p>\n<p>The assertion is case-sensitive. If you want it to be case-insensitive, you can pass the argument ignore_case=True.</p>\n<p>You can change the exception message by setting a custom string to error_message.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Page Should Contain String X Times</td>\n<td>something</td>\n<td>3</td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Contain String X Times</td>\n<td>someTHING</td>\n<td>3</td>\n<td>ignore_case=True</td>\n</tr>\n<tr>\n<td>Page Should Contain String X Times</td>\n<td>something</td>\n<td>3</td>\n<td>error_message=New error message</td>\n</tr>\n</table>", "shortdoc": "Asserts that the entered string appears the desired number of times on the mainframe screen.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 168}, {"name": "Page Should Match Regex", "args": [{"name": "regex_pattern", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "regex_pattern: str"}], "doc": "<p>Fails if string does not match pattern as a regular expression. Regular expression check is implemented using the Python <a href=\"https://docs.python.org/2/library/re.html\">re module</a>. Python's regular expression syntax is derived from Perl, and it is thus also very similar to the syntax used, for example, in Java, Ruby and .NET.</p>\n<p>Backslash is an escape character in the test data, and possible backslashes in the pattern must thus be escaped with another backslash (e.g. \\\\d\\\\w+).</p>", "shortdoc": "Fails if string does not match pattern as a regular expression. Regular expression check is implemented using the Python [https://docs.python.org/2/library/re.html|re module]. Python's regular expression syntax is derived from Perl, and it is thus also very similar to the syntax used, for example, in Java, Ruby and .NET.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 201}, {"name": "Page Should Not Contain All Strings", "args": [{"name": "list_string", "type": {"name": "List", "typedoc": "list", "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}], "union": false}, "types": ["List[str]"], "typedocs": {"List": "list", "str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "list_string: List[str]"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}, {"name": "error_message", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error_message: str | None = None"}], "doc": "<p>Fails if one of the strings in a given list exists on the mainframe screen. If one of the string are found, the keyword will raise an exception.</p>\n<p>The assertion is case-sensitive. If you want it to be case-insensitive, you can pass the argument ignore_case=True.</p>\n<p>You can change the exception message by setting a custom string to error_message.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Page Should Not Contain All Strings</td>\n<td>${list_of_string}</td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Not Contain All Strings</td>\n<td>${list_of_string}</td>\n<td>ignore_case=True</td>\n</tr>\n<tr>\n<td>Page Should Not Contain All Strings</td>\n<td>${list_of_string}</td>\n<td>error_message=New error message</td>\n</tr>\n</table>", "shortdoc": "Fails if one of the strings in a given list exists on the mainframe screen. If one of the string are found, the keyword will raise an exception.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 138}, {"name": "Page Should Not Contain Any String", "args": [{"name": "list_string", "type": {"name": "List", "typedoc": "list", "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}], "union": false}, "types": ["List[str]"], "typedocs": {"List": "list", "str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "list_string: List[str]"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}, {"name": "error_message", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error_message: str | None = None"}], "doc": "<p>Assert that none of the strings in a given list exists on the mainframe screen. If one or more of the string are found, the keyword will raise an exception.</p>\n<p>The assertion is case-sensitive. If you want it to be case-insensitive, you can pass the argument ignore_case=True.</p>\n<p>You can change the exception message by setting a custom string to error_message.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Page Should Not Contain Any Strings</td>\n<td>${list_of_string}</td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Not Contain Any Strings</td>\n<td>${list_of_string}</td>\n<td>ignore_case=True</td>\n</tr>\n<tr>\n<td>Page Should Not Contain Any Strings</td>\n<td>${list_of_string}</td>\n<td>error_message=New error message</td>\n</tr>\n</table>", "shortdoc": "Assert that none of the strings in a given list exists on the mainframe screen. If one or more of the string are found, the keyword will raise an exception.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 95}, {"name": "Page Should Not Contain Match", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}, {"name": "error_message", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error_message: str | None = None"}], "doc": "<p>Assert that the text displayed on the mainframe screen does NOT match the given pattern.</p>\n<p>Pattern matching is similar to matching files in a shell, and it is always case-sensitive. In the pattern, * matches anything and ? matches any single character.</p>\n<p>Note that for this keyword the entire screen is considered a string. So if you want to search for the string \"something\" and it is somewhere other than at the beginning or end of the screen, it should be reported as follows: <b>*something*</b></p>\n<p>The assertion is case-sensitive. If you want it to be case-insensitive, you can pass the argument ignore_case=True.</p>\n<p>You can change the exception message by setting a custom string to error_message.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Page Should Not Contain Match</td>\n<td><b>*something*</b></td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Not Contain Match</td>\n<td><b>*so???hing*</b></td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Not Contain Match</td>\n<td><b>*someTHING*</b></td>\n<td>ignore_case=True</td>\n</tr>\n<tr>\n<td>Page Should Not Contain Match</td>\n<td><b>*something*</b></td>\n<td>error_message=New error message</td>\n</tr>\n</table>", "shortdoc": "Assert that the text displayed on the mainframe screen does NOT match the given pattern.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 265}, {"name": "Page Should Not Contain String", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}, {"name": "ignore_case", "type": {"name": "bool", "typedoc": "boolean", "nested": [], "union": false}, "types": ["bool"], "typedocs": {"bool": "boolean"}, "defaultValue": "False", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "ignore_case: bool = False"}, {"name": "error_message", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "None", "typedoc": "None", "nested": [], "union": false}], "union": true}, "types": ["str", "None"], "typedocs": {"str": "string", "None": "None"}, "defaultValue": "None", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "error_message: str | None = None"}], "doc": "<p>Assert that a given string does NOT exist on the mainframe screen.</p>\n<p>The assertion is case-sensitive. If you want it to be case-insensitive, you can pass the argument ignore_case=True.</p>\n<p>You can change the exception message by setting a custom string to error_message.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Page Should Not Contain String</td>\n<td>something</td>\n<td></td>\n</tr>\n<tr>\n<td>Page Should Not Contain String</td>\n<td>someTHING</td>\n<td>ignore_case=True</td>\n</tr>\n<tr>\n<td>Page Should Not Contain String</td>\n<td>something</td>\n<td>error_message=New error message</td>\n</tr>\n</table>", "shortdoc": "Assert that a given string does NOT exist on the mainframe screen.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 39}, {"name": "Page Should Not Match Regex", "args": [{"name": "regex_pattern", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "regex_pattern: str"}], "doc": "<p>Fails if string does match pattern as a regular expression. Regular expression check is implemented using the Python <a href=\"https://docs.python.org/2/library/re.html\">re module</a>. Python's regular expression syntax is derived from Perl, and it is thus also very similar to the syntax used, for example, in Java, Ruby and .NET.</p>\n<p>Backslash is an escape character in the test data, and possible backslashes in the pattern must thus be escaped with another backslash (e.g. \\\\d\\\\w+).</p>", "shortdoc": "Fails if string does match pattern as a regular expression. Regular expression check is implemented using the Python [https://docs.python.org/2/library/re.html|re module]. Python's regular expression syntax is derived from Perl, and it is thus also very similar to the syntax used, for example, in Java, Ruby and .NET.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\assertions.py", "lineno": 215}, {"name": "Read", "args": [{"name": "ypos", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "ypos: int"}, {"name": "xpos", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "xpos: int"}, {"name": "length", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "length: int"}], "doc": "<p>Get a string of <code>length</code> at screen coordinates <code>ypos</code> / <code>xpos</code>.</p>\n<p>Coordinates are 1 based, as listed in the status area of the terminal.</p>\n<p>Example for read a string in the position y=8 / x=10 of a length 15:</p>\n<table border=\"1\">\n<tr>\n<td>${value}</td>\n<td>Read</td>\n<td>8</td>\n<td>10</td>\n<td>15</td>\n</tr>\n</table>", "shortdoc": "Get a string of ``length`` at screen coordinates ``ypos`` / ``xpos``.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\read_write.py", "lineno": 12}, {"name": "Read All Screen", "args": [], "doc": "<p>Read the current screen and returns all content in one string.</p>\n<p>This is useful if your automation scripts should take different routes depending on a message shown on the screen.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${screen}</td>\n<td>Read All Screen</td>\n</tr>\n<tr>\n<td>IF</td>\n<td>'certain text' in '''${screen}'''</td>\n</tr>\n<tr>\n<td></td>\n<td>Do Something</td>\n</tr>\n<tr>\n<td>ELSE</td>\n<td></td>\n</tr>\n<tr>\n<td></td>\n<td>Do Something Else</td>\n</tr>\n<tr>\n<td>END</td>\n<td></td>\n</tr>\n</table>", "shortdoc": "Read the current screen and returns all content in one string.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\read_write.py", "lineno": 30}, {"name": "Read From Current Position", "args": [{"name": "length", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "length: int"}], "doc": "<p>Similar to <a href=\"#Read\" class=\"name\">Read</a>, however this keyword only takes <span class=\"name\">length</span> as an argument to get a string of length from the current cursor position.</p>", "shortdoc": "Similar to `Read`, however this keyword only takes `length` as an argument to get a string of length from the current cursor position.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\read_write.py", "lineno": 23}, {"name": "Register Run On Failure Keyword", "args": [{"name": "keyword", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "keyword: str"}], "doc": "<p>This keyword lets you change the keyword that runs on failure during test execution. The default is <a href=\"#Take%20Screenshot\" class=\"name\">Take Screenshot</a>, which is set on library import.</p>\n<p>You can set <code>None</code> to this keyword, if you do not want to run any keyword on failure.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Register Run On Failure Keyword</td>\n<td>None</td>\n<td># no keyword is run on failure</td>\n</tr>\n<tr>\n<td>Register Run On Failure Keyword</td>\n<td>Custom Keyword</td>\n<td># Custom Keyword is run on failure</td>\n</tr>\n</table>", "shortdoc": "This keyword lets you change the keyword that runs on failure during test execution. The default is `Take Screenshot`, which is set on library import.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\__init__.py", "lineno": 179}, {"name": "Send Enter", "args": [], "doc": "<p>Send an Enter to the screen.</p>", "shortdoc": "Send an Enter to the screen.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\commands.py", "lineno": 56}, {"name": "Send PF", "args": [{"name": "pf", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "pf: str"}], "doc": "<p>Send a Program Function to the screen.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Send PF</td>\n<td>3</td>\n</tr>\n</table>", "shortdoc": "Send a Program Function to the screen.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\commands.py", "lineno": 78}, {"name": "Set Screenshot Folder", "args": [{"name": "path", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "path: str"}], "doc": "<p>Set a folder to keep the html files generated by the <a href=\"#Take%20Screenshot\" class=\"name\">Take Screenshot</a> keyword.</p>\n<p>Note that the folder needs to exist before running your automation scripts. Else the images will be stored in the <code>${OUTPUT DIR}</code> set by robotframework.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Set Screenshot Folder</td>\n<td>C:\\\\Temp\\\\Images</td>\n</tr>\n</table>", "shortdoc": "Set a folder to keep the html files generated by the `Take Screenshot` keyword.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\screenshot.py", "lineno": 12}, {"name": "Switch Connection", "args": [{"name": "alias_or_index", "type": {"name": "Union", "typedoc": null, "nested": [{"name": "str", "typedoc": "string", "nested": [], "union": false}, {"name": "int", "typedoc": "integer", "nested": [], "union": false}], "union": true}, "types": ["str", "int"], "typedocs": {"str": "string", "int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "alias_or_index: str | int"}], "doc": "<p>Switch the current connection to the one identified by index or alias. Indices are returned from and aliases can be optionally provided to the <a href=\"#Open%20Connection\" class=\"name\">Open Connection</a> and <a href=\"#Open%20Connection%20From%20Session%20File\" class=\"name\">Open Connection From Session File</a> keywords.</p>\n<p>For more information on opening and switching between multiple connections, please refer to the <a href=\"#Concurrent%20Connections\" class=\"name\">Concurrent Connections</a> section.</p>\n<p>Examples:</p>\n<table border=\"1\">\n<tr>\n<td>Open Connection</td>\n<td>Hostname</td>\n<td>alias=first</td>\n<td></td>\n</tr>\n<tr>\n<td>Open Connection</td>\n<td>Hostname</td>\n<td>alias=second</td>\n<td># second is now the current connection</td>\n</tr>\n<tr>\n<td>Switch Connection</td>\n<td>first</td>\n<td></td>\n<td># first is now the current connection</td>\n</tr>\n</table>", "shortdoc": "Switch the current connection to the one identified by index or alias. Indices are returned from and aliases can be optionally provided to the `Open Connection` and `Open Connection From Session File` keywords.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\connection.py", "lineno": 185}, {"name": "Take Screenshot", "args": [{"name": "height", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": "410", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "height: int = 410"}, {"name": "width", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": "670", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "width: int = 670"}, {"name": "filename_prefix", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": "screenshot", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "filename_prefix: str = screenshot"}], "doc": "<p>Generate a screenshot of the IBM 3270 Mainframe in a html format. The default folder is the log folder of RobotFramework, if you want change see the <a href=\"#Set%20Screenshot%20Folder\" class=\"name\">Set Screenshot Folder</a>.</p>\n<p>The Screenshot is printed in an iframe log, with the values of height=410 and width=670, you can change these values by passing them to the keyword.</p>\n<p>The file name prefix can be set, the default is \"screenshot\".</p>\n<p>The full file path is returned.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>${filepath}</td>\n<td>Take Screenshot</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>${filepath}</td>\n<td>Take Screenshot</td>\n<td>height=500</td>\n<td>width=700</td>\n</tr>\n<tr>\n<td>Take Screenshot</td>\n<td>height=500</td>\n<td>width=700</td>\n<td></td>\n</tr>\n<tr>\n<td>Take Screenshot</td>\n<td>filename_prefix=MyScreenshot</td>\n<td></td>\n<td></td>\n</tr>\n</table>", "shortdoc": "Generate a screenshot of the IBM 3270 Mainframe in a html format. The default folder is the log folder of RobotFramework, if you want change see the `Set Screenshot Folder`.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\screenshot.py", "lineno": 28}, {"name": "Wait Field Detected", "args": [], "doc": "<p>Wait until the screen is ready, the cursor has been positioned on a modifiable field, and the keyboard is unlocked.</p>\n<p>Sometimes the server will \"unlock\" the keyboard but the screen will not yet be ready.  In that case, an attempt to read or write to the screen will result in a 'E' keyboard status because we tried to read from a screen that is not ready yet.</p>\n<p>Using this method tells the client to wait until a field is detected and the cursor has been positioned on it.</p>", "shortdoc": "Wait until the screen is ready, the cursor has been positioned on a modifiable field, and the keyboard is unlocked.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\wait_and_timeout.py", "lineno": 65}, {"name": "Wait Until String", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}, {"name": "timeout", "type": {"name": "timedelta", "typedoc": "timedelta", "nested": [], "union": false}, "types": ["timedelta"], "typedocs": {"timedelta": "timedelta"}, "defaultValue": "0:00:05", "kind": "POSITIONAL_OR_NAMED", "required": false, "repr": "timeout: timedelta = 0:00:05"}], "doc": "<p>Wait until a string exists on the mainframe screen to perform the next step. If the string does not appear in 5 seconds, the keyword will raise an exception. You can define a different timeout.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Wait Until String</td>\n<td>something</td>\n<td></td>\n</tr>\n<tr>\n<td>Wait Until String</td>\n<td>something</td>\n<td>10</td>\n</tr>\n<tr>\n<td>Wait Until String</td>\n<td>something</td>\n<td>15 s</td>\n</tr>\n<tr>\n<td>Wait Until String</td>\n<td>something</td>\n<td>0:00:15</td>\n</tr>\n</table>", "shortdoc": "Wait until a string exists on the mainframe screen to perform the next step. If the string does not appear in 5 seconds, the keyword will raise an exception. You can define a different timeout.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\wait_and_timeout.py", "lineno": 80}, {"name": "Write", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}], "doc": "<p>Send a string <b>and Enter</b> to the screen at the current cursor location.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Write</td>\n<td>something</td>\n</tr>\n</table>", "shortdoc": "Send a string *and Enter* to the screen at the current cursor location.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\read_write.py", "lineno": 116}, {"name": "Write Bare", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}], "doc": "<p>Send only the string to the screen at the current cursor location.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Write Bare</td>\n<td>something</td>\n</tr>\n</table>", "shortdoc": "Send only the string to the screen at the current cursor location.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\read_write.py", "lineno": 125}, {"name": "Write Bare In Position", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}, {"name": "ypos", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "ypos: int"}, {"name": "xpos", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "xpos: int"}], "doc": "<p>Send only the string to the screen at screen coordinates <code>ypos</code> / <code>xpos</code>.</p>\n<p>Coordinates are 1 based, as listed in the status area of the terminal.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Write Bare in Position</td>\n<td>something</td>\n<td>9</td>\n<td>11</td>\n</tr>\n</table>", "shortdoc": "Send only the string to the screen at screen coordinates ``ypos`` / ``xpos``.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\read_write.py", "lineno": 146}, {"name": "Write In Position", "args": [{"name": "txt", "type": {"name": "str", "typedoc": "string", "nested": [], "union": false}, "types": ["str"], "typedocs": {"str": "string"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "txt: str"}, {"name": "ypos", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "ypos: int"}, {"name": "xpos", "type": {"name": "int", "typedoc": "integer", "nested": [], "union": false}, "types": ["int"], "typedocs": {"int": "integer"}, "defaultValue": null, "kind": "POSITIONAL_OR_NAMED", "required": true, "repr": "xpos: int"}], "doc": "<p>Send a string <b>and Enter</b> to the screen at screen coordinates <code>ypos</code> / <code>xpos</code>.</p>\n<p>Coordinates are 1 based, as listed in the status area of the terminal.</p>\n<p>Example:</p>\n<table border=\"1\">\n<tr>\n<td>Write in Position</td>\n<td>something</td>\n<td>9</td>\n<td>11</td>\n</tr>\n</table>", "shortdoc": "Send a string *and Enter* to the screen at screen coordinates ``ypos`` / ``xpos``.", "tags": [], "source": "C:\\Robot\\Robot-Framework-Mainframe-3270-Library\\Mainframe3270\\keywords\\read_write.py", "lineno": 134}], "dataTypes": {"enums": [{"type": "Enum", "name": "ResultMode", "doc": "<p>An enumeration.</p>", "members": [{"name": "As_Tuple", "value": "1"}, {"name": "As_Dict", "value": "2"}]}], "typedDicts": []}, "typedocs": [{"type": "Standard", "name": "boolean", "doc": "<p>Strings <code>TRUE</code>, <code>YES</code>, <code>ON</code> and <code>1</code> are converted to Boolean <code>True</code>, the empty string as well as strings <code>FALSE</code>, <code>NO</code>, <code>OFF</code> and <code>0</code> are converted to Boolean <code>False</code>, and the string <code>NONE</code> is converted to the Python <code>None</code> object. Other strings and other accepted values are passed as-is, allowing keywords to handle them specially if needed. All string comparisons are case-insensitive.</p>\n<p>Examples: <code>TRUE</code> (converted to <code>True</code>), <code>off</code> (converted to <code>False</code>), <code>example</code> (used as-is)</p>", "usages": ["__init__", "Get String Positions", "Get String Positions Only After", "Get String Positions Only Before", "Page Should Contain All Strings", "Page Should Contain Any String", "Page Should Contain Match", "Page Should Contain String", "Page Should Contain String X Times", "Page Should Not Contain All Strings", "Page Should Not Contain Any String", "Page Should Not Contain Match", "Page Should Not Contain String"], "accepts": ["string", "integer", "float", "None"]}, {"type": "Standard", "name": "integer", "doc": "<p>Conversion is done using Python's <a href=\"https://docs.python.org/library/functions.html#int\">int</a> built-in function. Floating point numbers are accepted only if they can be represented as integers exactly. For example, <code>1.0</code> is accepted and <code>1.1</code> is not.</p>\n<p>Starting from RF 4.1, it is possible to use hexadecimal, octal and binary numbers by prefixing values with <code>0x</code>, <code>0o</code> and <code>0b</code>, respectively.</p>\n<p>Starting from RF 4.1, spaces and underscores can be used as visual separators for digit grouping purposes.</p>\n<p>Examples: <code>42</code>, <code>-1</code>, <code>0b1010</code>, <code>10 000 000</code>, <code>0xBAD_C0FFEE</code></p>", "usages": ["Delete Char", "Delete Field", "Get String Positions Only After", "Get String Positions Only Before", "Move Cursor To", "Open Connection", "Page Should Contain String X Times", "Read", "Read From Current Position", "Switch Connection", "Take Screenshot", "Write Bare In Position", "Write In Position"], "accepts": ["string", "float"]}, {"type": "Standard", "name": "list", "doc": "<p>Strings must be Python <a href=\"https://docs.python.org/library/stdtypes.html#list\">list</a> literals. They are converted to actual lists using the <a href=\"https://docs.python.org/library/ast.html#ast.literal_eval\">ast.literal_eval</a> function. They can contain any values <code>ast.literal_eval</code> supports, including lists and other containers.</p>\n<p>If the type has nested types like <code>list[int]</code>, items are converted to those types automatically. This in new in Robot Framework 6.0.</p>\n<p>Examples: <code>['one', 'two']</code>, <code>[('one', 1), ('two', 2)]</code></p>", "usages": ["Open Connection", "Page Should Contain All Strings", "Page Should Contain Any String", "Page Should Not Contain All Strings", "Page Should Not Contain Any String"], "accepts": ["string", "Sequence"]}, {"type": "Standard", "name": "None", "doc": "<p>String <code>NONE</code> (case-insensitive) is converted to Python <code>None</code> object. Other values cause an error.</p>", "usages": ["Delete Char", "Delete Field", "Open Connection", "Open Connection From Session File", "Page Should Contain All Strings", "Page Should Contain Any String", "Page Should Contain Match", "Page Should Contain String", "Page Should Contain String X Times", "Page Should Not Contain All Strings", "Page Should Not Contain Any String", "Page Should Not Contain Match", "Page Should Not Contain String"], "accepts": ["string"]}, {"type": "Standard", "name": "Path", "doc": "<p>Strings are converted <a href=\"https://docs.python.org/library/pathlib.html\">Path</a> objects. On Windows <code>/</code> is converted to <code>\\</code> automatically.</p>\n<p>Examples: <code>/tmp/absolute/path</code>, <code>relative/path/to/file.ext</code>, <code>name.txt</code></p>", "usages": ["Open Connection", "Open Connection From Session File"], "accepts": ["string", "PurePath"]}, {"type": "Enum", "name": "ResultMode", "doc": "<p>An enumeration.</p>", "usages": ["Get Current Position", "Get String Positions", "Get String Positions Only After", "Get String Positions Only Before"], "accepts": ["string"], "members": [{"name": "As_Tuple", "value": "1"}, {"name": "As_Dict", "value": "2"}]}, {"type": "Standard", "name": "string", "doc": "<p>All arguments are converted to Unicode strings.</p>", "usages": ["__init__", "Execute Command", "Get String Positions", "Get String Positions Only After", "Get String Positions Only Before", "Open Connection", "Open Connection From Session File", "Page Should Contain All Strings", "Page Should Contain Any String", "Page Should Contain Match", "Page Should Contain String", "Page Should Contain String X Times", "Page Should Match Regex", "Page Should Not Contain All Strings", "Page Should Not Contain Any String", "Page Should Not Contain Match", "Page Should Not Contain String", "Page Should Not Match Regex", "Register Run On Failure Keyword", "Send PF", "Set Screenshot Folder", "Switch Connection", "Take Screenshot", "Wait Until String", "Write", "Write Bare", "Write Bare In Position", "Write In Position"], "accepts": ["Any"]}, {"type": "Standard", "name": "timedelta", "doc": "<p>Strings are expected to represent a time interval in one of the time formats Robot Framework supports:</p>\n<ul>\n<li>a number representing seconds like <code>42</code> or <code>10.5</code></li>\n<li>a time string like <code>1 hour 2 seconds</code> or <code>1h 2s</code></li>\n<li>a \"timer\" string like <code>01:02</code> (1 minute 2 seconds) or <code>01:00:03</code> (1 hour 3 seconds)</li>\n</ul>\n<p>Integers and floats are considered to be seconds.</p>\n<p>See the <a href=\"https://robotframework.org/robotframework/\">Robot Framework User Guide</a> for more details about the supported time formats.</p>", "usages": ["__init__", "Change Timeout", "Change Wait Time", "Change Wait Time After Write", "Wait Until String"], "accepts": ["string", "integer", "float"]}]}
 </script>
 <title></title>
 </head>
diff --git a/doc/Mainframe3270.xml b/doc/Mainframe3270.xml
index ec606e6..600adba 100644
--- a/doc/Mainframe3270.xml
+++ b/doc/Mainframe3270.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<keywordspec name="Mainframe3270" type="LIBRARY" format="ROBOT" scope="SUITE" generated="2023-06-15T16:58:00+00:00" specversion="5" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\__init__.py" lineno="24">
+<keywordspec name="Mainframe3270" type="LIBRARY" format="ROBOT" scope="SUITE" generated="2023-12-17T06:36:43+00:00" specversion="5" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\__init__.py" lineno="24">
 <version>4.0</version>
 <doc>Mainframe3270 is a library for Robot Framework based on the [https://pypi.org/project/py3270/|py3270 project],
 a Python interface to x3270, an IBM 3270 terminal emulator. It provides an API to a x3270 or s3270 subprocess.
@@ -227,7 +227,7 @@ Example:
 <doc>Close the current connection.</doc>
 <shortdoc>Close the current connection.</shortdoc>
 </kw>
-<kw name="Delete Char" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\commands.py" lineno="24">
+<kw name="Delete Char" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\commands.py" lineno="25">
 <arguments repr="ypos: int | None = None, xpos: int | None = None">
 <arg kind="POSITIONAL_OR_NAMED" required="false" repr="ypos: int | None = None">
 <name>ypos</name>
@@ -250,7 +250,7 @@ Example:
     | Delete Char | ypos=9 | xpos=25 |</doc>
 <shortdoc>Delete the character under the cursor. If you want to delete a character that is in another position, simply pass the coordinates ``ypos`` / ``xpos``.</shortdoc>
 </kw>
-<kw name="Delete Field" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\commands.py" lineno="39">
+<kw name="Delete Field" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\commands.py" lineno="40">
 <arguments repr="ypos: int | None = None, xpos: int | None = None">
 <arg kind="POSITIONAL_OR_NAMED" required="false" repr="ypos: int | None = None">
 <name>ypos</name>
@@ -274,7 +274,7 @@ Example:
     | Delete Field | ypos=12 | xpos=6 |</doc>
 <shortdoc>Delete the entire content of a field at the current cursor location and positions the cursor at beginning of field. If you want to delete a field that is in another position, simply pass the coordinates ``ypos`` / ``xpos`` of any part in the field.</shortdoc>
 </kw>
-<kw name="Execute Command" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\commands.py" lineno="11">
+<kw name="Execute Command" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\commands.py" lineno="12">
 <arguments repr="cmd: str">
 <arg kind="POSITIONAL_OR_NAMED" required="true" repr="cmd: str">
 <name>cmd</name>
@@ -290,13 +290,155 @@ Example:
     | Execute Command | PF(1) |</doc>
 <shortdoc>Execute a [http://x3270.bgp.nu/wc3270-man.html#Actions|x3270 command].</shortdoc>
 </kw>
-<kw name="Move Next Field" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\commands.py" lineno="63">
+<kw name="Get Current Position" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\commands.py" lineno="88">
+<arguments repr="mode: ResultMode = As_Tuple">
+<arg kind="POSITIONAL_OR_NAMED" required="false" repr="mode: ResultMode = As_Tuple">
+<name>mode</name>
+<type name="ResultMode" typedoc="ResultMode">ResultMode</type>
+<default>As_Tuple</default>
+</arg>
+</arguments>
+<doc>Returns the current cursor position. The coordinates are 1 based.
+
+By default, this keyword returns a tuple of integers. However, if you specify the `mode` with the value
+``"As Dict"`` (case-insensitive), a dictionary in the form of ``{"xpos": int, "ypos": int}`` is returned.
+
+Example:
+    | Get Cursor Position |         | # Returns a position like (1, 1) |
+    | Get Cursor Position | As Dict | # Returns a position like {"xpos": 1, "ypos": 1} |</doc>
+<shortdoc>Returns the current cursor position. The coordinates are 1 based.</shortdoc>
+</kw>
+<kw name="Get String Positions" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\read_write.py" lineno="47">
+<arguments repr="string: str, mode: ResultMode = As_Tuple, ignore_case: bool = False">
+<arg kind="POSITIONAL_OR_NAMED" required="true" repr="string: str">
+<name>string</name>
+<type name="str" typedoc="string">str</type>
+</arg>
+<arg kind="POSITIONAL_OR_NAMED" required="false" repr="mode: ResultMode = As_Tuple">
+<name>mode</name>
+<type name="ResultMode" typedoc="ResultMode">ResultMode</type>
+<default>As_Tuple</default>
+</arg>
+<arg kind="POSITIONAL_OR_NAMED" required="false" repr="ignore_case: bool = False">
+<name>ignore_case</name>
+<type name="bool" typedoc="boolean">bool</type>
+<default>False</default>
+</arg>
+</arguments>
+<doc>Returns a list of tuples of ypos and xpos for the position where the `string` was found,
+or an empty list if it was not found.
+
+If you specify the `mode` with the value `"As Dict"` (case-insensitive),
+a list of dictionaries in the form of ``[{"xpos": int, "ypos": int}]`` is returned.
+
+If `ignore_case` is set to `True`, then the search is done case-insensitively.
+
+Example:
+    | ${positions} | Get String Positions | Abc |         | # Returns a list like [(1, 8)] |
+    | ${positions} | Get String Positions | Abc | As Dict | # Returns a list like [{"ypos": 1, "xpos": 8}] |</doc>
+<shortdoc>Returns a list of tuples of ypos and xpos for the position where the `string` was found, or an empty list if it was not found.</shortdoc>
+</kw>
+<kw name="Get String Positions Only After" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\read_write.py" lineno="64">
+<arguments repr="ypos: int, xpos: int, string: str, mode: ResultMode = As_Tuple, ignore_case: bool = False">
+<arg kind="POSITIONAL_OR_NAMED" required="true" repr="ypos: int">
+<name>ypos</name>
+<type name="int" typedoc="integer">int</type>
+</arg>
+<arg kind="POSITIONAL_OR_NAMED" required="true" repr="xpos: int">
+<name>xpos</name>
+<type name="int" typedoc="integer">int</type>
+</arg>
+<arg kind="POSITIONAL_OR_NAMED" required="true" repr="string: str">
+<name>string</name>
+<type name="str" typedoc="string">str</type>
+</arg>
+<arg kind="POSITIONAL_OR_NAMED" required="false" repr="mode: ResultMode = As_Tuple">
+<name>mode</name>
+<type name="ResultMode" typedoc="ResultMode">ResultMode</type>
+<default>As_Tuple</default>
+</arg>
+<arg kind="POSITIONAL_OR_NAMED" required="false" repr="ignore_case: bool = False">
+<name>ignore_case</name>
+<type name="bool" typedoc="boolean">bool</type>
+<default>False</default>
+</arg>
+</arguments>
+<doc>Returns a list of tuples of ypos and xpos for the position where the `string` was found,
+but only after the specified ypos/xpos coordinates. If it is not found an empty list is returned.
+
+If you specify the `mode` with the value `"As Dict"` (case-insensitive),
+a list of dictionaries in the form of ``[{"xpos": int, "ypos": int}]`` is returned.
+
+If `ignore_case` is set to `True`, then the search is done case-insensitively.
+
+Example:
+    | ${positions} | Get String Positions Only After | 5 | 4 | Abc |         | # Returns a list like [(5, 5)] |
+    | ${positions} | Get String Positions Only After | 5 | 4 | Abc | As Dict | # Returns a list like [{"ypos": 5, "xpos": 5}] |</doc>
+<shortdoc>Returns a list of tuples of ypos and xpos for the position where the `string` was found, but only after the specified ypos/xpos coordinates. If it is not found an empty list is returned.</shortdoc>
+</kw>
+<kw name="Get String Positions Only Before" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\read_write.py" lineno="90">
+<arguments repr="ypos: int, xpos: int, string: str, mode: ResultMode = As_Tuple, ignore_case: bool = False">
+<arg kind="POSITIONAL_OR_NAMED" required="true" repr="ypos: int">
+<name>ypos</name>
+<type name="int" typedoc="integer">int</type>
+</arg>
+<arg kind="POSITIONAL_OR_NAMED" required="true" repr="xpos: int">
+<name>xpos</name>
+<type name="int" typedoc="integer">int</type>
+</arg>
+<arg kind="POSITIONAL_OR_NAMED" required="true" repr="string: str">
+<name>string</name>
+<type name="str" typedoc="string">str</type>
+</arg>
+<arg kind="POSITIONAL_OR_NAMED" required="false" repr="mode: ResultMode = As_Tuple">
+<name>mode</name>
+<type name="ResultMode" typedoc="ResultMode">ResultMode</type>
+<default>As_Tuple</default>
+</arg>
+<arg kind="POSITIONAL_OR_NAMED" required="false" repr="ignore_case: bool = False">
+<name>ignore_case</name>
+<type name="bool" typedoc="boolean">bool</type>
+<default>False</default>
+</arg>
+</arguments>
+<doc>Returns a list of tuples of ypos and xpos for the position where the `string` was found,
+but only before the specified ypos/xpos coordinates. If it is not found an empty list is returned.
+
+If you specify the `mode` with the value `"As Dict"` (case-insensitive),
+a list of dictionaries in the form of ``[{"xpos": int, "ypos": int}]`` is returned.
+
+If `ignore_case` is set to `True`, then the search is done case-insensitively.
+
+Example:
+    | ${positions} | Get String Positions Only Before | 11 | 20 | Abc |         | # Returns a list like [(11, 19)] |
+    | ${positions} | Get String Positions Only Before | 11 | 20 | Abc | As Dict | # Returns a list like [{"ypos": 11, "xpos": 19}] |</doc>
+<shortdoc>Returns a list of tuples of ypos and xpos for the position where the `string` was found, but only before the specified ypos/xpos coordinates. If it is not found an empty list is returned.</shortdoc>
+</kw>
+<kw name="Move Cursor To" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\commands.py" lineno="103">
+<arguments repr="ypos: int, xpos: int">
+<arg kind="POSITIONAL_OR_NAMED" required="true" repr="ypos: int">
+<name>ypos</name>
+<type name="int" typedoc="integer">int</type>
+</arg>
+<arg kind="POSITIONAL_OR_NAMED" required="true" repr="xpos: int">
+<name>xpos</name>
+<type name="int" typedoc="integer">int</type>
+</arg>
+</arguments>
+<doc>Moves the cursor to the specified ypos/xpos position. The coordinates are 1 based.
+This keyword raises an error if the specified values exceed the Mainframe screen dimensions.
+
+Example:
+    | Move Cursor To | 1 | 5 |</doc>
+<shortdoc>Moves the cursor to the specified ypos/xpos position. The coordinates are 1 based. This keyword raises an error if the specified values exceed the Mainframe screen dimensions.</shortdoc>
+</kw>
+<kw name="Move Next Field" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\commands.py" lineno="64">
 <arguments repr="">
 </arguments>
 <doc>Move the cursor to the next input field. Equivalent to pressing the Tab key.</doc>
 <shortdoc>Move the cursor to the next input field. Equivalent to pressing the Tab key.</shortdoc>
 </kw>
-<kw name="Move Previous Field" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\commands.py" lineno="70">
+<kw name="Move Previous Field" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\commands.py" lineno="71">
 <arguments repr="">
 </arguments>
 <doc>Move the cursor to the previous input field. Equivalent to pressing the Shift+Tab keys.</doc>
@@ -735,7 +877,7 @@ Backslash is an escape character in the test data, and possible backslashes in t
 thus be escaped with another backslash (e.g. \\d\\w+).</doc>
 <shortdoc>Fails if string does match pattern as a regular expression. Regular expression check is implemented using the Python [https://docs.python.org/2/library/re.html|re module]. Python's regular expression syntax is derived from Perl, and it is thus also very similar to the syntax used, for example, in Java, Ruby and .NET.</shortdoc>
 </kw>
-<kw name="Read" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\read_write.py" lineno="11">
+<kw name="Read" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\read_write.py" lineno="12">
 <arguments repr="ypos: int, xpos: int, length: int">
 <arg kind="POSITIONAL_OR_NAMED" required="true" repr="ypos: int">
 <name>ypos</name>
@@ -758,7 +900,7 @@ Example for read a string in the position y=8 / x=10 of a length 15:
     | ${value} | Read | 8 | 10 | 15 |</doc>
 <shortdoc>Get a string of ``length`` at screen coordinates ``ypos`` / ``xpos``.</shortdoc>
 </kw>
-<kw name="Read All Screen" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\read_write.py" lineno="22">
+<kw name="Read All Screen" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\read_write.py" lineno="30">
 <arguments repr="">
 </arguments>
 <doc>Read the current screen and returns all content in one string.
@@ -775,6 +917,17 @@ Example:
     | END | |</doc>
 <shortdoc>Read the current screen and returns all content in one string.</shortdoc>
 </kw>
+<kw name="Read From Current Position" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\read_write.py" lineno="23">
+<arguments repr="length: int">
+<arg kind="POSITIONAL_OR_NAMED" required="true" repr="length: int">
+<name>length</name>
+<type name="int" typedoc="integer">int</type>
+</arg>
+</arguments>
+<doc>Similar to `Read`, however this keyword only takes `length` as an argument
+to get a string of length from the current cursor position.</doc>
+<shortdoc>Similar to `Read`, however this keyword only takes `length` as an argument to get a string of length from the current cursor position.</shortdoc>
+</kw>
 <kw name="Register Run On Failure Keyword" lineno="179">
 <arguments repr="keyword: str">
 <arg kind="POSITIONAL_OR_NAMED" required="true" repr="keyword: str">
@@ -792,13 +945,13 @@ Example:
     | Register Run On Failure Keyword | Custom Keyword | # Custom Keyword is run on failure |</doc>
 <shortdoc>This keyword lets you change the keyword that runs on failure during test execution. The default is `Take Screenshot`, which is set on library import.</shortdoc>
 </kw>
-<kw name="Send Enter" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\commands.py" lineno="55">
+<kw name="Send Enter" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\commands.py" lineno="56">
 <arguments repr="">
 </arguments>
 <doc>Send an Enter to the screen.</doc>
 <shortdoc>Send an Enter to the screen.</shortdoc>
 </kw>
-<kw name="Send PF" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\commands.py" lineno="77">
+<kw name="Send PF" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\commands.py" lineno="78">
 <arguments repr="pf: str">
 <arg kind="POSITIONAL_OR_NAMED" required="true" repr="pf: str">
 <name>pf</name>
@@ -808,7 +961,7 @@ Example:
 <doc>Send a Program Function to the screen.
 
 Example:
-       | Send PF | 3 |</doc>
+    | Send PF | 3 |</doc>
 <shortdoc>Send a Program Function to the screen.</shortdoc>
 </kw>
 <kw name="Set Screenshot Folder" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\screenshot.py" lineno="12">
@@ -919,7 +1072,7 @@ Example:
     | Wait Until String | something | 0:00:15 |</doc>
 <shortdoc>Wait until a string exists on the mainframe screen to perform the next step. If the string does not appear in 5 seconds, the keyword will raise an exception. You can define a different timeout.</shortdoc>
 </kw>
-<kw name="Write" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\read_write.py" lineno="39">
+<kw name="Write" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\read_write.py" lineno="116">
 <arguments repr="txt: str">
 <arg kind="POSITIONAL_OR_NAMED" required="true" repr="txt: str">
 <name>txt</name>
@@ -932,7 +1085,7 @@ Example:
     | Write | something |</doc>
 <shortdoc>Send a string *and Enter* to the screen at the current cursor location.</shortdoc>
 </kw>
-<kw name="Write Bare" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\read_write.py" lineno="48">
+<kw name="Write Bare" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\read_write.py" lineno="125">
 <arguments repr="txt: str">
 <arg kind="POSITIONAL_OR_NAMED" required="true" repr="txt: str">
 <name>txt</name>
@@ -945,7 +1098,7 @@ Example:
     | Write Bare | something |</doc>
 <shortdoc>Send only the string to the screen at the current cursor location.</shortdoc>
 </kw>
-<kw name="Write Bare In Position" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\read_write.py" lineno="69">
+<kw name="Write Bare In Position" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\read_write.py" lineno="146">
 <arguments repr="txt: str, ypos: int, xpos: int">
 <arg kind="POSITIONAL_OR_NAMED" required="true" repr="txt: str">
 <name>txt</name>
@@ -969,7 +1122,7 @@ Example:
     | Write Bare in Position | something | 9 | 11 |</doc>
 <shortdoc>Send only the string to the screen at screen coordinates ``ypos`` / ``xpos``.</shortdoc>
 </kw>
-<kw name="Write In Position" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\read_write.py" lineno="57">
+<kw name="Write In Position" source="C:\Robot\Robot-Framework-Mainframe-3270-Library\Mainframe3270\keywords\read_write.py" lineno="134">
 <arguments repr="txt: str, ypos: int, xpos: int">
 <arg kind="POSITIONAL_OR_NAMED" required="true" repr="txt: str">
 <name>txt</name>
@@ -995,6 +1148,15 @@ Example:
 </kw>
 </keywords>
 <datatypes>
+<enums>
+<enum name="ResultMode">
+<doc>An enumeration.</doc>
+<members>
+<member name="As_Tuple" value="1"/>
+<member name="As_Dict" value="2"/>
+</members>
+</enum>
+</enums>
 </datatypes>
 <typedocs>
 <type name="boolean" type="Standard">
@@ -1016,6 +1178,9 @@ Examples: ``TRUE`` (converted to ``True``), ``off`` (converted to ``False``),
 </accepts>
 <usages>
 <usage>__init__</usage>
+<usage>Get String Positions</usage>
+<usage>Get String Positions Only After</usage>
+<usage>Get String Positions Only Before</usage>
 <usage>Page Should Contain All Strings</usage>
 <usage>Page Should Contain Any String</usage>
 <usage>Page Should Contain Match</usage>
@@ -1048,9 +1213,13 @@ Examples: ``42``, ``-1``, ``0b1010``, ``10 000 000``, ``0xBAD_C0FFEE``
 <usages>
 <usage>Delete Char</usage>
 <usage>Delete Field</usage>
+<usage>Get String Positions Only After</usage>
+<usage>Get String Positions Only Before</usage>
+<usage>Move Cursor To</usage>
 <usage>Open Connection</usage>
 <usage>Page Should Contain String X Times</usage>
 <usage>Read</usage>
+<usage>Read From Current Position</usage>
 <usage>Switch Connection</usage>
 <usage>Take Screenshot</usage>
 <usage>Write Bare In Position</usage>
@@ -1119,6 +1288,22 @@ Examples: ``/tmp/absolute/path``, ``relative/path/to/file.ext``, ``name.txt``
 <usage>Open Connection From Session File</usage>
 </usages>
 </type>
+<type name="ResultMode" type="Enum">
+<doc>An enumeration.</doc>
+<accepts>
+<type>string</type>
+</accepts>
+<usages>
+<usage>Get Current Position</usage>
+<usage>Get String Positions</usage>
+<usage>Get String Positions Only After</usage>
+<usage>Get String Positions Only Before</usage>
+</usages>
+<members>
+<member name="As_Tuple" value="1"/>
+<member name="As_Dict" value="2"/>
+</members>
+</type>
 <type name="string" type="Standard">
 <doc>All arguments are converted to Unicode strings.</doc>
 <accepts>
@@ -1127,6 +1312,9 @@ Examples: ``/tmp/absolute/path``, ``relative/path/to/file.ext``, ``name.txt``
 <usages>
 <usage>__init__</usage>
 <usage>Execute Command</usage>
+<usage>Get String Positions</usage>
+<usage>Get String Positions Only After</usage>
+<usage>Get String Positions Only Before</usage>
 <usage>Open Connection</usage>
 <usage>Open Connection From Session File</usage>
 <usage>Page Should Contain All Strings</usage>
diff --git a/robotframework_mainframe3270.egg-info/PKG-INFO b/robotframework_mainframe3270.egg-info/PKG-INFO
index 3c5d1f4..bd054f3 100644
--- a/robotframework_mainframe3270.egg-info/PKG-INFO
+++ b/robotframework_mainframe3270.egg-info/PKG-INFO
@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: robotframework-mainframe3270
-Version: 4.0
+Version: 4.1
 Summary: Mainframe Test library for Robot Framework
 Home-page: https://github.com/Altran-PT-GDC/Robot-Framework-Mainframe-3270-Library
 Author: Altran Portugal
@@ -19,6 +19,8 @@ Classifier: Topic :: Software Development :: Testing :: Acceptance
 Description-Content-Type: text/markdown
 License-File: LICENSE.md
 License-File: THIRD-PARTY-NOTICES.txt
+Requires-Dist: robotframework
+Requires-Dist: robotframework-pythonlibcore
 
 [![PyPi downloads](https://img.shields.io/pypi/dm/robotframework-mainframe3270.svg)](https://pypi.org/project/robotframework-mainframe3270/)
 [![Total downloads](https://static.pepy.tech/personalized-badge/robotframework-mainframe3270?period=total&units=international_system&left_color=lightgrey&right_color=yellow&left_text=total)](https://pypi.org/project/robotframework-mainframe3270/)
@@ -33,7 +35,7 @@ License-File: THIRD-PARTY-NOTICES.txt
 Mainframe3270 is a library for Robot Framework based on the [py3270 project](https://pypi.org/project/py3270/), a Python interface to x3270, an IBM 3270 terminal emulator. It provides an API to a x3270 or s3270 subprocess.
 
 ## Compatibility
-Mainframe3270 requires Python 3. It is tested with Python 3.7 and 3.10, but should support all versions in between these.
+Mainframe3270 requires Python 3. It is tested with Python 3.8 and 3.12, but should support all versions in between these.
 
 ## Installation
 

From 57bd17a5f0abf29ea499aa5ea4460bd5f179b088 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Thu, 21 Dec 2023 14:49:47 +0000
Subject: [PATCH 2/2] [Changelog CI] Add Changelog for Version 4.1

---
 CHANGELOG.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 45bf3cf..fbc2d82 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,11 @@
+# Version: 4.1
+
+* [#113](https://github.com/Altran-PT-GDC/Robot-Framework-Mainframe-3270-Library/pull/113): #110 Get Cursor Position 
+* [#114](https://github.com/Altran-PT-GDC/Robot-Framework-Mainframe-3270-Library/pull/114): #112 Implement find string keyword
+* [#115](https://github.com/Altran-PT-GDC/Robot-Framework-Mainframe-3270-Library/pull/115): #111 Read From Current Position keyword
+* [#118](https://github.com/Altran-PT-GDC/Robot-Framework-Mainframe-3270-Library/pull/118): #117 Create Get String Positions Only Before / After keywords
+
+
 # Version: 4.0
 
 * [#97](https://github.com/Altran-PT-GDC/Robot-Framework-Mainframe-3270-Library/pull/97): (#73) Enable concurrent connections