From 0e148a85f52cc431a6d5537210e6605f06f463f7 Mon Sep 17 00:00:00 2001
From: Ed Manlove <devPyPlTw@verizon.net>
Date: Wed, 31 Jul 2019 20:39:50 -0400
Subject: [PATCH 01/12] Fixed compatibility issues with import exceptions.

---
 AngularJSLibrary/__init__.py | 5 ++++-
 CHANGES.rst                  | 3 +++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/AngularJSLibrary/__init__.py b/AngularJSLibrary/__init__.py
index 656ab62..081bfd8 100644
--- a/AngularJSLibrary/__init__.py
+++ b/AngularJSLibrary/__init__.py
@@ -5,7 +5,10 @@
 from selenium.common.exceptions import TimeoutException
 from SeleniumLibrary.locators import ElementFinder
 
-from exceptions import AttributeError
+try:
+    from exceptions import AttributeError
+except ImportError:
+    pass
 import time
 
 js_wait_for_angularjs = """
diff --git a/CHANGES.rst b/CHANGES.rst
index dad0473..35585f2 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -10,6 +10,9 @@ Changes:
 - Added error and informative message when unable to find root element or root component.
   [anthonyfromtheuk][HelioGuilherme66][emanlove]
 
+- Modified for Python 3 compatibility
+  [emanlove]
+
 0.0.9 (2018-09-08)
 ------------------
 Fixes:

From e46cc31bfbd6aa956a928a005e500992d42b8b4f Mon Sep 17 00:00:00 2001
From: Ed Manlove <devPyPlTw@verizon.net>
Date: Wed, 31 Jul 2019 21:11:59 -0400
Subject: [PATCH 02/12] Preparing for the 0.0.10 release.

---
 AngularJSLibrary/__init__.py |  2 +-
 CHANGES.rst                  | 10 ++++++++--
 setup.py                     |  2 +-
 3 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/AngularJSLibrary/__init__.py b/AngularJSLibrary/__init__.py
index 03cccaf..b76737e 100644
--- a/AngularJSLibrary/__init__.py
+++ b/AngularJSLibrary/__init__.py
@@ -169,7 +169,7 @@ def _sldriver(self):
 class AngularJSLibrary:
 
     ROBOT_LIBRARY_SCOPE = 'GLOBAL'
-    ROBOT_LIBRARY_VERSION = '0.0.10dev1'
+    ROBOT_LIBRARY_VERSION = '0.0.10'
 
     def __init__(self,
                  root_selector=None,
diff --git a/CHANGES.rst b/CHANGES.rst
index da6bb31..c3cf2e2 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -1,10 +1,10 @@
 Changelog
 =========
-0.0.10 (unreleased)
+0.0.10 (2019-07-31)
 ---------
 Changes:
 
-- Updated library documentation.
+- Updated library and keyword documentation.
   [aaltat][emanlove]
 
 - Added error and informative message when unable to find root element or root component.
@@ -16,6 +16,12 @@ Changes:
 - Documented discrepancy between the ``Set Ignore Implicit Angular Wait`` keyword argument and the equivalent import library argument.
   [HelioGuilherme66][aaltat][emanlove]
 
+- Update for compatibility with SeleniumLibrary 4.0.
+  [aaltat][emanlove]
+
+- Fixed major issue with setup test environment under Windows documentation.
+  [emanlove]
+
 0.0.9 (2018-09-08)
 ------------------
 Fixes:
diff --git a/setup.py b/setup.py
index 9e1b176..0744c81 100644
--- a/setup.py
+++ b/setup.py
@@ -17,7 +17,7 @@
 
 setup(
     name='robotframework-angularjs',
-    version='0.0.10dev1',
+    version='0.0.10',
     description="""An AngularJS extension to Robotframework's Selenium2Library""",
     long_description=long_description,
     long_description_content_type='text/x-rst',

From 3b671c9c71b5442b340d3758027d9507aa15b66d Mon Sep 17 00:00:00 2001
From: Ed Manlove <devPyPlTw@verizon.net>
Date: Wed, 31 Jul 2019 21:26:41 -0400
Subject: [PATCH 03/12] Bumping version to 0.0.11dev1

---
 AngularJSLibrary/__init__.py | 2 +-
 setup.py                     | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/AngularJSLibrary/__init__.py b/AngularJSLibrary/__init__.py
index b76737e..c9a955d 100644
--- a/AngularJSLibrary/__init__.py
+++ b/AngularJSLibrary/__init__.py
@@ -169,7 +169,7 @@ def _sldriver(self):
 class AngularJSLibrary:
 
     ROBOT_LIBRARY_SCOPE = 'GLOBAL'
-    ROBOT_LIBRARY_VERSION = '0.0.10'
+    ROBOT_LIBRARY_VERSION = '0.0.11dev1'
 
     def __init__(self,
                  root_selector=None,
diff --git a/setup.py b/setup.py
index 0744c81..57aa0a2 100644
--- a/setup.py
+++ b/setup.py
@@ -17,7 +17,7 @@
 
 setup(
     name='robotframework-angularjs',
-    version='0.0.10',
+    version='0.0.11dev1',
     description="""An AngularJS extension to Robotframework's Selenium2Library""",
     long_description=long_description,
     long_description_content_type='text/x-rst',

From b3fed80b4bb984aee5aecb2217e03ec8249c6ae1 Mon Sep 17 00:00:00 2001
From: Ed Manlove <devPyPlTw@verizon.net>
Date: Wed, 31 Jul 2019 21:32:22 -0400
Subject: [PATCH 04/12] Updated keyword documentation for 0.0.10 release.

---
 docs/index.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/index.html b/docs/index.html
index 1a69475..4220fdd 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -5,7 +5,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 3.1.1 (Python 3.6.4 on win32)" name="Generator">
+<meta content="Robot Framework 3.1.2 (Python 3.6.4 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">
 body {
@@ -547,7 +547,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 = {"all_tags":[],"contains_tags":false,"doc":"<p>Documentation for library <code>AngularJSLibrary\x3c/code>.\x3c/p>","generated":"2019-04-21 21:44:01","inits":[{"args":["root_selector=None","implicit_angular_wait=30.0","ignore_implicit_angular_wait=False"],"doc":"<p>AngularJSLibrary can be imported with optional arguments.\x3c/p>\n<p><code>root_selector\x3c/code> is the locator of the root angular object. If none is given it defaults to <code>[ng-app]\x3c/code>.\x3c/p>\n<p>For more information please refer to the following documentation:\x3c/p>\n<p>$rootElement - <a href=\"https://docs.angularjs.org/api/ng/service/$rootElement\">AngularJS API documentation\x3c/a>\x3c/p>\n<p>ngApp - <a href=\"https://docs.angularjs.org/api/ng/directive/ngApp\">AngularJS API documentation\x3c/a>\x3c/p>\n<p>Not Yet Implemented - <code>implicit_angular_wait\x3c/code> is the implicit timeout that AngularJS library waits for angular to finish rendering and waits for any outstanding $http calls.\x3c/p>\n<p><code>ignore_implicit_angular_wait\x3c/code> is a flag which when set to True the AngularJS Library will not wait for Angular $timeouts nor $http calls to complete when finding elements by locator. As noted in the Protractor documentation \"this should be used only when necessary, such as when a page continuously polls an API using $timeout.\" The default value is False.\x3c/p>\n<p>Examples:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Library\x3c/td>\n<td>AngularJSLibrary\x3c/td>\n<td>root_selector=[ng-version]\x3c/td>\n<td># Use [ng-version] as root element selector instead of the default [ng-app]\x3c/td>\n\x3c/tr>\n<tr>\n<td>Library\x3c/td>\n<td>AngularJSLibrary\x3c/td>\n<td>ignore_implicit_angular_wait=${true}\x3c/td>\n<td># Will not wait for angular syncronization\x3c/td>\n\x3c/tr>\n\x3c/table>","matched":true,"name":"Init","shortdoc":"AngularJSLibrary can be imported with optional arguments.","tags":[]}],"keywords":[{"args":["ignore"],"doc":"<p>Turns off the implicit wait by setting <code>ignore\x3c/code> to true. The implicit wait can be re-enabled by setting <code>ignore\x3c/code> to false.\x3c/p>\n<p>This is helpful when navigating between a Angular site and a non-angular website within the same script.\x3c/p>","matched":true,"name":"Set Ignore Implicit Angular Wait","shortdoc":"Turns off the implicit wait by setting ``ignore`` to true. The implicit wait can be re-enabled by setting ``ignore`` to false.","tags":[]},{"args":["timeout=None","error=None"],"doc":"<p>An explicit wait allowing Angular queue to empty.\x3c/p>\n<p>With the implicit wait functionality it is expected that most of the situations where waiting is needed will be handled \"automatically\" by the \"hidden\" implicit wait. Thus it is expected that this keyword will be rarely used.\x3c/p>","matched":true,"name":"Wait For Angular","shortdoc":"An explicit wait allowing Angular queue to empty.","tags":[]}],"name":"AngularJSLibrary","named_args":true,"scope":"global","version":"0.0.10dev1"};
+libdoc = {"all_tags":[],"contains_tags":false,"doc":"<p>Documentation for library <code>AngularJSLibrary\x3c/code>.\x3c/p>","generated":"2019-07-31 21:30:57","inits":[{"args":["root_selector=None","implicit_angular_wait=30.0","ignore_implicit_angular_wait=False"],"doc":"<p>AngularJSLibrary can be imported with optional arguments.\x3c/p>\n<p><code>root_selector\x3c/code> is the locator of the root angular object. If none is given it defaults to <code>[ng-app]\x3c/code>.\x3c/p>\n<p>For more information please refer to the following documentation:\x3c/p>\n<p>$rootElement - <a href=\"https://docs.angularjs.org/api/ng/service/$rootElement\">AngularJS API documentation\x3c/a>\x3c/p>\n<p>ngApp - <a href=\"https://docs.angularjs.org/api/ng/directive/ngApp\">AngularJS API documentation\x3c/a>\x3c/p>\n<p>Not Yet Implemented - <code>implicit_angular_wait\x3c/code> is the implicit timeout that AngularJS library waits for angular to finish rendering and waits for any outstanding $http calls.\x3c/p>\n<p><code>ignore_implicit_angular_wait\x3c/code> is a flag which when set to True the AngularJS Library will not wait for Angular $timeouts nor $http calls to complete when finding elements by locator. As noted in the Protractor documentation \"this should be used only when necessary, such as when a page continuously polls an API using $timeout.\" The default value is False. Note, up through the current version, there is a discrepancy between the <code>Set Ignore Implicit Angular Wait\x3c/code> keyword argument and the equivalent import library argument. The <code>Set Ignore Implicit Angular Wait\x3c/code> keyword has a strict requirement that the <code>ignore\x3c/code> argument must be a Python boolean where as the imported library argument accepts and Robot Framework Boolean arguments as outlined in the BuiltIn Library documentation. This discrepancy may be resolved in a future release.\x3c/p>\n<p>Examples:\x3c/p>\n<table border=\"1\">\n<tr>\n<td>Library\x3c/td>\n<td>AngularJSLibrary\x3c/td>\n<td>root_selector=[ng-version]\x3c/td>\n<td># Use [ng-version] as root element selector instead of the default [ng-app]\x3c/td>\n\x3c/tr>\n<tr>\n<td>Library\x3c/td>\n<td>AngularJSLibrary\x3c/td>\n<td>ignore_implicit_angular_wait=${true}\x3c/td>\n<td># Will not wait for angular syncronization\x3c/td>\n\x3c/tr>\n\x3c/table>","matched":true,"name":"Init","shortdoc":"AngularJSLibrary can be imported with optional arguments.","tags":[]}],"keywords":[{"args":["ignore"],"doc":"<p>Turns off the implicit wait by setting <code>ignore\x3c/code> to ${True}. The implicit wait can be re-enabled by setting <code>ignore\x3c/code> to ${False}. Note the value for <code>ignore\x3c/code> must be a Python boolean, meaning either ${True} or ${False} or equivalent, for this keyword.\x3c/p>\n<p>This is helpful when navigating between a Angular site and a non-angular website within the same script.\x3c/p>","matched":true,"name":"Set Ignore Implicit Angular Wait","shortdoc":"Turns off the implicit wait by setting ``ignore`` to ${True}. The implicit wait can be re-enabled by setting ``ignore`` to ${False}. Note the value for ``ignore`` must be a Python boolean, meaning either ${True} or ${False} or equivalent, for this keyword.","tags":[]},{"args":["timeout=None","error=None"],"doc":"<p>An explicit wait allowing Angular queue to empty.\x3c/p>\n<p>With the implicit wait functionality it is expected that most of the situations where waiting is needed will be handled \"automatically\" by the \"hidden\" implicit wait. Thus it is expected that this keyword will be rarely used.\x3c/p>","matched":true,"name":"Wait For Angular","shortdoc":"An explicit wait allowing Angular queue to empty.","tags":[]}],"name":"AngularJSLibrary","named_args":true,"scope":"global","version":"0.0.10"};
 </script>
 <title>Codestin Search App</title>
 </head>

From d7b2c38b124411169f9e2620d3c2b4147cde1ded Mon Sep 17 00:00:00 2001
From: klaasderks <61226892+klaasderks@users.noreply.github.com>
Date: Thu, 30 Apr 2020 12:29:11 +0200
Subject: [PATCH 05/12] extended errormessage root selector

The error that is trown when the default rootselector ng-app is used, is not realy clear about adjusting the way the library is imported:
"Keyword 'Element Text Should Be' failed after retrying for 30 seconds. The last error was: WebDriverException: Message: unknown error: Unable to find root selector using "[ng-app]". Please refer to the AngularJS library documentation for more information on how to resolve this error."

I made a smal adjustment to add: Unable to find root selector *that is given by importing the library* using
---
 AngularJSLibrary/__init__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/AngularJSLibrary/__init__.py b/AngularJSLibrary/__init__.py
index c9a955d..a0271aa 100644
--- a/AngularJSLibrary/__init__.py
+++ b/AngularJSLibrary/__init__.py
@@ -29,7 +29,7 @@
     var callback = function () {waiting = false;}
     var el = document.querySelector(arguments[0]);
     if (!el) {
-      throw new Error('Unable to find root selector using "' +
+      throw new Error('Unable to find root selector that is given by importing the library using "' +
                       arguments[0] +
                       '". Please refer to the AngularJS library documentation' +
                       ' for more information on how to resolve this error.')

From fcbddea3cb09f02f7df5633365727a0283d7715f Mon Sep 17 00:00:00 2001
From: Ed Manlove <emanlove@verizon.net>
Date: Thu, 2 Jun 2022 18:03:50 -0400
Subject: [PATCH 06/12] Fixed broken link to keyword documentation

---
 README.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.rst b/README.rst
index d9e9926..5a7b068 100644
--- a/README.rst
+++ b/README.rst
@@ -32,7 +32,7 @@ Alternatively, to install from source:
     
 Keyword Documentation
 ---------------------
-The keyword documentation can be found on the `Github project page <http://selenium2library.github.io/robotframework-angularjs/>`_.
+The keyword documentation can be found on the `Github project page <https://marketsquare.github.io/robotframework-angularjs/>`_.
 
 
 Importing the library

From fa0edd335f6ab95dcd4d4333259fa6640c8b54c8 Mon Sep 17 00:00:00 2001
From: Ed Manlove <emanlove@verizon.net>
Date: Sun, 24 Jul 2022 19:18:01 -0400
Subject: [PATCH 07/12] Updated Wait For Angular test suite and test server

- Added implicit wait for angular test cases
- Started using css selector instead of binding locator
- Removed previous implicit wait tests
- Removed tests which were expecting to fail due to timeout on `Wait For
  Angular` keyword. The thrown error on timeout was changed to a silent
  graceful fail in a previous release. Thus these test were no longer
  valid.
- Moved initial `Wait For Angular` keyword in each test case, along
  with Test Setup Go To sync page into keyword
- Added Suite Setup using the same keyword. It appeared that after the
  first opening testapp to sync page, the subsequent Go To sync page
  were quicker. Thus as we get an intial load within suite setup all the
  test setup executions wil have this advantage (including the very
  first test case).
- Added angular_wait.robot test suite documentation
- Update various test case documentation

- Updated testserver patch with a few minor bug fixes

- Updated build & test steps for developing the library
---
 AngularJSLibrary/angular_wait.robot  | 128 +++++++++++++++++----------
 AngularJSLibrary/testserver.py.patch |  18 ++--
 DEVELOPERS.rst                       |  12 +--
 3 files changed, 94 insertions(+), 64 deletions(-)

diff --git a/AngularJSLibrary/angular_wait.robot b/AngularJSLibrary/angular_wait.robot
index 725fdd1..303bdca 100644
--- a/AngularJSLibrary/angular_wait.robot
+++ b/AngularJSLibrary/angular_wait.robot
@@ -1,118 +1,143 @@
 *** Settings ***
-Test Setup      Go To   http://${SERVER}/testapp/ng1/alt_root_index.html#/async
+Suite Setup      Go To Async Page and Wait
+Test Setup      Go To Async Page and Wait
 Resource        ../resource.robot
 Library         AngularJSLibrary
 
+Documentation   This test suite for validating the waiting for angular functionality
+...             Based off of protractor\spec\basic\synchronize_spec.js
+
 *** Test Cases ***
 Waits For Http Calls
     [Documentation]  `Wait For Angular` should delay for 2 seconds.
-    Wait For Angular
     Element Text Should Be  binding=slowHttpStatus  not started
-
     Click Button  css=[ng-click="slowHttp()"]
 
     Wait For Angular  timeout=20sec
+
+    Element Text Should Be  binding=slowHttpStatus  done
+
+Implicitly Waits For Http Calls
+    [Documentation]  Second `Element Text Should Be` (done) should delay for 2 seconds.
+    Element Text Should Be  binding=slowHttpStatus  not started
+    Click Button  css=[ng-click="slowHttp()"]
     Element Text Should Be  binding=slowHttpStatus  done
 
+Implicitly Waits For Http Calls (without Binding locators)
+    [Documentation]  Second `Element Text Should Be` (done) should delay for 2 seconds.
+    Element Text Should Be  css=[ng-bind="slowHttpStatus"]  not started
+    Click Button  css=[ng-click="slowHttp()"]
+    Element Text Should Be  css=[ng-bind="slowHttpStatus"]  done
+
 Waits For Long Javascript Execution
     [Documentation]  This test will take variable amount of time but should not
     ...    take more than about five seconds.
-    Wait For Angular
     Element Text Should Be  binding=slowFunctionStatus  not started
-
     Click Button  css=[ng-click="slowFunction()"]
 
     Wait For Angular
+
     Element Text Should Be  binding=slowFunctionStatus  done
 
+Implicitly Waits For Long Javascript Execution
+    [Documentation]  This test will take variable amount of time but should not
+    ...    take more than about five seconds.
+
+    Element Text Should Be  css=[ng-bind="slowFunctionStatus"]  not started
+    Click Button  css=[ng-click="slowFunction()"]
+    Element Text Should Be  css=[ng-bind="slowFunctionStatus"]  done
+
 DOES NOT wait for timeout
     [Documentation]  The `Wait For Angular` keyword should return immediately
     ...    and not wait for a javascript timeout.
-    Wait For Angular
     Element Text Should Be  binding=slowTimeoutStatus  not started
-
     Click Button  css=[ng-click="slowTimeout()"]
 
     Wait For Angular
+
     Element Text Should Be  binding=slowTimeoutStatus  pending...
 
+Implicitly DOES NOT wait for timeout
+    [Documentation]  The second `Element Text Should Be` keyword (pending...)
+    ...    should return immediately and not wait for a javascript timeout.
+    Element Text Should Be  css=[ng-bind="slowTimeoutStatus"]  not started
+    Click Button  css=[ng-click="slowTimeout()"]
+    Element Text Should Be  css=[ng-bind="slowTimeoutStatus"]  pending...
+
 Waits For $timeout
-    [Documentation]  Test should take around 4 seconds.
-    Wait For Angular
+    [Documentation]  `Wait For Angular` should delay for 4 seconds.
     Element Text Should Be  binding=slowAngularTimeoutStatus  not started
-
     Click Button  css=[ng-click="slowAngularTimeout()"]
 
     Wait For Angular  timeout=30sec
+
     Element Text Should Be  binding=slowAngularTimeoutStatus  done
     
+Implicitly Waits For $timeout
+    [Documentation]  Second `Element Text Should Be` (done) should delay for 4 seconds.
+    Element Text Should Be  css=[ng-bind="slowAngularTimeoutStatus"]  not started
+    Click Button  css=[ng-click="slowAngularTimeout()"]
+    Element Text Should Be  css=[ng-bind="slowAngularTimeoutStatus"]  done
+    
 Waits For $timeout Then A Promise
-    [Documentation]  Test should take around 4 seconds.
-    Wait For Angular
+    [Documentation]  `Wait For Angular` should delay for around 4 seconds.
     Element Text Should Be  binding=slowAngularTimeoutPromiseStatus  not started
-
     Click Button  css=[ng-click="slowAngularTimeoutPromise()"]
 
     Wait For Angular  timeout=30sec
+
     Element Text Should Be  binding=slowAngularTimeoutPromiseStatus  done
     
+Implicitly Waits For $timeout Then A Promise
+    [Documentation]  Second `Element Text Should Be` (done) should delay for around 4 seconds.
+    Element Text Should Be  css=[ng-bind="slowAngularTimeoutPromiseStatus"]  not started
+    Click Button  css=[ng-click="slowAngularTimeoutPromise()"]
+    Element Text Should Be  css=[ng-bind="slowAngularTimeoutPromiseStatus"]  done
+    
 Waits For Long Http Call Then A Promise
     [Documentation]  `Wait For Angular` should delay for 2 seconds.
-    Wait For Angular
     Element Text Should Be  binding=slowHttpPromiseStatus  not started
-
     Click Button  css=[ng-click="slowHttpPromise()"]
 
     Wait For Angular  timeout=30sec
+
     Element Text Should Be  binding=slowHttpPromiseStatus  done
 
+Implicitly Waits For Long Http Call Then A Promise
+    [Documentation]  Second `Element Text Should Be` (done) should delay for 2 seconds.
+    Element Text Should Be  css=[ng-bind="slowHttpPromiseStatus"]  not started
+    Click Button  css=[ng-click="slowHttpPromise()"]
+    Element Text Should Be  css=[ng-bind="slowHttpPromiseStatus"]  done
+
 Waits For Slow Routing Changes
-    Wait For Angular
+    [Documentation]  `Wait For Angular` should delay for around 5 seconds.
     Element Text Should Be  binding=routingChangeStatus  not started
-
     Click Button  css=[ng-click="routingChange()"]
 
     Wait For Angular  timeout=30sec
+
+    Page Should Contain  polling mechanism
+
+Implicitly Waits For Slow Routing Changes
+    [Documentation]  Second `Element Text Should Be` (done) should delay for around 5 seconds.
+    Element Text Should Be  binding=routingChangeStatus  not started
+    Click Button  css=[ng-click="routingChange()"]
     Page Should Contain  polling mechanism
 
 Waits For Slow Ng-Include Templates To Load
-    Wait For Angular
+    [Documentation]  `Wait For Angular` should delay for around 2 seconds.
     Element Text Should Be  css=.included  fast template contents
-
     Click Button  css=[ng-click="changeTemplateUrl()"]
 
     Wait For Angular  timeout=30sec
+    
     Element Text Should Be  css=.included  slow template contents
 
-Wait Times Out
-    Wait For Angular
-    Element Text Should Be  binding=slowAngularTimeoutStatus  not started
-
-    Click Button  css=[ng-click="slowAngularTimeout()"]
-
-    Run Keyword And Expect Error  *  Wait For Angular  timeout=1sec
-
-Log Pending Http Calls
-    Wait For Angular
-    Element Text Should Be  binding=slowHttpPromiseStatus  not started
-
-    Click Button  css=[ng-click="slowHttpPromise()"]
-
-    Run Keyword And Expect Error  *  Wait For Angular  timeout=1sec
-
-Implicit Wait For Angular On Timeout
-    Wait For Angular
-
-    Click Button  css=[ng-click="slowAngularTimeout()"]
-
-    Click Button  css=[ng-click="slowAngularTimeoutHideButton()"]
-
-Implicit Wait For Angular On Timeout With Promise
-    Wait For Angular
-
-    Click Button  css=[ng-click="slowAngularTimeoutPromise()"]
-
-    Click Button  css=[ng-click="slowAngularTimeoutPromiseHideButton()"]
+Implicitly Waits For Slow Ng-Include Templates To Load
+    [Documentation]  Second `Element Text Should Be` (done) should delay for around 2 seconds.
+    Element Text Should Be  css=.included  fast template contents
+    Click Button  css=[ng-click="changeTemplateUrl()"]
+    Element Text Should Be  css=.included  slow template contents
 
 Toggle Implicit Wait For Angular Flag
     Element Should Not Be Visible  css=[ng-click="slowAngularTimeoutHideButton()"]
@@ -134,4 +159,9 @@ Toggle Implicit Wait For Angular Flag
 
     Click Button  css=[ng-click="slowAngularTimeoutHideButton()"]
 
-    Element Should Not Be Visible  css=[ng-click="slowAngularTimeoutHideButton()"]
\ No newline at end of file
+    Element Should Not Be Visible  css=[ng-click="slowAngularTimeoutHideButton()"]
+
+*** Keywords ***
+Go To Async Page and Wait
+    Go To   http://${SERVER}/testapp/ng1/alt_root_index.html#/async
+    Wait For Angular
\ No newline at end of file
diff --git a/AngularJSLibrary/testserver.py.patch b/AngularJSLibrary/testserver.py.patch
index 35255fa..8aa66b0 100644
--- a/AngularJSLibrary/testserver.py.patch
+++ b/AngularJSLibrary/testserver.py.patch
@@ -1,23 +1,23 @@
 diff --git a/atest/resources/testserver/testserver.py b/atest/resources/testserver/testserver.py
-index 19e82ef..cf2abf1 100644
+index 565c650..8e3d82b 100644
 --- a/atest/resources/testserver/testserver.py
 +++ b/atest/resources/testserver/testserver.py
-@@ -5,6 +5,7 @@ from __future__ import print_function
+@@ -3,6 +3,7 @@
  
  import os
  import sys
 +from time import sleep
- try:
-     from httplib import HTTPConnection
-     from BaseHTTPServer import HTTPServer
-@@ -28,6 +29,36 @@ class StoppableHttpRequestHandler(SimpleHTTPRequestHandler):
+ 
+ from http.client import HTTPConnection
+ from http.server import SimpleHTTPRequestHandler, HTTPServer
+@@ -21,6 +22,36 @@ class StoppableHttpRequestHandler(SimpleHTTPRequestHandler):
      def do_POST(self):
          self.do_GET()
  
 +    def do_GET(self):
 +        """Response pages for Angular tests.
 +        
-+        Added by Edward Manlove - June 5, 2014
++        Added by AngularJSLibrary
 +        """
 +        if self.path.endswith('/fastcall'):
 +            self.send_response(200)
@@ -34,13 +34,13 @@ index 19e82ef..cf2abf1 100644
 +            self.send_response(200)
 +            self.send_header('Content-type', 'text/html')
 +            self.end_headers()
-+            self.wfile.write('fast template contents')
++            self.wfile.write(b'fast template contents')
 +        elif self.path.endswith('/slowTemplateUrl'):
 +            sleep(2)
 +            self.send_response(200)
 +            self.send_header('Content-type', 'text/html')
 +            self.end_headers()
-+            self.wfile.write('slow template contents')
++            self.wfile.write(b'slow template contents')
 +        else:
 +            SimpleHTTPRequestHandler.do_GET(self)
 +
diff --git a/DEVELOPERS.rst b/DEVELOPERS.rst
index b3a7cde..2d6ba09 100644
--- a/DEVELOPERS.rst
+++ b/DEVELOPERS.rst
@@ -52,15 +52,15 @@ Here are the current (as of Aug. 3, 2018, selenium==3.14.0, robotframework-selen
 
 .. code::  bash
 
-    mkdir locator
-    cd locator/
+    mkdir ng-test
+    cd ng-test/
     git clone https://github.com/robotframework/SeleniumLibrary.git rf-sl
-    git clone https://github.com/Selenium2Library/robotframework-angularjs.git rf-ng
+    git clone https://github.com/MarketSquare/robotframework-angularjs.git rf-ng
     git clone https://github.com/angular/protractor.git ptor
     
-    virtualenv -p /usr/bin/python2.7 --no-site-packages cl-py27-env
-    source cl-py27-env/bin/activate
-    pip install robotframework robotstatuschecker mockito selenium
+    virtualenv -p /usr/bin/python3.9 cl-py39-env
+    source cl-py39-env/bin/activate
+    pip install robotframework robotstatuschecker mockito selenium requests pytest
     
     patch rf-sl/atest/resources/testserver/testserver.py rf-ng/AngularJSLibrary/testserver.py.patch 
     

From efe811e5f6a1a2d31f35fdd83095072e88538b86 Mon Sep 17 00:00:00 2001
From: Ed Manlove <emanlove@verizon.net>
Date: Sun, 31 Jul 2022 13:46:57 -0400
Subject: [PATCH 08/12] Major revision of README and Library Documentation

- Overhauled the README documentation to give much more depth into how
  the library works and what the end user needs to know and understand.
- Update links to Angular documentation within keyword doc
- Added demo scripts using AngularJS.org and Angular.io tutorials and
  examples
- Added additional citations for Google's MIT License and copyright
---
 AngularJSLibrary/__init__.py               |   4 +-
 AngularJSLibrary/demo_ngcdk_dialog.robot   |  12 +
 AngularJSLibrary/demo_phonecat.robot       |  10 +
 AngularJSLibrary/demo_waitforangular.robot |  13 +
 AngularJSLibrary/test_angular2.robot       |   2 +-
 DEVELOPERS.rst                             |   2 +-
 LICENSE                                    |   6 +-
 README.rst                                 | 308 +++++++++++++++++++--
 8 files changed, 321 insertions(+), 36 deletions(-)
 create mode 100644 AngularJSLibrary/demo_ngcdk_dialog.robot
 create mode 100644 AngularJSLibrary/demo_phonecat.robot
 create mode 100644 AngularJSLibrary/demo_waitforangular.robot

diff --git a/AngularJSLibrary/__init__.py b/AngularJSLibrary/__init__.py
index a0271aa..965b2e9 100644
--- a/AngularJSLibrary/__init__.py
+++ b/AngularJSLibrary/__init__.py
@@ -182,9 +182,9 @@ def __init__(self,
 
         For more information please refer to the following documentation:
 
-           $rootElement - [https://docs.angularjs.org/api/ng/service/$rootElement|AngularJS API documentation]
+           $rootElement - [https://code.angularjs.org/snapshot-stable/docs/api/ng/service/$rootElement|AngularJS API documentation]
 
-           ngApp - [https://docs.angularjs.org/api/ng/directive/ngApp|AngularJS API documentation]
+           ngApp - [https://code.angularjs.org/snapshot-stable/docs/api/ng/directive/ngApp|AngularJS API documentation]
 
         Not Yet Implemented - ``implicit_angular_wait`` is the implicit timeout that AngularJS library
                              waits for angular to finish rendering and waits for any outstanding $http calls.
diff --git a/AngularJSLibrary/demo_ngcdk_dialog.robot b/AngularJSLibrary/demo_ngcdk_dialog.robot
new file mode 100644
index 0000000..59c8ba0
--- /dev/null
+++ b/AngularJSLibrary/demo_ngcdk_dialog.robot
@@ -0,0 +1,12 @@
+*** Settings ***
+Library    SeleniumLibrary
+Library    AngularJSLibrary    root_selector=material-docs-app
+
+*** Test Cases ***
+Add Favorite Animal To Dialog
+    Open Browser  https://material.angular.io/cdk/dialog/examples  Chrome
+    Input Text    //input[@for='dialog-user-name']  Robot Framework
+    Click Button  Pick one
+    Input Text    //input[@for='favorite-animal']  Aibo
+    Click Button  OK
+    Element Text Should Be    //cdk-dialog-overview-example/ol/li[3]    You chose: Aibo
\ No newline at end of file
diff --git a/AngularJSLibrary/demo_phonecat.robot b/AngularJSLibrary/demo_phonecat.robot
new file mode 100644
index 0000000..8ce76eb
--- /dev/null
+++ b/AngularJSLibrary/demo_phonecat.robot
@@ -0,0 +1,10 @@
+*** Settings ***
+Library    SeleniumLibrary
+Library    AngularJSLibrary    root_selector=[ng-app]
+
+*** Test Cases ***
+Search Through The Phone Catalog For Samsung Phones
+    Open Browser  http://angular.github.io/angular-phonecat/step-14/app  Chrome
+    Input Text  //input  Samsung
+    Click Link  Samsung Galaxy Tab™
+    Element Text Should Be    css:phone-detail h1    Samsung Galaxy Tab™
\ No newline at end of file
diff --git a/AngularJSLibrary/demo_waitforangular.robot b/AngularJSLibrary/demo_waitforangular.robot
new file mode 100644
index 0000000..b799e84
--- /dev/null
+++ b/AngularJSLibrary/demo_waitforangular.robot
@@ -0,0 +1,13 @@
+*** Settings ***
+Library    SeleniumLibrary
+Library    AngularJSLibrary    ignore_implicit_angular_wait=True
+
+*** Test Cases ***
+Search Through The Phone Catalog For Samsung Phones
+    Open Browser  http://angular.github.io/angular-phonecat/step-14/app  Chrome
+    Wait For Angular
+    Input Text  //input  Samsung
+    Wait For Angular
+    Click Link  Samsung Galaxy Tab™
+    Wait For Angular
+    Element Text Should Be    css:phone-detail h1    Samsung Galaxy Tab™
\ No newline at end of file
diff --git a/AngularJSLibrary/test_angular2.robot b/AngularJSLibrary/test_angular2.robot
index a6ca1a7..1a74669 100644
--- a/AngularJSLibrary/test_angular2.robot
+++ b/AngularJSLibrary/test_angular2.robot
@@ -1,5 +1,5 @@
 *** Settings ***
-Library    Selenium2Library
+Library    SeleniumLibrary
 Library    AngularJSLibrary
 
 *** Test Case ***
diff --git a/DEVELOPERS.rst b/DEVELOPERS.rst
index 2d6ba09..2df97c1 100644
--- a/DEVELOPERS.rst
+++ b/DEVELOPERS.rst
@@ -48,7 +48,7 @@ Steps to update keyword documentation
 
 Current Steps to Setup Development Environment and Run Tests
 ------------------------------------------------------------
-Here are the current (as of Aug. 3, 2018, selenium==3.14.0, robotframework-seleniumlibrary==3.2.0.dev1, protractor==5.4.0) instructions for setting up the development environment and running the tests
+Here are the current (as of July 25, 2022, selenium==4.3.0, robotframework-seleniumlibrary==6.1.0.dev1, protractor==6.0.0) instructions for setting up the development environment and running the tests
 
 .. code::  bash
 
diff --git a/LICENSE b/LICENSE
index ea1006b..17a143e 100644
--- a/LICENSE
+++ b/LICENSE
@@ -206,11 +206,13 @@
 AngularJSLibrary\ng-repeater.js:
 AngularJSLibrary\ng-repeater.min.js:
 AngularJSLibrary\__init__.py (certain javascript portions):
+Various code examples (as noted in the documentation):
 
    The MIT License
 
-   Copyright (c) 2010-2015 Google, Inc.
-
+   Copyright (c) 2010-2020 Google LLC. http://angularjs.org
+   Copyright (c) 2010-2022 Google LLC. http://angular.io/license
+   
    Permission is hereby granted, free of charge, to any person obtaining a copy
    of this software and associated documentation files (the "Software"), to deal
    in the Software without restriction, including without limitation the rights
diff --git a/README.rst b/README.rst
index 5a7b068..0fa513a 100644
--- a/README.rst
+++ b/README.rst
@@ -1,18 +1,24 @@
 AngularJSLibrary - robotframework-angularjs
 ===========================================
-An AngularJS and Angular extension to Robotframework's SeleniumLibrary
-
-About the support for various Angular and Selenium Library versions
--------------------------------------------------------------------
-As of AngularJSLibrary version 0.0.7 (31 March, 2018 release) only the SeleniumLibrary is supported (despite the name of the GITHUB group hosting the library).
-
-The AngularJSLibrary, despite the name including JS, supports both Angular 2.0+ (known as simply Angular) and Angular 1.0 (also known as Angular JS).
-
-
-What is included
-----------------
-AngularJSLibrary provides functionality in two key areas: angular specific **locator strategies** and **waiting**. Just as there are strategies provide by the SeleniumLibrary for locating elements by ID, CSS, or xPath, this library adds startegies for finding elements by binding, model, and repeater. The library also provides both an explicit keyword for waiting on angular and an implicit wait.
-
+An AngularJS and Angular extension to Robotframework's SeleniumLibrary.
+AngularJSLibrary primarily provides functionality to deal with **waiting** and
+thus timing issue when testing Angular based websites. The library does this by
+providing first an implicit wait and, subsequently, an explicit keyword for
+waiting on angular.
+
+About the support for various Angular versions and overall status of this library
+---------------------------------------------------------------------------------
+The AngularJSLibrary, despite the name including JS, supports testing against
+both Angular 2.0+ (known as simply Angular) and Angular 1.0 (also known as
+Angular JS).
+
+This library is considered mature and feature complete. Ongoing support is
+provided through the Robot Framework community Slack. Thus it may appear
+to be abandoned or neglected for which it is not.
+
+**Please carefully read through this README in its entirety**. It covers how
+to configure and import the library into your test scripts, use and understand
+its key functionality, as well as troubleshooting and debugging information.
 
 Installation
 ------------
@@ -29,43 +35,276 @@ Alternatively, to install from source:
 
     python setup.py install
 
+
+Identifying the Angular root element
+------------------------------------
+Prior to importing the library, one must identify the Angular root element or root
+component. For more information about 
+
+Here are a few examples of Angular sites and their corresponding root elements or
+components. The first example is from the `AngularJS.org PhoneCat tutorial <http://angular.github.io/angular-phonecat/step-14/app>`_.
+The base html code is
+
+.. code::  html
+
+    <html lang="en" ng-app="phonecatApp">
+      <head>
+        <!-- ... -->
+      </head>
+      <body>
     
-Keyword Documentation
----------------------
-The keyword documentation can be found on the `Github project page <https://marketsquare.github.io/robotframework-angularjs/>`_.
+        <div class="view-container">
+          <div ng-view class="view-frame"></div>
+        </div>
+    
+      </body>
+    </html>
+
+In the PhoneCat tutorial the html element with the ng-app attribute is the root
+element. Thus for this website the root selector would be :code:`[ng-app]`. The
+next example is the `Getting started with Angular tutorial <https://angular.io/start>`_
+on angular.io site. It's main html looks like
+
+.. code::  html
+
+    <!DOCTYPE html>
+    <html lang="en">
+      <head>
+        <!-- ... -->
+      </head>
+      <body>
+        <app-root></app-root>
+      </body>
+    </html>
+
+Here the root component is the app-root element and thus the root selector for
+this website would be :code:`app-root`. The last example is the `example tab of
+the Dialog UI component <https://material.angular.io/cdk/dialog/examples>`_
+within the Angular.io Component Dev Kit (CDK).
+
+.. code::  html
+
+    <!DOCTYPE html><html lang="en-US"><head>
+    <!-- ... -->
+    </head>
+    
+
+    <body class="docs-app-background">
+      <material-docs-app></material-docs-app>
+      <!-- ... -->
+    
+    </body></html>
+
+The root component for the Dialog component example page is the material-docs-app
+element. The root selector will be :code:`material-docs-app`.
 
+Now we will use the root selector when we import the library.
 
 Importing the library
 ---------------------
-In order to use the keywords you have to include AngularJSLibrary in the settings section of your test or test suite. Note will will need to include the SeleniumLibrary **before** you import the AngularJSLibrary.
+The proper name for importing the library is :code:`AngularJSLibrary`. You will
+need to include the SeleniumLibrary **before** you import the AngularJSLibrary.
+The first of two library options is `root_selector`. So using our first example,
+the PhoneCat tutorial from AngularJS.org above, our import may look like,
 
 .. code::  robotframework
 
     *** Settings ***
-    Library         SeleniumLibrary
-    Library         AngularJSLibrary
-    ...
+    Library    SeleniumLibrary
+    Library    AngularJSLibrary    root_selector=[ng-app]
     
     *** Test Cases ***
-    Go To  localhost:8080
-    Wait for Angular
-    ...
+    Search Through The Phone Catalog For Samsung Phones
+        Open Browser  http://angular.github.io/angular-phonecat/step-14/app  Chrome
+        Input Text  //input  Samsung
+        Click Link  Samsung Galaxy Tab™
+        Element Text Should Be    css:phone-detail h1    Samsung Galaxy Tab™
 
-There are currently two library options: root_selector, ignore_implicit_angular_wait. root_selector allows the user to set the Angular root element (AngularJS) or root component (Angular). The default value is :code:`[ng-app]` and is a CSS selector; more specifically an attribute selector looking for an element with the attribute :code:`ng-app`. Starting in AngularJSLibrary version 0.0.10 if the root selector query fails an error is thrown noting the library is "[u]nable to find root selector ...". To resolve this issue one must discover the root element or component within the Angular appliction under test.
+As the default value for the root_selector argument is :code:`[ng-app]`, for
+the PhoneCat tutorial we did not need to specify the root_selector and could
+have written the Library import as
 
-ignore_implicit_angular_wait is a flag which when set to True the AngularJS Library will not wait for Angular $timeouts nor $http calls to complete when finding elements by locator. As noted in the Protractor documentation "this should be used only when necessary, such as when a page continuously polls an API using $timeout." The default value is False.
+.. code::  robotframework
+
+    *** Settings ***
+    Library    SeleniumLibrary
+    Library    AngularJSLibrary
+    
+    *** Test Cases ***
+    Search Through The Phone Catalog For Samsung Phones
+        Open Browser  http://angular.github.io/angular-phonecat/step-14/app  Chrome
+        Input Text  //input  Samsung
+        Click Link  Samsung Galaxy Tab™
+        Element Text Should Be    css:phone-detail h1    Samsung Galaxy Tab™
 
+*If you get an "Unable to find root selector ..." error* then you should re-check
+your root_selector. Note that unlike locators used with the SeleniumLibrary the
+root_selector **should not** contain the css locator prefix.
+
+The second library option, ignore_implicit_angular_wait, is a flag which when
+set to True the AngularJS Library will not wait for Angular $timeouts nor
+$http calls to complete when finding elements by locator. The default value is
+False.
+
+*If the application under test starts on a non angular page,* for example a
+login page that is not angular which leads into an angular app, then one should
+start with the implicit angular wait turned off. For example,
+
+.. code::  robotframework
+
+    *** Settings ***
+    Library    SeleniumLibrary
+    Library    AngularJSLibrary    ignore_implicit_angular_wait=True
+    
+    *** Test Cases ***
+    Login Into Non Angular Page
+        # ...
 
 Usage of the Waiting functionality
 ----------------------------------
-The AngularJS Library provides two types of waiting; a explicit keyword that one calls out or writes into their script and then an built-in implicit wait that automatically waits when using a locator strategy. Note currently the implicit wait is not invoked when using a web element as the locator. By default the implicit is turned on. This means as soon as you import the library you will have waiting enabled.
+The AngularJS Library provides two types of waiting: a built-in implicit wait
+that automatically waits when using a locator strategy and then an explicit
+keyword that one calls out or writes into their script. In the tutorial and
+examples above the scripts there aren't any expicit wait calls. Here instead
+the script is relying on the implicit wait which by default is turned on.
+This means as soon as you import the library you will have waiting enabled.
 
-You may turn off the implicit wait by either using the :code:`Set Ignore Implicit Angular Wait` keyword with an argument of :code:`${True}` or when importing the library. For some testing situations, for example the initial login page is non-angular, one may want to start without the implicit waiting enabled.
+This can be demostrated by importing the library with the implicit wait turned
+off and using instead the library's explicit `Wait For Angular` keyword.
 
-With the implicit wait functionality it is expected that most of the situations where waiting is needed will be handled "automatically" by this "hidden" implicit wait. Thus if one examined your test case they would not see many, if any, `Wait For Angular` keywords but instead would see actions keywords with no "waiting" keywords in between actions. There are though times when one needs to explicitly call out to wait for angular. For example when using a SeleniumLibrary keyword that does not use a locator strategy, like :code:`Alert Should Be Present` and :code:`Page should contain ...`, or if you use webelement.
+.. code::  robotframework
 
+    *** Settings ***
+    Library    SeleniumLibrary
+    Library    AngularJSLibrary    ignore_implicit_angular_wait=True
+    
+    *** Test Cases ***
+    Search Through The Phone Catalog For Samsung Phones
+        Open Browser  http://angular.github.io/angular-phonecat/step-14/app  Chrome
+        Wait For Angular
+        Input Text  //input  Samsung
+        Wait For Angular
+        Click Link  Samsung Galaxy Tab™
+        Wait For Angular
+        Element Text Should Be    css:phone-detail h1    Samsung Galaxy Tab™
+
+The expected and designed usage of this library is to use the implicit wait in
+almost all cases. The reasoning is that it makes for a much cleaner and clearer
+test case. Note currently the implicit wait is not invoked when using a web
+element as the locator.
+
+In addition to the option to turn off the implicit wait on libray import, you
+may turn it off using the :code:`Set Ignore Implicit Angular Wait` keyword with
+an argument of :code:`${True}`. 
+
+With the implicit wait functionality it is expected that most of the situations
+where waiting is needed will be handled "automatically" by this "hidden" implicit
+wait. Thus if one examined your test case they would not see many, if any,
+`Wait For Angular` keywords but instead would see actions keywords with no
+"waiting" keywords in between actions. There are though times when one needs to
+explicitly call out to wait for angular. For example when using a SeleniumLibrary
+keyword that does not use a locator strategy, like :code:`Alert Should Be Present`
+and :code:`Page should contain ...`, or if you use webelement.
+
+
+Understanding and verifying the angular waits
+---------------------------------------------
+Although the waits seem like "Magic" they are not. Let's look into how the
+waits are implimented and work to gain insight as to how they work. The waits,
+both the implicit and explicit, poll what I call the "angular queue".
+Technically it is checking that angular has "finished rendering and has no
+outstanding $http or $timeout calls". It does this by checking the
+`notifyWhenNoOutstandingRequests` function for AngularJS applications. For
+Angular applications the library is checking the `isStable` function on the
+Angular Testibility service.
+
+This can be seen within the log file by setting the loglevel to DEBUG or TRACE.
+Rerunning the PhoneCat demo (:code:`robot --loglevel DEBUG demo_phonecat.robot`)
+one should see in the log file
+
+.. code::  robotframework
 
-Usage of the Angular Specific Locator Stratergies
+    20:01:04.658	INFO	Typing text 'Samsung' into text field '//input'.	
+    20:01:04.658	DEBUG	POST http://localhost:50271/session/f75e7aaf5a00c717ae5e4af34a6ce516540611dae4b7f6079ce1a753c308cde2/execute/sync {"script": "...snip..."]}	
+    20:01:04.661	DEBUG	http://localhost:50271 "POST /session/f75e7aaf5a00c717ae5e4af34a6ce516540611dae4b7f6079ce1a753c308cde2/execute/sync HTTP/1.1" 200 14	
+    20:01:04.661	DEBUG	Remote response: status=200 | data={"value":true} | headers=HTTPHeaderDict({'Content-Length': '14', 'Content-Type': 'application/json; charset=utf-8', 'cache-control': 'no-cache'})	
+    20:01:04.661	DEBUG	Finished Request	
+
+For space reasons I snipped out the core script on the POST execute/sync line.
+One should see these lines repeated several times over. This is the polling the
+library is doing to see if the application is ready to test. It will repeat
+this query till either it returns true or it will repeat till the "give up"
+timeout. If it gives up, it will silently and gracefully fail continuing onto
+the actions it was waiting to perform. It is important for the user of this
+library to see and understand, at a basic level, this functionality. As the
+primary usage are these implicit, and thus hidden, waits it is key to see how
+to check the library is operating properly and when it is waiting.
+
+*When using the AngularJS Library, if all waits timeout then the AngularJS
+Library may not wait properly with that application under test.* This,
+recalling all previously outlined information, is telling you that the
+Angular app is constantly busy. This can happen depending on how the angular
+application is designed. It may also affect only a portion of the application
+so it is important to test out various parts of the application.
+
+Further debugging techniques
+----------------------------
+In addition to using the AngularJS Library, one can use the Browser's DevTools
+as a way to test out and demonstrate the core operation of the library against
+an application. To be clear, this is not library code but similar Javascript
+code which one uses outside of robot to exhibit, to a dev team for example,
+what the library is seeing when it querys the application. When viewing the
+application under test open the DevTools, preferably under Chrome, and on the
+Console tab type the following,
+
+If the application is built with AngularJS or Angular 1.x then the script is
+
+.. code::  javascript
+
+    var callback = function () {console.log('*')}
+    var el = document.querySelector('[ng-app]');
+    var h = setInterval(function w4ng() {
+        console.log('.');
+        try {
+            angular.element(el).injector().get('$browser').
+                notifyWhenNoOutstandingRequests(callback);
+        } catch (err) {
+          console.log(err.message);
+          callback(err.message);
+        }
+      }, 10);
+
+For Angular v2+ then the script is
+
+.. code::  javascript
+
+    var callback = function () {console.log('*')}
+    var el = document.querySelector('material-docs-app');
+    var h = setInterval(function w4ng() {
+        console.log('.');
+        try {
+            var readyToTest = window.getAngularTestability(el).isStable();
+        } catch (err) {
+          console.log(err.message);
+          callback(err.message);
+        }
+        if (!readyToTest) {
+          callback()
+        } else {
+          console.log('.');
+        }
+      }, 10);
+
+This will display a :code:`.` when "stable". Otherwise it will show a :code:`*`
+when "busy". To shut down the javascript interval and stop this script type on
+the console prompt :code:`clearInterval(h);`. [Chrome Browser is preferred
+because repeated output within its DevTools console will be displayed as a
+single line with a count versus a new line for each output making it much
+easier to see and read.] I have personally used this myself both in developing
+this library as well as demonstrating to various Angular developers how a
+design/implementation is blocking testability.
+
+Usage of the Angular Specific Locator Strategies
 -------------------------------------------------
 The new locator strategies include
 
@@ -112,7 +351,12 @@ Finally there is the strategy of find by repeat. This takes the general form of
 
 Getting Help
 ------------
-If you need help with AngularJSLibrary, SeleniumLibrary, or Robot Framework usage, please post to the `user group for Robot Framework <https://groups.google.com/forum/#!forum/robotframework-users>`_.
+If you need help with AngularJSLibrary, SeleniumLibrary, or Robot Framework usage, please reach out within the Robot Framework community `Slack <>`_ [`Invite to join community slack <https://rf-invite.herokuapp.com/>`_].
+
+    
+Keyword Documentation
+---------------------
+The keyword documentation can be found on the `Github project page <https://marketsquare.github.io/robotframework-angularjs/>`_.
 
 
 Testing
@@ -126,3 +370,7 @@ References
 `SeleniumLibrary <https://github.com/robotframework/SeleniumLibrary>`_: Web testing library for Robot Framework
 
 `Protractor <http://www.protractortest.org>`_: E2E test framework for Angular apps
+
+`isStable reference <https://angular.io/api/core/ApplicationRef#is-stable-examples>`_
+
+`Angular Testability service <https://angular.io/api/core/Testability>`_

From dfd6658a19c471fa67d029abcc6e27418128c847 Mon Sep 17 00:00:00 2001
From: Ed Manlove <emanlove@verizon.net>
Date: Sun, 21 Aug 2022 20:54:18 -0400
Subject: [PATCH 09/12] Major revision of the documentation

---
 README.rst | 21 ++++++++-------------
 1 file changed, 8 insertions(+), 13 deletions(-)

diff --git a/README.rst b/README.rst
index 0fa513a..23300c4 100644
--- a/README.rst
+++ b/README.rst
@@ -6,8 +6,8 @@ thus timing issue when testing Angular based websites. The library does this by
 providing first an implicit wait and, subsequently, an explicit keyword for
 waiting on angular.
 
-About the support for various Angular versions and overall status of this library
----------------------------------------------------------------------------------
+About this library
+------------------
 The AngularJSLibrary, despite the name including JS, supports testing against
 both Angular 2.0+ (known as simply Angular) and Angular 1.0 (also known as
 Angular JS).
@@ -188,23 +188,18 @@ off and using instead the library's explicit `Wait For Angular` keyword.
         Wait For Angular
         Element Text Should Be    css:phone-detail h1    Samsung Galaxy Tab™
 
-The expected and designed usage of this library is to use the implicit wait in
-almost all cases. The reasoning is that it makes for a much cleaner and clearer
-test case. Note currently the implicit wait is not invoked when using a web
-element as the locator.
-
-In addition to the option to turn off the implicit wait on libray import, you
-may turn it off using the :code:`Set Ignore Implicit Angular Wait` keyword with
-an argument of :code:`${True}`. 
-
 With the implicit wait functionality it is expected that most of the situations
 where waiting is needed will be handled "automatically" by this "hidden" implicit
 wait. Thus if one examined your test case they would not see many, if any,
 `Wait For Angular` keywords but instead would see actions keywords with no
-"waiting" keywords in between actions. There are though times when one needs to
+"waiting" keywords in between actions. There are times, though, when one needs to
 explicitly call out to wait for angular. For example when using a SeleniumLibrary
 keyword that does not use a locator strategy, like :code:`Alert Should Be Present`
-and :code:`Page should contain ...`, or if you use webelement.
+and :code:`Page should contain`, or if you use webelement.
+
+In addition to the option to turn off the implicit wait on library import, you
+may turn it off using the :code:`Set Ignore Implicit Angular Wait` keyword with
+an argument of :code:`${True}`. 
 
 
 Understanding and verifying the angular waits

From 384ce292c3b3cc2d1bdff52bc1557e1ef57b6180 Mon Sep 17 00:00:00 2001
From: Ed Manlove <emanlove@verizon.net>
Date: Fri, 26 May 2023 11:22:14 -0400
Subject: [PATCH 10/12] Fixed link for Robot Framework community Slack

---
 README.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.rst b/README.rst
index 23300c4..0767ad9 100644
--- a/README.rst
+++ b/README.rst
@@ -346,7 +346,7 @@ Finally there is the strategy of find by repeat. This takes the general form of
 
 Getting Help
 ------------
-If you need help with AngularJSLibrary, SeleniumLibrary, or Robot Framework usage, please reach out within the Robot Framework community `Slack <>`_ [`Invite to join community slack <https://rf-invite.herokuapp.com/>`_].
+If you need help with AngularJSLibrary, SeleniumLibrary, or Robot Framework usage, please reach out within the Robot Framework community `Slack <https://slack.robotframework.org/>`_.
 
     
 Keyword Documentation

From b5975a6d06c8d7fd61bdf274439780b19ce263d2 Mon Sep 17 00:00:00 2001
From: Ed Manlove <emanlove@verizon.net>
Date: Fri, 26 May 2023 12:18:49 -0400
Subject: [PATCH 11/12] Updated notes on angular specific locator strategies

---
 README.rst | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/README.rst b/README.rst
index 0767ad9..d7f1023 100644
--- a/README.rst
+++ b/README.rst
@@ -299,16 +299,16 @@ easier to see and read.] I have personally used this myself both in developing
 this library as well as demonstrating to various Angular developers how a
 design/implementation is blocking testability.
 
-Usage of the Angular Specific Locator Strategies
+Additional Angular Specific Locator Strategies
 -------------------------------------------------
-The new locator strategies include
-
-.. code::
-
-    binding=
-    model=
-    repeater=
-
+**Note: It is no longer recommended to use these angular specific locator
+strategies. Although functional, the SeleniumLibrary locator strategies are more
+than sufficient and in most cases easier to use then these strategies. For backward
+compatablity reasons these will be left in but it is strongly recommended not to
+use.**
+
+The library provides three new locator strategies, including ``binding``,
+``model``, and ``repeater``.
 
 For example, you can look for an Angular ng-binding using
 

From fe0c9f555ee1edf7d70de645aba32e6cd5119f98 Mon Sep 17 00:00:00 2001
From: Ed Manlove <emanlove@verizon.net>
Date: Thu, 22 Feb 2024 21:30:22 -0500
Subject: [PATCH 12/12] Clarrifying the status of the AngularJSLibrary

It has been noted that some feel this library is no longer "useful" as
there have been very little changes of late. Instead it is because this
is mature and stable library providing a very specific functionality,
provide it well, and has very little need for change. Thus I am updating
the metadata on this project to reflect this reality.

I think I may need to say as such within the project documentation but
that can come in another commit.
---
 setup.py | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/setup.py b/setup.py
index 57aa0a2..afd9efa 100644
--- a/setup.py
+++ b/setup.py
@@ -1,8 +1,8 @@
-"""An AngularJS extension to Robotframework's Selenium2Library
+"""An AngularJS/Angular extension to Robotframework's SeleniumLibrary
 
 See:
 http://robotframework.org/
-https://github.com/Selenium2Library/robotframework-angularjs
+https://github.com/MarketSquare/robotframework-angularjs
 """
 
 from setuptools import setup, find_packages
@@ -17,20 +17,21 @@
 
 setup(
     name='robotframework-angularjs',
-    version='0.0.11dev1',
-    description="""An AngularJS extension to Robotframework's Selenium2Library""",
+    version='1.0.0',
+    description="""An AngularJS/Angular extension to Robotframework's SeleniumLibrary""",
     long_description=long_description,
     long_description_content_type='text/x-rst',
-    url='https://github.com/Selenium2Library/robotframework-angularjs',
+    url='https://github.com/MarketSquare/robotframework-angularjs',
     author='Zephraph, Ed Manlove',
-    author_email='zephraph@gmail.com, devPyPlTw@verizon.net',
+    author_email='emanlove@verizon.net',
     license='Apache License 2.0',
     classifiers=[
-        'Development Status :: 3 - Alpha',
+        'Development Status :: 6 - Mature',
         'Framework :: Robot Framework',
         'License :: OSI Approved :: Apache Software License',
         'Operating System :: OS Independent',
         'Programming Language :: Python',
+        'Programming Language :: Python :: 3',
         'Topic :: Software Development :: Testing',
     ],
     keywords='robotframework testing testautomation angular selenium webdriver',