From 25b6ba874d3de09d5add654a2fff9c87c9ab2280 Mon Sep 17 00:00:00 2001 From: Ivan Maslov Date: Sun, 20 Dec 2020 17:41:39 +0300 Subject: [PATCH] #add sphinx autodoc prototype with __Orchestrator__ guide in eng --- Sources/ENG_GuideSphinxGenerate.cmd | 6 + Sources/GuideSphinx/Makefile | 20 + Sources/GuideSphinx/Orchestrator.rst | 26 + Sources/GuideSphinx/conf.py | 55 + Sources/GuideSphinx/index.rst | 29 + Sources/GuideSphinx/make_ENG_Guide.bat | 39 + Sources/pyOpenRPA/Agent/__Agent__.py | 1 + Sources/pyOpenRPA/Agent/readme.md | 2 + .../Orchestrator/__Orchestrator__.py | 545 +- Wiki/ENG_Guide/doctrees/Orchestrator.doctree | Bin 0 -> 233927 bytes Wiki/ENG_Guide/doctrees/environment.pickle | Bin 0 -> 102574 bytes Wiki/ENG_Guide/doctrees/index.doctree | Bin 0 -> 234198 bytes Wiki/ENG_Guide/html/.buildinfo | 4 + Wiki/ENG_Guide/html/Orchestrator.html | 999 ++ Wiki/ENG_Guide/html/_modules/index.html | 158 + .../Orchestrator/__Orchestrator__.html | 1531 +++ .../html/_sources/Orchestrator.rst.txt | 26 + Wiki/ENG_Guide/html/_sources/index.rst.txt | 29 + Wiki/ENG_Guide/html/_static/basic.css | 856 ++ Wiki/ENG_Guide/html/_static/doctools.js | 316 + .../html/_static/documentation_options.js | 12 + Wiki/ENG_Guide/html/_static/file.png | Bin 0 -> 286 bytes Wiki/ENG_Guide/html/_static/jquery-3.5.1.js | 10872 ++++++++++++++++ Wiki/ENG_Guide/html/_static/jquery.js | 2 + Wiki/ENG_Guide/html/_static/language_data.js | 297 + Wiki/ENG_Guide/html/_static/minus.png | Bin 0 -> 90 bytes Wiki/ENG_Guide/html/_static/plus.png | Bin 0 -> 90 bytes Wiki/ENG_Guide/html/_static/pygments.css | 74 + Wiki/ENG_Guide/html/_static/pygments_dark.css | 83 + Wiki/ENG_Guide/html/_static/scripts/main.js | 2 + .../html/_static/scripts/main.js.map | 1 + Wiki/ENG_Guide/html/_static/searchtools.js | 514 + .../ENG_Guide/html/_static/styles/default.css | 2 + .../html/_static/styles/default.css.map | 1 + .../html/_static/styles/furo-extensions.css | 2 + .../_static/styles/furo-extensions.css.map | 1 + Wiki/ENG_Guide/html/_static/styles/furo.css | 2 + .../html/_static/styles/furo.css.map | 1 + .../html/_static/underscore-1.3.1.js | 999 ++ Wiki/ENG_Guide/html/_static/underscore.js | 31 + Wiki/ENG_Guide/html/genindex.html | 50 + Wiki/ENG_Guide/html/index.html | 997 ++ Wiki/ENG_Guide/html/objects.inv | 12 + Wiki/ENG_Guide/html/py-modindex.html | 50 + Wiki/ENG_Guide/html/search.html | 166 + Wiki/ENG_Guide/html/searchindex.js | 1 + Wiki/ENG_Guide/markdown/Orchestrator.md | 1105 ++ Wiki/ENG_Guide/markdown/index.md | 1105 ++ .../Basic Syntax _ Markdown Guide.html | 0 ...70b406c047460fe.js.Без названия | 0 ...55a6d475561dbe9.js.Без названия | 0 ...c5944412d3c5855eb1f26f2dc9a339c6170fff.css | 0 .../anchor.min.js.Без названия | 0 .../docsearch.min.js.Без названия | 0 .../markdown-mark-white.svg | 0 .../philly-magic-garden.jpg | Bin .../shiprock.jpg | Bin .../tux.png | Bin 58 files changed, 20926 insertions(+), 98 deletions(-) create mode 100644 Sources/ENG_GuideSphinxGenerate.cmd create mode 100644 Sources/GuideSphinx/Makefile create mode 100644 Sources/GuideSphinx/Orchestrator.rst create mode 100644 Sources/GuideSphinx/conf.py create mode 100644 Sources/GuideSphinx/index.rst create mode 100644 Sources/GuideSphinx/make_ENG_Guide.bat create mode 100644 Sources/pyOpenRPA/Agent/readme.md create mode 100644 Wiki/ENG_Guide/doctrees/Orchestrator.doctree create mode 100644 Wiki/ENG_Guide/doctrees/environment.pickle create mode 100644 Wiki/ENG_Guide/doctrees/index.doctree create mode 100644 Wiki/ENG_Guide/html/.buildinfo create mode 100644 Wiki/ENG_Guide/html/Orchestrator.html create mode 100644 Wiki/ENG_Guide/html/_modules/index.html create mode 100644 Wiki/ENG_Guide/html/_modules/pyOpenRPA/Orchestrator/__Orchestrator__.html create mode 100644 Wiki/ENG_Guide/html/_sources/Orchestrator.rst.txt create mode 100644 Wiki/ENG_Guide/html/_sources/index.rst.txt create mode 100644 Wiki/ENG_Guide/html/_static/basic.css create mode 100644 Wiki/ENG_Guide/html/_static/doctools.js create mode 100644 Wiki/ENG_Guide/html/_static/documentation_options.js create mode 100644 Wiki/ENG_Guide/html/_static/file.png create mode 100644 Wiki/ENG_Guide/html/_static/jquery-3.5.1.js create mode 100644 Wiki/ENG_Guide/html/_static/jquery.js create mode 100644 Wiki/ENG_Guide/html/_static/language_data.js create mode 100644 Wiki/ENG_Guide/html/_static/minus.png create mode 100644 Wiki/ENG_Guide/html/_static/plus.png create mode 100644 Wiki/ENG_Guide/html/_static/pygments.css create mode 100644 Wiki/ENG_Guide/html/_static/pygments_dark.css create mode 100644 Wiki/ENG_Guide/html/_static/scripts/main.js create mode 100644 Wiki/ENG_Guide/html/_static/scripts/main.js.map create mode 100644 Wiki/ENG_Guide/html/_static/searchtools.js create mode 100644 Wiki/ENG_Guide/html/_static/styles/default.css create mode 100644 Wiki/ENG_Guide/html/_static/styles/default.css.map create mode 100644 Wiki/ENG_Guide/html/_static/styles/furo-extensions.css create mode 100644 Wiki/ENG_Guide/html/_static/styles/furo-extensions.css.map create mode 100644 Wiki/ENG_Guide/html/_static/styles/furo.css create mode 100644 Wiki/ENG_Guide/html/_static/styles/furo.css.map create mode 100644 Wiki/ENG_Guide/html/_static/underscore-1.3.1.js create mode 100644 Wiki/ENG_Guide/html/_static/underscore.js create mode 100644 Wiki/ENG_Guide/html/genindex.html create mode 100644 Wiki/ENG_Guide/html/index.html create mode 100644 Wiki/ENG_Guide/html/objects.inv create mode 100644 Wiki/ENG_Guide/html/py-modindex.html create mode 100644 Wiki/ENG_Guide/html/search.html create mode 100644 Wiki/ENG_Guide/html/searchindex.js create mode 100644 Wiki/ENG_Guide/markdown/Orchestrator.md create mode 100644 Wiki/ENG_Guide/markdown/index.md rename Wiki/{Help => _}/Basic Syntax _ Markdown Guide.html (100%) rename Wiki/{Help => _}/Basic Syntax _ Markdown Guide_files/1066bc339a3beded5f6c4279870b406c047460fe.js.Без названия (100%) rename Wiki/{Help => _}/Basic Syntax _ Markdown Guide_files/2c5110a7ae8f1f020352b27cb55a6d475561dbe9.js.Без названия (100%) rename Wiki/{Help => _}/Basic Syntax _ Markdown Guide_files/2cc5944412d3c5855eb1f26f2dc9a339c6170fff.css (100%) rename Wiki/{Help => _}/Basic Syntax _ Markdown Guide_files/anchor.min.js.Без названия (100%) rename Wiki/{Help => _}/Basic Syntax _ Markdown Guide_files/docsearch.min.js.Без названия (100%) rename Wiki/{Help => _}/Basic Syntax _ Markdown Guide_files/markdown-mark-white.svg (100%) rename Wiki/{Help => _}/Basic Syntax _ Markdown Guide_files/philly-magic-garden.jpg (100%) rename Wiki/{Help => _}/Basic Syntax _ Markdown Guide_files/shiprock.jpg (100%) rename Wiki/{Help => _}/Basic Syntax _ Markdown Guide_files/tux.png (100%) diff --git a/Sources/ENG_GuideSphinxGenerate.cmd b/Sources/ENG_GuideSphinxGenerate.cmd new file mode 100644 index 00000000..f3d79814 --- /dev/null +++ b/Sources/ENG_GuideSphinxGenerate.cmd @@ -0,0 +1,6 @@ +cd %~dp0 +RD /S /Q "%~dp0..\Wiki\ENG_Guide\doctrees" +RD /S /Q "%~dp0..\Wiki\ENG_Guide\html" +RD /S /Q "%~dp0..\Wiki\ENG_Guide\markdown" +GuideSphinx\make_ENG_Guide.bat html +pause >nul \ No newline at end of file diff --git a/Sources/GuideSphinx/Makefile b/Sources/GuideSphinx/Makefile new file mode 100644 index 00000000..d0c3cbf1 --- /dev/null +++ b/Sources/GuideSphinx/Makefile @@ -0,0 +1,20 @@ +# Minimal makefile for Sphinx documentation +# + +# You can set these variables from the command line, and also +# from the environment for the first two. +SPHINXOPTS ?= +SPHINXBUILD ?= sphinx-build +SOURCEDIR = source +BUILDDIR = build + +# Put it first so that "make" without argument is like "make help". +help: + @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) + +.PHONY: help Makefile + +# Catch-all target: route all unknown targets to Sphinx using the new +# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS). +%: Makefile + @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O) diff --git a/Sources/GuideSphinx/Orchestrator.rst b/Sources/GuideSphinx/Orchestrator.rst new file mode 100644 index 00000000..dbae85b5 --- /dev/null +++ b/Sources/GuideSphinx/Orchestrator.rst @@ -0,0 +1,26 @@ +.. pyOpenRPA documentation master file, created by + sphinx-quickstart on Sat Dec 19 23:59:00 2020. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +Welcome to pyOpenRPA's documentation! +===================================== + +.. toctree:: + :maxdepth: 2 + :caption: Contents: + + + +Indices and tables +===================================== + +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` + + +pyOpenRPA Orchestrator +===================================== +.. automodule:: pyOpenRPA.Orchestrator.__Orchestrator__ + :members: diff --git a/Sources/GuideSphinx/conf.py b/Sources/GuideSphinx/conf.py new file mode 100644 index 00000000..3e578d51 --- /dev/null +++ b/Sources/GuideSphinx/conf.py @@ -0,0 +1,55 @@ +# Configuration file for the Sphinx documentation builder. +# +# This file only contains a selection of the most common options. For a full +# list see the documentation: +# https://www.sphinx-doc.org/en/master/usage/configuration.html + +# -- Path setup -------------------------------------------------------------- + +# If extensions (or modules to document with autodoc) are in another directory, +# add these directories to sys.path here. If the directory is relative to the +# documentation root, use os.path.abspath to make it absolute, like shown here. +# +import os +import sys +sys.path.insert(0, os.path.abspath(r'..')) + + +# -- Project information ----------------------------------------------------- + +project = 'pyOpenRPA' +copyright = '2020, Ivan Maslov' +author = 'Ivan Maslov' + +# The full version, including alpha/beta/rc tags +release = 'v1.2.0' + + +# -- General configuration --------------------------------------------------- + +# Add any Sphinx extension module names here, as strings. They can be +# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom +# ones. +extensions = ['sphinx.ext.todo', 'sphinx.ext.viewcode', 'sphinx.ext.autodoc'] + +# Add any paths that contain templates here, relative to this directory. +templates_path = ['_templates'] + +# List of patterns, relative to source directory, that match files and +# directories to ignore when looking for source files. +# This pattern also affects html_static_path and html_extra_path. +exclude_patterns = [] + + +# -- Options for HTML output ------------------------------------------------- + +# The theme to use for HTML and HTML Help pages. See the documentation for +# a list of builtin themes. +# +#html_theme = 'alabaster' +html_theme = "furo" + +# Add any paths that contain custom static files (such as style sheets) here, +# relative to this directory. They are copied after the builtin static files, +# so a file named "default.css" will overwrite the builtin "default.css". +html_static_path = ['_static'] \ No newline at end of file diff --git a/Sources/GuideSphinx/index.rst b/Sources/GuideSphinx/index.rst new file mode 100644 index 00000000..9b83f9e6 --- /dev/null +++ b/Sources/GuideSphinx/index.rst @@ -0,0 +1,29 @@ +.. pyOpenRPA documentation master file, created by + sphinx-quickstart on Sat Dec 19 23:59:00 2020. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +Welcome to pyOpenRPA's documentation! +===================================== + +.. toctree:: + :maxdepth: 2 + :caption: Contents: + :glob: + :titlesonly: + Orchestrator + * + + +Indices and tables +===================================== + +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` + + +pyOpenRPA Orchestrator +===================================== +.. automodule:: pyOpenRPA.Orchestrator.__Orchestrator__ + :members: diff --git a/Sources/GuideSphinx/make_ENG_Guide.bat b/Sources/GuideSphinx/make_ENG_Guide.bat new file mode 100644 index 00000000..7c357bd7 --- /dev/null +++ b/Sources/GuideSphinx/make_ENG_Guide.bat @@ -0,0 +1,39 @@ +cd %~dp0 +@ECHO OFF +set PATH=%PATH%;%~dp0..\..\Resources\WPy64-3720\python-3.7.2.amd64\Scripts +set PYTHONPATH=%PATH%;%~dp0..\..\Resources\WPy64-3720\python-3.7.2.amd64\Scripts +pushd %~dp0 + +REM Command file for Sphinx documentation + +if "%SPHINXBUILD%" == "" ( + set SPHINXBUILD=sphinx-build +) +set SOURCEDIR=%~dp0 +set BUILDDIR=..\..\Wiki\ENG_Guide + +if "%1" == "" goto help + +%SPHINXBUILD% >NUL 2>NUL +if errorlevel 9009 ( + echo. + echo.The 'sphinx-build' command was not found. Make sure you have Sphinx + echo.installed, then set the SPHINXBUILD environment variable to point + echo.to the full path of the 'sphinx-build' executable. Alternatively you + echo.may add the Sphinx directory to PATH. + echo. + echo.If you don't have Sphinx installed, grab it from + echo.http://sphinx-doc.org/ + exit /b 1 +) + +%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% +%SPHINXBUILD% -M markdown %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% +goto end + +:help +%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O% + +:end +popd +pause>nul diff --git a/Sources/pyOpenRPA/Agent/__Agent__.py b/Sources/pyOpenRPA/Agent/__Agent__.py index d17a77d1..2f4e670b 100644 --- a/Sources/pyOpenRPA/Agent/__Agent__.py +++ b/Sources/pyOpenRPA/Agent/__Agent__.py @@ -4,6 +4,7 @@ from . import Processor # Processor Queue # Create binary file by the base64 string (safe for JSON transmition) def OSFileBinaryDataBase64StrCreate(inFilePathStr, inFileDataBase64Str,inGSettings = None): + """ Create binary file by the base64 string (safe for JSON transmition)""" lFile = open(inFilePathStr, "wb") lFile.write(base64.b64decode(inFileDataBase64Str)) lFile.close() diff --git a/Sources/pyOpenRPA/Agent/readme.md b/Sources/pyOpenRPA/Agent/readme.md new file mode 100644 index 00000000..9b46cac7 --- /dev/null +++ b/Sources/pyOpenRPA/Agent/readme.md @@ -0,0 +1,2 @@ +# TEST +Hello world \ No newline at end of file diff --git a/Sources/pyOpenRPA/Orchestrator/__Orchestrator__.py b/Sources/pyOpenRPA/Orchestrator/__Orchestrator__.py index 1e4c0d14..d9b22477 100644 --- a/Sources/pyOpenRPA/Orchestrator/__Orchestrator__.py +++ b/Sources/pyOpenRPA/Orchestrator/__Orchestrator__.py @@ -27,20 +27,35 @@ global gSettingsDict # AGENT DEFS -# Add activity in AgentDict def AgentActivityItemAdd(inGSettings, inHostNameStr, inUserStr, inActivityItemDict): - # Check if item is created + """ + Add activity in AgentDict. Check if item is created + + :param inGSettings: Global settings dict (singleton) + :param inHostNameStr: Agent host name + :param inUserStr: User login, where agent is based + :param inActivityItemDict: ActivityItem + :return: sad + """ lAgentDictItemKeyTurple = (inHostNameStr.upper(),inUserStr.upper()) if lAgentDictItemKeyTurple not in inGSettings["AgentDict"]: inGSettings["AgentDict"][lAgentDictItemKeyTurple] = SettingsTemplate.__AgentDictItemCreate__() lThisAgentDict = inGSettings["AgentDict"][lAgentDictItemKeyTurple] lThisAgentDict["ActivityList"].append(inActivityItemDict) -# Send to agent activity item to OSCMD + def AgentOSCMD(inGSettings, inHostNameStr, inUserStr, inCMDStr, inRunAsyncBool=True): - # pyOpenRPA.Agent: Send CMD to OS. Result return to log + Orchestrator by the A2O connection - # def OSCMD(inCMDStr, inRunAsyncBool=True, inGSettings=None): - # Create Activity Item for the agent + """ + pyOpenRPA.Agent: Send CMD to OS. Result return to log + Orchestrator by the A2O connection + def OSCMD(inCMDStr, inRunAsyncBool=True, inGSettings=None): + Send to agent activity item to OSCMD + + :param inGSettings: Global settings dict (singleton) + :param inHostNameStr: + :param inUserStr: + :param inCMDStr: + :param inRunAsyncBool: + """ lActivityItemDict = { "Def":"OSCMD", # def alias (look pyOpeRPA.Agent gSettings["ProcessorDict"]["AliasDefDict"]) "ArgList":[], # Args list @@ -51,11 +66,19 @@ def AgentOSCMD(inGSettings, inHostNameStr, inUserStr, inCMDStr, inRunAsyncBool=T #Send item in AgentDict for the futher data transmition AgentActivityItemAdd(inGSettings=inGSettings, inHostNameStr=inHostNameStr, inUserStr=inUserStr, inActivityItemDict=lActivityItemDict) -# Send binary file to Agent (Bytes) def AgentOSFileBinaryDataBytesCreate(inGSettings, inHostNameStr, inUserStr, inFilePathStr, inFileDataBytes): - # pyOpenRPA.Agent: Create binary file by the base64 string (safe for JSON transmition) - # def OSFileBinaryDataBase64StrCreate(inFilePathStr, inFileDataBase64Str,inGSettings = None): - # Create Activity Item for the agent + """ + pyOpenRPA.Agent: Create binary file by the base64 string (safe for JSON transmition) + def OSFileBinaryDataBase64StrCreate(inFilePathStr, inFileDataBase64Str,inGSettings = None): + Send binary file to Agent (Bytes) + + :param inGSettings: Global settings dict (singleton) + :param inHostNameStr: + :param inUserStr: + :param inFilePathStr: + :param inFileDataBytes: + """ + lFileDataBase64Str = base64.b64encode(inFileDataBytes).decode("utf-8") lActivityItemDict = { "Def":"OSFileBinaryDataBase64StrCreate", # def alias (look pyOpeRPA.Agent gSettings["ProcessorDict"]["AliasDefDict"]) @@ -67,11 +90,20 @@ def AgentOSFileBinaryDataBytesCreate(inGSettings, inHostNameStr, inUserStr, inFi #Send item in AgentDict for the futher data transmition AgentActivityItemAdd(inGSettings=inGSettings, inHostNameStr=inHostNameStr, inUserStr=inUserStr, inActivityItemDict=lActivityItemDict) -# Send binary file to Agent (base64 string) + def AgentOSFileBinaryDataBase64StrCreate(inGSettings, inHostNameStr, inUserStr, inFilePathStr, inFileDataBase64Str): - # pyOpenRPA.Agent: Create binary file by the base64 string (safe for JSON transmission) - # def OSFileBinaryDataBase64StrCreate(inFilePathStr, inFileDataBase64Str,inGSettings = None): - # Create Activity Item for the agent + """ + pyOpenRPA.Agent: Create binary file by the base64 string (safe for JSON transmission) + def OSFileBinaryDataBase64StrCreate(inFilePathStr, inFileDataBase64Str,inGSettings = None): + Send binary file to Agent (base64 string) + + :param inGSettings: Global settings dict (singleton) + :param inHostNameStr: + :param inUserStr: + :param inFilePathStr: + :param inFileDataBase64Str: + """ + lActivityItemDict = { "Def":"OSFileBinaryDataBase64StrCreate", # def alias (look pyOpeRPA.Agent gSettings["ProcessorDict"]["AliasDefDict"]) "ArgList":[], # Args list @@ -84,9 +116,19 @@ def AgentOSFileBinaryDataBase64StrCreate(inGSettings, inHostNameStr, inUserStr, # Send text file to Agent (string) def AgentOSFileTextDataStrCreate(inGSettings, inHostNameStr, inUserStr, inFilePathStr, inFileDataStr, inEncodingStr = "utf-8"): - # pyOpenRPA.Agent: Create text file by the string - # def OSFileTextDataStrCreate(inFilePathStr, inFileDataStr, inEncodingStr = "utf-8",inGSettings = None): - # Create Activity Item for the agent + """ + pyOpenRPA.Agent: Create text file by the string + def OSFileTextDataStrCreate(inFilePathStr, inFileDataStr, inEncodingStr = "utf-8",inGSettings = None): + Create Activity Item for the agent + + :param inGSettings: Global settings dict (singleton) + :param inHostNameStr: + :param inUserStr: + :param inFilePathStr: + :param inFileDataStr: + :param inEncodingStr: + """ + lActivityItemDict = { "Def":"OSFileTextDataStrCreate", # def alias (look pyOpeRPA.Agent gSettings["ProcessorDict"]["AliasDefDict"]) "ArgList":[], # Args list @@ -98,8 +140,15 @@ def AgentOSFileTextDataStrCreate(inGSettings, inHostNameStr, inUserStr, inFilePa AgentActivityItemAdd(inGSettings=inGSettings, inHostNameStr=inHostNameStr, inUserStr=inUserStr, inActivityItemDict=lActivityItemDict) # OS DEFS -# Defs to use in orchestrator -def OSCredentialsVerify(inUserStr, inPasswordStr, inDomainStr=""): ## Verify credentials in windows +def OSCredentialsVerify(inUserStr, inPasswordStr, inDomainStr=""): ## + """ + Verify user credentials in windows. Return bool + + :param inUserStr: + :param inPasswordStr: + :param inDomainStr: + :return: True - Credentials are actual; False - Credentials are not actual + """ try: hUser = win32security.LogonUser( inUserStr,inDomainStr, inPasswordStr, @@ -110,7 +159,15 @@ def OSCredentialsVerify(inUserStr, inPasswordStr, inDomainStr=""): ## Verify cre else: return True -def OSCMD(inCMDStr, inRunAsyncBool=True, inLogger = None): ## OS send command in shell locally +def OSCMD(inCMDStr, inRunAsyncBool=True, inLogger = None): + """ + OS send command in shell locally + + :param inCMDStr: + :param inRunAsyncBool: + :param inLogger: + :return: CMD result string + """ lResultStr = "" # Subdef to listen OS result def _CMDRunAndListenLogs(inCMDStr, inLogger): @@ -143,7 +200,12 @@ def OSCMD(inCMDStr, inRunAsyncBool=True, inLogger = None): ## OS send command in #lResultCMDRun = 1 # os.system(lCMDCode) return lResultStr -def OrchestratorRestart(inGSettings=None): ## Orchestrator restart +def OrchestratorRestart(inGSettings=None): + """ + Orchestrator restart + + :param inGSettings: Global settings dict (singleton) + """ OrchestratorSessionSave(inGSettings=inGSettings) # Dump RDP List in file json if inGSettings is not None: lL = inGSettings["Logger"] @@ -152,25 +214,44 @@ def OrchestratorRestart(inGSettings=None): ## Orchestrator restart os.execl(sys.executable, os.path.abspath(__file__), *sys.argv) sys.exit(0) -def OrchestratorSessionSave(inGSettings=None): ## Orchestrator session save - # Dump RDP List in file json - lFile = open("_SessionLast_RDPList.json", "w", encoding="utf-8") - lFile.write(json.dumps(inGSettings["RobotRDPActive"]["RDPList"])) # dump json to file - lFile.close() # Close the file - if inGSettings is not None: - lL = inGSettings["Logger"] - if lL: lL.info( - f"Orchestrator has dump the RDP list before the restart.") - return True - -#Check is client is has access for the key list -def UACKeyListCheck(inRequest, inRoleKeyList): - return inRequest.UACClientCheck(inRoleKeyList=inRoleKeyList) +def OrchestratorSessionSave(inGSettings=None): + """ + Orchestrator session save in file _SessionLast_RDPList.json (encoding = "utf-8") + + :param inGSettings: Global settings dict (singleton) + :return: True every time + """ + # Dump RDP List in file json + lFile = open("_SessionLast_RDPList.json", "w", encoding="utf-8") + lFile.write(json.dumps(inGSettings["RobotRDPActive"]["RDPList"])) # dump json to file + lFile.close() # Close the file + if inGSettings is not None: + lL = inGSettings["Logger"] + if lL: lL.info( + f"Orchestrator has dump the RDP list before the restart.") + return True +def UACKeyListCheck(inRequest, inRoleKeyList) -> bool: + """ + Check is client is has access for the key list + :param inRequest: + :param inRoleKeyList: + :return: bool + """ + return inRequest.UACClientCheck(inRoleKeyList=inRoleKeyList) -# Update user access def UACUpdate(inGSettings, inADLoginStr, inADStr="", inADIsDefaultBool=True, inURLList=None, inRoleHierarchyAllowedDict=None): + """ + Update user access (UAC) + + :param inGSettings: Global settings dict (singleton) + :param inADLoginStr: + :param inADStr: + :param inADIsDefaultBool: + :param inURLList: + :param inRoleHierarchyAllowedDict: + """ lUserTurple = (inADStr.upper(),inADLoginStr.upper()) # Create turple key for inGSettings["ServerDict"]["AccessUsers"]["RuleDomainUserDict"] if inURLList is None: inURLList = [] # Check if None if inRoleHierarchyAllowedDict is None: inRoleHierarchyAllowedDict = {} # Check if None @@ -195,8 +276,13 @@ def UACUpdate(inGSettings, inADLoginStr, inADStr="", inADIsDefaultBool=True, inU # Case add default domain + user inGSettings["ServerDict"]["AccessUsers"]["RuleDomainUserDict"].update({("",inADLoginStr.upper()):lRuleDomainUserDict}) -# Add supertoken for the all access (it is need for the robot communication without human) def UACSuperTokenUpdate(inGSettings, inSuperTokenStr): + """ + Add supertoken for the all access (it is need for the robot communication without human) + + :param inGSettings: Global settings dict (singleton) + :param inSuperTokenStr: + """ lLoginStr = "SUPERTOKEN" UACUpdate(inGSettings=inGSettings, inADLoginStr=lLoginStr) inGSettings["ServerDict"]["AccessUsers"]["AuthTokensDict"].update( @@ -207,13 +293,23 @@ def UACSuperTokenUpdate(inGSettings, inSuperTokenStr): # OrchestratorWeb defs # # # # # # # # # # # # # # # # # # # # # # # -# Connect URL to DEF -# "inMethodStr":"GET|POST", -# "inURLStr": "/index", #URL of the request -# "inMatchTypeStr": "", #"BeginWith|Contains|Equal|EqualCase", -# "inContentTypeStr": "", #HTTP Content-type -# "inDef": None #Function with str result + def WebURLConnectDef(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inDef, inContentTypeStr="application/octet-stream"): + """ + Connect URL to DEF + "inMethodStr":"GET|POST", + "inURLStr": "/index", #URL of the request + "inMatchTypeStr": "", #"BeginWith|Contains|Equal|EqualCase", + "inContentTypeStr": "", #HTTP Content-type + "inDef": None #Function with str result + + :param inGSettings: Global settings dict (singleton) + :param inMethodStr: + :param inURLStr: + :param inMatchTypeStr: + :param inDef: + :param inContentTypeStr: + """ lURLItemDict = { "Method": inMethodStr.upper(), "URL": inURLStr, # URL of the request @@ -226,12 +322,21 @@ def WebURLConnectDef(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inDef, } inGSettings["ServerDict"]["URLList"].append(lURLItemDict) -# Connect URL to Folder -# "inMethodStr":"GET|POST", -# "inURLStr": "/Folder/", #URL of the request -# "inMatchTypeStr": "", #"BeginWith|Contains|Equal|EqualCase", -# "inFolderPathStr": "", #Absolute or relative path + def WebURLConnectFolder(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inFolderPathStr): + """ + Connect URL to Folder + "inMethodStr":"GET|POST", + "inURLStr": "/Folder/", #URL of the request + "inMatchTypeStr": "", #"BeginWith|Contains|Equal|EqualCase", + "inFolderPathStr": "", #Absolute or relative path + + :param inGSettings: Global settings dict (singleton) + :param inMethodStr: + :param inURLStr: + :param inMatchTypeStr: + :param inFolderPathStr: + """ # Check if last symbol is "/" - append if not exist lFolderPathStr = os.path.abspath(inFolderPathStr) if lFolderPathStr[-1]!="/":lFolderPathStr+="/" @@ -247,12 +352,22 @@ def WebURLConnectFolder(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inFo } inGSettings["ServerDict"]["URLList"].append(lURLItemDict) -# Connect URL to File -# "inMethodStr":"GET|POST", -# "inURLStr": "/index", #URL of the request -# "inMatchTypeStr": "", #"BeginWith|Contains|Equal|EqualCase", -# "inFolderPathStr": "", #Absolute or relative path + def WebURLConnectFile(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inFilePathStr, inContentTypeStr="application/octet-stream"): + """ + Connect URL to File + "inMethodStr":"GET|POST", + "inURLStr": "/index", #URL of the request + "inMatchTypeStr": "", #"BeginWith|Contains|Equal|EqualCase", + "inFolderPathStr": "", #Absolute or relative path + + :param inGSettings: Global settings dict (singleton) + :param inMethodStr: + :param inURLStr: + :param inMatchTypeStr: + :param inFilePathStr: + :param inContentTypeStr: + """ lURLItemDict = { "Method": inMethodStr.upper(), "URL": inURLStr, # URL of the request @@ -264,8 +379,16 @@ def WebURLConnectFile(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inFile } inGSettings["ServerDict"]["URLList"].append(lURLItemDict) -# Add control panel HTML, JSON generator or JS when page init def WebCPUpdate(inGSettings, inCPKeyStr, inHTMLRenderDef=None, inJSONGeneratorDef=None, inJSInitGeneratorDef=None): + """ + Add control panel HTML, JSON generator or JS when page init + + :param inGSettings: Global settings dict (singleton) + :param inCPKeyStr: + :param inHTMLRenderDef: + :param inJSONGeneratorDef: + :param inJSInitGeneratorDef: + """ # Create Struct if the re is current key if inCPKeyStr not in inGSettings["CPDict"]: inGSettings["CPDict"][inCPKeyStr] = {"HTMLRenderDef": None,"JSONGeneratorDef": None, "JSInitGeneratorDef": None} @@ -279,25 +402,49 @@ def WebCPUpdate(inGSettings, inCPKeyStr, inHTMLRenderDef=None, inJSONGeneratorDe if inJSInitGeneratorDef is not None: inGSettings["CPDict"][inCPKeyStr]["JSInitGeneratorDef"] = inJSInitGeneratorDef -# Return User info about request Return {"DomainUpperStr":"", "UserNameUpperStr": ""} def WebUserInfoGet(inRequest): + """ + Return User info about request + + :param inRequest: + :return: {"DomainUpperStr": "", "UserNameUpperStr": ""} + """ lDomainUpperStr = inRequest.OpenRPA["Domain"].upper() lUserUpperStr = inRequest.OpenRPA["User"].upper() return {"DomainUpperStr": lDomainUpperStr, "UserNameUpperStr": lUserUpperStr} -# Return bool if request is authentificated with supetoken (token which is never expires) def WebUserIsSuperToken(inRequest, inGSettings): + """ + Return bool if request is authentificated with supetoken (token which is never expires) + + :param inRequest: + :param inGSettings: Global settings dict (singleton) + :return: bool True - is supertoken; False - is not supertoken + """ lIsSuperTokenBool = False # Get Flag is supertoken (True|False) lIsSuperTokenBool = inGSettings.get("ServerDict", {}).get("AccessUsers", {}).get("AuthTokensDict", {}).get(inRequest.OpenRPA["AuthToken"], {}).get("FlagDoNotExpire", False) return lIsSuperTokenBool -# Return User UAC Hierarchy DICT Return {...} def WebUserUACHierarchyGet(inRequest): + """ + Return User UAC Hierarchy DICT Return {...} + + :param inRequest: + :return: UAC Dict {} + """ return inRequest.UserRoleHierarchyGet() ## GSettings defs -def GSettingsKeyListValueSet(inGSettings, inValue, inKeyList=None): # Set value in GSettings by the key list +def GSettingsKeyListValueSet(inGSettings, inValue, inKeyList=None): + """ + Set value in GSettings by the key list + + :param inGSettings: Global settings dict (singleton) + :param inValue: + :param inKeyList: + :return: bool + """ if inKeyList is None: inKeyList = [] lDict = inGSettings for lItem2 in inKeyList[:-1]: @@ -310,7 +457,14 @@ def GSettingsKeyListValueSet(inGSettings, inValue, inKeyList=None): # Set value lDict[inKeyList[-1]] = inValue #Set value return True -def GSettingsKeyListValueGet(inGSettings, inKeyList=None): # Get the value from the GSettings by the key list +def GSettingsKeyListValueGet(inGSettings, inKeyList=None): + """ + Get the value from the GSettings by the key list + + :param inGSettings: Global settings dict (singleton) + :param inKeyList: + :return: value any type + """ if inKeyList is None: inKeyList = [] lDict = inGSettings for lItem2 in inKeyList[:-1]: @@ -322,7 +476,15 @@ def GSettingsKeyListValueGet(inGSettings, inKeyList=None): # Get the value from lDict=lDict[lItem2] return lDict.get(inKeyList[-1],None) -def GSettingsKeyListValueAppend(inGSettings, inValue, inKeyList=None): # Append value in GSettings by the key list +def GSettingsKeyListValueAppend(inGSettings, inValue, inKeyList=None): + """ + Append value in GSettings by the key list + + :param inGSettings: Global settings dict (singleton) + :param inValue: + :param inKeyList: + :return: True every time + """ if inKeyList is None: inKeyList = [] lDict = inGSettings for lItem2 in inKeyList[:-1]: @@ -335,7 +497,15 @@ def GSettingsKeyListValueAppend(inGSettings, inValue, inKeyList=None): # Append lDict[inKeyList[-1]].append(inValue) #Set value return True -def GSettingsKeyListValueOperatorPlus(inGSettings, inValue, inKeyList=None): # Operator plus value in GSettings by the key list +def GSettingsKeyListValueOperatorPlus(inGSettings, inValue, inKeyList=None): + """ + Operator plus value in GSettings by the key list + + :param inGSettings: Global settings dict (singleton) + :param inValue: + :param inKeyList: + :return: True every time + """ if inKeyList is None: inKeyList = [] lDict = inGSettings for lItem2 in inKeyList[:-1]: @@ -348,9 +518,15 @@ def GSettingsKeyListValueOperatorPlus(inGSettings, inValue, inKeyList=None): # O lDict[inKeyList[-1]] += inValue #Set value return True -# Create alias for def (can be used in ActivityItem in field Def) -# return Alias str def ProcessorAliasDefCreate(inGSettings, inDef, inAliasStr=None): + """ + Create alias for def (can be used in ActivityItem in field Def) + + :param inGSettings: Global settings dict (singleton) + :param inDef: + :param inAliasStr: + :return: str Alias + """ lL = inGSettings["Logger"] if inAliasStr is None: inAliasStr = str(inDef) # Check if key is not exists @@ -360,15 +536,29 @@ def ProcessorAliasDefCreate(inGSettings, inDef, inAliasStr=None): inGSettings["ProcessorDict"]["AliasDefDict"][inAliasStr] = inDef return inAliasStr -# Update alias for def (can be used in ActivityItem in field Def) -# return Alias str def ProcessorAliasDefUpdate(inGSettings, inDef, inAliasStr): + """ + Update alias for def (can be used in ActivityItem in field Def) + + :param inGSettings: Global settings dict (singleton) + :param inDef: + :param inAliasStr: + :return: str Alias + """ inGSettings["ProcessorDict"]["AliasDefDict"][inAliasStr] = inDef return inAliasStr -# Create ActivityItem -# return dict def ProcessorActivityItemCreate(inDef, inArgList=None, inArgDict=None, inArgGSettingsStr=None, inArgLoggerStr=None): + """ + Create ActivityItem + + :param inDef: + :param inArgList: + :param inArgDict: + :param inArgGSettingsStr: + :param inArgLoggerStr: + :return: {} + """ if inArgList is None: inArgList=[] if inArgDict is None: inArgDict={} lActivityItemDict= { @@ -380,8 +570,17 @@ def ProcessorActivityItemCreate(inDef, inArgList=None, inArgDict=None, inArgGSet } return lActivityItemDict -# Add Activity item in Processor list def ProcessorActivityItemAppend(inGSettings, inDef, inArgList=None, inArgDict=None, inArgGSettingsStr=None, inArgLoggerStr=None): + """ + Add Activity item in Processor list + + :param inGSettings: Global settings dict (singleton) + :param inDef: + :param inArgList: + :param inArgDict: + :param inArgGSettingsStr: + :param inArgLoggerStr: + """ if inArgList is None: inArgList=[] if inArgDict is None: inArgDict={} lActivityList=[ @@ -397,9 +596,12 @@ def ProcessorActivityItemAppend(inGSettings, inDef, inArgList=None, inArgDict=No ## Process defs def ProcessIsStarted(inProcessNameWOExeStr): # Check if process is started - ''' + """ Check if there is any running process that contains the given name processName. - ''' + + :param inProcessNameWOExeStr: + :return: True - process is running; False - process is not running + """ #Iterate over the all the running process for proc in psutil.process_iter(): try: @@ -408,9 +610,16 @@ def ProcessIsStarted(inProcessNameWOExeStr): # Check if process is started return True except (psutil.NoSuchProcess, psutil.AccessDenied, psutil.ZombieProcess): pass - return False; + return False + +def ProcessStart(inPathStr, inArgList, inStopProcessNameWOExeStr=None): + """ + Start process locally [optional: if task name is not started] -def ProcessStart(inPathStr, inArgList, inStopProcessNameWOExeStr=None): # Start process locally [optional: if task name is not started] + :param inPathStr: + :param inArgList: + :param inStopProcessNameWOExeStr: + """ lStartProcessBool = True if inStopProcessNameWOExeStr is not None: #Check if process running lCheckTaskName = inStopProcessNameWOExeStr @@ -427,7 +636,15 @@ def ProcessStart(inPathStr, inArgList, inStopProcessNameWOExeStr=None): # Start lItemArgs.extend(inArgList) subprocess.Popen(lItemArgs,shell=True) -def ProcessStop(inProcessNameWOExeStr, inCloseForceBool, inUserNameStr = "%username%"): # Stop process +def ProcessStop(inProcessNameWOExeStr, inCloseForceBool, inUserNameStr = "%username%"): + """ + Stop process + + :param inProcessNameWOExeStr: + :param inCloseForceBool: + :param inUserNameStr: + :return: + """ # Support input arg if with .exe lProcessNameWExeStr = inProcessNameWOExeStr if len(lProcessNameWExeStr) > 4: @@ -445,8 +662,13 @@ def ProcessStop(inProcessNameWOExeStr, inCloseForceBool, inUserNameStr = "%usern # Kill process os.system(lActivityCloseCommand) -#Check activity of the list of processes def ProcessListGet(inProcessNameWOExeList=None): + """ + Check activity of the list of processes + + :param inProcessNameWOExeList: + :return: TODO FILL THE RESULT DICT + """ if inProcessNameWOExeList is None: inProcessNameWOExeList = [] '''Get list of running process sorted by Memory Usage and filtered by inProcessNameWOExeList''' lMapUPPERInput = {} # Mapping for processes WO exe @@ -457,7 +679,6 @@ def ProcessListGet(inProcessNameWOExeList=None): if lItem is not None: lProcessNameWOExeList.append(f"{lItem.upper()}.EXE") lMapUPPERInput[f"{lItem.upper()}.EXE"]= lItem - # # # Iterate over the list for proc in psutil.process_iter(): try: @@ -475,7 +696,17 @@ def ProcessListGet(inProcessNameWOExeList=None): return lResult # Python def - start module function -def PythonStart(inModulePathStr, inDefNameStr, inArgList=None, inArgDict=None, inLogger = None): # Python import module and start def +def PythonStart(inModulePathStr, inDefNameStr, inArgList=None, inArgDict=None, inLogger = None): + """ + Python import module and start def + + :param inModulePathStr: + :param inDefNameStr: + :param inArgList: + :param inArgDict: + :param inLogger: + :return: + """ if inArgList is None: inArgList=[] if inArgDict is None: inArgDict={} try: @@ -491,8 +722,16 @@ def PythonStart(inModulePathStr, inDefNameStr, inArgList=None, inArgDict=None, i # Scheduler # # # # # # # # # # # # # # # # # # # # # # # -# Add activity in time weekly def SchedulerActivityTimeAddWeekly(inGSettings, inTimeHHMMStr="23:55:", inWeekdayList=None, inActivityList=None): + """ + Add activity in time weekly + + :param inGSettings: Global settings dict (singleton) + :param inTimeHHMMStr: + :param inWeekdayList: + :param inActivityList: + :return: + """ if inWeekdayList is None: inWeekdayList=[] if inActivityList is None: inActivityList=[] lActivityTimeItemDict = { @@ -507,9 +746,22 @@ def SchedulerActivityTimeAddWeekly(inGSettings, inTimeHHMMStr="23:55:", inWeekda # RDPSession # # # # # # # # # # # # # # # # # # # # # # # -# Create some RDP template dict to use it when connect/reconnect def RDPTemplateCreate(inLoginStr, inPasswordStr, inHostStr="127.0.0.1", inPortInt = 3389, inWidthPXInt = 1680, inHeightPXInt = 1050, inUseBothMonitorBool = False, inDepthBitInt = 32, inSharedDriveList=None): + """ + Create some RDP template dict to use it when connect/reconnect + + :param inLoginStr: + :param inPasswordStr: + :param inHostStr: + :param inPortInt: + :param inWidthPXInt: + :param inHeightPXInt: + :param inUseBothMonitorBool: + :param inDepthBitInt: + :param inSharedDriveList: + :return: + """ if inSharedDriveList is None: inSharedDriveList = ["c"] lRDPTemplateDict= { # Init the configuration item "Host": inHostStr, # Host address, example "77.77.22.22" @@ -534,19 +786,36 @@ def RDPTemplateCreate(inLoginStr, inPasswordStr, inHostStr="127.0.0.1", inPortIn } return lRDPTemplateDict -# Search dublicates in GSettings RDPlist TODO! +# TODO Search dublicates in GSettings RDPlist ! # Return list if dublicates def RDPSessionDublicatesResolve(inGSettings): + """ + Search dublicates in GSettings RDPlist + !def is developing! + + :param inGSettings: Global settings dict (singleton) + :return: + """ pass #for lItemKeyStr in inGSettings["RobotRDPActive"]["RDPList"]: # lItemDict = inGSettings["RobotRDPActive"]["RDPList"][lItemKeyStr] - -# Create new RDPSession in RobotRDPActive. Attention - activity will be ignored if key is exists -# 2 way of the use -# Var 1: inGSettings, inRDPSessionKeyStr, inRDPTemplateDict -# Var 2 (Backward compatibility): inGSettings, inRDPSessionKeyStr, inHostStr, inPortStr, inLoginStr, inPasswordStr def RDPSessionConnect(inGSettings, inRDPSessionKeyStr, inRDPTemplateDict=None, inHostStr=None, inPortStr=None, inLoginStr=None, inPasswordStr=None): + """ + Create new RDPSession in RobotRDPActive. Attention - activity will be ignored if key is exists + 2 way of the use + Var 1: inGSettings, inRDPSessionKeyStr, inRDPTemplateDict + Var 2 (Backward compatibility): inGSettings, inRDPSessionKeyStr, inHostStr, inPortStr, inLoginStr, inPasswordStr + + :param inGSettings: Global settings dict (singleton) + :param inRDPSessionKeyStr: + :param inRDPTemplateDict: + :param inHostStr: + :param inPortStr: + :param inLoginStr: + :param inPasswordStr: + :return: True every time + """ # Check thread if not Core.IsProcessorThread(inGSettings=inGSettings): if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP def was called not from processor queue - activity will be append in the processor queue.") @@ -575,8 +844,15 @@ def RDPSessionConnect(inGSettings, inRDPSessionKeyStr, inRDPTemplateDict=None, i if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP session was not created because it is alredy exists in the RDPList. Use RDPSessionReconnect if you want to update RDP configuration.") return True -# Disconnect the RDP session def RDPSessionDisconnect(inGSettings, inRDPSessionKeyStr, inBreakTriggerProcessWOExeList = None): + """ + Disconnect the RDP session + + :param inGSettings: Global settings dict (singleton) + :param inRDPSessionKeyStr: + :param inBreakTriggerProcessWOExeList: + :return: True every time + """ if inBreakTriggerProcessWOExeList is None: inBreakTriggerProcessWOExeList = [] # Check thread if not Core.IsProcessorThread(inGSettings=inGSettings): @@ -601,8 +877,15 @@ def RDPSessionDisconnect(inGSettings, inRDPSessionKeyStr, inBreakTriggerProcessW Connector.SystemRDPWarningClickOk() # Click all warning messages return True -# RDP Session reconnect def RDPSessionReconnect(inGSettings, inRDPSessionKeyStr, inRDPTemplateDict=None): + """ + RDP Session reconnect + + :param inGSettings: Global settings dict (singleton) + :param inRDPSessionKeyStr: + :param inRDPTemplateDict: + :return: + """ # Check thread if not Core.IsProcessorThread(inGSettings=inGSettings): if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP def was called not from processor queue - activity will be append in the processor queue.") @@ -625,14 +908,27 @@ def RDPSessionReconnect(inGSettings, inRDPSessionKeyStr, inRDPTemplateDict=None) Connector.Session(lRDPConfigurationItem) return True -# Stop track the RDP session. Current def dont kill RDP session - only stop to track it (it can give ) def RDPSessionMonitorStop(inGSettings, inRDPSessionKeyStr): + """ + Stop track the RDP session. Current def dont kill RDP session - only stop to track it (it can give ) + + :param inGSettings: Global settings dict (singleton) + :param inRDPSessionKeyStr: + :return: + """ lResult = True inGSettings["RobotRDPActive"]["RDPList"].pop(inRDPSessionKeyStr,None) # Remove item from RDPList return lResult -# Logoff the RDP session def RDPSessionLogoff(inGSettings, inRDPSessionKeyStr, inBreakTriggerProcessWOExeList = None): + """ + Logoff the RDP session + + :param inGSettings: Global settings dict (singleton) + :param inRDPSessionKeyStr: + :param inBreakTriggerProcessWOExeList: + :return: True - logoff is successful + """ if inBreakTriggerProcessWOExeList is None: inBreakTriggerProcessWOExeList = [] lResult = True # Check thread @@ -660,8 +956,14 @@ def RDPSessionLogoff(inGSettings, inRDPSessionKeyStr, inBreakTriggerProcessWOExe inGSettings["RobotRDPActive"]["RDPList"].pop(inRDPSessionKeyStr,None) # Remove item from RDPList return lResult -# Check RDP Session responsibility TODO NEED DEV + TEST def RDPSessionResponsibilityCheck(inGSettings, inRDPSessionKeyStr): + """ + Check RDP Session responsibility TODO NEED DEV + TEST + + :param inGSettings: Global settings dict (singleton) + :param inRDPSessionKeyStr: + :return: True every time + """ # Check thread if not Core.IsProcessorThread(inGSettings=inGSettings): if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP def was called not from processor queue - activity will be append in the processor queue.") @@ -697,8 +999,17 @@ def RDPSessionResponsibilityCheck(inGSettings, inRDPSessionKeyStr): lDoCheckResponsibilityCountCurrent+=1 return True -# Start process if it is not running def RDPSessionProcessStartIfNotRunning(inGSettings, inRDPSessionKeyStr, inProcessNameWEXEStr, inFilePathStr, inFlagGetAbsPathBool=True): + """ + Start process if it is not running + + :param inGSettings: Global settings dict (singleton) + :param inRDPSessionKeyStr: + :param inProcessNameWEXEStr: + :param inFilePathStr: + :param inFlagGetAbsPathBool: + :return: + """ # Check thread if not Core.IsProcessorThread(inGSettings=inGSettings): if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP def was called not from processor queue - activity will be append in the processor queue.") @@ -721,8 +1032,16 @@ def RDPSessionProcessStartIfNotRunning(inGSettings, inRDPSessionKeyStr, inProces inRDPConfigurationItem=inGSettings["RobotRDPActive"]["RDPList"][inRDPSessionKeyStr]) return lResult - def RDPSessionCMDRun(inGSettings, inRDPSessionKeyStr, inCMDStr, inModeStr="CROSSCHECK"): + """ + Send command in RDP session + + :param inGSettings: Global settings dict (singleton) + :param inRDPSessionKeyStr: + :param inCMDStr: + :param inModeStr: + :return: True - CMD was executed successfully + """ # Check thread if not Core.IsProcessorThread(inGSettings=inGSettings): if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP def was called not from processor queue - activity will be append in the processor queue.") @@ -743,8 +1062,17 @@ def RDPSessionCMDRun(inGSettings, inRDPSessionKeyStr, inCMDStr, inModeStr="CROSS Connector.SessionCMDRun(inSessionHex=lSessionHex, inCMDCommandStr=inCMDStr, inModeStr=inModeStr, inLogger=inGSettings["Logger"], inRDPConfigurationItem=inGSettings["RobotRDPActive"]["RDPList"][inRDPSessionKeyStr]) return lResult -# Create CMD str to stop process + def RDPSessionProcessStop(inGSettings, inRDPSessionKeyStr, inProcessNameWEXEStr, inFlagForceCloseBool): + """ + Create CMD str to stop process + + :param inGSettings: Global settings dict (singleton) + :param inRDPSessionKeyStr: + :param inProcessNameWEXEStr: + :param inFlagForceCloseBool: + :return: + """ # Check thread if not Core.IsProcessorThread(inGSettings=inGSettings): if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP def was called not from processor queue - activity will be append in the processor queue.") @@ -767,8 +1095,17 @@ def RDPSessionProcessStop(inGSettings, inRDPSessionKeyStr, inProcessNameWEXEStr, if lSessionHex: Connector.SessionCMDRun(inSessionHex=lSessionHex, inCMDCommandStr=lCMDStr, inModeStr="CROSSCHECK", inLogger=inGSettings["Logger"], inRDPConfigurationItem=inGSettings["RobotRDPActive"]["RDPList"][inRDPSessionKeyStr]) return lResult -# Send file from Host to Session RDP using shared drive in RDP + def RDPSessionFileStoredSend(inGSettings, inRDPSessionKeyStr, inHostFilePathStr, inRDPFilePathStr): + """ + Send file from Host to Session RDP using shared drive in RDP + + :param inGSettings: Global settings dict (singleton) + :param inRDPSessionKeyStr: + :param inHostFilePathStr: + :param inRDPFilePathStr: + :return: + """ # Check thread if not Core.IsProcessorThread(inGSettings=inGSettings): if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP def was called not from processor queue - activity will be append in the processor queue.") @@ -790,8 +1127,17 @@ def RDPSessionFileStoredSend(inGSettings, inRDPSessionKeyStr, inHostFilePathStr, if lSessionHex: Connector.SessionCMDRun(inSessionHex=lSessionHex, inCMDCommandStr=lCMDStr, inModeStr="LISTEN", inClipboardTimeoutSec = 120, inLogger=inGSettings["Logger"], inRDPConfigurationItem=inGSettings["RobotRDPActive"]["RDPList"][inRDPSessionKeyStr]) return lResult -# Recieve file from Session RDP to Host using shared drive in RDP + def RDPSessionFileStoredRecieve(inGSettings, inRDPSessionKeyStr, inRDPFilePathStr, inHostFilePathStr): + """ + Receive file from Session RDP to Host using shared drive in RDP + + :param inGSettings: Global settings dict (singleton) + :param inRDPSessionKeyStr: + :param inRDPFilePathStr: + :param inHostFilePathStr: + :return: + """ # Check thread if not Core.IsProcessorThread(inGSettings=inGSettings): if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP def was called not from processor queue - activity will be append in the processor queue.") @@ -817,8 +1163,13 @@ def RDPSessionFileStoredRecieve(inGSettings, inRDPSessionKeyStr, inRDPFilePathSt # # # # # Start orchestrator # # # # # # # # # # # # # # # # # # # # # # # -# Interval gsettings auto cleaner def GSettingsAutocleaner(inGSettings): + """ + Interval gsettings auto cleaner + + :param inGSettings: Global settings dict (singleton) + :return: + """ while True: time.sleep(inGSettings["Autocleaner"]["IntervalSecFloat"]) # Wait for the next iteration lL = inGSettings["Logger"] @@ -836,7 +1187,7 @@ def GSettingsAutocleaner(inGSettings): # # # # # # # # # # # # # # # # # # # # # # # # # # from .. import __version__ # Get version from the package -# Main def for orchestrator + def Orchestrator(inGSettings): lL = inGSettings["Logger"] # https://stackoverflow.com/questions/130763/request-uac-elevation-from-within-a-python-script @@ -1009,8 +1360,6 @@ def Orchestrator(inGSettings): # Backward compatibility below to 1.2.0 def __deprecated_orchestrator_start__(): - #Call Settings function from argv[1] file - ################################################ lSubmoduleFunctionName = "Settings" lFileFullPath = sys.argv[1] lModuleName = (lFileFullPath.split("\\")[-1])[0:-3] diff --git a/Wiki/ENG_Guide/doctrees/Orchestrator.doctree b/Wiki/ENG_Guide/doctrees/Orchestrator.doctree new file mode 100644 index 0000000000000000000000000000000000000000..4e328ddecd8a48cb3003fc9cc84e0ec198239461 GIT binary patch literal 233927 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 GrTjnbS->>_ literal 0 HcmV?d00001 diff --git a/Wiki/ENG_Guide/doctrees/environment.pickle b/Wiki/ENG_Guide/doctrees/environment.pickle new file mode 100644 index 0000000000000000000000000000000000000000..cb9306ab41a98b2f439390a04c673e8e37852f0f GIT binary patch literal 102574 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 + + + + + + Welcome to pyOpenRPA’s documentation! - pyOpenRPA v1.2.0 documentation + + + + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + + + + + + + +
    +
    +
    + +
    +
    +
    pyOpenRPA v1.2.0 documentation
     +
    +
    + +
    +
    + +
    +
    +
    + +
    +

    Welcome to pyOpenRPA’s documentation!

    +
    +
    +
    +
    +

    Indices and tables

    + +
    +
    +

    pyOpenRPA Orchestrator

    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.AgentActivityItemAdd(inGSettings, inHostNameStr, inUserStr, inActivityItemDict)[source]
    +

    Add activity in AgentDict. Check if item is created

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inHostNameStr – Agent host name

      • +

    • inUserStr – User login, where agent is based

      • +

    • inActivityItemDict – ActivityItem

      • +
    +
    +
    Returns
    +

    sad

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.AgentOSCMD(inGSettings, inHostNameStr, inUserStr, inCMDStr, inRunAsyncBool=True)[source]
    +

    pyOpenRPA.Agent: Send CMD to OS. Result return to log + Orchestrator by the A2O connection +def OSCMD(inCMDStr, inRunAsyncBool=True, inGSettings=None): +Send to agent activity item to OSCMD

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inHostNameStr –

      • +

    • inUserStr –

      • +

    • inCMDStr –

      • +

    • inRunAsyncBool –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.AgentOSFileBinaryDataBase64StrCreate(inGSettings, inHostNameStr, inUserStr, inFilePathStr, inFileDataBase64Str)[source]
    +

    pyOpenRPA.Agent: Create binary file by the base64 string (safe for JSON transmission) +def OSFileBinaryDataBase64StrCreate(inFilePathStr, inFileDataBase64Str,inGSettings = None): +Send binary file to Agent (base64 string)

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inHostNameStr –

      • +

    • inUserStr –

      • +

    • inFilePathStr –

      • +

    • inFileDataBase64Str –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.AgentOSFileBinaryDataBytesCreate(inGSettings, inHostNameStr, inUserStr, inFilePathStr, inFileDataBytes)[source]
    +

    pyOpenRPA.Agent: Create binary file by the base64 string (safe for JSON transmition) +def OSFileBinaryDataBase64StrCreate(inFilePathStr, inFileDataBase64Str,inGSettings = None): +Send binary file to Agent (Bytes)

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inHostNameStr –

      • +

    • inUserStr –

      • +

    • inFilePathStr –

      • +

    • inFileDataBytes –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.AgentOSFileTextDataStrCreate(inGSettings, inHostNameStr, inUserStr, inFilePathStr, inFileDataStr, inEncodingStr='utf-8')[source]
    +

    pyOpenRPA.Agent: Create text file by the string +def OSFileTextDataStrCreate(inFilePathStr, inFileDataStr, inEncodingStr = “utf-8”,inGSettings = None): +Create Activity Item for the agent

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inHostNameStr –

      • +

    • inUserStr –

      • +

    • inFilePathStr –

      • +

    • inFileDataStr –

      • +

    • inEncodingStr –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsAutocleaner(inGSettings)[source]
    +

    Interval gsettings auto cleaner

    +
    +
    Parameters
    +

    inGSettings – Global settings dict (singleton)

    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsKeyListValueAppend(inGSettings, inValue, inKeyList=None)[source]
    +

    Append value in GSettings by the key list

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inValue –

      • +

    • inKeyList –

      • +
    +
    +
    Returns
    +

    True every time

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsKeyListValueGet(inGSettings, inKeyList=None)[source]
    +

    Get the value from the GSettings by the key list

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inKeyList –

      • +
    +
    +
    Returns
    +

    value any type

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsKeyListValueOperatorPlus(inGSettings, inValue, inKeyList=None)[source]
    +

    Operator plus value in GSettings by the key list

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inValue –

      • +

    • inKeyList –

      • +
    +
    +
    Returns
    +

    True every time

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsKeyListValueSet(inGSettings, inValue, inKeyList=None)[source]
    +

    Set value in GSettings by the key list

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inValue –

      • +

    • inKeyList –

      • +
    +
    +
    Returns
    +

    bool

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.OSCMD(inCMDStr, inRunAsyncBool=True, inLogger=None)[source]
    +

    OS send command in shell locally

    +
    +
    Parameters
    +
      +

    • inCMDStr –

      • +

    • inRunAsyncBool –

      • +

    • inLogger –

      • +
    +
    +
    Returns
    +

    CMD result string

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.OSCredentialsVerify(inUserStr, inPasswordStr, inDomainStr='')[source]
    +

    Verify user credentials in windows. Return bool

    +
    +
    Parameters
    +
      +

    • inUserStr –

      • +

    • inPasswordStr –

      • +

    • inDomainStr –

      • +
    +
    +
    Returns
    +

    True - Credentials are actual; False - Credentials are not actual

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.OrchestratorRestart(inGSettings=None)[source]
    +

    Orchestrator restart

    +
    +
    Parameters
    +

    inGSettings – Global settings dict (singleton)

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.OrchestratorSessionSave(inGSettings=None)[source]
    +

    Orchestrator session save in file _SessionLast_RDPList.json (encoding = “utf-8”)

    +
    +
    Parameters
    +

    inGSettings – Global settings dict (singleton)

    +
    +
    Returns
    +

    True every time

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.ProcessIsStarted(inProcessNameWOExeStr)[source]
    +

    Check if there is any running process that contains the given name processName.

    +
    +
    Parameters
    +

    inProcessNameWOExeStr –

    +
    +
    Returns
    +

    True - process is running; False - process is not running

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.ProcessListGet(inProcessNameWOExeList=None)[source]
    +

    Check activity of the list of processes

    +
    +
    Parameters
    +

    inProcessNameWOExeList –

    +
    +
    Returns
    +

    TODO FILL THE RESULT DICT

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.ProcessStart(inPathStr, inArgList, inStopProcessNameWOExeStr=None)[source]
    +

    Start process locally [optional: if task name is not started]

    +
    +
    Parameters
    +
      +

    • inPathStr –

      • +

    • inArgList –

      • +

    • inStopProcessNameWOExeStr –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.ProcessStop(inProcessNameWOExeStr, inCloseForceBool, inUserNameStr='%username%')[source]
    +

    Stop process

    +
    +
    Parameters
    +
      +

    • inProcessNameWOExeStr –

      • +

    • inCloseForceBool –

      • +

    • inUserNameStr –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.ProcessorActivityItemAppend(inGSettings, inDef, inArgList=None, inArgDict=None, inArgGSettingsStr=None, inArgLoggerStr=None)[source]
    +

    Add Activity item in Processor list

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inDef –

      • +

    • inArgList –

      • +

    • inArgDict –

      • +

    • inArgGSettingsStr –

      • +

    • inArgLoggerStr –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.ProcessorActivityItemCreate(inDef, inArgList=None, inArgDict=None, inArgGSettingsStr=None, inArgLoggerStr=None)[source]
    +

    Create ActivityItem

    +
    +
    Parameters
    +
      +

    • inDef –

      • +

    • inArgList –

      • +

    • inArgDict –

      • +

    • inArgGSettingsStr –

      • +

    • inArgLoggerStr –

      • +
    +
    +
    Returns
    +

    {}

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.ProcessorAliasDefCreate(inGSettings, inDef, inAliasStr=None)[source]
    +

    Create alias for def (can be used in ActivityItem in field Def)

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inDef –

      • +

    • inAliasStr –

      • +
    +
    +
    Returns
    +

    str Alias

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.ProcessorAliasDefUpdate(inGSettings, inDef, inAliasStr)[source]
    +

    Update alias for def (can be used in ActivityItem in field Def)

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inDef –

      • +

    • inAliasStr –

      • +
    +
    +
    Returns
    +

    str Alias

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.PythonStart(inModulePathStr, inDefNameStr, inArgList=None, inArgDict=None, inLogger=None)[source]
    +

    Python import module and start def

    +
    +
    Parameters
    +
      +

    • inModulePathStr –

      • +

    • inDefNameStr –

      • +

    • inArgList –

      • +

    • inArgDict –

      • +

    • inLogger –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionCMDRun(inGSettings, inRDPSessionKeyStr, inCMDStr, inModeStr='CROSSCHECK')[source]
    +

    Send command in RDP session

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +

    • inCMDStr –

      • +

    • inModeStr –

      • +
    +
    +
    Returns
    +

    True - CMD was executed successfully

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionConnect(inGSettings, inRDPSessionKeyStr, inRDPTemplateDict=None, inHostStr=None, inPortStr=None, inLoginStr=None, inPasswordStr=None)[source]
    +
    +
    Create new RDPSession in RobotRDPActive. Attention - activity will be ignored if key is exists

    2 way of the use

    +
    +
    +

    Var 1: inGSettings, inRDPSessionKeyStr, inRDPTemplateDict +Var 2 (Backward compatibility): inGSettings, inRDPSessionKeyStr, inHostStr, inPortStr, inLoginStr, inPasswordStr

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +

    • inRDPTemplateDict –

      • +

    • inHostStr –

      • +

    • inPortStr –

      • +

    • inLoginStr –

      • +

    • inPasswordStr –

      • +
    +
    +
    Returns
    +

    True every time

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionDisconnect(inGSettings, inRDPSessionKeyStr, inBreakTriggerProcessWOExeList=None)[source]
    +

    Disconnect the RDP session

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +

    • inBreakTriggerProcessWOExeList –

      • +
    +
    +
    Returns
    +

    True every time

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionDublicatesResolve(inGSettings)[source]
    +

    Search dublicates in GSettings RDPlist +!def is developing!

    +
    +
    Parameters
    +

    inGSettings – Global settings dict (singleton)

    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionFileStoredRecieve(inGSettings, inRDPSessionKeyStr, inRDPFilePathStr, inHostFilePathStr)[source]
    +

    Receive file from Session RDP to Host using shared drive in RDP

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +

    • inRDPFilePathStr –

      • +

    • inHostFilePathStr –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionFileStoredSend(inGSettings, inRDPSessionKeyStr, inHostFilePathStr, inRDPFilePathStr)[source]
    +

    Send file from Host to Session RDP using shared drive in RDP

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +

    • inHostFilePathStr –

      • +

    • inRDPFilePathStr –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionLogoff(inGSettings, inRDPSessionKeyStr, inBreakTriggerProcessWOExeList=None)[source]
    +

    Logoff the RDP session

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +

    • inBreakTriggerProcessWOExeList –

      • +
    +
    +
    Returns
    +

    True - logoff is successful

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionMonitorStop(inGSettings, inRDPSessionKeyStr)[source]
    +

    Stop track the RDP session. Current def dont kill RDP session - only stop to track it (it can give )

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionProcessStartIfNotRunning(inGSettings, inRDPSessionKeyStr, inProcessNameWEXEStr, inFilePathStr, inFlagGetAbsPathBool=True)[source]
    +

    Start process if it is not running

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +

    • inProcessNameWEXEStr –

      • +

    • inFilePathStr –

      • +

    • inFlagGetAbsPathBool –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionProcessStop(inGSettings, inRDPSessionKeyStr, inProcessNameWEXEStr, inFlagForceCloseBool)[source]
    +

    Create CMD str to stop process

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +

    • inProcessNameWEXEStr –

      • +

    • inFlagForceCloseBool –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionReconnect(inGSettings, inRDPSessionKeyStr, inRDPTemplateDict=None)[source]
    +

    RDP Session reconnect

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +

    • inRDPTemplateDict –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionResponsibilityCheck(inGSettings, inRDPSessionKeyStr)[source]
    +

    Check RDP Session responsibility TODO NEED DEV + TEST

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +
    +
    +
    Returns
    +

    True every time

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPTemplateCreate(inLoginStr, inPasswordStr, inHostStr='127.0.0.1', inPortInt=3389, inWidthPXInt=1680, inHeightPXInt=1050, inUseBothMonitorBool=False, inDepthBitInt=32, inSharedDriveList=None)[source]
    +

    Create some RDP template dict to use it when connect/reconnect

    +
    +
    Parameters
    +
      +

    • inLoginStr –

      • +

    • inPasswordStr –

      • +

    • inHostStr –

      • +

    • inPortInt –

      • +

    • inWidthPXInt –

      • +

    • inHeightPXInt –

      • +

    • inUseBothMonitorBool –

      • +

    • inDepthBitInt –

      • +

    • inSharedDriveList –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.SchedulerActivityTimeAddWeekly(inGSettings, inTimeHHMMStr='23:55:', inWeekdayList=None, inActivityList=None)[source]
    +

    Add activity in time weekly

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inTimeHHMMStr –

      • +

    • inWeekdayList –

      • +

    • inActivityList –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.UACKeyListCheck(inRequest, inRoleKeyList) → bool[source]
    +

    Check is client is has access for the key list

    +
    +
    Parameters
    +
      +

    • inRequest –

      • +

    • inRoleKeyList –

      • +
    +
    +
    Returns
    +

    bool

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.UACSuperTokenUpdate(inGSettings, inSuperTokenStr)[source]
    +

    Add supertoken for the all access (it is need for the robot communication without human)

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inSuperTokenStr –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.UACUpdate(inGSettings, inADLoginStr, inADStr='', inADIsDefaultBool=True, inURLList=None, inRoleHierarchyAllowedDict=None)[source]
    +

    Update user access (UAC)

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inADLoginStr –

      • +

    • inADStr –

      • +

    • inADIsDefaultBool –

      • +

    • inURLList –

      • +

    • inRoleHierarchyAllowedDict –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.WebCPUpdate(inGSettings, inCPKeyStr, inHTMLRenderDef=None, inJSONGeneratorDef=None, inJSInitGeneratorDef=None)[source]
    +

    Add control panel HTML, JSON generator or JS when page init

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inCPKeyStr –

      • +

    • inHTMLRenderDef –

      • +

    • inJSONGeneratorDef –

      • +

    • inJSInitGeneratorDef –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.WebURLConnectDef(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inDef, inContentTypeStr='application/octet-stream')[source]
    +
    +
    +
    Connect URL to DEF

    “inMethodStr”:”GET|POST”, +“inURLStr”: “/index”, #URL of the request +“inMatchTypeStr”: “”, #”BeginWith|Contains|Equal|EqualCase”, +“inContentTypeStr”: “”, #HTTP Content-type +“inDef”: None #Function with str result

    +
    +
    +
    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inMethodStr –

      • +

    • inURLStr –

      • +

    • inMatchTypeStr –

      • +

    • inDef –

      • +

    • inContentTypeStr –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.WebURLConnectFile(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inFilePathStr, inContentTypeStr='application/octet-stream')[source]
    +
    +
    Connect URL to File

    “inMethodStr”:”GET|POST”, +“inURLStr”: “/index”, #URL of the request +“inMatchTypeStr”: “”, #”BeginWith|Contains|Equal|EqualCase”, +“inFolderPathStr”: “”, #Absolute or relative path

    +
    +
    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inMethodStr –

      • +

    • inURLStr –

      • +

    • inMatchTypeStr –

      • +

    • inFilePathStr –

      • +

    • inContentTypeStr –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.WebURLConnectFolder(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inFolderPathStr)[source]
    +
    +
    Connect URL to Folder

    “inMethodStr”:”GET|POST”, +“inURLStr”: “/Folder/”, #URL of the request +“inMatchTypeStr”: “”, #”BeginWith|Contains|Equal|EqualCase”, +“inFolderPathStr”: “”, #Absolute or relative path

    +
    +
    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inMethodStr –

      • +

    • inURLStr –

      • +

    • inMatchTypeStr –

      • +

    • inFolderPathStr –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.WebUserInfoGet(inRequest)[source]
    +

    Return User info about request

    +
    +
    Parameters
    +

    inRequest –

    +
    +
    Returns
    +

    {“DomainUpperStr”: “”, “UserNameUpperStr”: “”}

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.WebUserIsSuperToken(inRequest, inGSettings)[source]
    +

    Return bool if request is authentificated with supetoken (token which is never expires)

    +
    +
    Parameters
    +
      +

    • inRequest –

      • +

    • inGSettings – Global settings dict (singleton)

      • +
    +
    +
    Returns
    +

    bool True - is supertoken; False - is not supertoken

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.WebUserUACHierarchyGet(inRequest)[source]
    +

    Return User UAC Hierarchy DICT Return {…}

    +
    +
    Parameters
    +

    inRequest –

    +
    +
    Returns
    +

    UAC Dict {}

    +
    +
    +
    +
    + +
    + +
    + +
    +
    + + \ No newline at end of file diff --git a/Wiki/ENG_Guide/html/_modules/index.html b/Wiki/ENG_Guide/html/_modules/index.html new file mode 100644 index 00000000..d00f19cc --- /dev/null +++ b/Wiki/ENG_Guide/html/_modules/index.html @@ -0,0 +1,158 @@ + + + + + + + Overview: module code - pyOpenRPA v1.2.0 documentation + + + + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + + + + + + + +
    +
    +
    + +
    +
    +
    pyOpenRPA v1.2.0 documentation
     +
    +
    + +
    +
    + +
    +
    + + +
    + +
    +
    + + \ No newline at end of file diff --git a/Wiki/ENG_Guide/html/_modules/pyOpenRPA/Orchestrator/__Orchestrator__.html b/Wiki/ENG_Guide/html/_modules/pyOpenRPA/Orchestrator/__Orchestrator__.html new file mode 100644 index 00000000..c3413c96 --- /dev/null +++ b/Wiki/ENG_Guide/html/_modules/pyOpenRPA/Orchestrator/__Orchestrator__.html @@ -0,0 +1,1531 @@ + + + + + + + pyOpenRPA.Orchestrator.__Orchestrator__ - pyOpenRPA v1.2.0 documentation + + + + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + + + + + + + +
    +
    +
    + +
    +
    +
    pyOpenRPA v1.2.0 documentation
     +
    +
    + +
    +
    + +
    +
    +
    + +

    Source code for pyOpenRPA.Orchestrator.__Orchestrator__

    +import subprocess, json, psutil, time, os, win32security, sys, base64, logging, ctypes #Get input argument
+from . import Server
+from . import Timer
+from . import Processor
+from . import BackwardCompatibility # Backward compatibility from v1.1.13
+from . import Core
+from .Utils import LoggerHandlerDumpLogList
+
+# ATTENTION! HERE IS NO Relative import because it will be imported dynamically
+# All function check the flag SessionIsWindowResponsibleBool == True else no cammand is processed
+# All functions can return None, Bool or Dict { "IsSuccessful": True }
+from .RobotRDPActive import CMDStr # Create CMD Strings
+from .RobotRDPActive import Connector # RDP API
+
+#from .Settings import Settings
+import importlib
+from importlib import util
+import threading # Multi-threading for RobotRDPActive
+from .RobotRDPActive import RobotRDPActive #Start robot rdp active
+from .RobotScreenActive import Monitor #Start robot screen active
+from . import SettingsTemplate # Settings template
+import uuid # Generate uuid
+import datetime # datetime
+
+#Единый глобальный словарь (За основу взять из Settings.py)
+global gSettingsDict
+
+# AGENT DEFS
+
+
    [docs]def AgentActivityItemAdd(inGSettings, inHostNameStr, inUserStr, inActivityItemDict):
+    """
+    Add activity in AgentDict. Check if item is created
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inHostNameStr: Agent host name
+    :param inUserStr: User login, where agent is based
+    :param inActivityItemDict: ActivityItem
+    :return: sad
+    """
+    lAgentDictItemKeyTurple = (inHostNameStr.upper(),inUserStr.upper())
+    if lAgentDictItemKeyTurple not in inGSettings["AgentDict"]:
+        inGSettings["AgentDict"][lAgentDictItemKeyTurple] = SettingsTemplate.__AgentDictItemCreate__()
+    lThisAgentDict = inGSettings["AgentDict"][lAgentDictItemKeyTurple]
+    lThisAgentDict["ActivityList"].append(inActivityItemDict)
    
+
+
+
    [docs]def AgentOSCMD(inGSettings, inHostNameStr, inUserStr, inCMDStr, inRunAsyncBool=True):
+    """
+    pyOpenRPA.Agent: Send CMD to OS. Result return to log + Orchestrator by the A2O connection
+    def OSCMD(inCMDStr, inRunAsyncBool=True, inGSettings=None):
+    Send to agent activity item to OSCMD
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inHostNameStr:
+    :param inUserStr:
+    :param inCMDStr:
+    :param inRunAsyncBool:
+    """
+    lActivityItemDict = {
+        "Def":"OSCMD", # def alias (look pyOpeRPA.Agent gSettings["ProcessorDict"]["AliasDefDict"])
+        "ArgList":[], # Args list
+        "ArgDict":{"inCMDStr":inCMDStr,"inRunAsyncBool":inRunAsyncBool}, # Args dictionary
+        "ArgGSettings": "inGSettings", # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+        "ArgLogger": None # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+    }
+    #Send item in AgentDict for the futher data transmition
+    AgentActivityItemAdd(inGSettings=inGSettings, inHostNameStr=inHostNameStr, inUserStr=inUserStr, inActivityItemDict=lActivityItemDict)
    
+
+
    [docs]def AgentOSFileBinaryDataBytesCreate(inGSettings, inHostNameStr, inUserStr, inFilePathStr, inFileDataBytes):
+    """
+    pyOpenRPA.Agent: Create binary file by the base64 string (safe for JSON transmition)
+    def OSFileBinaryDataBase64StrCreate(inFilePathStr, inFileDataBase64Str,inGSettings = None):
+    Send binary file to Agent (Bytes)
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inHostNameStr:
+    :param inUserStr:
+    :param inFilePathStr:
+    :param inFileDataBytes:
+    """
+
+    lFileDataBase64Str = base64.b64encode(inFileDataBytes).decode("utf-8")
+    lActivityItemDict = {
+        "Def":"OSFileBinaryDataBase64StrCreate", # def alias (look pyOpeRPA.Agent gSettings["ProcessorDict"]["AliasDefDict"])
+        "ArgList":[], # Args list
+        "ArgDict":{"inFilePathStr":inFilePathStr,"inFileDataBase64Str":lFileDataBase64Str}, # Args dictionary
+        "ArgGSettings": "inGSettings", # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+        "ArgLogger": None # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+    }
+    #Send item in AgentDict for the futher data transmition
+    AgentActivityItemAdd(inGSettings=inGSettings, inHostNameStr=inHostNameStr, inUserStr=inUserStr, inActivityItemDict=lActivityItemDict)
    
+
+
+
    [docs]def AgentOSFileBinaryDataBase64StrCreate(inGSettings, inHostNameStr, inUserStr, inFilePathStr, inFileDataBase64Str):
+    """
+    pyOpenRPA.Agent: Create binary file by the base64 string (safe for JSON transmission)
+    def OSFileBinaryDataBase64StrCreate(inFilePathStr, inFileDataBase64Str,inGSettings = None):
+    Send binary file to Agent (base64 string)
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inHostNameStr:
+    :param inUserStr:
+    :param inFilePathStr:
+    :param inFileDataBase64Str:
+    """
+
+    lActivityItemDict = {
+        "Def":"OSFileBinaryDataBase64StrCreate", # def alias (look pyOpeRPA.Agent gSettings["ProcessorDict"]["AliasDefDict"])
+        "ArgList":[], # Args list
+        "ArgDict":{"inFilePathStr":inFilePathStr,"inFileDataBase64Str":inFileDataBase64Str}, # Args dictionary
+        "ArgGSettings": "inGSettings", # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+        "ArgLogger": None # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+    }
+    #Send item in AgentDict for the futher data transmition
+    AgentActivityItemAdd(inGSettings=inGSettings, inHostNameStr=inHostNameStr, inUserStr=inUserStr, inActivityItemDict=lActivityItemDict)
    
+
+# Send text file to Agent (string)
+
    [docs]def AgentOSFileTextDataStrCreate(inGSettings, inHostNameStr, inUserStr, inFilePathStr, inFileDataStr, inEncodingStr = "utf-8"):
+    """
+    pyOpenRPA.Agent: Create text file by the string
+    def OSFileTextDataStrCreate(inFilePathStr, inFileDataStr, inEncodingStr = "utf-8",inGSettings = None):
+    Create Activity Item for the agent
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inHostNameStr:
+    :param inUserStr:
+    :param inFilePathStr:
+    :param inFileDataStr:
+    :param inEncodingStr:
+    """
+
+    lActivityItemDict = {
+        "Def":"OSFileTextDataStrCreate", # def alias (look pyOpeRPA.Agent gSettings["ProcessorDict"]["AliasDefDict"])
+        "ArgList":[], # Args list
+        "ArgDict":{"inFilePathStr":inFilePathStr,"inFileDataStr":inFileDataStr, "inEncodingStr": inEncodingStr}, # Args dictionary
+        "ArgGSettings": "inGSettings", # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+        "ArgLogger": None # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+    }
+    #Send item in AgentDict for the futher data transmition
+    AgentActivityItemAdd(inGSettings=inGSettings, inHostNameStr=inHostNameStr, inUserStr=inUserStr, inActivityItemDict=lActivityItemDict)
    
+
+# OS DEFS
+
    [docs]def OSCredentialsVerify(inUserStr, inPasswordStr, inDomainStr=""): ##
+    """
+    Verify user credentials in windows. Return bool
+
+    :param inUserStr:
+    :param inPasswordStr:
+    :param inDomainStr:
+    :return: True - Credentials are actual; False - Credentials are not actual
+    """
+    try:
+        hUser = win32security.LogonUser(
+            inUserStr,inDomainStr, inPasswordStr,
+            win32security.LOGON32_LOGON_NETWORK, win32security.LOGON32_PROVIDER_DEFAULT
+        )
+    except win32security.error:
+        return False
+    else:
+        return True
    
+
+
    [docs]def OSCMD(inCMDStr, inRunAsyncBool=True, inLogger = None):
+    """
+    OS send command in shell locally
+
+    :param inCMDStr:
+    :param inRunAsyncBool:
+    :param inLogger:
+    :return: CMD result string
+    """
+    lResultStr = ""
+    # Subdef to listen OS result
+    def _CMDRunAndListenLogs(inCMDStr, inLogger):
+        lResultStr = ""
+        lOSCMDKeyStr = str(uuid.uuid4())[0:4].upper()
+        lCMDProcess = subprocess.Popen(f'cmd /c {inCMDStr}', stdout=subprocess.PIPE, stderr=subprocess.STDOUT)
+        if inLogger:
+            lListenBool = True
+            inLogger.info(f"{lOSCMDKeyStr}: # # # # CMD Process has been STARTED # # # # ")
+            inLogger.info(f"{lOSCMDKeyStr}: {inCMDStr}")
+            while lListenBool:
+                lOutputLineBytes = lCMDProcess.stdout.readline()
+                if lOutputLineBytes == b"":
+                    lListenBool = False
+                lStr = lOutputLineBytes.decode('cp866')
+                if lStr.endswith("\n"): lStr = lStr[:-1]
+                inLogger.info(f"{lOSCMDKeyStr}: {lStr}")
+                lResultStr+=lStr
+            inLogger.info(f"{lOSCMDKeyStr}: # # # # CMD Process has been FINISHED # # # # ")
+        return lResultStr
+    # New call
+    if inRunAsyncBool:
+        lThread = threading.Thread(target=_CMDRunAndListenLogs, kwargs={"inCMDStr":inCMDStr, "inLogger":inLogger})
+        lThread.start()
+        lResultStr="ActivityList has been started in async mode - no output is available here."
+    else:
+        lResultStr = _CMDRunAndListenLogs(inCMDStr=inCMDStr, inLogger=inLogger)
+    #lCMDCode = "cmd /c " + inCMDStr
+    #subprocess.Popen(lCMDCode)
+    #lResultCMDRun = 1  # os.system(lCMDCode)
+    return lResultStr
    
+
+
    [docs]def OrchestratorRestart(inGSettings=None):
+    """
+    Orchestrator restart
+
+    :param inGSettings: Global settings dict (singleton)
+    """
+    OrchestratorSessionSave(inGSettings=inGSettings) # Dump RDP List in file json
+    if inGSettings is not None:
+        lL = inGSettings["Logger"]
+        if lL: lL.info(f"Do restart")
+    # Restart session
+    os.execl(sys.executable, os.path.abspath(__file__), *sys.argv)
+    sys.exit(0)
    
+
+
    [docs]def OrchestratorSessionSave(inGSettings=None):
+    """
+    Orchestrator session save in file _SessionLast_RDPList.json (encoding = "utf-8")
+
+    :param inGSettings: Global settings dict (singleton)
+    :return: True every time
+    """
+    # Dump RDP List in file json
+    lFile = open("_SessionLast_RDPList.json", "w", encoding="utf-8")
+    lFile.write(json.dumps(inGSettings["RobotRDPActive"]["RDPList"]))  # dump json to file
+    lFile.close()  # Close the file
+    if inGSettings is not None:
+        lL = inGSettings["Logger"]
+        if lL: lL.info(
+            f"Orchestrator has dump the RDP list before the restart.")
+    return True
    
+
+
    [docs]def UACKeyListCheck(inRequest, inRoleKeyList) -> bool:
+    """
+    Check is client is has access for the key list
+
+    :param inRequest:
+    :param inRoleKeyList:
+    :return: bool
+    """
+    return inRequest.UACClientCheck(inRoleKeyList=inRoleKeyList)
    
+
+
    [docs]def UACUpdate(inGSettings, inADLoginStr, inADStr="", inADIsDefaultBool=True, inURLList=None, inRoleHierarchyAllowedDict=None):
+    """
+    Update user access (UAC)
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inADLoginStr:
+    :param inADStr:
+    :param inADIsDefaultBool:
+    :param inURLList:
+    :param inRoleHierarchyAllowedDict:
+    """
+    lUserTurple = (inADStr.upper(),inADLoginStr.upper()) # Create turple key for inGSettings["ServerDict"]["AccessUsers"]["RuleDomainUserDict"]
+    if inURLList is None: inURLList = [] # Check if None
+    if inRoleHierarchyAllowedDict is None: inRoleHierarchyAllowedDict = {} # Check if None
+    # Get the old URLList
+    try:
+        inURLList += inGSettings["ServerDict"]["AccessUsers"]["RuleDomainUserDict"][lUserTurple]["MethodMatchURLBeforeList"]
+    except:
+        pass
+    # Check RoleHierarchyAllowedDict in gSettings for the old role hierarchy - include in result.
+    if lUserTurple in inGSettings["ServerDict"]["AccessUsers"]["RuleDomainUserDict"] and "RoleHierarchyAllowedDict" in inGSettings["ServerDict"]["AccessUsers"]["RuleDomainUserDict"][lUserTurple]:
+        lRoleHierarchyAllowedOLDDict = inGSettings["ServerDict"]["AccessUsers"]["RuleDomainUserDict"][lUserTurple]["RoleHierarchyAllowedDict"]
+        Server.__ComplexDictMerge2to1__(in1Dict=inRoleHierarchyAllowedDict, in2Dict=lRoleHierarchyAllowedOLDDict) # Merge dict 2 into dict 1
+
+    # Create Access item
+    lRuleDomainUserDict = {
+        "MethodMatchURLBeforeList": inURLList,
+        "RoleHierarchyAllowedDict": inRoleHierarchyAllowedDict
+    }
+    # Case add domain + user
+    inGSettings["ServerDict"]["AccessUsers"]["RuleDomainUserDict"].update({(inADStr.upper(),inADLoginStr.upper()):lRuleDomainUserDict})
+    if inADIsDefaultBool:
+        # Case add default domain + user
+        inGSettings["ServerDict"]["AccessUsers"]["RuleDomainUserDict"].update({("",inADLoginStr.upper()):lRuleDomainUserDict})
    
+
+
    [docs]def UACSuperTokenUpdate(inGSettings, inSuperTokenStr):
+    """
+    Add supertoken for the all access (it is need for the robot communication without human)
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inSuperTokenStr:
+    """
+    lLoginStr = "SUPERTOKEN"
+    UACUpdate(inGSettings=inGSettings, inADLoginStr=lLoginStr)
+    inGSettings["ServerDict"]["AccessUsers"]["AuthTokensDict"].update(
+        {inSuperTokenStr:{"User":lLoginStr, "Domain":"", "TokenDatetime":  datetime.datetime.now(), "FlagDoNotExpire":True}}
+    )
    
+
+# # # # # # # # # # # # # # # # # # # # # # #
+# OrchestratorWeb defs
+# # # # # # # # # # # # # # # # # # # # # # #
+
+
+
    [docs]def WebURLConnectDef(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inDef, inContentTypeStr="application/octet-stream"):
+    """
+     Connect URL to DEF
+        "inMethodStr":"GET|POST",
+        "inURLStr": "/index", #URL of the request
+        "inMatchTypeStr": "", #"BeginWith|Contains|Equal|EqualCase",
+        "inContentTypeStr": "", #HTTP Content-type
+        "inDef": None #Function with str result
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inMethodStr:
+    :param inURLStr:
+    :param inMatchTypeStr:
+    :param inDef:
+    :param inContentTypeStr:
+    """
+    lURLItemDict = {
+        "Method": inMethodStr.upper(),
+        "URL": inURLStr,  # URL of the request
+        "MatchType": inMatchTypeStr,  # "BeginWith|Contains|Equal|EqualCase",
+        # "ResponseFilePath": "", #Absolute or relative path
+        #"ResponseFolderPath": "C:\Abs\Archive\scopeSrcUL\OpenRPA\Orchestrator\Settings",
+        # Absolute or relative path
+        "ResponseContentType": inContentTypeStr, #HTTP Content-type
+        "ResponseDefRequestGlobal": inDef #Function with str result
+    }
+    inGSettings["ServerDict"]["URLList"].append(lURLItemDict)
    
+
+
+
    [docs]def WebURLConnectFolder(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inFolderPathStr):
+    """
+    Connect URL to Folder
+        "inMethodStr":"GET|POST",
+        "inURLStr": "/Folder/", #URL of the request
+        "inMatchTypeStr": "", #"BeginWith|Contains|Equal|EqualCase",
+        "inFolderPathStr": "", #Absolute or relative path
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inMethodStr:
+    :param inURLStr:
+    :param inMatchTypeStr:
+    :param inFolderPathStr:
+    """
+    # Check if last symbol is "/" - append if not exist
+    lFolderPathStr = os.path.abspath(inFolderPathStr)
+    if lFolderPathStr[-1]!="/":lFolderPathStr+="/"
+    # Prepare URLItem
+    lURLItemDict = {
+        "Method": inMethodStr.upper(),
+        "URL": inURLStr,  # URL of the request
+        "MatchType": inMatchTypeStr,  # "BeginWith|Contains|Equal|EqualCase",
+        # "ResponseFilePath": "", #Absolute or relative path
+        "ResponseFolderPath": lFolderPathStr, # Absolute or relative path
+        "ResponseContentType": "application/octet-stream", #HTTP Content-type
+        #"ResponseDefRequestGlobal": inDef #Function with str result
+    }
+    inGSettings["ServerDict"]["URLList"].append(lURLItemDict)
    
+
+
+
    [docs]def WebURLConnectFile(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inFilePathStr, inContentTypeStr="application/octet-stream"):
+    """
+    Connect URL to File
+        "inMethodStr":"GET|POST",
+        "inURLStr": "/index", #URL of the request
+        "inMatchTypeStr": "", #"BeginWith|Contains|Equal|EqualCase",
+        "inFolderPathStr": "", #Absolute or relative path
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inMethodStr:
+    :param inURLStr:
+    :param inMatchTypeStr:
+    :param inFilePathStr:
+    :param inContentTypeStr:
+    """
+    lURLItemDict = {
+        "Method": inMethodStr.upper(),
+        "URL": inURLStr,  # URL of the request
+        "MatchType": inMatchTypeStr,  # "BeginWith|Contains|Equal|EqualCase",
+        "ResponseFilePath": os.path.abspath(inFilePathStr), #Absolute or relative path
+        #"ResponseFolderPath": os.path.abspath(inFilePathStr), # Absolute or relative path
+        "ResponseContentType": inContentTypeStr, #HTTP Content-type
+        #"ResponseDefRequestGlobal": inDef #Function with str result
+    }
+    inGSettings["ServerDict"]["URLList"].append(lURLItemDict)
    
+
+
    [docs]def WebCPUpdate(inGSettings, inCPKeyStr, inHTMLRenderDef=None, inJSONGeneratorDef=None, inJSInitGeneratorDef=None):
+    """
+    Add control panel HTML, JSON generator or JS when page init
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inCPKeyStr:
+    :param inHTMLRenderDef:
+    :param inJSONGeneratorDef:
+    :param inJSInitGeneratorDef:
+    """
+    # Create Struct if the re is current key
+    if inCPKeyStr not in inGSettings["CPDict"]:
+        inGSettings["CPDict"][inCPKeyStr] = {"HTMLRenderDef": None,"JSONGeneratorDef": None, "JSInitGeneratorDef": None}
+    # CASE HTMLRender
+    if inHTMLRenderDef is not None:
+        inGSettings["CPDict"][inCPKeyStr]["HTMLRenderDef"]=inHTMLRenderDef
+    # CASE JSONGenerator
+    if inJSONGeneratorDef is not None:
+        inGSettings["CPDict"][inCPKeyStr]["JSONGeneratorDef"] = inJSONGeneratorDef
+    # CASE JSInitGeneratorDef
+    if inJSInitGeneratorDef is not None:
+        inGSettings["CPDict"][inCPKeyStr]["JSInitGeneratorDef"] = inJSInitGeneratorDef
    
+
+
    [docs]def WebUserInfoGet(inRequest):
+    """
+    Return User info about request
+
+    :param inRequest:
+    :return: {"DomainUpperStr": "", "UserNameUpperStr": ""}
+    """
+    lDomainUpperStr = inRequest.OpenRPA["Domain"].upper()
+    lUserUpperStr = inRequest.OpenRPA["User"].upper()
+    return {"DomainUpperStr": lDomainUpperStr, "UserNameUpperStr": lUserUpperStr}
    
+
+
    [docs]def WebUserIsSuperToken(inRequest, inGSettings):
+    """
+    Return bool if request is authentificated with supetoken (token which is never expires)
+
+    :param inRequest:
+    :param inGSettings: Global settings dict (singleton)
+    :return: bool True - is supertoken; False - is not supertoken
+    """
+    lIsSuperTokenBool = False
+    # Get Flag is supertoken (True|False)
+    lIsSuperTokenBool = inGSettings.get("ServerDict", {}).get("AccessUsers", {}).get("AuthTokensDict", {}).get(inRequest.OpenRPA["AuthToken"], {}).get("FlagDoNotExpire", False)
+    return lIsSuperTokenBool
    
+
+
    [docs]def WebUserUACHierarchyGet(inRequest):
+    """
+    Return User UAC Hierarchy DICT Return {...}
+
+    :param inRequest:
+    :return: UAC Dict {}
+    """
+    return inRequest.UserRoleHierarchyGet()
    
+
+## GSettings defs
+
    [docs]def GSettingsKeyListValueSet(inGSettings, inValue, inKeyList=None):
+    """
+    Set value in GSettings by the key list
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inValue:
+    :param inKeyList:
+    :return: bool
+    """
+    if inKeyList is None: inKeyList = []
+    lDict = inGSettings
+    for lItem2 in inKeyList[:-1]:
+        #Check if key - value exists
+        if lItem2 in lDict:
+            pass
+        else:
+            lDict[lItem2]={}
+        lDict=lDict[lItem2]
+    lDict[inKeyList[-1]] = inValue #Set value
+    return True
    
+
+
    [docs]def GSettingsKeyListValueGet(inGSettings, inKeyList=None):
+    """
+    Get the value from the GSettings by the key list
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inKeyList:
+    :return: value any type
+    """
+    if inKeyList is None: inKeyList = []
+    lDict = inGSettings
+    for lItem2 in inKeyList[:-1]:
+        #Check if key - value exists
+        if lItem2 in lDict:
+            pass
+        else:
+            lDict[lItem2]={}
+        lDict=lDict[lItem2]
+    return lDict.get(inKeyList[-1],None)
    
+
+
    [docs]def GSettingsKeyListValueAppend(inGSettings, inValue, inKeyList=None):
+    """
+    Append value in GSettings by the key list
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inValue:
+    :param inKeyList:
+    :return: True every time
+    """
+    if inKeyList is None: inKeyList = []
+    lDict = inGSettings
+    for lItem2 in inKeyList[:-1]:
+        #Check if key - value exists
+        if lItem2 in lDict:
+            pass
+        else:
+            lDict[lItem2]={}
+        lDict=lDict[lItem2]
+    lDict[inKeyList[-1]].append(inValue) #Set value
+    return True
    
+
+
    [docs]def GSettingsKeyListValueOperatorPlus(inGSettings, inValue, inKeyList=None):
+    """
+    Operator plus value in GSettings by the key list
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inValue:
+    :param inKeyList:
+    :return: True every time
+    """
+    if inKeyList is None: inKeyList = []
+    lDict = inGSettings
+    for lItem2 in inKeyList[:-1]:
+        #Check if key - value exists
+        if lItem2 in lDict:
+            pass
+        else:
+            lDict[lItem2]={}
+        lDict=lDict[lItem2]
+    lDict[inKeyList[-1]] += inValue #Set value
+    return True
    
+
+
    [docs]def ProcessorAliasDefCreate(inGSettings, inDef, inAliasStr=None):
+    """
+    Create alias for def (can be used in ActivityItem in field Def)
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inDef:
+    :param inAliasStr:
+    :return: str Alias
+    """
+    lL = inGSettings["Logger"]
+    if inAliasStr is None: inAliasStr = str(inDef)
+    # Check if key is not exists
+    if inAliasStr in inGSettings["ProcessorDict"]["AliasDefDict"]:
+        inAliasStr = str(inDef)
+        if lL: lL.warning(f"Orchestrator.ProcessorAliasDefCreate: Alias {inAliasStr} already exists in alias dictionary. Another alias will be generated and returned")
+    inGSettings["ProcessorDict"]["AliasDefDict"][inAliasStr] = inDef
+    return inAliasStr
    
+
+
    [docs]def ProcessorAliasDefUpdate(inGSettings, inDef, inAliasStr):
+    """
+    Update alias for def (can be used in ActivityItem in field Def)
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inDef:
+    :param inAliasStr:
+    :return: str Alias
+    """
+    inGSettings["ProcessorDict"]["AliasDefDict"][inAliasStr] = inDef
+    return inAliasStr
    
+
+
    [docs]def ProcessorActivityItemCreate(inDef, inArgList=None, inArgDict=None, inArgGSettingsStr=None, inArgLoggerStr=None):
+    """
+    Create ActivityItem
+
+    :param inDef:
+    :param inArgList:
+    :param inArgDict:
+    :param inArgGSettingsStr:
+    :param inArgLoggerStr:
+    :return: {}
+    """
+    if inArgList is None: inArgList=[]
+    if inArgDict is None: inArgDict={}
+    lActivityItemDict= {
+            "Def":inDef, # def link or def alias (look gSettings["Processor"]["AliasDefDict"])
+            "ArgList":inArgList, # Args list
+            "ArgDict":inArgDict, # Args dictionary
+            "ArgGSettings": inArgGSettingsStr, # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+            "ArgLogger": inArgLoggerStr # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+        }
+    return lActivityItemDict
    
+
+
    [docs]def ProcessorActivityItemAppend(inGSettings, inDef, inArgList=None, inArgDict=None, inArgGSettingsStr=None, inArgLoggerStr=None):
+    """
+    Add Activity item in Processor list
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inDef:
+    :param inArgList:
+    :param inArgDict:
+    :param inArgGSettingsStr:
+    :param inArgLoggerStr:
+    """
+    if inArgList is None: inArgList=[]
+    if inArgDict is None: inArgDict={}
+    lActivityList=[
+        {
+            "Def":inDef, # def link or def alias (look gSettings["Processor"]["AliasDefDict"])
+            "ArgList":inArgList, # Args list
+            "ArgDict":inArgDict, # Args dictionary
+            "ArgGSettings": inArgGSettingsStr, # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+            "ArgLogger": inArgLoggerStr # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+        },
+    ]
+    inGSettings["ProcessorDict"]["ActivityList"]+=lActivityList
    
+
+## Process defs
+
    [docs]def ProcessIsStarted(inProcessNameWOExeStr): # Check if process is started
+    """
+    Check if there is any running process that contains the given name processName.
+
+    :param inProcessNameWOExeStr:
+    :return: True - process is running; False - process is not running
+    """
+    #Iterate over the all the running process
+    for proc in psutil.process_iter():
+        try:
+            # Check if process name contains the given name string.
+            if inProcessNameWOExeStr.lower() in proc.name().lower():
+                return True
+        except (psutil.NoSuchProcess, psutil.AccessDenied, psutil.ZombieProcess):
+            pass
+    return False
    
+
+
    [docs]def ProcessStart(inPathStr, inArgList, inStopProcessNameWOExeStr=None):
+    """
+    Start process locally [optional: if task name is not started]
+
+    :param inPathStr:
+    :param inArgList:
+    :param inStopProcessNameWOExeStr:
+    """
+    lStartProcessBool = True
+    if inStopProcessNameWOExeStr is not None: #Check if process running
+        lCheckTaskName = inStopProcessNameWOExeStr
+        if len(lCheckTaskName)>4:
+            if lCheckTaskName[-4:].upper() != ".EXE":
+                lCheckTaskName = lCheckTaskName+".exe"
+        else:
+            lCheckTaskName = lCheckTaskName+".exe"
+        #Check if process exist
+        if not ProcessIsStarted(inProcessNameWOExeStr=lCheckTaskName): lStartProcessBool=True
+
+    if lStartProcessBool == True: # Start if flag is true
+        lItemArgs=[inPathStr]
+        lItemArgs.extend(inArgList)
+        subprocess.Popen(lItemArgs,shell=True)
    
+
+
    [docs]def ProcessStop(inProcessNameWOExeStr, inCloseForceBool, inUserNameStr = "%username%"):
+    """
+    Stop process
+
+    :param inProcessNameWOExeStr:
+    :param inCloseForceBool:
+    :param inUserNameStr:
+    :return:
+    """
+    # Support input arg if with .exe
+    lProcessNameWExeStr = inProcessNameWOExeStr
+    if len(lProcessNameWExeStr) > 4:
+        if lProcessNameWExeStr[-4:].upper() != ".EXE":
+            lProcessNameWExeStr = lProcessNameWExeStr + ".exe"
+    else:
+        lProcessNameWExeStr = lProcessNameWExeStr + ".exe"
+    # Flag Force
+    lActivityCloseCommand = 'taskkill /im ' + lProcessNameWExeStr
+    if inCloseForceBool == True:
+        lActivityCloseCommand += " /F"
+    # None - all users, %username% - current user, another str - another user
+    if inUserNameStr is not None:
+        lActivityCloseCommand += f' /fi "username eq {inUserNameStr}"'
+    # Kill process
+    os.system(lActivityCloseCommand)
    
+
+
    [docs]def ProcessListGet(inProcessNameWOExeList=None):
+    """
+    Check activity of the list of processes
+
+    :param inProcessNameWOExeList:
+    :return: TODO FILL THE RESULT DICT
+    """
+    if inProcessNameWOExeList is None: inProcessNameWOExeList = []
+    '''Get list of running process sorted by Memory Usage and filtered by inProcessNameWOExeList'''
+    lMapUPPERInput = {} # Mapping for processes WO exe
+    lResult = {"ProcessWOExeList":[],"ProcessDetailList":[]}
+    # Create updated list for quick check
+    lProcessNameWOExeList = []
+    for lItem in inProcessNameWOExeList:
+        if lItem is not None:
+            lProcessNameWOExeList.append(f"{lItem.upper()}.EXE")
+            lMapUPPERInput[f"{lItem.upper()}.EXE"]= lItem
+    # Iterate over the list
+    for proc in psutil.process_iter():
+        try:
+            # Fetch process details as dict
+            pinfo = proc.as_dict(attrs=['pid', 'name', 'username'])
+            pinfo['vms'] = proc.memory_info().vms / (1024 * 1024)
+            pinfo['NameWOExeUpperStr'] = pinfo['name'][:-4].upper()
+            # Add if empty inProcessNameWOExeList or if process in inProcessNameWOExeList
+            if len(lProcessNameWOExeList)==0 or pinfo['name'].upper() in lProcessNameWOExeList:
+                pinfo['NameWOExeStr'] = lMapUPPERInput[pinfo['name'].upper()]
+                lResult["ProcessDetailList"].append(pinfo) # Append dict to list
+                lResult["ProcessWOExeList"].append(pinfo['NameWOExeStr'])
+        except (psutil.NoSuchProcess, psutil.AccessDenied, psutil.ZombieProcess):
+           pass
+    return lResult
    
+
+# Python def - start module function
+
    [docs]def PythonStart(inModulePathStr, inDefNameStr, inArgList=None, inArgDict=None, inLogger = None):
+    """
+    Python import module and start def
+
+    :param inModulePathStr:
+    :param inDefNameStr:
+    :param inArgList:
+    :param inArgDict:
+    :param inLogger:
+    :return:
+    """
+    if inArgList is None: inArgList=[]
+    if inArgDict is None: inArgDict={}
+    try:
+        lModule=importlib.import_module(inModulePathStr) #Подключить модуль для вызова
+        lFunction=getattr(lModule,inDefNameStr) #Найти функцию
+        return lFunction(*inArgList,**inArgDict)
+    except Exception as e:
+        if inLogger: inLogger.exception("Loop activity error: module/function not founded")
    
+
+# # # # # # # # # # # # # # # # # # # # # # #
+
+# # # # # # # # # # # # # # # # # # # # # # #
+# Scheduler
+# # # # # # # # # # # # # # # # # # # # # # #
+
+
    [docs]def SchedulerActivityTimeAddWeekly(inGSettings, inTimeHHMMStr="23:55:", inWeekdayList=None, inActivityList=None):
+    """
+    Add activity in time weekly
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inTimeHHMMStr:
+    :param inWeekdayList:
+    :param inActivityList:
+    :return:
+    """
+    if inWeekdayList is None: inWeekdayList=[]
+    if inActivityList is None: inActivityList=[]
+    lActivityTimeItemDict = {
+        "TimeHH:MMStr": inTimeHHMMStr,  # Time [HH:MM] to trigger activity
+        "WeekdayList": inWeekdayList, # List of the weekday index when activity is applicable, Default [1,2,3,4,5,6,7]
+        "ActivityList": inActivityList,
+        "GUID": None  #    # Will be filled in Orchestrator automatically - is needed for detect activity completion
+    },
+    inGSettings["SchedulerDict"]["ActivityTimeList"].append(lActivityTimeItemDict)
    
+
+# # # # # # # # # # # # # # # # # # # # # # #
+# RDPSession
+# # # # # # # # # # # # # # # # # # # # # # #
+
+
    [docs]def RDPTemplateCreate(inLoginStr, inPasswordStr, inHostStr="127.0.0.1", inPortInt = 3389, inWidthPXInt = 1680,  inHeightPXInt = 1050,
+                      inUseBothMonitorBool = False, inDepthBitInt = 32, inSharedDriveList=None):
+    """
+    Create some RDP template dict to use it when connect/reconnect
+
+    :param inLoginStr:
+    :param inPasswordStr:
+    :param inHostStr:
+    :param inPortInt:
+    :param inWidthPXInt:
+    :param inHeightPXInt:
+    :param inUseBothMonitorBool:
+    :param inDepthBitInt:
+    :param inSharedDriveList:
+    :return:
+    """
+    if inSharedDriveList is None: inSharedDriveList = ["c"]
+    lRDPTemplateDict= {  # Init the configuration item
+        "Host": inHostStr,  # Host address, example "77.77.22.22"
+        "Port": str(inPortInt),  # RDP Port, example "3389"
+        "Login": inLoginStr,  # Login, example "test"
+        "Password": inPasswordStr,  # Password, example "test"
+        "Screen": {
+            "Width": inWidthPXInt,  # Width of the remote desktop in pixels, example 1680
+            "Height": inHeightPXInt,  # Height of the remote desktop in pixels, example 1050
+            # "640x480" or "1680x1050" or "FullScreen". If Resolution not exists set full screen, example
+            "FlagUseAllMonitors": inUseBothMonitorBool,  # True or False, example False
+            "DepthBit": str(inDepthBitInt)  # "32" or "24" or "16" or "15", example "32"
+        },
+        "SharedDriveList": inSharedDriveList,  # List of the Root sesion hard drives, example ["c"]
+        ###### Will updated in program ############
+        "SessionHex": "77777sdfsdf77777dsfdfsf77777777",  # Hex is created when robot runs, example ""
+        "SessionIsWindowExistBool": False,
+        # Flag if the RDP window is exist, old name "FlagSessionIsActive". Check every n seconds , example False
+        "SessionIsWindowResponsibleBool": False,
+        # Flag if RDP window is responsible (recieve commands). Check every nn seconds. If window is Responsible - window is Exist too , example False
+        "SessionIsIgnoredBool": False  # Flag to ignore RDP window False - dont ignore, True - ignore, example False
+    }
+    return lRDPTemplateDict
    
+
+# TODO Search dublicates in GSettings RDPlist !
+# Return list if dublicates
+
    [docs]def RDPSessionDublicatesResolve(inGSettings):
+    """
+    Search dublicates in GSettings RDPlist
+    !def is developing!
+
+    :param inGSettings: Global settings dict (singleton)
+    :return:
+    """
+    pass
    
+    #for lItemKeyStr in inGSettings["RobotRDPActive"]["RDPList"]:
+    #   lItemDict = inGSettings["RobotRDPActive"]["RDPList"][lItemKeyStr]
+
+
    [docs]def RDPSessionConnect(inGSettings, inRDPSessionKeyStr, inRDPTemplateDict=None, inHostStr=None, inPortStr=None, inLoginStr=None, inPasswordStr=None):
+    """
+    Create new RDPSession in RobotRDPActive. Attention - activity will be ignored if key is exists
+     2 way of the use
+    Var 1: inGSettings, inRDPSessionKeyStr, inRDPTemplateDict
+    Var 2  (Backward compatibility): inGSettings, inRDPSessionKeyStr, inHostStr, inPortStr, inLoginStr, inPasswordStr
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inRDPSessionKeyStr:
+    :param inRDPTemplateDict:
+    :param inHostStr:
+    :param inPortStr:
+    :param inLoginStr:
+    :param inPasswordStr:
+    :return: True every time
+    """
+    # Check thread
+    if not Core.IsProcessorThread(inGSettings=inGSettings):
+        if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP def was called not from processor queue - activity will be append in the processor queue.")
+        lResult = {
+            "Def": RDPSessionConnect, # def link or def alias (look gSettings["Processor"]["AliasDefDict"])
+            "ArgList": [],  # Args list
+            "ArgDict": {"inRDPSessionKeyStr": inRDPSessionKeyStr, "inRDPTemplateDict":inRDPTemplateDict, "inHostStr": inHostStr, "inPortStr": inPortStr,
+                    "inLoginStr": inLoginStr, "inPasswordStr": inPasswordStr},  # Args dictionary
+            "ArgGSettings": "inGSettings",  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+            "ArgLogger": None  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+        }
+        inGSettings["ProcessorDict"]["ActivityList"].append(lResult)
+    else: # In processor - do execution
+        # Var 1 - if RDPTemplateDict is input
+        lRDPConfigurationItem=inRDPTemplateDict
+        # Var 2 - backward compatibility
+        if lRDPConfigurationItem is None:
+            lRDPConfigurationItem = RDPTemplateCreate(inLoginStr=inLoginStr, inPasswordStr=inPasswordStr,
+                  inHostStr=inHostStr, inPortInt = int(inPortStr))            # ATTENTION - dont connect if RDP session is exist
+        # Start the connect
+        if inRDPSessionKeyStr not in inGSettings["RobotRDPActive"]["RDPList"]:
+            inGSettings["RobotRDPActive"]["RDPList"][inRDPSessionKeyStr] = lRDPConfigurationItem # Add item in RDPList
+            Connector.Session(lRDPConfigurationItem) # Create the RDP session
+            Connector.SystemRDPWarningClickOk()  # Click all warning messages
+        else:
+            if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP session was not created because it is alredy exists in the RDPList. Use RDPSessionReconnect if you want to update RDP configuration.")
+    return True
    
+
+
    [docs]def RDPSessionDisconnect(inGSettings, inRDPSessionKeyStr, inBreakTriggerProcessWOExeList = None):
+    """
+    Disconnect the RDP session
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inRDPSessionKeyStr:
+    :param inBreakTriggerProcessWOExeList:
+    :return: True every time
+    """
+    if inBreakTriggerProcessWOExeList is None: inBreakTriggerProcessWOExeList = []
+    # Check thread
+    if not Core.IsProcessorThread(inGSettings=inGSettings):
+        if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP def was called not from processor queue - activity will be append in the processor queue.")
+        lResult = {
+            "Def": RDPSessionDisconnect, # def link or def alias (look gSettings["Processor"]["AliasDefDict"])
+            "ArgList": [],  # Args list
+            "ArgDict": {"inRDPSessionKeyStr": inRDPSessionKeyStr, "inBreakTriggerProcessWOExeList": inBreakTriggerProcessWOExeList },  # Args dictionary
+            "ArgGSettings": "inGSettings",  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+            "ArgLogger": None  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+        }
+        inGSettings["ProcessorDict"]["ActivityList"].append(lResult)
+    else: # In processor - do execution
+        lSessionHex = inGSettings["RobotRDPActive"]["RDPList"].get(inRDPSessionKeyStr,{}).get("SessionHex", None)
+        if lSessionHex:
+            lProcessListResult = {"ProcessWOExeList":[],"ProcessDetailList":[]}
+            if len(inBreakTriggerProcessWOExeList) > 0:
+                lProcessListResult = ProcessListGet(inProcessNameWOExeList=inBreakTriggerProcessWOExeList)  # Run the task manager monitor
+            if len(lProcessListResult["ProcessWOExeList"]) == 0: # Start disconnect if no process exist
+                inGSettings["RobotRDPActive"]["RDPList"].pop(inRDPSessionKeyStr,None)
+                Connector.SessionClose(inSessionHexStr=lSessionHex)
+                Connector.SystemRDPWarningClickOk()  # Click all warning messages
+    return True
    
+
+
    [docs]def RDPSessionReconnect(inGSettings, inRDPSessionKeyStr, inRDPTemplateDict=None):
+    """
+    RDP Session reconnect
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inRDPSessionKeyStr:
+    :param inRDPTemplateDict:
+    :return:
+    """
+    # Check thread
+    if not Core.IsProcessorThread(inGSettings=inGSettings):
+        if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP def was called not from processor queue - activity will be append in the processor queue.")
+        lResult = {
+            "Def": RDPSessionReconnect, # def link or def alias (look gSettings["Processor"]["AliasDefDict"])
+            "ArgList": [],  # Args list
+            "ArgDict": {"inRDPSessionKeyStr": inRDPSessionKeyStr, "inRDPTemplateDict":inRDPTemplateDict },  # Args dictionary
+            "ArgGSettings": "inGSettings",  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+            "ArgLogger": None  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+        }
+        inGSettings["ProcessorDict"]["ActivityList"].append(lResult)
+    else:
+        lRDPConfigurationItem = inGSettings["RobotRDPActive"]["RDPList"][inRDPSessionKeyStr]
+        RDPSessionDisconnect(inRDPSessionKeyStr=inRDPSessionKeyStr) # Disconnect the RDP
+        # Replace Configuration item if inRDPTemplateDict exists
+        if inRDPTemplateDict is not None: lRDPConfigurationItem=inRDPTemplateDict
+        # Add item in RDPList
+        inGSettings["RobotRDPActive"]["RDPList"][inRDPSessionKeyStr] = lRDPConfigurationItem
+        # Create the RDP session
+        Connector.Session(lRDPConfigurationItem)
+    return True
    
+
+
    [docs]def RDPSessionMonitorStop(inGSettings, inRDPSessionKeyStr):
+    """
+    Stop track the RDP session. Current def dont kill RDP session - only stop to track it (it can give )
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inRDPSessionKeyStr:
+    :return:
+    """
+    lResult = True
+    inGSettings["RobotRDPActive"]["RDPList"].pop(inRDPSessionKeyStr,None) # Remove item from RDPList
+    return lResult
    
+
+
    [docs]def RDPSessionLogoff(inGSettings, inRDPSessionKeyStr, inBreakTriggerProcessWOExeList = None):
+    """
+    Logoff the RDP session
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inRDPSessionKeyStr:
+    :param inBreakTriggerProcessWOExeList:
+    :return: True - logoff is successful
+    """
+    if inBreakTriggerProcessWOExeList is None: inBreakTriggerProcessWOExeList = []
+    lResult = True
+    # Check thread
+    if not Core.IsProcessorThread(inGSettings=inGSettings):
+        if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP def was called not from processor queue - activity will be append in the processor queue.")
+        lResult = {
+            "Def": RDPSessionLogoff, # def link or def alias (look gSettings["Processor"]["AliasDefDict"])
+            "ArgList": [],  # Args list
+            "ArgDict": {"inRDPSessionKeyStr": inRDPSessionKeyStr, "inBreakTriggerProcessWOExeList": inBreakTriggerProcessWOExeList },  # Args dictionary
+            "ArgGSettings": "inGSettings",  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+            "ArgLogger": None  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+        }
+        inGSettings["ProcessorDict"]["ActivityList"].append(lResult)
+    else:
+        lCMDStr = "shutdown -L" # CMD logoff command
+        # Calculate the session Hex
+        lSessionHex = inGSettings["RobotRDPActive"]["RDPList"].get(inRDPSessionKeyStr,{}).get("SessionHex", None)
+        if lSessionHex:
+            lProcessListResult = {"ProcessWOExeList":[],"ProcessDetailList":[]}
+            if len(inBreakTriggerProcessWOExeList) > 0:
+                lProcessListResult = ProcessListGet(inProcessNameWOExeList=inBreakTriggerProcessWOExeList)  # Run the task manager monitor
+            if len(lProcessListResult["ProcessWOExeList"]) == 0: # Start logoff if no process exist
+                # Run CMD - dont crosscheck because CMD dont return value to the clipboard when logoff
+                Connector.SessionCMDRun(inSessionHex=lSessionHex, inCMDCommandStr=lCMDStr, inModeStr="RUN", inLogger=inGSettings["Logger"], inRDPConfigurationItem=inGSettings["RobotRDPActive"]["RDPList"][inRDPSessionKeyStr])
+                inGSettings["RobotRDPActive"]["RDPList"].pop(inRDPSessionKeyStr,None) # Remove item from RDPList
+    return lResult
    
+
+
    [docs]def RDPSessionResponsibilityCheck(inGSettings, inRDPSessionKeyStr):
+    """
+    Check RDP Session responsibility TODO NEED DEV + TEST
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inRDPSessionKeyStr:
+    :return: True every time
+    """
+    # Check thread
+    if not Core.IsProcessorThread(inGSettings=inGSettings):
+        if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP def was called not from processor queue - activity will be append in the processor queue.")
+        lResult = {
+            "Def": RDPSessionResponsibilityCheck, # def link or def alias (look gSettings["Processor"]["AliasDefDict"])
+            "ArgList": [],  # Args list
+            "ArgDict": {"inRDPSessionKeyStr": inRDPSessionKeyStr },  # Args dictionary
+            "ArgGSettings": "inGSettings",  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+            "ArgLogger": None  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+        }
+        inGSettings["ProcessorDict"]["ActivityList"].append(lResult)
+    else:
+        lRDPConfigurationItem = inGSettings["RobotRDPActive"]["RDPList"][inRDPSessionKeyStr] # Get the alias
+        # set the fullscreen
+        # ATTENTION!!! Session hex can be updated!!!
+        Connector.SessionScreenFull(inSessionHex=lRDPConfigurationItem["SessionHex"], inLogger=inGSettings["Logger"], inRDPConfigurationItem=inGSettings["RobotRDPActive"]["RDPList"][inRDPSessionKeyStr])
+        time.sleep(1)
+        # Check RDP responsibility
+        lDoCheckResponsibilityBool = True
+        lDoCheckResponsibilityCountMax = 20
+        lDoCheckResponsibilityCountCurrent = 0
+        while lDoCheckResponsibilityBool:
+            # Check if counter is exceed - raise exception
+            if lDoCheckResponsibilityCountCurrent >= lDoCheckResponsibilityCountMax:
+                pass
+                #raise ConnectorExceptions.SessionWindowNotResponsibleError("Error when initialize the RDP session - RDP window is not responding!")
+            # Check responding
+            lDoCheckResponsibilityBool = not Connector.SystemRDPIsResponsible(inSessionHexStr = lRDPConfigurationItem["SessionHex"])
+            # Wait if is not responding
+            if lDoCheckResponsibilityBool:
+                time.sleep(3)
+            # increase the couter
+            lDoCheckResponsibilityCountCurrent+=1
+    return True
    
+
+
    [docs]def RDPSessionProcessStartIfNotRunning(inGSettings, inRDPSessionKeyStr, inProcessNameWEXEStr, inFilePathStr, inFlagGetAbsPathBool=True):
+    """
+    Start process if it is not running
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inRDPSessionKeyStr:
+    :param inProcessNameWEXEStr:
+    :param inFilePathStr:
+    :param inFlagGetAbsPathBool:
+    :return:
+    """
+    # Check thread
+    if not Core.IsProcessorThread(inGSettings=inGSettings):
+        if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP def was called not from processor queue - activity will be append in the processor queue.")
+        lResult = {
+            "Def": RDPSessionProcessStartIfNotRunning, # def link or def alias (look gSettings["Processor"]["AliasDefDict"])
+            "ArgList": [],  # Args list
+            "ArgDict": {"inRDPSessionKeyStr": inRDPSessionKeyStr,  "inProcessNameWEXEStr": inProcessNameWEXEStr, "inFilePathStr": inFilePathStr, "inFlagGetAbsPathBool": inFlagGetAbsPathBool },  # Args dictionary
+            "ArgGSettings": "inGSettings",  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+            "ArgLogger": None  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+        }
+        inGSettings["ProcessorDict"]["ActivityList"].append(lResult)
+    else:
+        lResult = True
+        lCMDStr = CMDStr.ProcessStartIfNotRunning(inProcessNameWEXEStr, inFilePathStr, inFlagGetAbsPath= inFlagGetAbsPathBool)
+        # Calculate the session Hex
+        lSessionHex = inGSettings["RobotRDPActive"]["RDPList"].get(inRDPSessionKeyStr,{}).get("SessionHex", None)
+        # Run CMD
+        if lSessionHex:
+            Connector.SessionCMDRun(inSessionHex=lSessionHex, inCMDCommandStr=lCMDStr, inModeStr="CROSSCHECK", inLogger=inGSettings["Logger"],
+                                    inRDPConfigurationItem=inGSettings["RobotRDPActive"]["RDPList"][inRDPSessionKeyStr])
+    return lResult
    
+
+
    [docs]def RDPSessionCMDRun(inGSettings, inRDPSessionKeyStr, inCMDStr, inModeStr="CROSSCHECK"):
+    """
+    Send command in RDP session
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inRDPSessionKeyStr:
+    :param inCMDStr:
+    :param inModeStr:
+    :return: True - CMD was executed successfully
+    """
+    # Check thread
+    if not Core.IsProcessorThread(inGSettings=inGSettings):
+        if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP def was called not from processor queue - activity will be append in the processor queue.")
+        lResult = {
+            "Def": RDPSessionCMDRun, # def link or def alias (look gSettings["Processor"]["AliasDefDict"])
+            "ArgList": [],  # Args list
+            "ArgDict": {"inRDPSessionKeyStr": inRDPSessionKeyStr,  "inCMDStr": inCMDStr, "inModeStr": inModeStr },  # Args dictionary
+            "ArgGSettings": "inGSettings",  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+            "ArgLogger": None  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+        }
+        inGSettings["ProcessorDict"]["ActivityList"].append(lResult)
+    else:
+        lResult = True
+        # Calculate the session Hex
+        lSessionHex = inGSettings["RobotRDPActive"]["RDPList"].get(inRDPSessionKeyStr,{}).get("SessionHex", None)
+        # Run CMD
+        if lSessionHex:
+            Connector.SessionCMDRun(inSessionHex=lSessionHex, inCMDCommandStr=inCMDStr, inModeStr=inModeStr, inLogger=inGSettings["Logger"],
+                                    inRDPConfigurationItem=inGSettings["RobotRDPActive"]["RDPList"][inRDPSessionKeyStr])
+    return lResult
    
+
+
    [docs]def RDPSessionProcessStop(inGSettings, inRDPSessionKeyStr, inProcessNameWEXEStr, inFlagForceCloseBool):
+    """
+    Create CMD str to stop process
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inRDPSessionKeyStr:
+    :param inProcessNameWEXEStr:
+    :param inFlagForceCloseBool:
+    :return:
+    """
+    # Check thread
+    if not Core.IsProcessorThread(inGSettings=inGSettings):
+        if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP def was called not from processor queue - activity will be append in the processor queue.")
+        lResult = {
+            "Def": RDPSessionProcessStop, # def link or def alias (look gSettings["Processor"]["AliasDefDict"])
+            "ArgList": [],  # Args list
+            "ArgDict": {"inRDPSessionKeyStr": inRDPSessionKeyStr,  "inProcessNameWEXEStr": inProcessNameWEXEStr, "inFlagForceCloseBool": inFlagForceCloseBool },  # Args dictionary
+            "ArgGSettings": "inGSettings",  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+            "ArgLogger": None  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+        }
+        inGSettings["ProcessorDict"]["ActivityList"].append(lResult)
+    else:
+        lResult = True
+        lCMDStr = f'taskkill /im "{inProcessNameWEXEStr}" /fi "username eq %USERNAME%"'
+        if inFlagForceCloseBool:
+            lCMDStr+= " /F"
+        # Calculate the session Hex
+        lSessionHex = inGSettings["RobotRDPActive"]["RDPList"].get(inRDPSessionKeyStr,{}).get("SessionHex", None)
+        # Run CMD
+        if lSessionHex:
+            Connector.SessionCMDRun(inSessionHex=lSessionHex, inCMDCommandStr=lCMDStr, inModeStr="CROSSCHECK", inLogger=inGSettings["Logger"], inRDPConfigurationItem=inGSettings["RobotRDPActive"]["RDPList"][inRDPSessionKeyStr])
+    return lResult
    
+
+
    [docs]def RDPSessionFileStoredSend(inGSettings, inRDPSessionKeyStr, inHostFilePathStr, inRDPFilePathStr):
+    """
+    Send file from Host to Session RDP using shared drive in RDP
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inRDPSessionKeyStr:
+    :param inHostFilePathStr:
+    :param inRDPFilePathStr:
+    :return:
+    """
+    # Check thread
+    if not Core.IsProcessorThread(inGSettings=inGSettings):
+        if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP def was called not from processor queue - activity will be append in the processor queue.")
+        lResult = {
+            "Def": RDPSessionFileStoredSend, # def link or def alias (look gSettings["Processor"]["AliasDefDict"])
+            "ArgList": [],  # Args list
+            "ArgDict": {"inRDPSessionKeyStr": inRDPSessionKeyStr,  "inHostFilePathStr": inHostFilePathStr, "inRDPFilePathStr": inRDPFilePathStr },  # Args dictionary
+            "ArgGSettings": "inGSettings",  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+            "ArgLogger": None  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+        }
+        inGSettings["ProcessorDict"]["ActivityList"].append(lResult)
+    else:
+        lResult = True
+        lCMDStr = CMDStr.FileStoredSend(inHostFilePath = inHostFilePathStr, inRDPFilePath = inRDPFilePathStr)
+        # Calculate the session Hex
+        lSessionHex = inGSettings["RobotRDPActive"]["RDPList"].get(inRDPSessionKeyStr, {}).get("SessionHex", None)
+        #lSessionHex = inGlobalDict["RobotRDPActive"]["RDPList"][inRDPSessionKeyStr]["SessionHex"]
+        # Run CMD
+        if lSessionHex:
+            Connector.SessionCMDRun(inSessionHex=lSessionHex, inCMDCommandStr=lCMDStr, inModeStr="LISTEN", inClipboardTimeoutSec = 120, inLogger=inGSettings["Logger"], inRDPConfigurationItem=inGSettings["RobotRDPActive"]["RDPList"][inRDPSessionKeyStr])
+    return lResult
    
+
+
    [docs]def RDPSessionFileStoredRecieve(inGSettings, inRDPSessionKeyStr, inRDPFilePathStr, inHostFilePathStr):
+    """
+    Receive file from Session RDP to Host using shared drive in RDP
+
+    :param inGSettings: Global settings dict (singleton)
+    :param inRDPSessionKeyStr:
+    :param inRDPFilePathStr:
+    :param inHostFilePathStr:
+    :return:
+    """
+    # Check thread
+    if not Core.IsProcessorThread(inGSettings=inGSettings):
+        if inGSettings["Logger"]: inGSettings["Logger"].warning(f"RDP def was called not from processor queue - activity will be append in the processor queue.")
+        lResult = {
+            "Def": RDPSessionFileStoredRecieve, # def link or def alias (look gSettings["Processor"]["AliasDefDict"])
+            "ArgList": [],  # Args list
+            "ArgDict": {"inRDPSessionKeyStr": inRDPSessionKeyStr, "inRDPFilePathStr": inRDPFilePathStr, "inHostFilePathStr": inHostFilePathStr },  # Args dictionary
+            "ArgGSettings": "inGSettings",  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+            "ArgLogger": None  # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
+        }
+        inGSettings["ProcessorDict"]["ActivityList"].append(lResult)
+    else:
+        lResult = True
+        lCMDStr = CMDStr.FileStoredRecieve(inRDPFilePath = inRDPFilePathStr, inHostFilePath = inHostFilePathStr)
+        # Calculate the session Hex
+        lSessionHex = inGSettings["RobotRDPActive"]["RDPList"].get(inRDPSessionKeyStr,{}).get("SessionHex", None)
+        # Run CMD
+        if lSessionHex:
+            Connector.SessionCMDRun(inSessionHex=lSessionHex, inCMDCommandStr=lCMDStr, inModeStr="LISTEN", inClipboardTimeoutSec = 120, inLogger=inGSettings["Logger"], inRDPConfigurationItem=inGSettings["RobotRDPActive"]["RDPList"][inRDPSessionKeyStr])
+    return lResult
    
+
+# # # # # # # # # # # # # # # # # # # # # # #
+# # # # # Start orchestrator
+# # # # # # # # # # # # # # # # # # # # # # #
+
+
    [docs]def GSettingsAutocleaner(inGSettings):
+    """
+    Interval gsettings auto cleaner
+
+    :param inGSettings: Global settings dict (singleton)
+    :return:
+    """
+    while True:
+        time.sleep(inGSettings["Autocleaner"]["IntervalSecFloat"])  # Wait for the next iteration
+        lL = inGSettings["Logger"]
+        if lL: lL.info(f"Autocleaner is running") # Info
+        lNowDatetime = datetime.datetime.now() # Get now time
+        # Clean old items in Client > Session > TechnicalSessionGUIDCache
+        lTechnicalSessionGUIDCacheNew = {}
+        for lItemKeyStr in inGSettings["Client"]["Session"]["TechnicalSessionGUIDCache"]:
+            lItemValue = inGSettings["Client"]["Session"]["TechnicalSessionGUIDCache"][lItemKeyStr]
+            if (lNowDatetime - lItemValue["InitDatetime"]).total_seconds() < inGSettings["Client"]["Session"]["LifetimeSecFloat"]: # Add if lifetime is ok
+                lTechnicalSessionGUIDCacheNew[lItemKeyStr]=lItemValue # Lifetime is ok - set
+            else:
+                if lL: lL.debug(f"Client > Session > TechnicalSessionGUIDCache > lItemKeyStr: Lifetime is expired. Remove from gSettings")  # Info
+        inGSettings["Client"]["Session"]["TechnicalSessionGUIDCache"] = lTechnicalSessionGUIDCacheNew # Set updated Cache
    
+    # # # # # # # # # # # # # # # # # # # # # # # # # #
+
+from .. import __version__ # Get version from the package
+
+def Orchestrator(inGSettings):
+    lL = inGSettings["Logger"]
+    # https://stackoverflow.com/questions/130763/request-uac-elevation-from-within-a-python-script
+    def is_admin():
+        try:
+            return ctypes.windll.shell32.IsUserAnAdmin()
+        except:
+            return False
+    if not is_admin():
+        # Re-run the program with admin rights
+        ctypes.windll.shell32.ShellExecuteW(None, "runas", sys.executable, " ".join(sys.argv), None, 1)
+    else:
+        # Code of your program here
+        #mGlobalDict = Settings.Settings(sys.argv[1])
+        gSettingsDict = inGSettings # Alias for old name in alg
+        inGSettings["VersionStr"] = __version__
+        #Logger alias
+        lL = gSettingsDict["Logger"]
+
+        if lL: lL.info("Link the gSettings in submodules")  #Logging
+        Processor.gSettingsDict = gSettingsDict
+        Timer.gSettingsDict = gSettingsDict
+        Timer.Processor.gSettingsDict = gSettingsDict
+        Server.gSettingsDict = gSettingsDict
+        Server.ProcessorOld.gSettingsDict = gSettingsDict # Backward compatibility
+
+        # Check _SessionLast_RDPList.json in working directory. if exist - load into gsettings
+        # GSettings
+        #"RobotRDPActive": {
+        #    "RDPList": {
+        if os.path.exists("_SessionLast_RDPList.json"):
+            lFile = open("_SessionLast_RDPList.json", "r", encoding="utf-8")
+            lSessionLastRDPList = json.loads(lFile.read())
+            lFile.close() # Close the file
+            os.remove("_SessionLast_RDPList.json") # remove the temp file
+            gSettingsDict["RobotRDPActive"]["RDPList"]=lSessionLastRDPList # Set the last session dict
+            if lL: lL.warning(f"RDP Session List was restored from previous Orchestrator session")
+
+        # Init SettingsUpdate defs from file list (after RDP restore)
+        lSettingsUpdateFilePathList = gSettingsDict.get("OrchestratorStart", {}).get("DefSettingsUpdatePathList",[])
+        lSubmoduleFunctionName = "SettingsUpdate"
+        lSettingsPath = "\\".join(os.path.join(os.getcwd(), __file__).split("\\")[:-1])
+        for lModuleFilePathItem in lSettingsUpdateFilePathList:  # Import defs with try catch
+            try:  # Try to init - go next if error and log in logger
+                lModuleName = lModuleFilePathItem[0:-3]
+                lFileFullPath = os.path.join(lSettingsPath, lModuleFilePathItem)
+                lTechSpecification = importlib.util.spec_from_file_location(lModuleName, lFileFullPath)
+                lTechModuleFromSpec = importlib.util.module_from_spec(lTechSpecification)
+                lTechSpecificationModuleLoader = lTechSpecification.loader.exec_module(lTechModuleFromSpec)
+                if lSubmoduleFunctionName in dir(lTechModuleFromSpec):
+                    # Run SettingUpdate function in submodule
+                    getattr(lTechModuleFromSpec, lSubmoduleFunctionName)(gSettingsDict)
+            except Exception as e:
+                if lL: lL.exception(f"Error when init .py file in orchestrator '{lModuleFilePathItem}'. Exception is below:")
+
+        # Turn on backward compatibility
+        BackwardCompatibility.Update(inGSettings= gSettingsDict)
+
+        # Append Orchestrator def to ProcessorDictAlias
+        lModule = sys.modules[__name__]
+        lModuleDefList = dir(lModule)
+        for lItemDefNameStr in lModuleDefList:
+            # Dont append alias for defs Orchestrator and ___deprecated_orchestrator_start__
+            if lItemDefNameStr not in ["Orchestrator", "___deprecated_orchestrator_start__"]:
+                lItemDef = getattr(lModule,lItemDefNameStr)
+                if callable(lItemDef): inGSettings["ProcessorDict"]["AliasDefDict"][lItemDefNameStr]=lItemDef
+
+        #Инициализация настроечных параметров
+        lDaemonLoopSeconds=gSettingsDict["SchedulerDict"]["CheckIntervalSecFloat"]
+        lDaemonActivityLogDict={} #Словарь отработанных активностей, ключ - кортеж (<activityType>, <datetime>, <processPath || processName>, <processArgs>)
+        lDaemonLastDateTime=datetime.datetime.now()
+        gSettingsDict["ServerDict"]["WorkingDirectoryPathStr"] = os.getcwd() # Set working directory in g settings
+
+        #Инициализация сервера
+        lThreadServer = Server.RobotDaemonServer("ServerThread", gSettingsDict)
+        lThreadServer.start()
+        if lL: lL.info("Web server has been started")  #Logging
+
+        # Init the RobotScreenActive in another thread
+        lRobotScreenActiveThread = threading.Thread(target= Monitor.CheckScreen)
+        lRobotScreenActiveThread.daemon = True # Run the thread in daemon mode.
+        lRobotScreenActiveThread.start() # Start the thread execution.
+        if lL: lL.info("Robot Screen active has been started")  #Logging
+
+        # Init the RobotRDPActive in another thread
+        lRobotRDPThreadControlDict = {"ThreadExecuteBool":True} # inThreadControlDict = {"ThreadExecuteBool":True}
+        lRobotRDPActiveThread = threading.Thread(target= RobotRDPActive.RobotRDPActive, kwargs={"inGSettings":gSettingsDict, "inThreadControlDict":lRobotRDPThreadControlDict})
+        lRobotRDPActiveThread.daemon = True # Run the thread in daemon mode.
+        lRobotRDPActiveThread.start() # Start the thread execution.
+        if lL: lL.info("Robot RDP active has been started")  #Logging
+
+        # Init autocleaner in another thread
+        lAutocleanerThread = threading.Thread(target= GSettingsAutocleaner, kwargs={"inGSettings":gSettingsDict})
+        lAutocleanerThread.daemon = True # Run the thread in daemon mode.
+        lAutocleanerThread.start() # Start the thread execution.
+        if lL: lL.info("Autocleaner thread has been started")  #Logging
+
+        # Orchestrator start activity
+        if lL: lL.info("Orchestrator start activity run")  #Logging
+        for lActivityItem in gSettingsDict["OrchestratorStart"]["ActivityList"]:
+            Processor.ActivityListOrDict(lActivityItem)
+
+        # Processor thread
+        lProcessorThread = threading.Thread(target= Processor.ProcessorRunSync, kwargs={"inGSettings":gSettingsDict, "inRobotRDPThreadControlDict":lRobotRDPThreadControlDict})
+        lProcessorThread.daemon = True # Run the thread in daemon mode.
+        lProcessorThread.start() # Start the thread execution.
+        if lL: lL.info("Processor has been started (ProcessorDict)")  #Logging
+
+
+        if lL: lL.info("Scheduler loop start")  #Logging
+        gDaemonActivityLogDictRefreshSecInt = 10 # The second period for clear lDaemonActivityLogDict from old items
+        gDaemonActivityLogDictLastTime = time.time() # The second perioad for clean lDaemonActivityLogDict from old items
+        while True:
+            try:
+                lCurrentDateTime = datetime.datetime.now()
+                #Циклический обход правил
+                lFlagSearchActivityType=True
+                # Periodically clear the lDaemonActivityLogDict
+                if time.time()-gDaemonActivityLogDictLastTime>=gDaemonActivityLogDictRefreshSecInt:
+                    gDaemonActivityLogDictLastTime = time.time() # Update the time
+                    for lIndex, lItem in enumerate(lDaemonActivityLogDict):
+                        if lItem["ActivityEndDateTime"] and lCurrentDateTime<=lItem["ActivityEndDateTime"]:
+                            pass
+                            # Activity is actual - do not delete now
+                        else:
+                            # remove the activity - not actual
+                            lDaemonActivityLogDict.pop(lIndex,None)
+                lIterationLastDateTime = lDaemonLastDateTime # Get current datetime before iterator (need for iterate all activities in loop)
+                # Iterate throught the activity list
+                for lIndex, lItem in enumerate(gSettingsDict["SchedulerDict"]["ActivityTimeList"]):
+                    try:
+                        # Prepare GUID of the activity
+                        lGUID = None
+                        if "GUID" in lItem and lItem["GUID"]:
+                            lGUID = lItem["GUID"]
+                        else:
+                            lGUID = str(uuid.uuid4())
+                            lItem["GUID"]=lGUID
+
+                        #Проверка дней недели, в рамках которых можно запускать активность
+                        lItemWeekdayList=lItem.get("WeekdayList", [0, 1, 2, 3, 4, 5, 6])
+                        if lCurrentDateTime.weekday() in lItemWeekdayList:
+                            if lFlagSearchActivityType:
+                                #######################################################################
+                                #Branch 1 - if has TimeHH:MM
+                                #######################################################################
+                                if "TimeHH:MM" in lItem:
+                                    #Вид активности - запуск процесса
+                                    #Сформировать временной штамп, относительно которого надо будет проверять время
+                                    #часовой пояс пока не учитываем
+                                    lActivityDateTime=datetime.datetime.strptime(lItem["TimeHH:MM"],"%H:%M")
+                                    lActivityDateTime=lActivityDateTime.replace(year=lCurrentDateTime.year,month=lCurrentDateTime.month,day=lCurrentDateTime.day)
+                                    #Убедиться в том, что время наступило
+                                    if (
+                                            lActivityDateTime>=lDaemonLastDateTime and
+                                            lCurrentDateTime>=lActivityDateTime):
+                                        # Log info about activity
+                                        if lL: lL.info(f"Scheduler:: Activity list is started in new thread. Scheduler item: {lItem}")  #Logging
+                                        # Do the activity
+                                        lThread = threading.Thread(target=Processor.ActivityListExecute, kwargs={"inGSettings": inGSettings, "inActivityList":lItem["ActivityList"]})
+                                        lThread.start()
+                                        lIterationLastDateTime = datetime.datetime.now() # Set the new datetime for the new processor activity
+                    except Exception as e:
+                        if lL: lL.exception(f"Scheduler: Exception has been catched in Scheduler module when activity time item was initialising. ActivityTimeItem is {lItem}")
+                lDaemonLastDateTime = lIterationLastDateTime # Set the new datetime for the new processor activity
+                #Уснуть до следующего прогона
+                time.sleep(lDaemonLoopSeconds)
+            except Exception as e:
+                if lL: lL.exception(f"Scheduler: Exception has been catched in Scheduler module. Global error")
+
+# Backward compatibility below to 1.2.0
+def __deprecated_orchestrator_start__():
+    lSubmoduleFunctionName = "Settings"
+    lFileFullPath = sys.argv[1]
+    lModuleName = (lFileFullPath.split("\\")[-1])[0:-3]
+    lTechSpecification = importlib.util.spec_from_file_location(lModuleName, lFileFullPath)
+    lTechModuleFromSpec = importlib.util.module_from_spec(lTechSpecification)
+    lTechSpecificationModuleLoader = lTechSpecification.loader.exec_module(lTechModuleFromSpec)
+    gSettingsDict = None
+    if lSubmoduleFunctionName in dir(lTechModuleFromSpec):
+        # Run SettingUpdate function in submodule
+        gSettingsDict = getattr(lTechModuleFromSpec, lSubmoduleFunctionName)()
+    #################################################
+    Orchestrator(inGSettings=gSettingsDict) # Call the orchestrator
+
    +
    + +
    + +
    +
    + + \ No newline at end of file diff --git a/Wiki/ENG_Guide/html/_sources/Orchestrator.rst.txt b/Wiki/ENG_Guide/html/_sources/Orchestrator.rst.txt new file mode 100644 index 00000000..dbae85b5 --- /dev/null +++ b/Wiki/ENG_Guide/html/_sources/Orchestrator.rst.txt @@ -0,0 +1,26 @@ +.. pyOpenRPA documentation master file, created by + sphinx-quickstart on Sat Dec 19 23:59:00 2020. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +Welcome to pyOpenRPA's documentation! +===================================== + +.. toctree:: + :maxdepth: 2 + :caption: Contents: + + + +Indices and tables +===================================== + +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` + + +pyOpenRPA Orchestrator +===================================== +.. automodule:: pyOpenRPA.Orchestrator.__Orchestrator__ + :members: diff --git a/Wiki/ENG_Guide/html/_sources/index.rst.txt b/Wiki/ENG_Guide/html/_sources/index.rst.txt new file mode 100644 index 00000000..9b83f9e6 --- /dev/null +++ b/Wiki/ENG_Guide/html/_sources/index.rst.txt @@ -0,0 +1,29 @@ +.. pyOpenRPA documentation master file, created by + sphinx-quickstart on Sat Dec 19 23:59:00 2020. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +Welcome to pyOpenRPA's documentation! +===================================== + +.. toctree:: + :maxdepth: 2 + :caption: Contents: + :glob: + :titlesonly: + Orchestrator + * + + +Indices and tables +===================================== + +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` + + +pyOpenRPA Orchestrator +===================================== +.. automodule:: pyOpenRPA.Orchestrator.__Orchestrator__ + :members: diff --git a/Wiki/ENG_Guide/html/_static/basic.css b/Wiki/ENG_Guide/html/_static/basic.css new file mode 100644 index 00000000..24a49f09 --- /dev/null +++ b/Wiki/ENG_Guide/html/_static/basic.css @@ -0,0 +1,856 @@ +/* + * basic.css + * ~~~~~~~~~ + * + * Sphinx stylesheet -- basic theme. + * + * :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/* -- main layout ----------------------------------------------------------- */ + +div.clearer { + clear: both; +} + +div.section::after { + display: block; + content: ''; + clear: left; +} + +/* -- relbar ---------------------------------------------------------------- */ + +div.related { + width: 100%; + font-size: 90%; +} + +div.related h3 { + display: none; +} + +div.related ul { + margin: 0; + padding: 0 0 0 10px; + list-style: none; +} + +div.related li { + display: inline; +} + +div.related li.right { + float: right; + margin-right: 5px; +} + +/* -- sidebar --------------------------------------------------------------- */ + +div.sphinxsidebarwrapper { + padding: 10px 5px 0 10px; +} + +div.sphinxsidebar { + float: left; + width: 230px; + margin-left: -100%; + font-size: 90%; + word-wrap: break-word; + overflow-wrap : break-word; +} + +div.sphinxsidebar ul { + list-style: none; +} + +div.sphinxsidebar ul ul, +div.sphinxsidebar ul.want-points { + margin-left: 20px; + list-style: square; +} + +div.sphinxsidebar ul ul { + margin-top: 0; + margin-bottom: 0; +} + +div.sphinxsidebar form { + margin-top: 10px; +} + +div.sphinxsidebar input { + border: 1px solid #98dbcc; + font-family: sans-serif; + font-size: 1em; +} + +div.sphinxsidebar #searchbox form.search { + overflow: hidden; +} + +div.sphinxsidebar #searchbox input[type="text"] { + float: left; + width: 80%; + padding: 0.25em; + box-sizing: border-box; +} + +div.sphinxsidebar #searchbox input[type="submit"] { + float: left; + width: 20%; + border-left: none; + padding: 0.25em; + box-sizing: border-box; +} + + +img { + border: 0; + max-width: 100%; +} + +/* -- search page ----------------------------------------------------------- */ + +ul.search { + margin: 10px 0 0 20px; + padding: 0; +} + +ul.search li { + padding: 5px 0 5px 20px; + background-image: url(file.png); + background-repeat: no-repeat; + background-position: 0 7px; +} + +ul.search li a { + font-weight: bold; +} + +ul.search li div.context { + color: #888; + margin: 2px 0 0 30px; + text-align: left; +} + +ul.keywordmatches li.goodmatch a { + font-weight: bold; +} + +/* -- index page ------------------------------------------------------------ */ + +table.contentstable { + width: 90%; + margin-left: auto; + margin-right: auto; +} + +table.contentstable p.biglink { + line-height: 150%; +} + +a.biglink { + font-size: 1.3em; +} + +span.linkdescr { + font-style: italic; + padding-top: 5px; + font-size: 90%; +} + +/* -- general index --------------------------------------------------------- */ + +table.indextable { + width: 100%; +} + +table.indextable td { + text-align: left; + vertical-align: top; +} + +table.indextable ul { + margin-top: 0; + margin-bottom: 0; + list-style-type: none; +} + +table.indextable > tbody > tr > td > ul { + padding-left: 0em; +} + +table.indextable tr.pcap { + height: 10px; +} + +table.indextable tr.cap { + margin-top: 10px; + background-color: #f2f2f2; +} + +img.toggler { + margin-right: 3px; + margin-top: 3px; + cursor: pointer; +} + +div.modindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +div.genindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +/* -- domain module index --------------------------------------------------- */ + +table.modindextable td { + padding: 2px; + border-collapse: collapse; +} + +/* -- general body styles --------------------------------------------------- */ + +div.body { + min-width: 450px; + max-width: 800px; +} + +div.body p, div.body dd, div.body li, div.body blockquote { + -moz-hyphens: auto; + -ms-hyphens: auto; + -webkit-hyphens: auto; + hyphens: auto; +} + +a.headerlink { + visibility: hidden; +} + +a.brackets:before, +span.brackets > a:before{ + content: "["; +} + +a.brackets:after, +span.brackets > a:after { + content: "]"; +} + +h1:hover > a.headerlink, +h2:hover > a.headerlink, +h3:hover > a.headerlink, +h4:hover > a.headerlink, +h5:hover > a.headerlink, +h6:hover > a.headerlink, +dt:hover > a.headerlink, +caption:hover > a.headerlink, +p.caption:hover > a.headerlink, +div.code-block-caption:hover > a.headerlink { + visibility: visible; +} + +div.body p.caption { + text-align: inherit; +} + +div.body td { + text-align: left; +} + +.first { + margin-top: 0 !important; +} + +p.rubric { + margin-top: 30px; + font-weight: bold; +} + +img.align-left, .figure.align-left, object.align-left { + clear: left; + float: left; + margin-right: 1em; +} + +img.align-right, .figure.align-right, object.align-right { + clear: right; + float: right; + margin-left: 1em; +} + +img.align-center, .figure.align-center, object.align-center { + display: block; + margin-left: auto; + margin-right: auto; +} + +img.align-default, .figure.align-default { + display: block; + margin-left: auto; + margin-right: auto; +} + +.align-left { + text-align: left; +} + +.align-center { + text-align: center; +} + +.align-default { + text-align: center; +} + +.align-right { + text-align: right; +} + +/* -- sidebars -------------------------------------------------------------- */ + +div.sidebar { + margin: 0 0 0.5em 1em; + border: 1px solid #ddb; + padding: 7px; + background-color: #ffe; + width: 40%; + float: right; + clear: right; + overflow-x: auto; +} + +p.sidebar-title { + font-weight: bold; +} + +div.admonition, div.topic, blockquote { + clear: left; +} + +/* -- topics ---------------------------------------------------------------- */ + +div.topic { + border: 1px solid #ccc; + padding: 7px; + margin: 10px 0 10px 0; +} + +p.topic-title { + font-size: 1.1em; + font-weight: bold; + margin-top: 10px; +} + +/* -- admonitions ----------------------------------------------------------- */ + +div.admonition { + margin-top: 10px; + margin-bottom: 10px; + padding: 7px; +} + +div.admonition dt { + font-weight: bold; +} + +p.admonition-title { + margin: 0px 10px 5px 0px; + font-weight: bold; +} + +div.body p.centered { + text-align: center; + margin-top: 25px; +} + +/* -- content of sidebars/topics/admonitions -------------------------------- */ + +div.sidebar > :last-child, +div.topic > :last-child, +div.admonition > :last-child { + margin-bottom: 0; +} + +div.sidebar::after, +div.topic::after, +div.admonition::after, +blockquote::after { + display: block; + content: ''; + clear: both; +} + +/* -- tables ---------------------------------------------------------------- */ + +table.docutils { + margin-top: 10px; + margin-bottom: 10px; + border: 0; + border-collapse: collapse; +} + +table.align-center { + margin-left: auto; + margin-right: auto; +} + +table.align-default { + margin-left: auto; + margin-right: auto; +} + +table caption span.caption-number { + font-style: italic; +} + +table caption span.caption-text { +} + +table.docutils td, table.docutils th { + padding: 1px 8px 1px 5px; + border-top: 0; + border-left: 0; + border-right: 0; + border-bottom: 1px solid #aaa; +} + +table.footnote td, table.footnote th { + border: 0 !important; +} + +th { + text-align: left; + padding-right: 5px; +} + +table.citation { + border-left: solid 1px gray; + margin-left: 1px; +} + +table.citation td { + border-bottom: none; +} + +th > :first-child, +td > :first-child { + margin-top: 0px; +} + +th > :last-child, +td > :last-child { + margin-bottom: 0px; +} + +/* -- figures --------------------------------------------------------------- */ + +div.figure { + margin: 0.5em; + padding: 0.5em; +} + +div.figure p.caption { + padding: 0.3em; +} + +div.figure p.caption span.caption-number { + font-style: italic; +} + +div.figure p.caption span.caption-text { +} + +/* -- field list styles ----------------------------------------------------- */ + +table.field-list td, table.field-list th { + border: 0 !important; +} + +.field-list ul { + margin: 0; + padding-left: 1em; +} + +.field-list p { + margin: 0; +} + +.field-name { + -moz-hyphens: manual; + -ms-hyphens: manual; + -webkit-hyphens: manual; + hyphens: manual; +} + +/* -- hlist styles ---------------------------------------------------------- */ + +table.hlist { + margin: 1em 0; +} + +table.hlist td { + vertical-align: top; +} + + +/* -- other body styles ----------------------------------------------------- */ + +ol.arabic { + list-style: decimal; +} + +ol.loweralpha { + list-style: lower-alpha; +} + +ol.upperalpha { + list-style: upper-alpha; +} + +ol.lowerroman { + list-style: lower-roman; +} + +ol.upperroman { + list-style: upper-roman; +} + +:not(li) > ol > li:first-child > :first-child, +:not(li) > ul > li:first-child > :first-child { + margin-top: 0px; +} + +:not(li) > ol > li:last-child > :last-child, +:not(li) > ul > li:last-child > :last-child { + margin-bottom: 0px; +} + +ol.simple ol p, +ol.simple ul p, +ul.simple ol p, +ul.simple ul p { + margin-top: 0; +} + +ol.simple > li:not(:first-child) > p, +ul.simple > li:not(:first-child) > p { + margin-top: 0; +} + +ol.simple p, +ul.simple p { + margin-bottom: 0; +} + +dl.footnote > dt, +dl.citation > dt { + float: left; + margin-right: 0.5em; +} + +dl.footnote > dd, +dl.citation > dd { + margin-bottom: 0em; +} + +dl.footnote > dd:after, +dl.citation > dd:after { + content: ""; + clear: both; +} + +dl.field-list { + display: grid; + grid-template-columns: fit-content(30%) auto; +} + +dl.field-list > dt { + font-weight: bold; + word-break: break-word; + padding-left: 0.5em; + padding-right: 5px; +} + +dl.field-list > dt:after { + content: ":"; +} + +dl.field-list > dd { + padding-left: 0.5em; + margin-top: 0em; + margin-left: 0em; + margin-bottom: 0em; +} + +dl { + margin-bottom: 15px; +} + +dd > :first-child { + margin-top: 0px; +} + +dd ul, dd table { + margin-bottom: 10px; +} + +dd { + margin-top: 3px; + margin-bottom: 10px; + margin-left: 30px; +} + +dl > dd:last-child, +dl > dd:last-child > :last-child { + margin-bottom: 0; +} + +dt:target, span.highlighted { + background-color: #fbe54e; +} + +rect.highlighted { + fill: #fbe54e; +} + +dl.glossary dt { + font-weight: bold; + font-size: 1.1em; +} + +.optional { + font-size: 1.3em; +} + +.sig-paren { + font-size: larger; +} + +.versionmodified { + font-style: italic; +} + +.system-message { + background-color: #fda; + padding: 5px; + border: 3px solid red; +} + +.footnote:target { + background-color: #ffa; +} + +.line-block { + display: block; + margin-top: 1em; + margin-bottom: 1em; +} + +.line-block .line-block { + margin-top: 0; + margin-bottom: 0; + margin-left: 1.5em; +} + +.guilabel, .menuselection { + font-family: sans-serif; +} + +.accelerator { + text-decoration: underline; +} + +.classifier { + font-style: oblique; +} + +.classifier:before { + font-style: normal; + margin: 0.5em; + content: ":"; +} + +abbr, acronym { + border-bottom: dotted 1px; + cursor: help; +} + +/* -- code displays --------------------------------------------------------- */ + +pre { + overflow: auto; + overflow-y: hidden; /* fixes display issues on Chrome browsers */ +} + +pre, div[class*="highlight-"] { + clear: both; +} + +span.pre { + -moz-hyphens: none; + -ms-hyphens: none; + -webkit-hyphens: none; + hyphens: none; +} + +div[class*="highlight-"] { + margin: 1em 0; +} + +td.linenos pre { + border: 0; + background-color: transparent; + color: #aaa; +} + +table.highlighttable { + display: block; +} + +table.highlighttable tbody { + display: block; +} + +table.highlighttable tr { + display: flex; +} + +table.highlighttable td { + margin: 0; + padding: 0; +} + +table.highlighttable td.linenos { + padding-right: 0.5em; +} + +table.highlighttable td.code { + flex: 1; + overflow: hidden; +} + +.highlight .hll { + display: block; +} + +div.highlight pre, +table.highlighttable pre { + margin: 0; +} + +div.code-block-caption + div { + margin-top: 0; +} + +div.code-block-caption { + margin-top: 1em; + padding: 2px 5px; + font-size: small; +} + +div.code-block-caption code { + background-color: transparent; +} + +table.highlighttable td.linenos, +span.linenos, +div.doctest > div.highlight span.gp { /* gp: Generic.Prompt */ + user-select: none; +} + +div.code-block-caption span.caption-number { + padding: 0.1em 0.3em; + font-style: italic; +} + +div.code-block-caption span.caption-text { +} + +div.literal-block-wrapper { + margin: 1em 0; +} + +code.descname { + background-color: transparent; + font-weight: bold; + font-size: 1.2em; +} + +code.descclassname { + background-color: transparent; +} + +code.xref, a code { + background-color: transparent; + font-weight: bold; +} + +h1 code, h2 code, h3 code, h4 code, h5 code, h6 code { + background-color: transparent; +} + +.viewcode-link { + float: right; +} + +.viewcode-back { + float: right; + font-family: sans-serif; +} + +div.viewcode-block:target { + margin: -1px -10px; + padding: 0 10px; +} + +/* -- math display ---------------------------------------------------------- */ + +img.math { + vertical-align: middle; +} + +div.body div.math p { + text-align: center; +} + +span.eqno { + float: right; +} + +span.eqno a.headerlink { + position: absolute; + z-index: 1; +} + +div.math:hover a.headerlink { + visibility: visible; +} + +/* -- printout stylesheet --------------------------------------------------- */ + +@media print { + div.document, + div.documentwrapper, + div.bodywrapper { + margin: 0 !important; + width: 100%; + } + + div.sphinxsidebar, + div.related, + div.footer, + #top-link { + display: none; + } +} \ No newline at end of file diff --git a/Wiki/ENG_Guide/html/_static/doctools.js b/Wiki/ENG_Guide/html/_static/doctools.js new file mode 100644 index 00000000..7d88f807 --- /dev/null +++ b/Wiki/ENG_Guide/html/_static/doctools.js @@ -0,0 +1,316 @@ +/* + * doctools.js + * ~~~~~~~~~~~ + * + * Sphinx JavaScript utilities for all documentation. + * + * :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/** + * select a different prefix for underscore + */ +$u = _.noConflict(); + +/** + * make the code below compatible with browsers without + * an installed firebug like debugger +if (!window.console || !console.firebug) { + var names = ["log", "debug", "info", "warn", "error", "assert", "dir", + "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace", + "profile", "profileEnd"]; + window.console = {}; + for (var i = 0; i < names.length; ++i) + window.console[names[i]] = function() {}; +} + */ + +/** + * small helper function to urldecode strings + */ +jQuery.urldecode = function(x) { + return decodeURIComponent(x).replace(/\+/g, ' '); +}; + +/** + * small helper function to urlencode strings + */ +jQuery.urlencode = encodeURIComponent; + +/** + * This function returns the parsed url parameters of the + * current request. Multiple values per key are supported, + * it will always return arrays of strings for the value parts. + */ +jQuery.getQueryParameters = function(s) { + if (typeof s === 'undefined') + s = document.location.search; + var parts = s.substr(s.indexOf('?') + 1).split('&'); + var result = {}; + for (var i = 0; i < parts.length; i++) { + var tmp = parts[i].split('=', 2); + var key = jQuery.urldecode(tmp[0]); + var value = jQuery.urldecode(tmp[1]); + if (key in result) + result[key].push(value); + else + result[key] = [value]; + } + return result; +}; + +/** + * highlight a given string on a jquery object by wrapping it in + * span elements with the given class name. + */ +jQuery.fn.highlightText = function(text, className) { + function highlight(node, addItems) { + if (node.nodeType === 3) { + var val = node.nodeValue; + var pos = val.toLowerCase().indexOf(text); + if (pos >= 0 && + !jQuery(node.parentNode).hasClass(className) && + !jQuery(node.parentNode).hasClass("nohighlight")) { + var span; + var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg"); + if (isInSVG) { + span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); + } else { + span = document.createElement("span"); + span.className = className; + } + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + node.parentNode.insertBefore(span, node.parentNode.insertBefore( + document.createTextNode(val.substr(pos + text.length)), + node.nextSibling)); + node.nodeValue = val.substr(0, pos); + if (isInSVG) { + var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect"); + var bbox = node.parentElement.getBBox(); + rect.x.baseVal.value = bbox.x; + rect.y.baseVal.value = bbox.y; + rect.width.baseVal.value = bbox.width; + rect.height.baseVal.value = bbox.height; + rect.setAttribute('class', className); + addItems.push({ + "parent": node.parentNode, + "target": rect}); + } + } + } + else if (!jQuery(node).is("button, select, textarea")) { + jQuery.each(node.childNodes, function() { + highlight(this, addItems); + }); + } + } + var addItems = []; + var result = this.each(function() { + highlight(this, addItems); + }); + for (var i = 0; i < addItems.length; ++i) { + jQuery(addItems[i].parent).before(addItems[i].target); + } + return result; +}; + +/* + * backward compatibility for jQuery.browser + * This will be supported until firefox bug is fixed. + */ +if (!jQuery.browser) { + jQuery.uaMatch = function(ua) { + ua = ua.toLowerCase(); + + var match = /(chrome)[ \/]([\w.]+)/.exec(ua) || + /(webkit)[ \/]([\w.]+)/.exec(ua) || + /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) || + /(msie) ([\w.]+)/.exec(ua) || + ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) || + []; + + return { + browser: match[ 1 ] || "", + version: match[ 2 ] || "0" + }; + }; + jQuery.browser = {}; + jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true; +} + +/** + * Small JavaScript module for the documentation. + */ +var Documentation = { + + init : function() { + this.fixFirefoxAnchorBug(); + this.highlightSearchWords(); + this.initIndexTable(); + if (DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) { + this.initOnKeyListeners(); + } + }, + + /** + * i18n support + */ + TRANSLATIONS : {}, + PLURAL_EXPR : function(n) { return n === 1 ? 0 : 1; }, + LOCALE : 'unknown', + + // gettext and ngettext don't access this so that the functions + // can safely bound to a different name (_ = Documentation.gettext) + gettext : function(string) { + var translated = Documentation.TRANSLATIONS[string]; + if (typeof translated === 'undefined') + return string; + return (typeof translated === 'string') ? translated : translated[0]; + }, + + ngettext : function(singular, plural, n) { + var translated = Documentation.TRANSLATIONS[singular]; + if (typeof translated === 'undefined') + return (n == 1) ? singular : plural; + return translated[Documentation.PLURALEXPR(n)]; + }, + + addTranslations : function(catalog) { + for (var key in catalog.messages) + this.TRANSLATIONS[key] = catalog.messages[key]; + this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); + this.LOCALE = catalog.locale; + }, + + /** + * add context elements like header anchor links + */ + addContextElements : function() { + $('div[id] > :header:first').each(function() { + $('\u00B6'). + attr('href', '#' + this.id). + attr('title', _('Permalink to this headline')). + appendTo(this); + }); + $('dt[id]').each(function() { + $('\u00B6'). + attr('href', '#' + this.id). + attr('title', _('Permalink to this definition')). + appendTo(this); + }); + }, + + /** + * workaround a firefox stupidity + * see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075 + */ + fixFirefoxAnchorBug : function() { + if (document.location.hash && $.browser.mozilla) + window.setTimeout(function() { + document.location.href += ''; + }, 10); + }, + + /** + * highlight the search words provided in the url in the text + */ + highlightSearchWords : function() { + var params = $.getQueryParameters(); + var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; + if (terms.length) { + var body = $('div.body'); + if (!body.length) { + body = $('body'); + } + window.setTimeout(function() { + $.each(terms, function() { + body.highlightText(this.toLowerCase(), 'highlighted'); + }); + }, 10); + $('

    ' + _('Hide Search Matches') + '

    ') + .appendTo($('#searchbox')); + } + }, + + /** + * init the domain index toggle buttons + */ + initIndexTable : function() { + var togglers = $('img.toggler').click(function() { + var src = $(this).attr('src'); + var idnum = $(this).attr('id').substr(7); + $('tr.cg-' + idnum).toggle(); + if (src.substr(-9) === 'minus.png') + $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); + else + $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); + }).css('display', ''); + if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) { + togglers.click(); + } + }, + + /** + * helper function to hide the search marks again + */ + hideSearchWords : function() { + $('#searchbox .highlight-link').fadeOut(300); + $('span.highlighted').removeClass('highlighted'); + }, + + /** + * make the url absolute + */ + makeURL : function(relativeURL) { + return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; + }, + + /** + * get the current relative url + */ + getCurrentURL : function() { + var path = document.location.pathname; + var parts = path.split(/\//); + $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { + if (this === '..') + parts.pop(); + }); + var url = parts.join('/'); + return path.substring(url.lastIndexOf('/') + 1, path.length - 1); + }, + + initOnKeyListeners: function() { + $(document).keydown(function(event) { + var activeElementType = document.activeElement.tagName; + // don't navigate when in search box, textarea, dropdown or button + if (activeElementType !== 'TEXTAREA' && activeElementType !== 'INPUT' && activeElementType !== 'SELECT' + && activeElementType !== 'BUTTON' && !event.altKey && !event.ctrlKey && !event.metaKey + && !event.shiftKey) { + switch (event.keyCode) { + case 37: // left + var prevHref = $('link[rel="prev"]').prop('href'); + if (prevHref) { + window.location.href = prevHref; + return false; + } + case 39: // right + var nextHref = $('link[rel="next"]').prop('href'); + if (nextHref) { + window.location.href = nextHref; + return false; + } + } + } + }); + } +}; + +// quick alias for translations +_ = Documentation.gettext; + +$(document).ready(function() { + Documentation.init(); +}); diff --git a/Wiki/ENG_Guide/html/_static/documentation_options.js b/Wiki/ENG_Guide/html/_static/documentation_options.js new file mode 100644 index 00000000..8e57d2b1 --- /dev/null +++ b/Wiki/ENG_Guide/html/_static/documentation_options.js @@ -0,0 +1,12 @@ +var DOCUMENTATION_OPTIONS = { + URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), + VERSION: 'v1.2.0', + LANGUAGE: 'None', + COLLAPSE_INDEX: false, + BUILDER: 'html', + FILE_SUFFIX: '.html', + LINK_SUFFIX: '.html', + HAS_SOURCE: true, + SOURCELINK_SUFFIX: '.txt', + NAVIGATION_WITH_KEYS: false +}; \ No newline at end of file diff --git a/Wiki/ENG_Guide/html/_static/file.png b/Wiki/ENG_Guide/html/_static/file.png new file mode 100644 index 0000000000000000000000000000000000000000..a858a410e4faa62ce324d814e4b816fff83a6fb3 GIT binary patch literal 286 zcmV+(0pb3MP)s`hMrGg#P~ix$^RISR_I47Y|r1 z_CyJOe}D1){SET-^Amu_i71Lt6eYfZjRyw@I6OQAIXXHDfiX^GbOlHe=Ae4>0m)d(f|Me07*qoM6N<$f}vM^LjV8( literal 0 HcmV?d00001 diff --git a/Wiki/ENG_Guide/html/_static/jquery-3.5.1.js b/Wiki/ENG_Guide/html/_static/jquery-3.5.1.js new file mode 100644 index 00000000..50937333 --- /dev/null +++ b/Wiki/ENG_Guide/html/_static/jquery-3.5.1.js @@ -0,0 +1,10872 @@ +/*! + * jQuery JavaScript Library v3.5.1 + * https://jquery.com/ + * + * Includes Sizzle.js + * https://sizzlejs.com/ + * + * Copyright JS Foundation and other contributors + * Released under the MIT license + * https://jquery.org/license + * + * Date: 2020-05-04T22:49Z + */ +( function( global, factory ) { + + "use strict"; + + if ( typeof module === "object" && typeof module.exports === "object" ) { + + // For CommonJS and CommonJS-like environments where a proper `window` + // is present, execute the factory and get jQuery. + // For environments that do not have a `window` with a `document` + // (such as Node.js), expose a factory as module.exports. + // This accentuates the need for the creation of a real `window`. + // e.g. var jQuery = require("jquery")(window); + // See ticket #14549 for more info. + module.exports = global.document ? + factory( global, true ) : + function( w ) { + if ( !w.document ) { + throw new Error( "jQuery requires a window with a document" ); + } + return factory( w ); + }; + } else { + factory( global ); + } + +// Pass this if window is not defined yet +} )( typeof window !== "undefined" ? window : this, function( window, noGlobal ) { + +// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1 +// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode +// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common +// enough that all such attempts are guarded in a try block. +"use strict"; + +var arr = []; + +var getProto = Object.getPrototypeOf; + +var slice = arr.slice; + +var flat = arr.flat ? function( array ) { + return arr.flat.call( array ); +} : function( array ) { + return arr.concat.apply( [], array ); +}; + + +var push = arr.push; + +var indexOf = arr.indexOf; + +var class2type = {}; + +var toString = class2type.toString; + +var hasOwn = class2type.hasOwnProperty; + +var fnToString = hasOwn.toString; + +var ObjectFunctionString = fnToString.call( Object ); + +var support = {}; + +var isFunction = function isFunction( obj ) { + + // Support: Chrome <=57, Firefox <=52 + // In some browsers, typeof returns "function" for HTML elements + // (i.e., `typeof document.createElement( "object" ) === "function"`). + // We don't want to classify *any* DOM node as a function. + return typeof obj === "function" && typeof obj.nodeType !== "number"; + }; + + +var isWindow = function isWindow( obj ) { + return obj != null && obj === obj.window; + }; + + +var document = window.document; + + + + var preservedScriptAttributes = { + type: true, + src: true, + nonce: true, + noModule: true + }; + + function DOMEval( code, node, doc ) { + doc = doc || document; + + var i, val, + script = doc.createElement( "script" ); + + script.text = code; + if ( node ) { + for ( i in preservedScriptAttributes ) { + + // Support: Firefox 64+, Edge 18+ + // Some browsers don't support the "nonce" property on scripts. + // On the other hand, just using `getAttribute` is not enough as + // the `nonce` attribute is reset to an empty string whenever it + // becomes browsing-context connected. + // See https://github.com/whatwg/html/issues/2369 + // See https://html.spec.whatwg.org/#nonce-attributes + // The `node.getAttribute` check was added for the sake of + // `jQuery.globalEval` so that it can fake a nonce-containing node + // via an object. + val = node[ i ] || node.getAttribute && node.getAttribute( i ); + if ( val ) { + script.setAttribute( i, val ); + } + } + } + doc.head.appendChild( script ).parentNode.removeChild( script ); + } + + +function toType( obj ) { + if ( obj == null ) { + return obj + ""; + } + + // Support: Android <=2.3 only (functionish RegExp) + return typeof obj === "object" || typeof obj === "function" ? + class2type[ toString.call( obj ) ] || "object" : + typeof obj; +} +/* global Symbol */ +// Defining this global in .eslintrc.json would create a danger of using the global +// unguarded in another place, it seems safer to define global only for this module + + + +var + version = "3.5.1", + + // Define a local copy of jQuery + jQuery = function( selector, context ) { + + // The jQuery object is actually just the init constructor 'enhanced' + // Need init if jQuery is called (just allow error to be thrown if not included) + return new jQuery.fn.init( selector, context ); + }; + +jQuery.fn = jQuery.prototype = { + + // The current version of jQuery being used + jquery: version, + + constructor: jQuery, + + // The default length of a jQuery object is 0 + length: 0, + + toArray: function() { + return slice.call( this ); + }, + + // Get the Nth element in the matched element set OR + // Get the whole matched element set as a clean array + get: function( num ) { + + // Return all the elements in a clean array + if ( num == null ) { + return slice.call( this ); + } + + // Return just the one element from the set + return num < 0 ? this[ num + this.length ] : this[ num ]; + }, + + // Take an array of elements and push it onto the stack + // (returning the new matched element set) + pushStack: function( elems ) { + + // Build a new jQuery matched element set + var ret = jQuery.merge( this.constructor(), elems ); + + // Add the old object onto the stack (as a reference) + ret.prevObject = this; + + // Return the newly-formed element set + return ret; + }, + + // Execute a callback for every element in the matched set. + each: function( callback ) { + return jQuery.each( this, callback ); + }, + + map: function( callback ) { + return this.pushStack( jQuery.map( this, function( elem, i ) { + return callback.call( elem, i, elem ); + } ) ); + }, + + slice: function() { + return this.pushStack( slice.apply( this, arguments ) ); + }, + + first: function() { + return this.eq( 0 ); + }, + + last: function() { + return this.eq( -1 ); + }, + + even: function() { + return this.pushStack( jQuery.grep( this, function( _elem, i ) { + return ( i + 1 ) % 2; + } ) ); + }, + + odd: function() { + return this.pushStack( jQuery.grep( this, function( _elem, i ) { + return i % 2; + } ) ); + }, + + eq: function( i ) { + var len = this.length, + j = +i + ( i < 0 ? len : 0 ); + return this.pushStack( j >= 0 && j < len ? [ this[ j ] ] : [] ); + }, + + end: function() { + return this.prevObject || this.constructor(); + }, + + // For internal use only. + // Behaves like an Array's method, not like a jQuery method. + push: push, + sort: arr.sort, + splice: arr.splice +}; + +jQuery.extend = jQuery.fn.extend = function() { + var options, name, src, copy, copyIsArray, clone, + target = arguments[ 0 ] || {}, + i = 1, + length = arguments.length, + deep = false; + + // Handle a deep copy situation + if ( typeof target === "boolean" ) { + deep = target; + + // Skip the boolean and the target + target = arguments[ i ] || {}; + i++; + } + + // Handle case when target is a string or something (possible in deep copy) + if ( typeof target !== "object" && !isFunction( target ) ) { + target = {}; + } + + // Extend jQuery itself if only one argument is passed + if ( i === length ) { + target = this; + i--; + } + + for ( ; i < length; i++ ) { + + // Only deal with non-null/undefined values + if ( ( options = arguments[ i ] ) != null ) { + + // Extend the base object + for ( name in options ) { + copy = options[ name ]; + + // Prevent Object.prototype pollution + // Prevent never-ending loop + if ( name === "__proto__" || target === copy ) { + continue; + } + + // Recurse if we're merging plain objects or arrays + if ( deep && copy && ( jQuery.isPlainObject( copy ) || + ( copyIsArray = Array.isArray( copy ) ) ) ) { + src = target[ name ]; + + // Ensure proper type for the source value + if ( copyIsArray && !Array.isArray( src ) ) { + clone = []; + } else if ( !copyIsArray && !jQuery.isPlainObject( src ) ) { + clone = {}; + } else { + clone = src; + } + copyIsArray = false; + + // Never move original objects, clone them + target[ name ] = jQuery.extend( deep, clone, copy ); + + // Don't bring in undefined values + } else if ( copy !== undefined ) { + target[ name ] = copy; + } + } + } + } + + // Return the modified object + return target; +}; + +jQuery.extend( { + + // Unique for each copy of jQuery on the page + expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ), + + // Assume jQuery is ready without the ready module + isReady: true, + + error: function( msg ) { + throw new Error( msg ); + }, + + noop: function() {}, + + isPlainObject: function( obj ) { + var proto, Ctor; + + // Detect obvious negatives + // Use toString instead of jQuery.type to catch host objects + if ( !obj || toString.call( obj ) !== "[object Object]" ) { + return false; + } + + proto = getProto( obj ); + + // Objects with no prototype (e.g., `Object.create( null )`) are plain + if ( !proto ) { + return true; + } + + // Objects with prototype are plain iff they were constructed by a global Object function + Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor; + return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString; + }, + + isEmptyObject: function( obj ) { + var name; + + for ( name in obj ) { + return false; + } + return true; + }, + + // Evaluates a script in a provided context; falls back to the global one + // if not specified. + globalEval: function( code, options, doc ) { + DOMEval( code, { nonce: options && options.nonce }, doc ); + }, + + each: function( obj, callback ) { + var length, i = 0; + + if ( isArrayLike( obj ) ) { + length = obj.length; + for ( ; i < length; i++ ) { + if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { + break; + } + } + } else { + for ( i in obj ) { + if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { + break; + } + } + } + + return obj; + }, + + // results is for internal usage only + makeArray: function( arr, results ) { + var ret = results || []; + + if ( arr != null ) { + if ( isArrayLike( Object( arr ) ) ) { + jQuery.merge( ret, + typeof arr === "string" ? + [ arr ] : arr + ); + } else { + push.call( ret, arr ); + } + } + + return ret; + }, + + inArray: function( elem, arr, i ) { + return arr == null ? -1 : indexOf.call( arr, elem, i ); + }, + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + merge: function( first, second ) { + var len = +second.length, + j = 0, + i = first.length; + + for ( ; j < len; j++ ) { + first[ i++ ] = second[ j ]; + } + + first.length = i; + + return first; + }, + + grep: function( elems, callback, invert ) { + var callbackInverse, + matches = [], + i = 0, + length = elems.length, + callbackExpect = !invert; + + // Go through the array, only saving the items + // that pass the validator function + for ( ; i < length; i++ ) { + callbackInverse = !callback( elems[ i ], i ); + if ( callbackInverse !== callbackExpect ) { + matches.push( elems[ i ] ); + } + } + + return matches; + }, + + // arg is for internal usage only + map: function( elems, callback, arg ) { + var length, value, + i = 0, + ret = []; + + // Go through the array, translating each of the items to their new values + if ( isArrayLike( elems ) ) { + length = elems.length; + for ( ; i < length; i++ ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret.push( value ); + } + } + + // Go through every key on the object, + } else { + for ( i in elems ) { + value = callback( elems[ i ], i, arg ); + + if ( value != null ) { + ret.push( value ); + } + } + } + + // Flatten any nested arrays + return flat( ret ); + }, + + // A global GUID counter for objects + guid: 1, + + // jQuery.support is not used in Core but other projects attach their + // properties to it so it needs to exist. + support: support +} ); + +if ( typeof Symbol === "function" ) { + jQuery.fn[ Symbol.iterator ] = arr[ Symbol.iterator ]; +} + +// Populate the class2type map +jQuery.each( "Boolean Number String Function Array Date RegExp Object Error Symbol".split( " " ), +function( _i, name ) { + class2type[ "[object " + name + "]" ] = name.toLowerCase(); +} ); + +function isArrayLike( obj ) { + + // Support: real iOS 8.2 only (not reproducible in simulator) + // `in` check used to prevent JIT error (gh-2145) + // hasOwn isn't used here due to false negatives + // regarding Nodelist length in IE + var length = !!obj && "length" in obj && obj.length, + type = toType( obj ); + + if ( isFunction( obj ) || isWindow( obj ) ) { + return false; + } + + return type === "array" || length === 0 || + typeof length === "number" && length > 0 && ( length - 1 ) in obj; +} +var Sizzle = +/*! + * Sizzle CSS Selector Engine v2.3.5 + * https://sizzlejs.com/ + * + * Copyright JS Foundation and other contributors + * Released under the MIT license + * https://js.foundation/ + * + * Date: 2020-03-14 + */ +( function( window ) { +var i, + support, + Expr, + getText, + isXML, + tokenize, + compile, + select, + outermostContext, + sortInput, + hasDuplicate, + + // Local document vars + setDocument, + document, + docElem, + documentIsHTML, + rbuggyQSA, + rbuggyMatches, + matches, + contains, + + // Instance-specific data + expando = "sizzle" + 1 * new Date(), + preferredDoc = window.document, + dirruns = 0, + done = 0, + classCache = createCache(), + tokenCache = createCache(), + compilerCache = createCache(), + nonnativeSelectorCache = createCache(), + sortOrder = function( a, b ) { + if ( a === b ) { + hasDuplicate = true; + } + return 0; + }, + + // Instance methods + hasOwn = ( {} ).hasOwnProperty, + arr = [], + pop = arr.pop, + pushNative = arr.push, + push = arr.push, + slice = arr.slice, + + // Use a stripped-down indexOf as it's faster than native + // https://jsperf.com/thor-indexof-vs-for/5 + indexOf = function( list, elem ) { + var i = 0, + len = list.length; + for ( ; i < len; i++ ) { + if ( list[ i ] === elem ) { + return i; + } + } + return -1; + }, + + booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|" + + "ismap|loop|multiple|open|readonly|required|scoped", + + // Regular expressions + + // http://www.w3.org/TR/css3-selectors/#whitespace + whitespace = "[\\x20\\t\\r\\n\\f]", + + // https://www.w3.org/TR/css-syntax-3/#ident-token-diagram + identifier = "(?:\\\\[\\da-fA-F]{1,6}" + whitespace + + "?|\\\\[^\\r\\n\\f]|[\\w-]|[^\0-\\x7f])+", + + // Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors + attributes = "\\[" + whitespace + "*(" + identifier + ")(?:" + whitespace + + + // Operator (capture 2) + "*([*^$|!~]?=)" + whitespace + + + // "Attribute values must be CSS identifiers [capture 5] + // or strings [capture 3 or capture 4]" + "*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|(" + identifier + "))|)" + + whitespace + "*\\]", + + pseudos = ":(" + identifier + ")(?:\\((" + + + // To reduce the number of selectors needing tokenize in the preFilter, prefer arguments: + // 1. quoted (capture 3; capture 4 or capture 5) + "('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|" + + + // 2. simple (capture 6) + "((?:\\\\.|[^\\\\()[\\]]|" + attributes + ")*)|" + + + // 3. anything else (capture 2) + ".*" + + ")\\)|)", + + // Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter + rwhitespace = new RegExp( whitespace + "+", "g" ), + rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + + whitespace + "+$", "g" ), + + rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ), + rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace + + "*" ), + rdescend = new RegExp( whitespace + "|>" ), + + rpseudo = new RegExp( pseudos ), + ridentifier = new RegExp( "^" + identifier + "$" ), + + matchExpr = { + "ID": new RegExp( "^#(" + identifier + ")" ), + "CLASS": new RegExp( "^\\.(" + identifier + ")" ), + "TAG": new RegExp( "^(" + identifier + "|[*])" ), + "ATTR": new RegExp( "^" + attributes ), + "PSEUDO": new RegExp( "^" + pseudos ), + "CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" + + whitespace + "*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + + whitespace + "*(\\d+)|))" + whitespace + "*\\)|)", "i" ), + "bool": new RegExp( "^(?:" + booleans + ")$", "i" ), + + // For use in libraries implementing .is() + // We use this for POS matching in `select` + "needsContext": new RegExp( "^" + whitespace + + "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" + whitespace + + "*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" ) + }, + + rhtml = /HTML$/i, + rinputs = /^(?:input|select|textarea|button)$/i, + rheader = /^h\d$/i, + + rnative = /^[^{]+\{\s*\[native \w/, + + // Easily-parseable/retrievable ID or TAG or CLASS selectors + rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/, + + rsibling = /[+~]/, + + // CSS escapes + // http://www.w3.org/TR/CSS21/syndata.html#escaped-characters + runescape = new RegExp( "\\\\[\\da-fA-F]{1,6}" + whitespace + "?|\\\\([^\\r\\n\\f])", "g" ), + funescape = function( escape, nonHex ) { + var high = "0x" + escape.slice( 1 ) - 0x10000; + + return nonHex ? + + // Strip the backslash prefix from a non-hex escape sequence + nonHex : + + // Replace a hexadecimal escape sequence with the encoded Unicode code point + // Support: IE <=11+ + // For values outside the Basic Multilingual Plane (BMP), manually construct a + // surrogate pair + high < 0 ? + String.fromCharCode( high + 0x10000 ) : + String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 ); + }, + + // CSS string/identifier serialization + // https://drafts.csswg.org/cssom/#common-serializing-idioms + rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g, + fcssescape = function( ch, asCodePoint ) { + if ( asCodePoint ) { + + // U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER + if ( ch === "\0" ) { + return "\uFFFD"; + } + + // Control characters and (dependent upon position) numbers get escaped as code points + return ch.slice( 0, -1 ) + "\\" + + ch.charCodeAt( ch.length - 1 ).toString( 16 ) + " "; + } + + // Other potentially-special ASCII characters get backslash-escaped + return "\\" + ch; + }, + + // Used for iframes + // See setDocument() + // Removing the function wrapper causes a "Permission Denied" + // error in IE + unloadHandler = function() { + setDocument(); + }, + + inDisabledFieldset = addCombinator( + function( elem ) { + return elem.disabled === true && elem.nodeName.toLowerCase() === "fieldset"; + }, + { dir: "parentNode", next: "legend" } + ); + +// Optimize for push.apply( _, NodeList ) +try { + push.apply( + ( arr = slice.call( preferredDoc.childNodes ) ), + preferredDoc.childNodes + ); + + // Support: Android<4.0 + // Detect silently failing push.apply + // eslint-disable-next-line no-unused-expressions + arr[ preferredDoc.childNodes.length ].nodeType; +} catch ( e ) { + push = { apply: arr.length ? + + // Leverage slice if possible + function( target, els ) { + pushNative.apply( target, slice.call( els ) ); + } : + + // Support: IE<9 + // Otherwise append directly + function( target, els ) { + var j = target.length, + i = 0; + + // Can't trust NodeList.length + while ( ( target[ j++ ] = els[ i++ ] ) ) {} + target.length = j - 1; + } + }; +} + +function Sizzle( selector, context, results, seed ) { + var m, i, elem, nid, match, groups, newSelector, + newContext = context && context.ownerDocument, + + // nodeType defaults to 9, since context defaults to document + nodeType = context ? context.nodeType : 9; + + results = results || []; + + // Return early from calls with invalid selector or context + if ( typeof selector !== "string" || !selector || + nodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) { + + return results; + } + + // Try to shortcut find operations (as opposed to filters) in HTML documents + if ( !seed ) { + setDocument( context ); + context = context || document; + + if ( documentIsHTML ) { + + // If the selector is sufficiently simple, try using a "get*By*" DOM method + // (excepting DocumentFragment context, where the methods don't exist) + if ( nodeType !== 11 && ( match = rquickExpr.exec( selector ) ) ) { + + // ID selector + if ( ( m = match[ 1 ] ) ) { + + // Document context + if ( nodeType === 9 ) { + if ( ( elem = context.getElementById( m ) ) ) { + + // Support: IE, Opera, Webkit + // TODO: identify versions + // getElementById can match elements by name instead of ID + if ( elem.id === m ) { + results.push( elem ); + return results; + } + } else { + return results; + } + + // Element context + } else { + + // Support: IE, Opera, Webkit + // TODO: identify versions + // getElementById can match elements by name instead of ID + if ( newContext && ( elem = newContext.getElementById( m ) ) && + contains( context, elem ) && + elem.id === m ) { + + results.push( elem ); + return results; + } + } + + // Type selector + } else if ( match[ 2 ] ) { + push.apply( results, context.getElementsByTagName( selector ) ); + return results; + + // Class selector + } else if ( ( m = match[ 3 ] ) && support.getElementsByClassName && + context.getElementsByClassName ) { + + push.apply( results, context.getElementsByClassName( m ) ); + return results; + } + } + + // Take advantage of querySelectorAll + if ( support.qsa && + !nonnativeSelectorCache[ selector + " " ] && + ( !rbuggyQSA || !rbuggyQSA.test( selector ) ) && + + // Support: IE 8 only + // Exclude object elements + ( nodeType !== 1 || context.nodeName.toLowerCase() !== "object" ) ) { + + newSelector = selector; + newContext = context; + + // qSA considers elements outside a scoping root when evaluating child or + // descendant combinators, which is not what we want. + // In such cases, we work around the behavior by prefixing every selector in the + // list with an ID selector referencing the scope context. + // The technique has to be used as well when a leading combinator is used + // as such selectors are not recognized by querySelectorAll. + // Thanks to Andrew Dupont for this technique. + if ( nodeType === 1 && + ( rdescend.test( selector ) || rcombinators.test( selector ) ) ) { + + // Expand context for sibling selectors + newContext = rsibling.test( selector ) && testContext( context.parentNode ) || + context; + + // We can use :scope instead of the ID hack if the browser + // supports it & if we're not changing the context. + if ( newContext !== context || !support.scope ) { + + // Capture the context ID, setting it first if necessary + if ( ( nid = context.getAttribute( "id" ) ) ) { + nid = nid.replace( rcssescape, fcssescape ); + } else { + context.setAttribute( "id", ( nid = expando ) ); + } + } + + // Prefix every selector in the list + groups = tokenize( selector ); + i = groups.length; + while ( i-- ) { + groups[ i ] = ( nid ? "#" + nid : ":scope" ) + " " + + toSelector( groups[ i ] ); + } + newSelector = groups.join( "," ); + } + + try { + push.apply( results, + newContext.querySelectorAll( newSelector ) + ); + return results; + } catch ( qsaError ) { + nonnativeSelectorCache( selector, true ); + } finally { + if ( nid === expando ) { + context.removeAttribute( "id" ); + } + } + } + } + } + + // All others + return select( selector.replace( rtrim, "$1" ), context, results, seed ); +} + +/** + * Create key-value caches of limited size + * @returns {function(string, object)} Returns the Object data after storing it on itself with + * property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength) + * deleting the oldest entry + */ +function createCache() { + var keys = []; + + function cache( key, value ) { + + // Use (key + " ") to avoid collision with native prototype properties (see Issue #157) + if ( keys.push( key + " " ) > Expr.cacheLength ) { + + // Only keep the most recent entries + delete cache[ keys.shift() ]; + } + return ( cache[ key + " " ] = value ); + } + return cache; +} + +/** + * Mark a function for special use by Sizzle + * @param {Function} fn The function to mark + */ +function markFunction( fn ) { + fn[ expando ] = true; + return fn; +} + +/** + * Support testing using an element + * @param {Function} fn Passed the created element and returns a boolean result + */ +function assert( fn ) { + var el = document.createElement( "fieldset" ); + + try { + return !!fn( el ); + } catch ( e ) { + return false; + } finally { + + // Remove from its parent by default + if ( el.parentNode ) { + el.parentNode.removeChild( el ); + } + + // release memory in IE + el = null; + } +} + +/** + * Adds the same handler for all of the specified attrs + * @param {String} attrs Pipe-separated list of attributes + * @param {Function} handler The method that will be applied + */ +function addHandle( attrs, handler ) { + var arr = attrs.split( "|" ), + i = arr.length; + + while ( i-- ) { + Expr.attrHandle[ arr[ i ] ] = handler; + } +} + +/** + * Checks document order of two siblings + * @param {Element} a + * @param {Element} b + * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b + */ +function siblingCheck( a, b ) { + var cur = b && a, + diff = cur && a.nodeType === 1 && b.nodeType === 1 && + a.sourceIndex - b.sourceIndex; + + // Use IE sourceIndex if available on both nodes + if ( diff ) { + return diff; + } + + // Check if b follows a + if ( cur ) { + while ( ( cur = cur.nextSibling ) ) { + if ( cur === b ) { + return -1; + } + } + } + + return a ? 1 : -1; +} + +/** + * Returns a function to use in pseudos for input types + * @param {String} type + */ +function createInputPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for buttons + * @param {String} type + */ +function createButtonPseudo( type ) { + return function( elem ) { + var name = elem.nodeName.toLowerCase(); + return ( name === "input" || name === "button" ) && elem.type === type; + }; +} + +/** + * Returns a function to use in pseudos for :enabled/:disabled + * @param {Boolean} disabled true for :disabled; false for :enabled + */ +function createDisabledPseudo( disabled ) { + + // Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable + return function( elem ) { + + // Only certain elements can match :enabled or :disabled + // https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled + // https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled + if ( "form" in elem ) { + + // Check for inherited disabledness on relevant non-disabled elements: + // * listed form-associated elements in a disabled fieldset + // https://html.spec.whatwg.org/multipage/forms.html#category-listed + // https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled + // * option elements in a disabled optgroup + // https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled + // All such elements have a "form" property. + if ( elem.parentNode && elem.disabled === false ) { + + // Option elements defer to a parent optgroup if present + if ( "label" in elem ) { + if ( "label" in elem.parentNode ) { + return elem.parentNode.disabled === disabled; + } else { + return elem.disabled === disabled; + } + } + + // Support: IE 6 - 11 + // Use the isDisabled shortcut property to check for disabled fieldset ancestors + return elem.isDisabled === disabled || + + // Where there is no isDisabled, check manually + /* jshint -W018 */ + elem.isDisabled !== !disabled && + inDisabledFieldset( elem ) === disabled; + } + + return elem.disabled === disabled; + + // Try to winnow out elements that can't be disabled before trusting the disabled property. + // Some victims get caught in our net (label, legend, menu, track), but it shouldn't + // even exist on them, let alone have a boolean value. + } else if ( "label" in elem ) { + return elem.disabled === disabled; + } + + // Remaining elements are neither :enabled nor :disabled + return false; + }; +} + +/** + * Returns a function to use in pseudos for positionals + * @param {Function} fn + */ +function createPositionalPseudo( fn ) { + return markFunction( function( argument ) { + argument = +argument; + return markFunction( function( seed, matches ) { + var j, + matchIndexes = fn( [], seed.length, argument ), + i = matchIndexes.length; + + // Match elements found at the specified indexes + while ( i-- ) { + if ( seed[ ( j = matchIndexes[ i ] ) ] ) { + seed[ j ] = !( matches[ j ] = seed[ j ] ); + } + } + } ); + } ); +} + +/** + * Checks a node for validity as a Sizzle context + * @param {Element|Object=} context + * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value + */ +function testContext( context ) { + return context && typeof context.getElementsByTagName !== "undefined" && context; +} + +// Expose support vars for convenience +support = Sizzle.support = {}; + +/** + * Detects XML nodes + * @param {Element|Object} elem An element or a document + * @returns {Boolean} True iff elem is a non-HTML XML node + */ +isXML = Sizzle.isXML = function( elem ) { + var namespace = elem.namespaceURI, + docElem = ( elem.ownerDocument || elem ).documentElement; + + // Support: IE <=8 + // Assume HTML when documentElement doesn't yet exist, such as inside loading iframes + // https://bugs.jquery.com/ticket/4833 + return !rhtml.test( namespace || docElem && docElem.nodeName || "HTML" ); +}; + +/** + * Sets document-related variables once based on the current document + * @param {Element|Object} [doc] An element or document object to use to set the document + * @returns {Object} Returns the current document + */ +setDocument = Sizzle.setDocument = function( node ) { + var hasCompare, subWindow, + doc = node ? node.ownerDocument || node : preferredDoc; + + // Return early if doc is invalid or already selected + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( doc == document || doc.nodeType !== 9 || !doc.documentElement ) { + return document; + } + + // Update global variables + document = doc; + docElem = document.documentElement; + documentIsHTML = !isXML( document ); + + // Support: IE 9 - 11+, Edge 12 - 18+ + // Accessing iframe documents after unload throws "permission denied" errors (jQuery #13936) + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( preferredDoc != document && + ( subWindow = document.defaultView ) && subWindow.top !== subWindow ) { + + // Support: IE 11, Edge + if ( subWindow.addEventListener ) { + subWindow.addEventListener( "unload", unloadHandler, false ); + + // Support: IE 9 - 10 only + } else if ( subWindow.attachEvent ) { + subWindow.attachEvent( "onunload", unloadHandler ); + } + } + + // Support: IE 8 - 11+, Edge 12 - 18+, Chrome <=16 - 25 only, Firefox <=3.6 - 31 only, + // Safari 4 - 5 only, Opera <=11.6 - 12.x only + // IE/Edge & older browsers don't support the :scope pseudo-class. + // Support: Safari 6.0 only + // Safari 6.0 supports :scope but it's an alias of :root there. + support.scope = assert( function( el ) { + docElem.appendChild( el ).appendChild( document.createElement( "div" ) ); + return typeof el.querySelectorAll !== "undefined" && + !el.querySelectorAll( ":scope fieldset div" ).length; + } ); + + /* Attributes + ---------------------------------------------------------------------- */ + + // Support: IE<8 + // Verify that getAttribute really returns attributes and not properties + // (excepting IE8 booleans) + support.attributes = assert( function( el ) { + el.className = "i"; + return !el.getAttribute( "className" ); + } ); + + /* getElement(s)By* + ---------------------------------------------------------------------- */ + + // Check if getElementsByTagName("*") returns only elements + support.getElementsByTagName = assert( function( el ) { + el.appendChild( document.createComment( "" ) ); + return !el.getElementsByTagName( "*" ).length; + } ); + + // Support: IE<9 + support.getElementsByClassName = rnative.test( document.getElementsByClassName ); + + // Support: IE<10 + // Check if getElementById returns elements by name + // The broken getElementById methods don't pick up programmatically-set names, + // so use a roundabout getElementsByName test + support.getById = assert( function( el ) { + docElem.appendChild( el ).id = expando; + return !document.getElementsByName || !document.getElementsByName( expando ).length; + } ); + + // ID filter and find + if ( support.getById ) { + Expr.filter[ "ID" ] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + return elem.getAttribute( "id" ) === attrId; + }; + }; + Expr.find[ "ID" ] = function( id, context ) { + if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { + var elem = context.getElementById( id ); + return elem ? [ elem ] : []; + } + }; + } else { + Expr.filter[ "ID" ] = function( id ) { + var attrId = id.replace( runescape, funescape ); + return function( elem ) { + var node = typeof elem.getAttributeNode !== "undefined" && + elem.getAttributeNode( "id" ); + return node && node.value === attrId; + }; + }; + + // Support: IE 6 - 7 only + // getElementById is not reliable as a find shortcut + Expr.find[ "ID" ] = function( id, context ) { + if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { + var node, i, elems, + elem = context.getElementById( id ); + + if ( elem ) { + + // Verify the id attribute + node = elem.getAttributeNode( "id" ); + if ( node && node.value === id ) { + return [ elem ]; + } + + // Fall back on getElementsByName + elems = context.getElementsByName( id ); + i = 0; + while ( ( elem = elems[ i++ ] ) ) { + node = elem.getAttributeNode( "id" ); + if ( node && node.value === id ) { + return [ elem ]; + } + } + } + + return []; + } + }; + } + + // Tag + Expr.find[ "TAG" ] = support.getElementsByTagName ? + function( tag, context ) { + if ( typeof context.getElementsByTagName !== "undefined" ) { + return context.getElementsByTagName( tag ); + + // DocumentFragment nodes don't have gEBTN + } else if ( support.qsa ) { + return context.querySelectorAll( tag ); + } + } : + + function( tag, context ) { + var elem, + tmp = [], + i = 0, + + // By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too + results = context.getElementsByTagName( tag ); + + // Filter out possible comments + if ( tag === "*" ) { + while ( ( elem = results[ i++ ] ) ) { + if ( elem.nodeType === 1 ) { + tmp.push( elem ); + } + } + + return tmp; + } + return results; + }; + + // Class + Expr.find[ "CLASS" ] = support.getElementsByClassName && function( className, context ) { + if ( typeof context.getElementsByClassName !== "undefined" && documentIsHTML ) { + return context.getElementsByClassName( className ); + } + }; + + /* QSA/matchesSelector + ---------------------------------------------------------------------- */ + + // QSA and matchesSelector support + + // matchesSelector(:active) reports false when true (IE9/Opera 11.5) + rbuggyMatches = []; + + // qSa(:focus) reports false when true (Chrome 21) + // We allow this because of a bug in IE8/9 that throws an error + // whenever `document.activeElement` is accessed on an iframe + // So, we allow :focus to pass through QSA all the time to avoid the IE error + // See https://bugs.jquery.com/ticket/13378 + rbuggyQSA = []; + + if ( ( support.qsa = rnative.test( document.querySelectorAll ) ) ) { + + // Build QSA regex + // Regex strategy adopted from Diego Perini + assert( function( el ) { + + var input; + + // Select is set to empty string on purpose + // This is to test IE's treatment of not explicitly + // setting a boolean content attribute, + // since its presence should be enough + // https://bugs.jquery.com/ticket/12359 + docElem.appendChild( el ).innerHTML = "" + + ""; + + // Support: IE8, Opera 11-12.16 + // Nothing should be selected when empty strings follow ^= or $= or *= + // The test attribute must be unknown in Opera but "safe" for WinRT + // https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section + if ( el.querySelectorAll( "[msallowcapture^='']" ).length ) { + rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" ); + } + + // Support: IE8 + // Boolean attributes and "value" are not treated correctly + if ( !el.querySelectorAll( "[selected]" ).length ) { + rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" ); + } + + // Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+ + if ( !el.querySelectorAll( "[id~=" + expando + "-]" ).length ) { + rbuggyQSA.push( "~=" ); + } + + // Support: IE 11+, Edge 15 - 18+ + // IE 11/Edge don't find elements on a `[name='']` query in some cases. + // Adding a temporary attribute to the document before the selection works + // around the issue. + // Interestingly, IE 10 & older don't seem to have the issue. + input = document.createElement( "input" ); + input.setAttribute( "name", "" ); + el.appendChild( input ); + if ( !el.querySelectorAll( "[name='']" ).length ) { + rbuggyQSA.push( "\\[" + whitespace + "*name" + whitespace + "*=" + + whitespace + "*(?:''|\"\")" ); + } + + // Webkit/Opera - :checked should return selected option elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + // IE8 throws error here and will not see later tests + if ( !el.querySelectorAll( ":checked" ).length ) { + rbuggyQSA.push( ":checked" ); + } + + // Support: Safari 8+, iOS 8+ + // https://bugs.webkit.org/show_bug.cgi?id=136851 + // In-page `selector#id sibling-combinator selector` fails + if ( !el.querySelectorAll( "a#" + expando + "+*" ).length ) { + rbuggyQSA.push( ".#.+[+~]" ); + } + + // Support: Firefox <=3.6 - 5 only + // Old Firefox doesn't throw on a badly-escaped identifier. + el.querySelectorAll( "\\\f" ); + rbuggyQSA.push( "[\\r\\n\\f]" ); + } ); + + assert( function( el ) { + el.innerHTML = "" + + ""; + + // Support: Windows 8 Native Apps + // The type and name attributes are restricted during .innerHTML assignment + var input = document.createElement( "input" ); + input.setAttribute( "type", "hidden" ); + el.appendChild( input ).setAttribute( "name", "D" ); + + // Support: IE8 + // Enforce case-sensitivity of name attribute + if ( el.querySelectorAll( "[name=d]" ).length ) { + rbuggyQSA.push( "name" + whitespace + "*[*^$|!~]?=" ); + } + + // FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled) + // IE8 throws error here and will not see later tests + if ( el.querySelectorAll( ":enabled" ).length !== 2 ) { + rbuggyQSA.push( ":enabled", ":disabled" ); + } + + // Support: IE9-11+ + // IE's :disabled selector does not pick up the children of disabled fieldsets + docElem.appendChild( el ).disabled = true; + if ( el.querySelectorAll( ":disabled" ).length !== 2 ) { + rbuggyQSA.push( ":enabled", ":disabled" ); + } + + // Support: Opera 10 - 11 only + // Opera 10-11 does not throw on post-comma invalid pseudos + el.querySelectorAll( "*,:x" ); + rbuggyQSA.push( ",.*:" ); + } ); + } + + if ( ( support.matchesSelector = rnative.test( ( matches = docElem.matches || + docElem.webkitMatchesSelector || + docElem.mozMatchesSelector || + docElem.oMatchesSelector || + docElem.msMatchesSelector ) ) ) ) { + + assert( function( el ) { + + // Check to see if it's possible to do matchesSelector + // on a disconnected node (IE 9) + support.disconnectedMatch = matches.call( el, "*" ); + + // This should fail with an exception + // Gecko does not error, returns false instead + matches.call( el, "[s!='']:x" ); + rbuggyMatches.push( "!=", pseudos ); + } ); + } + + rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join( "|" ) ); + rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join( "|" ) ); + + /* Contains + ---------------------------------------------------------------------- */ + hasCompare = rnative.test( docElem.compareDocumentPosition ); + + // Element contains another + // Purposefully self-exclusive + // As in, an element does not contain itself + contains = hasCompare || rnative.test( docElem.contains ) ? + function( a, b ) { + var adown = a.nodeType === 9 ? a.documentElement : a, + bup = b && b.parentNode; + return a === bup || !!( bup && bup.nodeType === 1 && ( + adown.contains ? + adown.contains( bup ) : + a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16 + ) ); + } : + function( a, b ) { + if ( b ) { + while ( ( b = b.parentNode ) ) { + if ( b === a ) { + return true; + } + } + } + return false; + }; + + /* Sorting + ---------------------------------------------------------------------- */ + + // Document order sorting + sortOrder = hasCompare ? + function( a, b ) { + + // Flag for duplicate removal + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + // Sort on method existence if only one input has compareDocumentPosition + var compare = !a.compareDocumentPosition - !b.compareDocumentPosition; + if ( compare ) { + return compare; + } + + // Calculate position if both inputs belong to the same document + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + compare = ( a.ownerDocument || a ) == ( b.ownerDocument || b ) ? + a.compareDocumentPosition( b ) : + + // Otherwise we know they are disconnected + 1; + + // Disconnected nodes + if ( compare & 1 || + ( !support.sortDetached && b.compareDocumentPosition( a ) === compare ) ) { + + // Choose the first element that is related to our preferred document + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( a == document || a.ownerDocument == preferredDoc && + contains( preferredDoc, a ) ) { + return -1; + } + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( b == document || b.ownerDocument == preferredDoc && + contains( preferredDoc, b ) ) { + return 1; + } + + // Maintain original order + return sortInput ? + ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : + 0; + } + + return compare & 4 ? -1 : 1; + } : + function( a, b ) { + + // Exit early if the nodes are identical + if ( a === b ) { + hasDuplicate = true; + return 0; + } + + var cur, + i = 0, + aup = a.parentNode, + bup = b.parentNode, + ap = [ a ], + bp = [ b ]; + + // Parentless nodes are either documents or disconnected + if ( !aup || !bup ) { + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + /* eslint-disable eqeqeq */ + return a == document ? -1 : + b == document ? 1 : + /* eslint-enable eqeqeq */ + aup ? -1 : + bup ? 1 : + sortInput ? + ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : + 0; + + // If the nodes are siblings, we can do a quick check + } else if ( aup === bup ) { + return siblingCheck( a, b ); + } + + // Otherwise we need full lists of their ancestors for comparison + cur = a; + while ( ( cur = cur.parentNode ) ) { + ap.unshift( cur ); + } + cur = b; + while ( ( cur = cur.parentNode ) ) { + bp.unshift( cur ); + } + + // Walk down the tree looking for a discrepancy + while ( ap[ i ] === bp[ i ] ) { + i++; + } + + return i ? + + // Do a sibling check if the nodes have a common ancestor + siblingCheck( ap[ i ], bp[ i ] ) : + + // Otherwise nodes in our document sort first + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + /* eslint-disable eqeqeq */ + ap[ i ] == preferredDoc ? -1 : + bp[ i ] == preferredDoc ? 1 : + /* eslint-enable eqeqeq */ + 0; + }; + + return document; +}; + +Sizzle.matches = function( expr, elements ) { + return Sizzle( expr, null, null, elements ); +}; + +Sizzle.matchesSelector = function( elem, expr ) { + setDocument( elem ); + + if ( support.matchesSelector && documentIsHTML && + !nonnativeSelectorCache[ expr + " " ] && + ( !rbuggyMatches || !rbuggyMatches.test( expr ) ) && + ( !rbuggyQSA || !rbuggyQSA.test( expr ) ) ) { + + try { + var ret = matches.call( elem, expr ); + + // IE 9's matchesSelector returns false on disconnected nodes + if ( ret || support.disconnectedMatch || + + // As well, disconnected nodes are said to be in a document + // fragment in IE 9 + elem.document && elem.document.nodeType !== 11 ) { + return ret; + } + } catch ( e ) { + nonnativeSelectorCache( expr, true ); + } + } + + return Sizzle( expr, document, null, [ elem ] ).length > 0; +}; + +Sizzle.contains = function( context, elem ) { + + // Set document vars if needed + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( ( context.ownerDocument || context ) != document ) { + setDocument( context ); + } + return contains( context, elem ); +}; + +Sizzle.attr = function( elem, name ) { + + // Set document vars if needed + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( ( elem.ownerDocument || elem ) != document ) { + setDocument( elem ); + } + + var fn = Expr.attrHandle[ name.toLowerCase() ], + + // Don't get fooled by Object.prototype properties (jQuery #13807) + val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ? + fn( elem, name, !documentIsHTML ) : + undefined; + + return val !== undefined ? + val : + support.attributes || !documentIsHTML ? + elem.getAttribute( name ) : + ( val = elem.getAttributeNode( name ) ) && val.specified ? + val.value : + null; +}; + +Sizzle.escape = function( sel ) { + return ( sel + "" ).replace( rcssescape, fcssescape ); +}; + +Sizzle.error = function( msg ) { + throw new Error( "Syntax error, unrecognized expression: " + msg ); +}; + +/** + * Document sorting and removing duplicates + * @param {ArrayLike} results + */ +Sizzle.uniqueSort = function( results ) { + var elem, + duplicates = [], + j = 0, + i = 0; + + // Unless we *know* we can detect duplicates, assume their presence + hasDuplicate = !support.detectDuplicates; + sortInput = !support.sortStable && results.slice( 0 ); + results.sort( sortOrder ); + + if ( hasDuplicate ) { + while ( ( elem = results[ i++ ] ) ) { + if ( elem === results[ i ] ) { + j = duplicates.push( i ); + } + } + while ( j-- ) { + results.splice( duplicates[ j ], 1 ); + } + } + + // Clear input after sorting to release objects + // See https://github.com/jquery/sizzle/pull/225 + sortInput = null; + + return results; +}; + +/** + * Utility function for retrieving the text value of an array of DOM nodes + * @param {Array|Element} elem + */ +getText = Sizzle.getText = function( elem ) { + var node, + ret = "", + i = 0, + nodeType = elem.nodeType; + + if ( !nodeType ) { + + // If no nodeType, this is expected to be an array + while ( ( node = elem[ i++ ] ) ) { + + // Do not traverse comment nodes + ret += getText( node ); + } + } else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) { + + // Use textContent for elements + // innerText usage removed for consistency of new lines (jQuery #11153) + if ( typeof elem.textContent === "string" ) { + return elem.textContent; + } else { + + // Traverse its children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + ret += getText( elem ); + } + } + } else if ( nodeType === 3 || nodeType === 4 ) { + return elem.nodeValue; + } + + // Do not include comment or processing instruction nodes + + return ret; +}; + +Expr = Sizzle.selectors = { + + // Can be adjusted by the user + cacheLength: 50, + + createPseudo: markFunction, + + match: matchExpr, + + attrHandle: {}, + + find: {}, + + relative: { + ">": { dir: "parentNode", first: true }, + " ": { dir: "parentNode" }, + "+": { dir: "previousSibling", first: true }, + "~": { dir: "previousSibling" } + }, + + preFilter: { + "ATTR": function( match ) { + match[ 1 ] = match[ 1 ].replace( runescape, funescape ); + + // Move the given value to match[3] whether quoted or unquoted + match[ 3 ] = ( match[ 3 ] || match[ 4 ] || + match[ 5 ] || "" ).replace( runescape, funescape ); + + if ( match[ 2 ] === "~=" ) { + match[ 3 ] = " " + match[ 3 ] + " "; + } + + return match.slice( 0, 4 ); + }, + + "CHILD": function( match ) { + + /* matches from matchExpr["CHILD"] + 1 type (only|nth|...) + 2 what (child|of-type) + 3 argument (even|odd|\d*|\d*n([+-]\d+)?|...) + 4 xn-component of xn+y argument ([+-]?\d*n|) + 5 sign of xn-component + 6 x of xn-component + 7 sign of y-component + 8 y of y-component + */ + match[ 1 ] = match[ 1 ].toLowerCase(); + + if ( match[ 1 ].slice( 0, 3 ) === "nth" ) { + + // nth-* requires argument + if ( !match[ 3 ] ) { + Sizzle.error( match[ 0 ] ); + } + + // numeric x and y parameters for Expr.filter.CHILD + // remember that false/true cast respectively to 0/1 + match[ 4 ] = +( match[ 4 ] ? + match[ 5 ] + ( match[ 6 ] || 1 ) : + 2 * ( match[ 3 ] === "even" || match[ 3 ] === "odd" ) ); + match[ 5 ] = +( ( match[ 7 ] + match[ 8 ] ) || match[ 3 ] === "odd" ); + + // other types prohibit arguments + } else if ( match[ 3 ] ) { + Sizzle.error( match[ 0 ] ); + } + + return match; + }, + + "PSEUDO": function( match ) { + var excess, + unquoted = !match[ 6 ] && match[ 2 ]; + + if ( matchExpr[ "CHILD" ].test( match[ 0 ] ) ) { + return null; + } + + // Accept quoted arguments as-is + if ( match[ 3 ] ) { + match[ 2 ] = match[ 4 ] || match[ 5 ] || ""; + + // Strip excess characters from unquoted arguments + } else if ( unquoted && rpseudo.test( unquoted ) && + + // Get excess from tokenize (recursively) + ( excess = tokenize( unquoted, true ) ) && + + // advance to the next closing parenthesis + ( excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length ) ) { + + // excess is a negative index + match[ 0 ] = match[ 0 ].slice( 0, excess ); + match[ 2 ] = unquoted.slice( 0, excess ); + } + + // Return only captures needed by the pseudo filter method (type and argument) + return match.slice( 0, 3 ); + } + }, + + filter: { + + "TAG": function( nodeNameSelector ) { + var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase(); + return nodeNameSelector === "*" ? + function() { + return true; + } : + function( elem ) { + return elem.nodeName && elem.nodeName.toLowerCase() === nodeName; + }; + }, + + "CLASS": function( className ) { + var pattern = classCache[ className + " " ]; + + return pattern || + ( pattern = new RegExp( "(^|" + whitespace + + ")" + className + "(" + whitespace + "|$)" ) ) && classCache( + className, function( elem ) { + return pattern.test( + typeof elem.className === "string" && elem.className || + typeof elem.getAttribute !== "undefined" && + elem.getAttribute( "class" ) || + "" + ); + } ); + }, + + "ATTR": function( name, operator, check ) { + return function( elem ) { + var result = Sizzle.attr( elem, name ); + + if ( result == null ) { + return operator === "!="; + } + if ( !operator ) { + return true; + } + + result += ""; + + /* eslint-disable max-len */ + + return operator === "=" ? result === check : + operator === "!=" ? result !== check : + operator === "^=" ? check && result.indexOf( check ) === 0 : + operator === "*=" ? check && result.indexOf( check ) > -1 : + operator === "$=" ? check && result.slice( -check.length ) === check : + operator === "~=" ? ( " " + result.replace( rwhitespace, " " ) + " " ).indexOf( check ) > -1 : + operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" : + false; + /* eslint-enable max-len */ + + }; + }, + + "CHILD": function( type, what, _argument, first, last ) { + var simple = type.slice( 0, 3 ) !== "nth", + forward = type.slice( -4 ) !== "last", + ofType = what === "of-type"; + + return first === 1 && last === 0 ? + + // Shortcut for :nth-*(n) + function( elem ) { + return !!elem.parentNode; + } : + + function( elem, _context, xml ) { + var cache, uniqueCache, outerCache, node, nodeIndex, start, + dir = simple !== forward ? "nextSibling" : "previousSibling", + parent = elem.parentNode, + name = ofType && elem.nodeName.toLowerCase(), + useCache = !xml && !ofType, + diff = false; + + if ( parent ) { + + // :(first|last|only)-(child|of-type) + if ( simple ) { + while ( dir ) { + node = elem; + while ( ( node = node[ dir ] ) ) { + if ( ofType ? + node.nodeName.toLowerCase() === name : + node.nodeType === 1 ) { + + return false; + } + } + + // Reverse direction for :only-* (if we haven't yet done so) + start = dir = type === "only" && !start && "nextSibling"; + } + return true; + } + + start = [ forward ? parent.firstChild : parent.lastChild ]; + + // non-xml :nth-child(...) stores cache data on `parent` + if ( forward && useCache ) { + + // Seek `elem` from a previously-cached index + + // ...in a gzip-friendly way + node = parent; + outerCache = node[ expando ] || ( node[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + ( outerCache[ node.uniqueID ] = {} ); + + cache = uniqueCache[ type ] || []; + nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; + diff = nodeIndex && cache[ 2 ]; + node = nodeIndex && parent.childNodes[ nodeIndex ]; + + while ( ( node = ++nodeIndex && node && node[ dir ] || + + // Fallback to seeking `elem` from the start + ( diff = nodeIndex = 0 ) || start.pop() ) ) { + + // When found, cache indexes on `parent` and break + if ( node.nodeType === 1 && ++diff && node === elem ) { + uniqueCache[ type ] = [ dirruns, nodeIndex, diff ]; + break; + } + } + + } else { + + // Use previously-cached element index if available + if ( useCache ) { + + // ...in a gzip-friendly way + node = elem; + outerCache = node[ expando ] || ( node[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + ( outerCache[ node.uniqueID ] = {} ); + + cache = uniqueCache[ type ] || []; + nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; + diff = nodeIndex; + } + + // xml :nth-child(...) + // or :nth-last-child(...) or :nth(-last)?-of-type(...) + if ( diff === false ) { + + // Use the same loop as above to seek `elem` from the start + while ( ( node = ++nodeIndex && node && node[ dir ] || + ( diff = nodeIndex = 0 ) || start.pop() ) ) { + + if ( ( ofType ? + node.nodeName.toLowerCase() === name : + node.nodeType === 1 ) && + ++diff ) { + + // Cache the index of each encountered element + if ( useCache ) { + outerCache = node[ expando ] || + ( node[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ node.uniqueID ] || + ( outerCache[ node.uniqueID ] = {} ); + + uniqueCache[ type ] = [ dirruns, diff ]; + } + + if ( node === elem ) { + break; + } + } + } + } + } + + // Incorporate the offset, then check against cycle size + diff -= last; + return diff === first || ( diff % first === 0 && diff / first >= 0 ); + } + }; + }, + + "PSEUDO": function( pseudo, argument ) { + + // pseudo-class names are case-insensitive + // http://www.w3.org/TR/selectors/#pseudo-classes + // Prioritize by case sensitivity in case custom pseudos are added with uppercase letters + // Remember that setFilters inherits from pseudos + var args, + fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] || + Sizzle.error( "unsupported pseudo: " + pseudo ); + + // The user may use createPseudo to indicate that + // arguments are needed to create the filter function + // just as Sizzle does + if ( fn[ expando ] ) { + return fn( argument ); + } + + // But maintain support for old signatures + if ( fn.length > 1 ) { + args = [ pseudo, pseudo, "", argument ]; + return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ? + markFunction( function( seed, matches ) { + var idx, + matched = fn( seed, argument ), + i = matched.length; + while ( i-- ) { + idx = indexOf( seed, matched[ i ] ); + seed[ idx ] = !( matches[ idx ] = matched[ i ] ); + } + } ) : + function( elem ) { + return fn( elem, 0, args ); + }; + } + + return fn; + } + }, + + pseudos: { + + // Potentially complex pseudos + "not": markFunction( function( selector ) { + + // Trim the selector passed to compile + // to avoid treating leading and trailing + // spaces as combinators + var input = [], + results = [], + matcher = compile( selector.replace( rtrim, "$1" ) ); + + return matcher[ expando ] ? + markFunction( function( seed, matches, _context, xml ) { + var elem, + unmatched = matcher( seed, null, xml, [] ), + i = seed.length; + + // Match elements unmatched by `matcher` + while ( i-- ) { + if ( ( elem = unmatched[ i ] ) ) { + seed[ i ] = !( matches[ i ] = elem ); + } + } + } ) : + function( elem, _context, xml ) { + input[ 0 ] = elem; + matcher( input, null, xml, results ); + + // Don't keep the element (issue #299) + input[ 0 ] = null; + return !results.pop(); + }; + } ), + + "has": markFunction( function( selector ) { + return function( elem ) { + return Sizzle( selector, elem ).length > 0; + }; + } ), + + "contains": markFunction( function( text ) { + text = text.replace( runescape, funescape ); + return function( elem ) { + return ( elem.textContent || getText( elem ) ).indexOf( text ) > -1; + }; + } ), + + // "Whether an element is represented by a :lang() selector + // is based solely on the element's language value + // being equal to the identifier C, + // or beginning with the identifier C immediately followed by "-". + // The matching of C against the element's language value is performed case-insensitively. + // The identifier C does not have to be a valid language name." + // http://www.w3.org/TR/selectors/#lang-pseudo + "lang": markFunction( function( lang ) { + + // lang value must be a valid identifier + if ( !ridentifier.test( lang || "" ) ) { + Sizzle.error( "unsupported lang: " + lang ); + } + lang = lang.replace( runescape, funescape ).toLowerCase(); + return function( elem ) { + var elemLang; + do { + if ( ( elemLang = documentIsHTML ? + elem.lang : + elem.getAttribute( "xml:lang" ) || elem.getAttribute( "lang" ) ) ) { + + elemLang = elemLang.toLowerCase(); + return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0; + } + } while ( ( elem = elem.parentNode ) && elem.nodeType === 1 ); + return false; + }; + } ), + + // Miscellaneous + "target": function( elem ) { + var hash = window.location && window.location.hash; + return hash && hash.slice( 1 ) === elem.id; + }, + + "root": function( elem ) { + return elem === docElem; + }, + + "focus": function( elem ) { + return elem === document.activeElement && + ( !document.hasFocus || document.hasFocus() ) && + !!( elem.type || elem.href || ~elem.tabIndex ); + }, + + // Boolean properties + "enabled": createDisabledPseudo( false ), + "disabled": createDisabledPseudo( true ), + + "checked": function( elem ) { + + // In CSS3, :checked should return both checked and selected elements + // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked + var nodeName = elem.nodeName.toLowerCase(); + return ( nodeName === "input" && !!elem.checked ) || + ( nodeName === "option" && !!elem.selected ); + }, + + "selected": function( elem ) { + + // Accessing this property makes selected-by-default + // options in Safari work properly + if ( elem.parentNode ) { + // eslint-disable-next-line no-unused-expressions + elem.parentNode.selectedIndex; + } + + return elem.selected === true; + }, + + // Contents + "empty": function( elem ) { + + // http://www.w3.org/TR/selectors/#empty-pseudo + // :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5), + // but not by others (comment: 8; processing instruction: 7; etc.) + // nodeType < 6 works because attributes (2) do not appear as children + for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { + if ( elem.nodeType < 6 ) { + return false; + } + } + return true; + }, + + "parent": function( elem ) { + return !Expr.pseudos[ "empty" ]( elem ); + }, + + // Element/input types + "header": function( elem ) { + return rheader.test( elem.nodeName ); + }, + + "input": function( elem ) { + return rinputs.test( elem.nodeName ); + }, + + "button": function( elem ) { + var name = elem.nodeName.toLowerCase(); + return name === "input" && elem.type === "button" || name === "button"; + }, + + "text": function( elem ) { + var attr; + return elem.nodeName.toLowerCase() === "input" && + elem.type === "text" && + + // Support: IE<8 + // New HTML5 attribute values (e.g., "search") appear with elem.type === "text" + ( ( attr = elem.getAttribute( "type" ) ) == null || + attr.toLowerCase() === "text" ); + }, + + // Position-in-collection + "first": createPositionalPseudo( function() { + return [ 0 ]; + } ), + + "last": createPositionalPseudo( function( _matchIndexes, length ) { + return [ length - 1 ]; + } ), + + "eq": createPositionalPseudo( function( _matchIndexes, length, argument ) { + return [ argument < 0 ? argument + length : argument ]; + } ), + + "even": createPositionalPseudo( function( matchIndexes, length ) { + var i = 0; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ), + + "odd": createPositionalPseudo( function( matchIndexes, length ) { + var i = 1; + for ( ; i < length; i += 2 ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ), + + "lt": createPositionalPseudo( function( matchIndexes, length, argument ) { + var i = argument < 0 ? + argument + length : + argument > length ? + length : + argument; + for ( ; --i >= 0; ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ), + + "gt": createPositionalPseudo( function( matchIndexes, length, argument ) { + var i = argument < 0 ? argument + length : argument; + for ( ; ++i < length; ) { + matchIndexes.push( i ); + } + return matchIndexes; + } ) + } +}; + +Expr.pseudos[ "nth" ] = Expr.pseudos[ "eq" ]; + +// Add button/input type pseudos +for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) { + Expr.pseudos[ i ] = createInputPseudo( i ); +} +for ( i in { submit: true, reset: true } ) { + Expr.pseudos[ i ] = createButtonPseudo( i ); +} + +// Easy API for creating new setFilters +function setFilters() {} +setFilters.prototype = Expr.filters = Expr.pseudos; +Expr.setFilters = new setFilters(); + +tokenize = Sizzle.tokenize = function( selector, parseOnly ) { + var matched, match, tokens, type, + soFar, groups, preFilters, + cached = tokenCache[ selector + " " ]; + + if ( cached ) { + return parseOnly ? 0 : cached.slice( 0 ); + } + + soFar = selector; + groups = []; + preFilters = Expr.preFilter; + + while ( soFar ) { + + // Comma and first run + if ( !matched || ( match = rcomma.exec( soFar ) ) ) { + if ( match ) { + + // Don't consume trailing commas as valid + soFar = soFar.slice( match[ 0 ].length ) || soFar; + } + groups.push( ( tokens = [] ) ); + } + + matched = false; + + // Combinators + if ( ( match = rcombinators.exec( soFar ) ) ) { + matched = match.shift(); + tokens.push( { + value: matched, + + // Cast descendant combinators to space + type: match[ 0 ].replace( rtrim, " " ) + } ); + soFar = soFar.slice( matched.length ); + } + + // Filters + for ( type in Expr.filter ) { + if ( ( match = matchExpr[ type ].exec( soFar ) ) && ( !preFilters[ type ] || + ( match = preFilters[ type ]( match ) ) ) ) { + matched = match.shift(); + tokens.push( { + value: matched, + type: type, + matches: match + } ); + soFar = soFar.slice( matched.length ); + } + } + + if ( !matched ) { + break; + } + } + + // Return the length of the invalid excess + // if we're just parsing + // Otherwise, throw an error or return tokens + return parseOnly ? + soFar.length : + soFar ? + Sizzle.error( selector ) : + + // Cache the tokens + tokenCache( selector, groups ).slice( 0 ); +}; + +function toSelector( tokens ) { + var i = 0, + len = tokens.length, + selector = ""; + for ( ; i < len; i++ ) { + selector += tokens[ i ].value; + } + return selector; +} + +function addCombinator( matcher, combinator, base ) { + var dir = combinator.dir, + skip = combinator.next, + key = skip || dir, + checkNonElements = base && key === "parentNode", + doneName = done++; + + return combinator.first ? + + // Check against closest ancestor/preceding element + function( elem, context, xml ) { + while ( ( elem = elem[ dir ] ) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + return matcher( elem, context, xml ); + } + } + return false; + } : + + // Check against all ancestor/preceding elements + function( elem, context, xml ) { + var oldCache, uniqueCache, outerCache, + newCache = [ dirruns, doneName ]; + + // We can't set arbitrary data on XML nodes, so they don't benefit from combinator caching + if ( xml ) { + while ( ( elem = elem[ dir ] ) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + if ( matcher( elem, context, xml ) ) { + return true; + } + } + } + } else { + while ( ( elem = elem[ dir ] ) ) { + if ( elem.nodeType === 1 || checkNonElements ) { + outerCache = elem[ expando ] || ( elem[ expando ] = {} ); + + // Support: IE <9 only + // Defend against cloned attroperties (jQuery gh-1709) + uniqueCache = outerCache[ elem.uniqueID ] || + ( outerCache[ elem.uniqueID ] = {} ); + + if ( skip && skip === elem.nodeName.toLowerCase() ) { + elem = elem[ dir ] || elem; + } else if ( ( oldCache = uniqueCache[ key ] ) && + oldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) { + + // Assign to newCache so results back-propagate to previous elements + return ( newCache[ 2 ] = oldCache[ 2 ] ); + } else { + + // Reuse newcache so results back-propagate to previous elements + uniqueCache[ key ] = newCache; + + // A match means we're done; a fail means we have to keep checking + if ( ( newCache[ 2 ] = matcher( elem, context, xml ) ) ) { + return true; + } + } + } + } + } + return false; + }; +} + +function elementMatcher( matchers ) { + return matchers.length > 1 ? + function( elem, context, xml ) { + var i = matchers.length; + while ( i-- ) { + if ( !matchers[ i ]( elem, context, xml ) ) { + return false; + } + } + return true; + } : + matchers[ 0 ]; +} + +function multipleContexts( selector, contexts, results ) { + var i = 0, + len = contexts.length; + for ( ; i < len; i++ ) { + Sizzle( selector, contexts[ i ], results ); + } + return results; +} + +function condense( unmatched, map, filter, context, xml ) { + var elem, + newUnmatched = [], + i = 0, + len = unmatched.length, + mapped = map != null; + + for ( ; i < len; i++ ) { + if ( ( elem = unmatched[ i ] ) ) { + if ( !filter || filter( elem, context, xml ) ) { + newUnmatched.push( elem ); + if ( mapped ) { + map.push( i ); + } + } + } + } + + return newUnmatched; +} + +function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) { + if ( postFilter && !postFilter[ expando ] ) { + postFilter = setMatcher( postFilter ); + } + if ( postFinder && !postFinder[ expando ] ) { + postFinder = setMatcher( postFinder, postSelector ); + } + return markFunction( function( seed, results, context, xml ) { + var temp, i, elem, + preMap = [], + postMap = [], + preexisting = results.length, + + // Get initial elements from seed or context + elems = seed || multipleContexts( + selector || "*", + context.nodeType ? [ context ] : context, + [] + ), + + // Prefilter to get matcher input, preserving a map for seed-results synchronization + matcherIn = preFilter && ( seed || !selector ) ? + condense( elems, preMap, preFilter, context, xml ) : + elems, + + matcherOut = matcher ? + + // If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results, + postFinder || ( seed ? preFilter : preexisting || postFilter ) ? + + // ...intermediate processing is necessary + [] : + + // ...otherwise use results directly + results : + matcherIn; + + // Find primary matches + if ( matcher ) { + matcher( matcherIn, matcherOut, context, xml ); + } + + // Apply postFilter + if ( postFilter ) { + temp = condense( matcherOut, postMap ); + postFilter( temp, [], context, xml ); + + // Un-match failing elements by moving them back to matcherIn + i = temp.length; + while ( i-- ) { + if ( ( elem = temp[ i ] ) ) { + matcherOut[ postMap[ i ] ] = !( matcherIn[ postMap[ i ] ] = elem ); + } + } + } + + if ( seed ) { + if ( postFinder || preFilter ) { + if ( postFinder ) { + + // Get the final matcherOut by condensing this intermediate into postFinder contexts + temp = []; + i = matcherOut.length; + while ( i-- ) { + if ( ( elem = matcherOut[ i ] ) ) { + + // Restore matcherIn since elem is not yet a final match + temp.push( ( matcherIn[ i ] = elem ) ); + } + } + postFinder( null, ( matcherOut = [] ), temp, xml ); + } + + // Move matched elements from seed to results to keep them synchronized + i = matcherOut.length; + while ( i-- ) { + if ( ( elem = matcherOut[ i ] ) && + ( temp = postFinder ? indexOf( seed, elem ) : preMap[ i ] ) > -1 ) { + + seed[ temp ] = !( results[ temp ] = elem ); + } + } + } + + // Add elements to results, through postFinder if defined + } else { + matcherOut = condense( + matcherOut === results ? + matcherOut.splice( preexisting, matcherOut.length ) : + matcherOut + ); + if ( postFinder ) { + postFinder( null, results, matcherOut, xml ); + } else { + push.apply( results, matcherOut ); + } + } + } ); +} + +function matcherFromTokens( tokens ) { + var checkContext, matcher, j, + len = tokens.length, + leadingRelative = Expr.relative[ tokens[ 0 ].type ], + implicitRelative = leadingRelative || Expr.relative[ " " ], + i = leadingRelative ? 1 : 0, + + // The foundational matcher ensures that elements are reachable from top-level context(s) + matchContext = addCombinator( function( elem ) { + return elem === checkContext; + }, implicitRelative, true ), + matchAnyContext = addCombinator( function( elem ) { + return indexOf( checkContext, elem ) > -1; + }, implicitRelative, true ), + matchers = [ function( elem, context, xml ) { + var ret = ( !leadingRelative && ( xml || context !== outermostContext ) ) || ( + ( checkContext = context ).nodeType ? + matchContext( elem, context, xml ) : + matchAnyContext( elem, context, xml ) ); + + // Avoid hanging onto element (issue #299) + checkContext = null; + return ret; + } ]; + + for ( ; i < len; i++ ) { + if ( ( matcher = Expr.relative[ tokens[ i ].type ] ) ) { + matchers = [ addCombinator( elementMatcher( matchers ), matcher ) ]; + } else { + matcher = Expr.filter[ tokens[ i ].type ].apply( null, tokens[ i ].matches ); + + // Return special upon seeing a positional matcher + if ( matcher[ expando ] ) { + + // Find the next relative operator (if any) for proper handling + j = ++i; + for ( ; j < len; j++ ) { + if ( Expr.relative[ tokens[ j ].type ] ) { + break; + } + } + return setMatcher( + i > 1 && elementMatcher( matchers ), + i > 1 && toSelector( + + // If the preceding token was a descendant combinator, insert an implicit any-element `*` + tokens + .slice( 0, i - 1 ) + .concat( { value: tokens[ i - 2 ].type === " " ? "*" : "" } ) + ).replace( rtrim, "$1" ), + matcher, + i < j && matcherFromTokens( tokens.slice( i, j ) ), + j < len && matcherFromTokens( ( tokens = tokens.slice( j ) ) ), + j < len && toSelector( tokens ) + ); + } + matchers.push( matcher ); + } + } + + return elementMatcher( matchers ); +} + +function matcherFromGroupMatchers( elementMatchers, setMatchers ) { + var bySet = setMatchers.length > 0, + byElement = elementMatchers.length > 0, + superMatcher = function( seed, context, xml, results, outermost ) { + var elem, j, matcher, + matchedCount = 0, + i = "0", + unmatched = seed && [], + setMatched = [], + contextBackup = outermostContext, + + // We must always have either seed elements or outermost context + elems = seed || byElement && Expr.find[ "TAG" ]( "*", outermost ), + + // Use integer dirruns iff this is the outermost matcher + dirrunsUnique = ( dirruns += contextBackup == null ? 1 : Math.random() || 0.1 ), + len = elems.length; + + if ( outermost ) { + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + outermostContext = context == document || context || outermost; + } + + // Add elements passing elementMatchers directly to results + // Support: IE<9, Safari + // Tolerate NodeList properties (IE: "length"; Safari: ) matching elements by id + for ( ; i !== len && ( elem = elems[ i ] ) != null; i++ ) { + if ( byElement && elem ) { + j = 0; + + // Support: IE 11+, Edge 17 - 18+ + // IE/Edge sometimes throw a "Permission denied" error when strict-comparing + // two documents; shallow comparisons work. + // eslint-disable-next-line eqeqeq + if ( !context && elem.ownerDocument != document ) { + setDocument( elem ); + xml = !documentIsHTML; + } + while ( ( matcher = elementMatchers[ j++ ] ) ) { + if ( matcher( elem, context || document, xml ) ) { + results.push( elem ); + break; + } + } + if ( outermost ) { + dirruns = dirrunsUnique; + } + } + + // Track unmatched elements for set filters + if ( bySet ) { + + // They will have gone through all possible matchers + if ( ( elem = !matcher && elem ) ) { + matchedCount--; + } + + // Lengthen the array for every element, matched or not + if ( seed ) { + unmatched.push( elem ); + } + } + } + + // `i` is now the count of elements visited above, and adding it to `matchedCount` + // makes the latter nonnegative. + matchedCount += i; + + // Apply set filters to unmatched elements + // NOTE: This can be skipped if there are no unmatched elements (i.e., `matchedCount` + // equals `i`), unless we didn't visit _any_ elements in the above loop because we have + // no element matchers and no seed. + // Incrementing an initially-string "0" `i` allows `i` to remain a string only in that + // case, which will result in a "00" `matchedCount` that differs from `i` but is also + // numerically zero. + if ( bySet && i !== matchedCount ) { + j = 0; + while ( ( matcher = setMatchers[ j++ ] ) ) { + matcher( unmatched, setMatched, context, xml ); + } + + if ( seed ) { + + // Reintegrate element matches to eliminate the need for sorting + if ( matchedCount > 0 ) { + while ( i-- ) { + if ( !( unmatched[ i ] || setMatched[ i ] ) ) { + setMatched[ i ] = pop.call( results ); + } + } + } + + // Discard index placeholder values to get only actual matches + setMatched = condense( setMatched ); + } + + // Add matches to results + push.apply( results, setMatched ); + + // Seedless set matches succeeding multiple successful matchers stipulate sorting + if ( outermost && !seed && setMatched.length > 0 && + ( matchedCount + setMatchers.length ) > 1 ) { + + Sizzle.uniqueSort( results ); + } + } + + // Override manipulation of globals by nested matchers + if ( outermost ) { + dirruns = dirrunsUnique; + outermostContext = contextBackup; + } + + return unmatched; + }; + + return bySet ? + markFunction( superMatcher ) : + superMatcher; +} + +compile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) { + var i, + setMatchers = [], + elementMatchers = [], + cached = compilerCache[ selector + " " ]; + + if ( !cached ) { + + // Generate a function of recursive functions that can be used to check each element + if ( !match ) { + match = tokenize( selector ); + } + i = match.length; + while ( i-- ) { + cached = matcherFromTokens( match[ i ] ); + if ( cached[ expando ] ) { + setMatchers.push( cached ); + } else { + elementMatchers.push( cached ); + } + } + + // Cache the compiled function + cached = compilerCache( + selector, + matcherFromGroupMatchers( elementMatchers, setMatchers ) + ); + + // Save selector and tokenization + cached.selector = selector; + } + return cached; +}; + +/** + * A low-level selection function that works with Sizzle's compiled + * selector functions + * @param {String|Function} selector A selector or a pre-compiled + * selector function built with Sizzle.compile + * @param {Element} context + * @param {Array} [results] + * @param {Array} [seed] A set of elements to match against + */ +select = Sizzle.select = function( selector, context, results, seed ) { + var i, tokens, token, type, find, + compiled = typeof selector === "function" && selector, + match = !seed && tokenize( ( selector = compiled.selector || selector ) ); + + results = results || []; + + // Try to minimize operations if there is only one selector in the list and no seed + // (the latter of which guarantees us context) + if ( match.length === 1 ) { + + // Reduce context if the leading compound selector is an ID + tokens = match[ 0 ] = match[ 0 ].slice( 0 ); + if ( tokens.length > 2 && ( token = tokens[ 0 ] ).type === "ID" && + context.nodeType === 9 && documentIsHTML && Expr.relative[ tokens[ 1 ].type ] ) { + + context = ( Expr.find[ "ID" ]( token.matches[ 0 ] + .replace( runescape, funescape ), context ) || [] )[ 0 ]; + if ( !context ) { + return results; + + // Precompiled matchers will still verify ancestry, so step up a level + } else if ( compiled ) { + context = context.parentNode; + } + + selector = selector.slice( tokens.shift().value.length ); + } + + // Fetch a seed set for right-to-left matching + i = matchExpr[ "needsContext" ].test( selector ) ? 0 : tokens.length; + while ( i-- ) { + token = tokens[ i ]; + + // Abort if we hit a combinator + if ( Expr.relative[ ( type = token.type ) ] ) { + break; + } + if ( ( find = Expr.find[ type ] ) ) { + + // Search, expanding context for leading sibling combinators + if ( ( seed = find( + token.matches[ 0 ].replace( runescape, funescape ), + rsibling.test( tokens[ 0 ].type ) && testContext( context.parentNode ) || + context + ) ) ) { + + // If seed is empty or no tokens remain, we can return early + tokens.splice( i, 1 ); + selector = seed.length && toSelector( tokens ); + if ( !selector ) { + push.apply( results, seed ); + return results; + } + + break; + } + } + } + } + + // Compile and execute a filtering function if one is not provided + // Provide `match` to avoid retokenization if we modified the selector above + ( compiled || compile( selector, match ) )( + seed, + context, + !documentIsHTML, + results, + !context || rsibling.test( selector ) && testContext( context.parentNode ) || context + ); + return results; +}; + +// One-time assignments + +// Sort stability +support.sortStable = expando.split( "" ).sort( sortOrder ).join( "" ) === expando; + +// Support: Chrome 14-35+ +// Always assume duplicates if they aren't passed to the comparison function +support.detectDuplicates = !!hasDuplicate; + +// Initialize against the default document +setDocument(); + +// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27) +// Detached nodes confoundingly follow *each other* +support.sortDetached = assert( function( el ) { + + // Should return 1, but returns 4 (following) + return el.compareDocumentPosition( document.createElement( "fieldset" ) ) & 1; +} ); + +// Support: IE<8 +// Prevent attribute/property "interpolation" +// https://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx +if ( !assert( function( el ) { + el.innerHTML = ""; + return el.firstChild.getAttribute( "href" ) === "#"; +} ) ) { + addHandle( "type|href|height|width", function( elem, name, isXML ) { + if ( !isXML ) { + return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 ); + } + } ); +} + +// Support: IE<9 +// Use defaultValue in place of getAttribute("value") +if ( !support.attributes || !assert( function( el ) { + el.innerHTML = ""; + el.firstChild.setAttribute( "value", "" ); + return el.firstChild.getAttribute( "value" ) === ""; +} ) ) { + addHandle( "value", function( elem, _name, isXML ) { + if ( !isXML && elem.nodeName.toLowerCase() === "input" ) { + return elem.defaultValue; + } + } ); +} + +// Support: IE<9 +// Use getAttributeNode to fetch booleans when getAttribute lies +if ( !assert( function( el ) { + return el.getAttribute( "disabled" ) == null; +} ) ) { + addHandle( booleans, function( elem, name, isXML ) { + var val; + if ( !isXML ) { + return elem[ name ] === true ? name.toLowerCase() : + ( val = elem.getAttributeNode( name ) ) && val.specified ? + val.value : + null; + } + } ); +} + +return Sizzle; + +} )( window ); + + + +jQuery.find = Sizzle; +jQuery.expr = Sizzle.selectors; + +// Deprecated +jQuery.expr[ ":" ] = jQuery.expr.pseudos; +jQuery.uniqueSort = jQuery.unique = Sizzle.uniqueSort; +jQuery.text = Sizzle.getText; +jQuery.isXMLDoc = Sizzle.isXML; +jQuery.contains = Sizzle.contains; +jQuery.escapeSelector = Sizzle.escape; + + + + +var dir = function( elem, dir, until ) { + var matched = [], + truncate = until !== undefined; + + while ( ( elem = elem[ dir ] ) && elem.nodeType !== 9 ) { + if ( elem.nodeType === 1 ) { + if ( truncate && jQuery( elem ).is( until ) ) { + break; + } + matched.push( elem ); + } + } + return matched; +}; + + +var siblings = function( n, elem ) { + var matched = []; + + for ( ; n; n = n.nextSibling ) { + if ( n.nodeType === 1 && n !== elem ) { + matched.push( n ); + } + } + + return matched; +}; + + +var rneedsContext = jQuery.expr.match.needsContext; + + + +function nodeName( elem, name ) { + + return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase(); + +}; +var rsingleTag = ( /^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i ); + + + +// Implement the identical functionality for filter and not +function winnow( elements, qualifier, not ) { + if ( isFunction( qualifier ) ) { + return jQuery.grep( elements, function( elem, i ) { + return !!qualifier.call( elem, i, elem ) !== not; + } ); + } + + // Single element + if ( qualifier.nodeType ) { + return jQuery.grep( elements, function( elem ) { + return ( elem === qualifier ) !== not; + } ); + } + + // Arraylike of elements (jQuery, arguments, Array) + if ( typeof qualifier !== "string" ) { + return jQuery.grep( elements, function( elem ) { + return ( indexOf.call( qualifier, elem ) > -1 ) !== not; + } ); + } + + // Filtered directly for both simple and complex selectors + return jQuery.filter( qualifier, elements, not ); +} + +jQuery.filter = function( expr, elems, not ) { + var elem = elems[ 0 ]; + + if ( not ) { + expr = ":not(" + expr + ")"; + } + + if ( elems.length === 1 && elem.nodeType === 1 ) { + return jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : []; + } + + return jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) { + return elem.nodeType === 1; + } ) ); +}; + +jQuery.fn.extend( { + find: function( selector ) { + var i, ret, + len = this.length, + self = this; + + if ( typeof selector !== "string" ) { + return this.pushStack( jQuery( selector ).filter( function() { + for ( i = 0; i < len; i++ ) { + if ( jQuery.contains( self[ i ], this ) ) { + return true; + } + } + } ) ); + } + + ret = this.pushStack( [] ); + + for ( i = 0; i < len; i++ ) { + jQuery.find( selector, self[ i ], ret ); + } + + return len > 1 ? jQuery.uniqueSort( ret ) : ret; + }, + filter: function( selector ) { + return this.pushStack( winnow( this, selector || [], false ) ); + }, + not: function( selector ) { + return this.pushStack( winnow( this, selector || [], true ) ); + }, + is: function( selector ) { + return !!winnow( + this, + + // If this is a positional/relative selector, check membership in the returned set + // so $("p:first").is("p:last") won't return true for a doc with two "p". + typeof selector === "string" && rneedsContext.test( selector ) ? + jQuery( selector ) : + selector || [], + false + ).length; + } +} ); + + +// Initialize a jQuery object + + +// A central reference to the root jQuery(document) +var rootjQuery, + + // A simple way to check for HTML strings + // Prioritize #id over to avoid XSS via location.hash (#9521) + // Strict HTML recognition (#11290: must start with <) + // Shortcut simple #id case for speed + rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/, + + init = jQuery.fn.init = function( selector, context, root ) { + var match, elem; + + // HANDLE: $(""), $(null), $(undefined), $(false) + if ( !selector ) { + return this; + } + + // Method init() accepts an alternate rootjQuery + // so migrate can support jQuery.sub (gh-2101) + root = root || rootjQuery; + + // Handle HTML strings + if ( typeof selector === "string" ) { + if ( selector[ 0 ] === "<" && + selector[ selector.length - 1 ] === ">" && + selector.length >= 3 ) { + + // Assume that strings that start and end with <> are HTML and skip the regex check + match = [ null, selector, null ]; + + } else { + match = rquickExpr.exec( selector ); + } + + // Match html or make sure no context is specified for #id + if ( match && ( match[ 1 ] || !context ) ) { + + // HANDLE: $(html) -> $(array) + if ( match[ 1 ] ) { + context = context instanceof jQuery ? context[ 0 ] : context; + + // Option to run scripts is true for back-compat + // Intentionally let the error be thrown if parseHTML is not present + jQuery.merge( this, jQuery.parseHTML( + match[ 1 ], + context && context.nodeType ? context.ownerDocument || context : document, + true + ) ); + + // HANDLE: $(html, props) + if ( rsingleTag.test( match[ 1 ] ) && jQuery.isPlainObject( context ) ) { + for ( match in context ) { + + // Properties of context are called as methods if possible + if ( isFunction( this[ match ] ) ) { + this[ match ]( context[ match ] ); + + // ...and otherwise set as attributes + } else { + this.attr( match, context[ match ] ); + } + } + } + + return this; + + // HANDLE: $(#id) + } else { + elem = document.getElementById( match[ 2 ] ); + + if ( elem ) { + + // Inject the element directly into the jQuery object + this[ 0 ] = elem; + this.length = 1; + } + return this; + } + + // HANDLE: $(expr, $(...)) + } else if ( !context || context.jquery ) { + return ( context || root ).find( selector ); + + // HANDLE: $(expr, context) + // (which is just equivalent to: $(context).find(expr) + } else { + return this.constructor( context ).find( selector ); + } + + // HANDLE: $(DOMElement) + } else if ( selector.nodeType ) { + this[ 0 ] = selector; + this.length = 1; + return this; + + // HANDLE: $(function) + // Shortcut for document ready + } else if ( isFunction( selector ) ) { + return root.ready !== undefined ? + root.ready( selector ) : + + // Execute immediately if ready is not present + selector( jQuery ); + } + + return jQuery.makeArray( selector, this ); + }; + +// Give the init function the jQuery prototype for later instantiation +init.prototype = jQuery.fn; + +// Initialize central reference +rootjQuery = jQuery( document ); + + +var rparentsprev = /^(?:parents|prev(?:Until|All))/, + + // Methods guaranteed to produce a unique set when starting from a unique set + guaranteedUnique = { + children: true, + contents: true, + next: true, + prev: true + }; + +jQuery.fn.extend( { + has: function( target ) { + var targets = jQuery( target, this ), + l = targets.length; + + return this.filter( function() { + var i = 0; + for ( ; i < l; i++ ) { + if ( jQuery.contains( this, targets[ i ] ) ) { + return true; + } + } + } ); + }, + + closest: function( selectors, context ) { + var cur, + i = 0, + l = this.length, + matched = [], + targets = typeof selectors !== "string" && jQuery( selectors ); + + // Positional selectors never match, since there's no _selection_ context + if ( !rneedsContext.test( selectors ) ) { + for ( ; i < l; i++ ) { + for ( cur = this[ i ]; cur && cur !== context; cur = cur.parentNode ) { + + // Always skip document fragments + if ( cur.nodeType < 11 && ( targets ? + targets.index( cur ) > -1 : + + // Don't pass non-elements to Sizzle + cur.nodeType === 1 && + jQuery.find.matchesSelector( cur, selectors ) ) ) { + + matched.push( cur ); + break; + } + } + } + } + + return this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched ); + }, + + // Determine the position of an element within the set + index: function( elem ) { + + // No argument, return index in parent + if ( !elem ) { + return ( this[ 0 ] && this[ 0 ].parentNode ) ? this.first().prevAll().length : -1; + } + + // Index in selector + if ( typeof elem === "string" ) { + return indexOf.call( jQuery( elem ), this[ 0 ] ); + } + + // Locate the position of the desired element + return indexOf.call( this, + + // If it receives a jQuery object, the first element is used + elem.jquery ? elem[ 0 ] : elem + ); + }, + + add: function( selector, context ) { + return this.pushStack( + jQuery.uniqueSort( + jQuery.merge( this.get(), jQuery( selector, context ) ) + ) + ); + }, + + addBack: function( selector ) { + return this.add( selector == null ? + this.prevObject : this.prevObject.filter( selector ) + ); + } +} ); + +function sibling( cur, dir ) { + while ( ( cur = cur[ dir ] ) && cur.nodeType !== 1 ) {} + return cur; +} + +jQuery.each( { + parent: function( elem ) { + var parent = elem.parentNode; + return parent && parent.nodeType !== 11 ? parent : null; + }, + parents: function( elem ) { + return dir( elem, "parentNode" ); + }, + parentsUntil: function( elem, _i, until ) { + return dir( elem, "parentNode", until ); + }, + next: function( elem ) { + return sibling( elem, "nextSibling" ); + }, + prev: function( elem ) { + return sibling( elem, "previousSibling" ); + }, + nextAll: function( elem ) { + return dir( elem, "nextSibling" ); + }, + prevAll: function( elem ) { + return dir( elem, "previousSibling" ); + }, + nextUntil: function( elem, _i, until ) { + return dir( elem, "nextSibling", until ); + }, + prevUntil: function( elem, _i, until ) { + return dir( elem, "previousSibling", until ); + }, + siblings: function( elem ) { + return siblings( ( elem.parentNode || {} ).firstChild, elem ); + }, + children: function( elem ) { + return siblings( elem.firstChild ); + }, + contents: function( elem ) { + if ( elem.contentDocument != null && + + // Support: IE 11+ + // elements with no `data` attribute has an object + // `contentDocument` with a `null` prototype. + getProto( elem.contentDocument ) ) { + + return elem.contentDocument; + } + + // Support: IE 9 - 11 only, iOS 7 only, Android Browser <=4.3 only + // Treat the template element as a regular one in browsers that + // don't support it. + if ( nodeName( elem, "template" ) ) { + elem = elem.content || elem; + } + + return jQuery.merge( [], elem.childNodes ); + } +}, function( name, fn ) { + jQuery.fn[ name ] = function( until, selector ) { + var matched = jQuery.map( this, fn, until ); + + if ( name.slice( -5 ) !== "Until" ) { + selector = until; + } + + if ( selector && typeof selector === "string" ) { + matched = jQuery.filter( selector, matched ); + } + + if ( this.length > 1 ) { + + // Remove duplicates + if ( !guaranteedUnique[ name ] ) { + jQuery.uniqueSort( matched ); + } + + // Reverse order for parents* and prev-derivatives + if ( rparentsprev.test( name ) ) { + matched.reverse(); + } + } + + return this.pushStack( matched ); + }; +} ); +var rnothtmlwhite = ( /[^\x20\t\r\n\f]+/g ); + + + +// Convert String-formatted options into Object-formatted ones +function createOptions( options ) { + var object = {}; + jQuery.each( options.match( rnothtmlwhite ) || [], function( _, flag ) { + object[ flag ] = true; + } ); + return object; +} + +/* + * Create a callback list using the following parameters: + * + * options: an optional list of space-separated options that will change how + * the callback list behaves or a more traditional option object + * + * By default a callback list will act like an event callback list and can be + * "fired" multiple times. + * + * Possible options: + * + * once: will ensure the callback list can only be fired once (like a Deferred) + * + * memory: will keep track of previous values and will call any callback added + * after the list has been fired right away with the latest "memorized" + * values (like a Deferred) + * + * unique: will ensure a callback can only be added once (no duplicate in the list) + * + * stopOnFalse: interrupt callings when a callback returns false + * + */ +jQuery.Callbacks = function( options ) { + + // Convert options from String-formatted to Object-formatted if needed + // (we check in cache first) + options = typeof options === "string" ? + createOptions( options ) : + jQuery.extend( {}, options ); + + var // Flag to know if list is currently firing + firing, + + // Last fire value for non-forgettable lists + memory, + + // Flag to know if list was already fired + fired, + + // Flag to prevent firing + locked, + + // Actual callback list + list = [], + + // Queue of execution data for repeatable lists + queue = [], + + // Index of currently firing callback (modified by add/remove as needed) + firingIndex = -1, + + // Fire callbacks + fire = function() { + + // Enforce single-firing + locked = locked || options.once; + + // Execute callbacks for all pending executions, + // respecting firingIndex overrides and runtime changes + fired = firing = true; + for ( ; queue.length; firingIndex = -1 ) { + memory = queue.shift(); + while ( ++firingIndex < list.length ) { + + // Run callback and check for early termination + if ( list[ firingIndex ].apply( memory[ 0 ], memory[ 1 ] ) === false && + options.stopOnFalse ) { + + // Jump to end and forget the data so .add doesn't re-fire + firingIndex = list.length; + memory = false; + } + } + } + + // Forget the data if we're done with it + if ( !options.memory ) { + memory = false; + } + + firing = false; + + // Clean up if we're done firing for good + if ( locked ) { + + // Keep an empty list if we have data for future add calls + if ( memory ) { + list = []; + + // Otherwise, this object is spent + } else { + list = ""; + } + } + }, + + // Actual Callbacks object + self = { + + // Add a callback or a collection of callbacks to the list + add: function() { + if ( list ) { + + // If we have memory from a past run, we should fire after adding + if ( memory && !firing ) { + firingIndex = list.length - 1; + queue.push( memory ); + } + + ( function add( args ) { + jQuery.each( args, function( _, arg ) { + if ( isFunction( arg ) ) { + if ( !options.unique || !self.has( arg ) ) { + list.push( arg ); + } + } else if ( arg && arg.length && toType( arg ) !== "string" ) { + + // Inspect recursively + add( arg ); + } + } ); + } )( arguments ); + + if ( memory && !firing ) { + fire(); + } + } + return this; + }, + + // Remove a callback from the list + remove: function() { + jQuery.each( arguments, function( _, arg ) { + var index; + while ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) { + list.splice( index, 1 ); + + // Handle firing indexes + if ( index <= firingIndex ) { + firingIndex--; + } + } + } ); + return this; + }, + + // Check if a given callback is in the list. + // If no argument is given, return whether or not list has callbacks attached. + has: function( fn ) { + return fn ? + jQuery.inArray( fn, list ) > -1 : + list.length > 0; + }, + + // Remove all callbacks from the list + empty: function() { + if ( list ) { + list = []; + } + return this; + }, + + // Disable .fire and .add + // Abort any current/pending executions + // Clear all callbacks and values + disable: function() { + locked = queue = []; + list = memory = ""; + return this; + }, + disabled: function() { + return !list; + }, + + // Disable .fire + // Also disable .add unless we have memory (since it would have no effect) + // Abort any pending executions + lock: function() { + locked = queue = []; + if ( !memory && !firing ) { + list = memory = ""; + } + return this; + }, + locked: function() { + return !!locked; + }, + + // Call all callbacks with the given context and arguments + fireWith: function( context, args ) { + if ( !locked ) { + args = args || []; + args = [ context, args.slice ? args.slice() : args ]; + queue.push( args ); + if ( !firing ) { + fire(); + } + } + return this; + }, + + // Call all the callbacks with the given arguments + fire: function() { + self.fireWith( this, arguments ); + return this; + }, + + // To know if the callbacks have already been called at least once + fired: function() { + return !!fired; + } + }; + + return self; +}; + + +function Identity( v ) { + return v; +} +function Thrower( ex ) { + throw ex; +} + +function adoptValue( value, resolve, reject, noValue ) { + var method; + + try { + + // Check for promise aspect first to privilege synchronous behavior + if ( value && isFunction( ( method = value.promise ) ) ) { + method.call( value ).done( resolve ).fail( reject ); + + // Other thenables + } else if ( value && isFunction( ( method = value.then ) ) ) { + method.call( value, resolve, reject ); + + // Other non-thenables + } else { + + // Control `resolve` arguments by letting Array#slice cast boolean `noValue` to integer: + // * false: [ value ].slice( 0 ) => resolve( value ) + // * true: [ value ].slice( 1 ) => resolve() + resolve.apply( undefined, [ value ].slice( noValue ) ); + } + + // For Promises/A+, convert exceptions into rejections + // Since jQuery.when doesn't unwrap thenables, we can skip the extra checks appearing in + // Deferred#then to conditionally suppress rejection. + } catch ( value ) { + + // Support: Android 4.0 only + // Strict mode functions invoked without .call/.apply get global-object context + reject.apply( undefined, [ value ] ); + } +} + +jQuery.extend( { + + Deferred: function( func ) { + var tuples = [ + + // action, add listener, callbacks, + // ... .then handlers, argument index, [final state] + [ "notify", "progress", jQuery.Callbacks( "memory" ), + jQuery.Callbacks( "memory" ), 2 ], + [ "resolve", "done", jQuery.Callbacks( "once memory" ), + jQuery.Callbacks( "once memory" ), 0, "resolved" ], + [ "reject", "fail", jQuery.Callbacks( "once memory" ), + jQuery.Callbacks( "once memory" ), 1, "rejected" ] + ], + state = "pending", + promise = { + state: function() { + return state; + }, + always: function() { + deferred.done( arguments ).fail( arguments ); + return this; + }, + "catch": function( fn ) { + return promise.then( null, fn ); + }, + + // Keep pipe for back-compat + pipe: function( /* fnDone, fnFail, fnProgress */ ) { + var fns = arguments; + + return jQuery.Deferred( function( newDefer ) { + jQuery.each( tuples, function( _i, tuple ) { + + // Map tuples (progress, done, fail) to arguments (done, fail, progress) + var fn = isFunction( fns[ tuple[ 4 ] ] ) && fns[ tuple[ 4 ] ]; + + // deferred.progress(function() { bind to newDefer or newDefer.notify }) + // deferred.done(function() { bind to newDefer or newDefer.resolve }) + // deferred.fail(function() { bind to newDefer or newDefer.reject }) + deferred[ tuple[ 1 ] ]( function() { + var returned = fn && fn.apply( this, arguments ); + if ( returned && isFunction( returned.promise ) ) { + returned.promise() + .progress( newDefer.notify ) + .done( newDefer.resolve ) + .fail( newDefer.reject ); + } else { + newDefer[ tuple[ 0 ] + "With" ]( + this, + fn ? [ returned ] : arguments + ); + } + } ); + } ); + fns = null; + } ).promise(); + }, + then: function( onFulfilled, onRejected, onProgress ) { + var maxDepth = 0; + function resolve( depth, deferred, handler, special ) { + return function() { + var that = this, + args = arguments, + mightThrow = function() { + var returned, then; + + // Support: Promises/A+ section 2.3.3.3.3 + // https://promisesaplus.com/#point-59 + // Ignore double-resolution attempts + if ( depth < maxDepth ) { + return; + } + + returned = handler.apply( that, args ); + + // Support: Promises/A+ section 2.3.1 + // https://promisesaplus.com/#point-48 + if ( returned === deferred.promise() ) { + throw new TypeError( "Thenable self-resolution" ); + } + + // Support: Promises/A+ sections 2.3.3.1, 3.5 + // https://promisesaplus.com/#point-54 + // https://promisesaplus.com/#point-75 + // Retrieve `then` only once + then = returned && + + // Support: Promises/A+ section 2.3.4 + // https://promisesaplus.com/#point-64 + // Only check objects and functions for thenability + ( typeof returned === "object" || + typeof returned === "function" ) && + returned.then; + + // Handle a returned thenable + if ( isFunction( then ) ) { + + // Special processors (notify) just wait for resolution + if ( special ) { + then.call( + returned, + resolve( maxDepth, deferred, Identity, special ), + resolve( maxDepth, deferred, Thrower, special ) + ); + + // Normal processors (resolve) also hook into progress + } else { + + // ...and disregard older resolution values + maxDepth++; + + then.call( + returned, + resolve( maxDepth, deferred, Identity, special ), + resolve( maxDepth, deferred, Thrower, special ), + resolve( maxDepth, deferred, Identity, + deferred.notifyWith ) + ); + } + + // Handle all other returned values + } else { + + // Only substitute handlers pass on context + // and multiple values (non-spec behavior) + if ( handler !== Identity ) { + that = undefined; + args = [ returned ]; + } + + // Process the value(s) + // Default process is resolve + ( special || deferred.resolveWith )( that, args ); + } + }, + + // Only normal processors (resolve) catch and reject exceptions + process = special ? + mightThrow : + function() { + try { + mightThrow(); + } catch ( e ) { + + if ( jQuery.Deferred.exceptionHook ) { + jQuery.Deferred.exceptionHook( e, + process.stackTrace ); + } + + // Support: Promises/A+ section 2.3.3.3.4.1 + // https://promisesaplus.com/#point-61 + // Ignore post-resolution exceptions + if ( depth + 1 >= maxDepth ) { + + // Only substitute handlers pass on context + // and multiple values (non-spec behavior) + if ( handler !== Thrower ) { + that = undefined; + args = [ e ]; + } + + deferred.rejectWith( that, args ); + } + } + }; + + // Support: Promises/A+ section 2.3.3.3.1 + // https://promisesaplus.com/#point-57 + // Re-resolve promises immediately to dodge false rejection from + // subsequent errors + if ( depth ) { + process(); + } else { + + // Call an optional hook to record the stack, in case of exception + // since it's otherwise lost when execution goes async + if ( jQuery.Deferred.getStackHook ) { + process.stackTrace = jQuery.Deferred.getStackHook(); + } + window.setTimeout( process ); + } + }; + } + + return jQuery.Deferred( function( newDefer ) { + + // progress_handlers.add( ... ) + tuples[ 0 ][ 3 ].add( + resolve( + 0, + newDefer, + isFunction( onProgress ) ? + onProgress : + Identity, + newDefer.notifyWith + ) + ); + + // fulfilled_handlers.add( ... ) + tuples[ 1 ][ 3 ].add( + resolve( + 0, + newDefer, + isFunction( onFulfilled ) ? + onFulfilled : + Identity + ) + ); + + // rejected_handlers.add( ... ) + tuples[ 2 ][ 3 ].add( + resolve( + 0, + newDefer, + isFunction( onRejected ) ? + onRejected : + Thrower + ) + ); + } ).promise(); + }, + + // Get a promise for this deferred + // If obj is provided, the promise aspect is added to the object + promise: function( obj ) { + return obj != null ? jQuery.extend( obj, promise ) : promise; + } + }, + deferred = {}; + + // Add list-specific methods + jQuery.each( tuples, function( i, tuple ) { + var list = tuple[ 2 ], + stateString = tuple[ 5 ]; + + // promise.progress = list.add + // promise.done = list.add + // promise.fail = list.add + promise[ tuple[ 1 ] ] = list.add; + + // Handle state + if ( stateString ) { + list.add( + function() { + + // state = "resolved" (i.e., fulfilled) + // state = "rejected" + state = stateString; + }, + + // rejected_callbacks.disable + // fulfilled_callbacks.disable + tuples[ 3 - i ][ 2 ].disable, + + // rejected_handlers.disable + // fulfilled_handlers.disable + tuples[ 3 - i ][ 3 ].disable, + + // progress_callbacks.lock + tuples[ 0 ][ 2 ].lock, + + // progress_handlers.lock + tuples[ 0 ][ 3 ].lock + ); + } + + // progress_handlers.fire + // fulfilled_handlers.fire + // rejected_handlers.fire + list.add( tuple[ 3 ].fire ); + + // deferred.notify = function() { deferred.notifyWith(...) } + // deferred.resolve = function() { deferred.resolveWith(...) } + // deferred.reject = function() { deferred.rejectWith(...) } + deferred[ tuple[ 0 ] ] = function() { + deferred[ tuple[ 0 ] + "With" ]( this === deferred ? undefined : this, arguments ); + return this; + }; + + // deferred.notifyWith = list.fireWith + // deferred.resolveWith = list.fireWith + // deferred.rejectWith = list.fireWith + deferred[ tuple[ 0 ] + "With" ] = list.fireWith; + } ); + + // Make the deferred a promise + promise.promise( deferred ); + + // Call given func if any + if ( func ) { + func.call( deferred, deferred ); + } + + // All done! + return deferred; + }, + + // Deferred helper + when: function( singleValue ) { + var + + // count of uncompleted subordinates + remaining = arguments.length, + + // count of unprocessed arguments + i = remaining, + + // subordinate fulfillment data + resolveContexts = Array( i ), + resolveValues = slice.call( arguments ), + + // the master Deferred + master = jQuery.Deferred(), + + // subordinate callback factory + updateFunc = function( i ) { + return function( value ) { + resolveContexts[ i ] = this; + resolveValues[ i ] = arguments.length > 1 ? slice.call( arguments ) : value; + if ( !( --remaining ) ) { + master.resolveWith( resolveContexts, resolveValues ); + } + }; + }; + + // Single- and empty arguments are adopted like Promise.resolve + if ( remaining <= 1 ) { + adoptValue( singleValue, master.done( updateFunc( i ) ).resolve, master.reject, + !remaining ); + + // Use .then() to unwrap secondary thenables (cf. gh-3000) + if ( master.state() === "pending" || + isFunction( resolveValues[ i ] && resolveValues[ i ].then ) ) { + + return master.then(); + } + } + + // Multiple arguments are aggregated like Promise.all array elements + while ( i-- ) { + adoptValue( resolveValues[ i ], updateFunc( i ), master.reject ); + } + + return master.promise(); + } +} ); + + +// These usually indicate a programmer mistake during development, +// warn about them ASAP rather than swallowing them by default. +var rerrorNames = /^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/; + +jQuery.Deferred.exceptionHook = function( error, stack ) { + + // Support: IE 8 - 9 only + // Console exists when dev tools are open, which can happen at any time + if ( window.console && window.console.warn && error && rerrorNames.test( error.name ) ) { + window.console.warn( "jQuery.Deferred exception: " + error.message, error.stack, stack ); + } +}; + + + + +jQuery.readyException = function( error ) { + window.setTimeout( function() { + throw error; + } ); +}; + + + + +// The deferred used on DOM ready +var readyList = jQuery.Deferred(); + +jQuery.fn.ready = function( fn ) { + + readyList + .then( fn ) + + // Wrap jQuery.readyException in a function so that the lookup + // happens at the time of error handling instead of callback + // registration. + .catch( function( error ) { + jQuery.readyException( error ); + } ); + + return this; +}; + +jQuery.extend( { + + // Is the DOM ready to be used? Set to true once it occurs. + isReady: false, + + // A counter to track how many items to wait for before + // the ready event fires. See #6781 + readyWait: 1, + + // Handle when the DOM is ready + ready: function( wait ) { + + // Abort if there are pending holds or we're already ready + if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) { + return; + } + + // Remember that the DOM is ready + jQuery.isReady = true; + + // If a normal DOM Ready event fired, decrement, and wait if need be + if ( wait !== true && --jQuery.readyWait > 0 ) { + return; + } + + // If there are functions bound, to execute + readyList.resolveWith( document, [ jQuery ] ); + } +} ); + +jQuery.ready.then = readyList.then; + +// The ready event handler and self cleanup method +function completed() { + document.removeEventListener( "DOMContentLoaded", completed ); + window.removeEventListener( "load", completed ); + jQuery.ready(); +} + +// Catch cases where $(document).ready() is called +// after the browser event has already occurred. +// Support: IE <=9 - 10 only +// Older IE sometimes signals "interactive" too soon +if ( document.readyState === "complete" || + ( document.readyState !== "loading" && !document.documentElement.doScroll ) ) { + + // Handle it asynchronously to allow scripts the opportunity to delay ready + window.setTimeout( jQuery.ready ); + +} else { + + // Use the handy event callback + document.addEventListener( "DOMContentLoaded", completed ); + + // A fallback to window.onload, that will always work + window.addEventListener( "load", completed ); +} + + + + +// Multifunctional method to get and set values of a collection +// The value/s can optionally be executed if it's a function +var access = function( elems, fn, key, value, chainable, emptyGet, raw ) { + var i = 0, + len = elems.length, + bulk = key == null; + + // Sets many values + if ( toType( key ) === "object" ) { + chainable = true; + for ( i in key ) { + access( elems, fn, i, key[ i ], true, emptyGet, raw ); + } + + // Sets one value + } else if ( value !== undefined ) { + chainable = true; + + if ( !isFunction( value ) ) { + raw = true; + } + + if ( bulk ) { + + // Bulk operations run against the entire set + if ( raw ) { + fn.call( elems, value ); + fn = null; + + // ...except when executing function values + } else { + bulk = fn; + fn = function( elem, _key, value ) { + return bulk.call( jQuery( elem ), value ); + }; + } + } + + if ( fn ) { + for ( ; i < len; i++ ) { + fn( + elems[ i ], key, raw ? + value : + value.call( elems[ i ], i, fn( elems[ i ], key ) ) + ); + } + } + } + + if ( chainable ) { + return elems; + } + + // Gets + if ( bulk ) { + return fn.call( elems ); + } + + return len ? fn( elems[ 0 ], key ) : emptyGet; +}; + + +// Matches dashed string for camelizing +var rmsPrefix = /^-ms-/, + rdashAlpha = /-([a-z])/g; + +// Used by camelCase as callback to replace() +function fcamelCase( _all, letter ) { + return letter.toUpperCase(); +} + +// Convert dashed to camelCase; used by the css and data modules +// Support: IE <=9 - 11, Edge 12 - 15 +// Microsoft forgot to hump their vendor prefix (#9572) +function camelCase( string ) { + return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); +} +var acceptData = function( owner ) { + + // Accepts only: + // - Node + // - Node.ELEMENT_NODE + // - Node.DOCUMENT_NODE + // - Object + // - Any + return owner.nodeType === 1 || owner.nodeType === 9 || !( +owner.nodeType ); +}; + + + + +function Data() { + this.expando = jQuery.expando + Data.uid++; +} + +Data.uid = 1; + +Data.prototype = { + + cache: function( owner ) { + + // Check if the owner object already has a cache + var value = owner[ this.expando ]; + + // If not, create one + if ( !value ) { + value = {}; + + // We can accept data for non-element nodes in modern browsers, + // but we should not, see #8335. + // Always return an empty object. + if ( acceptData( owner ) ) { + + // If it is a node unlikely to be stringify-ed or looped over + // use plain assignment + if ( owner.nodeType ) { + owner[ this.expando ] = value; + + // Otherwise secure it in a non-enumerable property + // configurable must be true to allow the property to be + // deleted when data is removed + } else { + Object.defineProperty( owner, this.expando, { + value: value, + configurable: true + } ); + } + } + } + + return value; + }, + set: function( owner, data, value ) { + var prop, + cache = this.cache( owner ); + + // Handle: [ owner, key, value ] args + // Always use camelCase key (gh-2257) + if ( typeof data === "string" ) { + cache[ camelCase( data ) ] = value; + + // Handle: [ owner, { properties } ] args + } else { + + // Copy the properties one-by-one to the cache object + for ( prop in data ) { + cache[ camelCase( prop ) ] = data[ prop ]; + } + } + return cache; + }, + get: function( owner, key ) { + return key === undefined ? + this.cache( owner ) : + + // Always use camelCase key (gh-2257) + owner[ this.expando ] && owner[ this.expando ][ camelCase( key ) ]; + }, + access: function( owner, key, value ) { + + // In cases where either: + // + // 1. No key was specified + // 2. A string key was specified, but no value provided + // + // Take the "read" path and allow the get method to determine + // which value to return, respectively either: + // + // 1. The entire cache object + // 2. The data stored at the key + // + if ( key === undefined || + ( ( key && typeof key === "string" ) && value === undefined ) ) { + + return this.get( owner, key ); + } + + // When the key is not a string, or both a key and value + // are specified, set or extend (existing objects) with either: + // + // 1. An object of properties + // 2. A key and value + // + this.set( owner, key, value ); + + // Since the "set" path can have two possible entry points + // return the expected data based on which path was taken[*] + return value !== undefined ? value : key; + }, + remove: function( owner, key ) { + var i, + cache = owner[ this.expando ]; + + if ( cache === undefined ) { + return; + } + + if ( key !== undefined ) { + + // Support array or space separated string of keys + if ( Array.isArray( key ) ) { + + // If key is an array of keys... + // We always set camelCase keys, so remove that. + key = key.map( camelCase ); + } else { + key = camelCase( key ); + + // If a key with the spaces exists, use it. + // Otherwise, create an array by matching non-whitespace + key = key in cache ? + [ key ] : + ( key.match( rnothtmlwhite ) || [] ); + } + + i = key.length; + + while ( i-- ) { + delete cache[ key[ i ] ]; + } + } + + // Remove the expando if there's no more data + if ( key === undefined || jQuery.isEmptyObject( cache ) ) { + + // Support: Chrome <=35 - 45 + // Webkit & Blink performance suffers when deleting properties + // from DOM nodes, so set to undefined instead + // https://bugs.chromium.org/p/chromium/issues/detail?id=378607 (bug restricted) + if ( owner.nodeType ) { + owner[ this.expando ] = undefined; + } else { + delete owner[ this.expando ]; + } + } + }, + hasData: function( owner ) { + var cache = owner[ this.expando ]; + return cache !== undefined && !jQuery.isEmptyObject( cache ); + } +}; +var dataPriv = new Data(); + +var dataUser = new Data(); + + + +// Implementation Summary +// +// 1. Enforce API surface and semantic compatibility with 1.9.x branch +// 2. Improve the module's maintainability by reducing the storage +// paths to a single mechanism. +// 3. Use the same single mechanism to support "private" and "user" data. +// 4. _Never_ expose "private" data to user code (TODO: Drop _data, _removeData) +// 5. Avoid exposing implementation details on user objects (eg. expando properties) +// 6. Provide a clear path for implementation upgrade to WeakMap in 2014 + +var rbrace = /^(?:\{[\w\W]*\}|\[[\w\W]*\])$/, + rmultiDash = /[A-Z]/g; + +function getData( data ) { + if ( data === "true" ) { + return true; + } + + if ( data === "false" ) { + return false; + } + + if ( data === "null" ) { + return null; + } + + // Only convert to a number if it doesn't change the string + if ( data === +data + "" ) { + return +data; + } + + if ( rbrace.test( data ) ) { + return JSON.parse( data ); + } + + return data; +} + +function dataAttr( elem, key, data ) { + var name; + + // If nothing was found internally, try to fetch any + // data from the HTML5 data-* attribute + if ( data === undefined && elem.nodeType === 1 ) { + name = "data-" + key.replace( rmultiDash, "-$&" ).toLowerCase(); + data = elem.getAttribute( name ); + + if ( typeof data === "string" ) { + try { + data = getData( data ); + } catch ( e ) {} + + // Make sure we set the data so it isn't changed later + dataUser.set( elem, key, data ); + } else { + data = undefined; + } + } + return data; +} + +jQuery.extend( { + hasData: function( elem ) { + return dataUser.hasData( elem ) || dataPriv.hasData( elem ); + }, + + data: function( elem, name, data ) { + return dataUser.access( elem, name, data ); + }, + + removeData: function( elem, name ) { + dataUser.remove( elem, name ); + }, + + // TODO: Now that all calls to _data and _removeData have been replaced + // with direct calls to dataPriv methods, these can be deprecated. + _data: function( elem, name, data ) { + return dataPriv.access( elem, name, data ); + }, + + _removeData: function( elem, name ) { + dataPriv.remove( elem, name ); + } +} ); + +jQuery.fn.extend( { + data: function( key, value ) { + var i, name, data, + elem = this[ 0 ], + attrs = elem && elem.attributes; + + // Gets all values + if ( key === undefined ) { + if ( this.length ) { + data = dataUser.get( elem ); + + if ( elem.nodeType === 1 && !dataPriv.get( elem, "hasDataAttrs" ) ) { + i = attrs.length; + while ( i-- ) { + + // Support: IE 11 only + // The attrs elements can be null (#14894) + if ( attrs[ i ] ) { + name = attrs[ i ].name; + if ( name.indexOf( "data-" ) === 0 ) { + name = camelCase( name.slice( 5 ) ); + dataAttr( elem, name, data[ name ] ); + } + } + } + dataPriv.set( elem, "hasDataAttrs", true ); + } + } + + return data; + } + + // Sets multiple values + if ( typeof key === "object" ) { + return this.each( function() { + dataUser.set( this, key ); + } ); + } + + return access( this, function( value ) { + var data; + + // The calling jQuery object (element matches) is not empty + // (and therefore has an element appears at this[ 0 ]) and the + // `value` parameter was not undefined. An empty jQuery object + // will result in `undefined` for elem = this[ 0 ] which will + // throw an exception if an attempt to read a data cache is made. + if ( elem && value === undefined ) { + + // Attempt to get data from the cache + // The key will always be camelCased in Data + data = dataUser.get( elem, key ); + if ( data !== undefined ) { + return data; + } + + // Attempt to "discover" the data in + // HTML5 custom data-* attrs + data = dataAttr( elem, key ); + if ( data !== undefined ) { + return data; + } + + // We tried really hard, but the data doesn't exist. + return; + } + + // Set the data... + this.each( function() { + + // We always store the camelCased key + dataUser.set( this, key, value ); + } ); + }, null, value, arguments.length > 1, null, true ); + }, + + removeData: function( key ) { + return this.each( function() { + dataUser.remove( this, key ); + } ); + } +} ); + + +jQuery.extend( { + queue: function( elem, type, data ) { + var queue; + + if ( elem ) { + type = ( type || "fx" ) + "queue"; + queue = dataPriv.get( elem, type ); + + // Speed up dequeue by getting out quickly if this is just a lookup + if ( data ) { + if ( !queue || Array.isArray( data ) ) { + queue = dataPriv.access( elem, type, jQuery.makeArray( data ) ); + } else { + queue.push( data ); + } + } + return queue || []; + } + }, + + dequeue: function( elem, type ) { + type = type || "fx"; + + var queue = jQuery.queue( elem, type ), + startLength = queue.length, + fn = queue.shift(), + hooks = jQuery._queueHooks( elem, type ), + next = function() { + jQuery.dequeue( elem, type ); + }; + + // If the fx queue is dequeued, always remove the progress sentinel + if ( fn === "inprogress" ) { + fn = queue.shift(); + startLength--; + } + + if ( fn ) { + + // Add a progress sentinel to prevent the fx queue from being + // automatically dequeued + if ( type === "fx" ) { + queue.unshift( "inprogress" ); + } + + // Clear up the last queue stop function + delete hooks.stop; + fn.call( elem, next, hooks ); + } + + if ( !startLength && hooks ) { + hooks.empty.fire(); + } + }, + + // Not public - generate a queueHooks object, or return the current one + _queueHooks: function( elem, type ) { + var key = type + "queueHooks"; + return dataPriv.get( elem, key ) || dataPriv.access( elem, key, { + empty: jQuery.Callbacks( "once memory" ).add( function() { + dataPriv.remove( elem, [ type + "queue", key ] ); + } ) + } ); + } +} ); + +jQuery.fn.extend( { + queue: function( type, data ) { + var setter = 2; + + if ( typeof type !== "string" ) { + data = type; + type = "fx"; + setter--; + } + + if ( arguments.length < setter ) { + return jQuery.queue( this[ 0 ], type ); + } + + return data === undefined ? + this : + this.each( function() { + var queue = jQuery.queue( this, type, data ); + + // Ensure a hooks for this queue + jQuery._queueHooks( this, type ); + + if ( type === "fx" && queue[ 0 ] !== "inprogress" ) { + jQuery.dequeue( this, type ); + } + } ); + }, + dequeue: function( type ) { + return this.each( function() { + jQuery.dequeue( this, type ); + } ); + }, + clearQueue: function( type ) { + return this.queue( type || "fx", [] ); + }, + + // Get a promise resolved when queues of a certain type + // are emptied (fx is the type by default) + promise: function( type, obj ) { + var tmp, + count = 1, + defer = jQuery.Deferred(), + elements = this, + i = this.length, + resolve = function() { + if ( !( --count ) ) { + defer.resolveWith( elements, [ elements ] ); + } + }; + + if ( typeof type !== "string" ) { + obj = type; + type = undefined; + } + type = type || "fx"; + + while ( i-- ) { + tmp = dataPriv.get( elements[ i ], type + "queueHooks" ); + if ( tmp && tmp.empty ) { + count++; + tmp.empty.add( resolve ); + } + } + resolve(); + return defer.promise( obj ); + } +} ); +var pnum = ( /[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/ ).source; + +var rcssNum = new RegExp( "^(?:([+-])=|)(" + pnum + ")([a-z%]*)$", "i" ); + + +var cssExpand = [ "Top", "Right", "Bottom", "Left" ]; + +var documentElement = document.documentElement; + + + + var isAttached = function( elem ) { + return jQuery.contains( elem.ownerDocument, elem ); + }, + composed = { composed: true }; + + // Support: IE 9 - 11+, Edge 12 - 18+, iOS 10.0 - 10.2 only + // Check attachment across shadow DOM boundaries when possible (gh-3504) + // Support: iOS 10.0-10.2 only + // Early iOS 10 versions support `attachShadow` but not `getRootNode`, + // leading to errors. We need to check for `getRootNode`. + if ( documentElement.getRootNode ) { + isAttached = function( elem ) { + return jQuery.contains( elem.ownerDocument, elem ) || + elem.getRootNode( composed ) === elem.ownerDocument; + }; + } +var isHiddenWithinTree = function( elem, el ) { + + // isHiddenWithinTree might be called from jQuery#filter function; + // in that case, element will be second argument + elem = el || elem; + + // Inline style trumps all + return elem.style.display === "none" || + elem.style.display === "" && + + // Otherwise, check computed style + // Support: Firefox <=43 - 45 + // Disconnected elements can have computed display: none, so first confirm that elem is + // in the document. + isAttached( elem ) && + + jQuery.css( elem, "display" ) === "none"; + }; + + + +function adjustCSS( elem, prop, valueParts, tween ) { + var adjusted, scale, + maxIterations = 20, + currentValue = tween ? + function() { + return tween.cur(); + } : + function() { + return jQuery.css( elem, prop, "" ); + }, + initial = currentValue(), + unit = valueParts && valueParts[ 3 ] || ( jQuery.cssNumber[ prop ] ? "" : "px" ), + + // Starting value computation is required for potential unit mismatches + initialInUnit = elem.nodeType && + ( jQuery.cssNumber[ prop ] || unit !== "px" && +initial ) && + rcssNum.exec( jQuery.css( elem, prop ) ); + + if ( initialInUnit && initialInUnit[ 3 ] !== unit ) { + + // Support: Firefox <=54 + // Halve the iteration target value to prevent interference from CSS upper bounds (gh-2144) + initial = initial / 2; + + // Trust units reported by jQuery.css + unit = unit || initialInUnit[ 3 ]; + + // Iteratively approximate from a nonzero starting point + initialInUnit = +initial || 1; + + while ( maxIterations-- ) { + + // Evaluate and update our best guess (doubling guesses that zero out). + // Finish if the scale equals or crosses 1 (making the old*new product non-positive). + jQuery.style( elem, prop, initialInUnit + unit ); + if ( ( 1 - scale ) * ( 1 - ( scale = currentValue() / initial || 0.5 ) ) <= 0 ) { + maxIterations = 0; + } + initialInUnit = initialInUnit / scale; + + } + + initialInUnit = initialInUnit * 2; + jQuery.style( elem, prop, initialInUnit + unit ); + + // Make sure we update the tween properties later on + valueParts = valueParts || []; + } + + if ( valueParts ) { + initialInUnit = +initialInUnit || +initial || 0; + + // Apply relative offset (+=/-=) if specified + adjusted = valueParts[ 1 ] ? + initialInUnit + ( valueParts[ 1 ] + 1 ) * valueParts[ 2 ] : + +valueParts[ 2 ]; + if ( tween ) { + tween.unit = unit; + tween.start = initialInUnit; + tween.end = adjusted; + } + } + return adjusted; +} + + +var defaultDisplayMap = {}; + +function getDefaultDisplay( elem ) { + var temp, + doc = elem.ownerDocument, + nodeName = elem.nodeName, + display = defaultDisplayMap[ nodeName ]; + + if ( display ) { + return display; + } + + temp = doc.body.appendChild( doc.createElement( nodeName ) ); + display = jQuery.css( temp, "display" ); + + temp.parentNode.removeChild( temp ); + + if ( display === "none" ) { + display = "block"; + } + defaultDisplayMap[ nodeName ] = display; + + return display; +} + +function showHide( elements, show ) { + var display, elem, + values = [], + index = 0, + length = elements.length; + + // Determine new display value for elements that need to change + for ( ; index < length; index++ ) { + elem = elements[ index ]; + if ( !elem.style ) { + continue; + } + + display = elem.style.display; + if ( show ) { + + // Since we force visibility upon cascade-hidden elements, an immediate (and slow) + // check is required in this first loop unless we have a nonempty display value (either + // inline or about-to-be-restored) + if ( display === "none" ) { + values[ index ] = dataPriv.get( elem, "display" ) || null; + if ( !values[ index ] ) { + elem.style.display = ""; + } + } + if ( elem.style.display === "" && isHiddenWithinTree( elem ) ) { + values[ index ] = getDefaultDisplay( elem ); + } + } else { + if ( display !== "none" ) { + values[ index ] = "none"; + + // Remember what we're overwriting + dataPriv.set( elem, "display", display ); + } + } + } + + // Set the display of the elements in a second loop to avoid constant reflow + for ( index = 0; index < length; index++ ) { + if ( values[ index ] != null ) { + elements[ index ].style.display = values[ index ]; + } + } + + return elements; +} + +jQuery.fn.extend( { + show: function() { + return showHide( this, true ); + }, + hide: function() { + return showHide( this ); + }, + toggle: function( state ) { + if ( typeof state === "boolean" ) { + return state ? this.show() : this.hide(); + } + + return this.each( function() { + if ( isHiddenWithinTree( this ) ) { + jQuery( this ).show(); + } else { + jQuery( this ).hide(); + } + } ); + } +} ); +var rcheckableType = ( /^(?:checkbox|radio)$/i ); + +var rtagName = ( /<([a-z][^\/\0>\x20\t\r\n\f]*)/i ); + +var rscriptType = ( /^$|^module$|\/(?:java|ecma)script/i ); + + + +( function() { + var fragment = document.createDocumentFragment(), + div = fragment.appendChild( document.createElement( "div" ) ), + input = document.createElement( "input" ); + + // Support: Android 4.0 - 4.3 only + // Check state lost if the name is set (#11217) + // Support: Windows Web Apps (WWA) + // `name` and `type` must use .setAttribute for WWA (#14901) + input.setAttribute( "type", "radio" ); + input.setAttribute( "checked", "checked" ); + input.setAttribute( "name", "t" ); + + div.appendChild( input ); + + // Support: Android <=4.1 only + // Older WebKit doesn't clone checked state correctly in fragments + support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked; + + // Support: IE <=11 only + // Make sure textarea (and checkbox) defaultValue is properly cloned + div.innerHTML = ""; + support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue; + + // Support: IE <=9 only + // IE <=9 replaces "; + support.option = !!div.lastChild; +} )(); + + +// We have to close these tags to support XHTML (#13200) +var wrapMap = { + + // XHTML parsers do not magically insert elements in the + // same way that tag soup parsers do. So we cannot shorten + // this by omitting or other required elements. + thead: [ 1, "", "
    " ], + col: [ 2, "", "
    " ], + tr: [ 2, "", "
    " ], + td: [ 3, "", "
    " ], + + _default: [ 0, "", "" ] +}; + +wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; +wrapMap.th = wrapMap.td; + +// Support: IE <=9 only +if ( !support.option ) { + wrapMap.optgroup = wrapMap.option = [ 1, "" ]; +} + + +function getAll( context, tag ) { + + // Support: IE <=9 - 11 only + // Use typeof to avoid zero-argument method invocation on host objects (#15151) + var ret; + + if ( typeof context.getElementsByTagName !== "undefined" ) { + ret = context.getElementsByTagName( tag || "*" ); + + } else if ( typeof context.querySelectorAll !== "undefined" ) { + ret = context.querySelectorAll( tag || "*" ); + + } else { + ret = []; + } + + if ( tag === undefined || tag && nodeName( context, tag ) ) { + return jQuery.merge( [ context ], ret ); + } + + return ret; +} + + +// Mark scripts as having already been evaluated +function setGlobalEval( elems, refElements ) { + var i = 0, + l = elems.length; + + for ( ; i < l; i++ ) { + dataPriv.set( + elems[ i ], + "globalEval", + !refElements || dataPriv.get( refElements[ i ], "globalEval" ) + ); + } +} + + +var rhtml = /<|&#?\w+;/; + +function buildFragment( elems, context, scripts, selection, ignored ) { + var elem, tmp, tag, wrap, attached, j, + fragment = context.createDocumentFragment(), + nodes = [], + i = 0, + l = elems.length; + + for ( ; i < l; i++ ) { + elem = elems[ i ]; + + if ( elem || elem === 0 ) { + + // Add nodes directly + if ( toType( elem ) === "object" ) { + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem ); + + // Convert non-html into a text node + } else if ( !rhtml.test( elem ) ) { + nodes.push( context.createTextNode( elem ) ); + + // Convert html into DOM nodes + } else { + tmp = tmp || fragment.appendChild( context.createElement( "div" ) ); + + // Deserialize a standard representation + tag = ( rtagName.exec( elem ) || [ "", "" ] )[ 1 ].toLowerCase(); + wrap = wrapMap[ tag ] || wrapMap._default; + tmp.innerHTML = wrap[ 1 ] + jQuery.htmlPrefilter( elem ) + wrap[ 2 ]; + + // Descend through wrappers to the right content + j = wrap[ 0 ]; + while ( j-- ) { + tmp = tmp.lastChild; + } + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( nodes, tmp.childNodes ); + + // Remember the top-level container + tmp = fragment.firstChild; + + // Ensure the created nodes are orphaned (#12392) + tmp.textContent = ""; + } + } + } + + // Remove wrapper from fragment + fragment.textContent = ""; + + i = 0; + while ( ( elem = nodes[ i++ ] ) ) { + + // Skip elements already in the context collection (trac-4087) + if ( selection && jQuery.inArray( elem, selection ) > -1 ) { + if ( ignored ) { + ignored.push( elem ); + } + continue; + } + + attached = isAttached( elem ); + + // Append to fragment + tmp = getAll( fragment.appendChild( elem ), "script" ); + + // Preserve script evaluation history + if ( attached ) { + setGlobalEval( tmp ); + } + + // Capture executables + if ( scripts ) { + j = 0; + while ( ( elem = tmp[ j++ ] ) ) { + if ( rscriptType.test( elem.type || "" ) ) { + scripts.push( elem ); + } + } + } + } + + return fragment; +} + + +var + rkeyEvent = /^key/, + rmouseEvent = /^(?:mouse|pointer|contextmenu|drag|drop)|click/, + rtypenamespace = /^([^.]*)(?:\.(.+)|)/; + +function returnTrue() { + return true; +} + +function returnFalse() { + return false; +} + +// Support: IE <=9 - 11+ +// focus() and blur() are asynchronous, except when they are no-op. +// So expect focus to be synchronous when the element is already active, +// and blur to be synchronous when the element is not already active. +// (focus and blur are always synchronous in other supported browsers, +// this just defines when we can count on it). +function expectSync( elem, type ) { + return ( elem === safeActiveElement() ) === ( type === "focus" ); +} + +// Support: IE <=9 only +// Accessing document.activeElement can throw unexpectedly +// https://bugs.jquery.com/ticket/13393 +function safeActiveElement() { + try { + return document.activeElement; + } catch ( err ) { } +} + +function on( elem, types, selector, data, fn, one ) { + var origFn, type; + + // Types can be a map of types/handlers + if ( typeof types === "object" ) { + + // ( types-Object, selector, data ) + if ( typeof selector !== "string" ) { + + // ( types-Object, data ) + data = data || selector; + selector = undefined; + } + for ( type in types ) { + on( elem, type, selector, data, types[ type ], one ); + } + return elem; + } + + if ( data == null && fn == null ) { + + // ( types, fn ) + fn = selector; + data = selector = undefined; + } else if ( fn == null ) { + if ( typeof selector === "string" ) { + + // ( types, selector, fn ) + fn = data; + data = undefined; + } else { + + // ( types, data, fn ) + fn = data; + data = selector; + selector = undefined; + } + } + if ( fn === false ) { + fn = returnFalse; + } else if ( !fn ) { + return elem; + } + + if ( one === 1 ) { + origFn = fn; + fn = function( event ) { + + // Can use an empty set, since event contains the info + jQuery().off( event ); + return origFn.apply( this, arguments ); + }; + + // Use same guid so caller can remove using origFn + fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ ); + } + return elem.each( function() { + jQuery.event.add( this, types, fn, data, selector ); + } ); +} + +/* + * Helper functions for managing events -- not part of the public interface. + * Props to Dean Edwards' addEvent library for many of the ideas. + */ +jQuery.event = { + + global: {}, + + add: function( elem, types, handler, data, selector ) { + + var handleObjIn, eventHandle, tmp, + events, t, handleObj, + special, handlers, type, namespaces, origType, + elemData = dataPriv.get( elem ); + + // Only attach events to objects that accept data + if ( !acceptData( elem ) ) { + return; + } + + // Caller can pass in an object of custom data in lieu of the handler + if ( handler.handler ) { + handleObjIn = handler; + handler = handleObjIn.handler; + selector = handleObjIn.selector; + } + + // Ensure that invalid selectors throw exceptions at attach time + // Evaluate against documentElement in case elem is a non-element node (e.g., document) + if ( selector ) { + jQuery.find.matchesSelector( documentElement, selector ); + } + + // Make sure that the handler has a unique ID, used to find/remove it later + if ( !handler.guid ) { + handler.guid = jQuery.guid++; + } + + // Init the element's event structure and main handler, if this is the first + if ( !( events = elemData.events ) ) { + events = elemData.events = Object.create( null ); + } + if ( !( eventHandle = elemData.handle ) ) { + eventHandle = elemData.handle = function( e ) { + + // Discard the second event of a jQuery.event.trigger() and + // when an event is called after a page has unloaded + return typeof jQuery !== "undefined" && jQuery.event.triggered !== e.type ? + jQuery.event.dispatch.apply( elem, arguments ) : undefined; + }; + } + + // Handle multiple events separated by a space + types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[ t ] ) || []; + type = origType = tmp[ 1 ]; + namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); + + // There *must* be a type, no attaching namespace-only handlers + if ( !type ) { + continue; + } + + // If event changes its type, use the special event handlers for the changed type + special = jQuery.event.special[ type ] || {}; + + // If selector defined, determine special event api type, otherwise given type + type = ( selector ? special.delegateType : special.bindType ) || type; + + // Update special based on newly reset type + special = jQuery.event.special[ type ] || {}; + + // handleObj is passed to all event handlers + handleObj = jQuery.extend( { + type: type, + origType: origType, + data: data, + handler: handler, + guid: handler.guid, + selector: selector, + needsContext: selector && jQuery.expr.match.needsContext.test( selector ), + namespace: namespaces.join( "." ) + }, handleObjIn ); + + // Init the event handler queue if we're the first + if ( !( handlers = events[ type ] ) ) { + handlers = events[ type ] = []; + handlers.delegateCount = 0; + + // Only use addEventListener if the special events handler returns false + if ( !special.setup || + special.setup.call( elem, data, namespaces, eventHandle ) === false ) { + + if ( elem.addEventListener ) { + elem.addEventListener( type, eventHandle ); + } + } + } + + if ( special.add ) { + special.add.call( elem, handleObj ); + + if ( !handleObj.handler.guid ) { + handleObj.handler.guid = handler.guid; + } + } + + // Add to the element's handler list, delegates in front + if ( selector ) { + handlers.splice( handlers.delegateCount++, 0, handleObj ); + } else { + handlers.push( handleObj ); + } + + // Keep track of which events have ever been used, for event optimization + jQuery.event.global[ type ] = true; + } + + }, + + // Detach an event or set of events from an element + remove: function( elem, types, handler, selector, mappedTypes ) { + + var j, origCount, tmp, + events, t, handleObj, + special, handlers, type, namespaces, origType, + elemData = dataPriv.hasData( elem ) && dataPriv.get( elem ); + + if ( !elemData || !( events = elemData.events ) ) { + return; + } + + // Once for each type.namespace in types; type may be omitted + types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; + t = types.length; + while ( t-- ) { + tmp = rtypenamespace.exec( types[ t ] ) || []; + type = origType = tmp[ 1 ]; + namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); + + // Unbind all events (on this namespace, if provided) for the element + if ( !type ) { + for ( type in events ) { + jQuery.event.remove( elem, type + types[ t ], handler, selector, true ); + } + continue; + } + + special = jQuery.event.special[ type ] || {}; + type = ( selector ? special.delegateType : special.bindType ) || type; + handlers = events[ type ] || []; + tmp = tmp[ 2 ] && + new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ); + + // Remove matching events + origCount = j = handlers.length; + while ( j-- ) { + handleObj = handlers[ j ]; + + if ( ( mappedTypes || origType === handleObj.origType ) && + ( !handler || handler.guid === handleObj.guid ) && + ( !tmp || tmp.test( handleObj.namespace ) ) && + ( !selector || selector === handleObj.selector || + selector === "**" && handleObj.selector ) ) { + handlers.splice( j, 1 ); + + if ( handleObj.selector ) { + handlers.delegateCount--; + } + if ( special.remove ) { + special.remove.call( elem, handleObj ); + } + } + } + + // Remove generic event handler if we removed something and no more handlers exist + // (avoids potential for endless recursion during removal of special event handlers) + if ( origCount && !handlers.length ) { + if ( !special.teardown || + special.teardown.call( elem, namespaces, elemData.handle ) === false ) { + + jQuery.removeEvent( elem, type, elemData.handle ); + } + + delete events[ type ]; + } + } + + // Remove data and the expando if it's no longer used + if ( jQuery.isEmptyObject( events ) ) { + dataPriv.remove( elem, "handle events" ); + } + }, + + dispatch: function( nativeEvent ) { + + var i, j, ret, matched, handleObj, handlerQueue, + args = new Array( arguments.length ), + + // Make a writable jQuery.Event from the native event object + event = jQuery.event.fix( nativeEvent ), + + handlers = ( + dataPriv.get( this, "events" ) || Object.create( null ) + )[ event.type ] || [], + special = jQuery.event.special[ event.type ] || {}; + + // Use the fix-ed jQuery.Event rather than the (read-only) native event + args[ 0 ] = event; + + for ( i = 1; i < arguments.length; i++ ) { + args[ i ] = arguments[ i ]; + } + + event.delegateTarget = this; + + // Call the preDispatch hook for the mapped type, and let it bail if desired + if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) { + return; + } + + // Determine handlers + handlerQueue = jQuery.event.handlers.call( this, event, handlers ); + + // Run delegates first; they may want to stop propagation beneath us + i = 0; + while ( ( matched = handlerQueue[ i++ ] ) && !event.isPropagationStopped() ) { + event.currentTarget = matched.elem; + + j = 0; + while ( ( handleObj = matched.handlers[ j++ ] ) && + !event.isImmediatePropagationStopped() ) { + + // If the event is namespaced, then each handler is only invoked if it is + // specially universal or its namespaces are a superset of the event's. + if ( !event.rnamespace || handleObj.namespace === false || + event.rnamespace.test( handleObj.namespace ) ) { + + event.handleObj = handleObj; + event.data = handleObj.data; + + ret = ( ( jQuery.event.special[ handleObj.origType ] || {} ).handle || + handleObj.handler ).apply( matched.elem, args ); + + if ( ret !== undefined ) { + if ( ( event.result = ret ) === false ) { + event.preventDefault(); + event.stopPropagation(); + } + } + } + } + } + + // Call the postDispatch hook for the mapped type + if ( special.postDispatch ) { + special.postDispatch.call( this, event ); + } + + return event.result; + }, + + handlers: function( event, handlers ) { + var i, handleObj, sel, matchedHandlers, matchedSelectors, + handlerQueue = [], + delegateCount = handlers.delegateCount, + cur = event.target; + + // Find delegate handlers + if ( delegateCount && + + // Support: IE <=9 + // Black-hole SVG instance trees (trac-13180) + cur.nodeType && + + // Support: Firefox <=42 + // Suppress spec-violating clicks indicating a non-primary pointer button (trac-3861) + // https://www.w3.org/TR/DOM-Level-3-Events/#event-type-click + // Support: IE 11 only + // ...but not arrow key "clicks" of radio inputs, which can have `button` -1 (gh-2343) + !( event.type === "click" && event.button >= 1 ) ) { + + for ( ; cur !== this; cur = cur.parentNode || this ) { + + // Don't check non-elements (#13208) + // Don't process clicks on disabled elements (#6911, #8165, #11382, #11764) + if ( cur.nodeType === 1 && !( event.type === "click" && cur.disabled === true ) ) { + matchedHandlers = []; + matchedSelectors = {}; + for ( i = 0; i < delegateCount; i++ ) { + handleObj = handlers[ i ]; + + // Don't conflict with Object.prototype properties (#13203) + sel = handleObj.selector + " "; + + if ( matchedSelectors[ sel ] === undefined ) { + matchedSelectors[ sel ] = handleObj.needsContext ? + jQuery( sel, this ).index( cur ) > -1 : + jQuery.find( sel, this, null, [ cur ] ).length; + } + if ( matchedSelectors[ sel ] ) { + matchedHandlers.push( handleObj ); + } + } + if ( matchedHandlers.length ) { + handlerQueue.push( { elem: cur, handlers: matchedHandlers } ); + } + } + } + } + + // Add the remaining (directly-bound) handlers + cur = this; + if ( delegateCount < handlers.length ) { + handlerQueue.push( { elem: cur, handlers: handlers.slice( delegateCount ) } ); + } + + return handlerQueue; + }, + + addProp: function( name, hook ) { + Object.defineProperty( jQuery.Event.prototype, name, { + enumerable: true, + configurable: true, + + get: isFunction( hook ) ? + function() { + if ( this.originalEvent ) { + return hook( this.originalEvent ); + } + } : + function() { + if ( this.originalEvent ) { + return this.originalEvent[ name ]; + } + }, + + set: function( value ) { + Object.defineProperty( this, name, { + enumerable: true, + configurable: true, + writable: true, + value: value + } ); + } + } ); + }, + + fix: function( originalEvent ) { + return originalEvent[ jQuery.expando ] ? + originalEvent : + new jQuery.Event( originalEvent ); + }, + + special: { + load: { + + // Prevent triggered image.load events from bubbling to window.load + noBubble: true + }, + click: { + + // Utilize native event to ensure correct state for checkable inputs + setup: function( data ) { + + // For mutual compressibility with _default, replace `this` access with a local var. + // `|| data` is dead code meant only to preserve the variable through minification. + var el = this || data; + + // Claim the first handler + if ( rcheckableType.test( el.type ) && + el.click && nodeName( el, "input" ) ) { + + // dataPriv.set( el, "click", ... ) + leverageNative( el, "click", returnTrue ); + } + + // Return false to allow normal processing in the caller + return false; + }, + trigger: function( data ) { + + // For mutual compressibility with _default, replace `this` access with a local var. + // `|| data` is dead code meant only to preserve the variable through minification. + var el = this || data; + + // Force setup before triggering a click + if ( rcheckableType.test( el.type ) && + el.click && nodeName( el, "input" ) ) { + + leverageNative( el, "click" ); + } + + // Return non-false to allow normal event-path propagation + return true; + }, + + // For cross-browser consistency, suppress native .click() on links + // Also prevent it if we're currently inside a leveraged native-event stack + _default: function( event ) { + var target = event.target; + return rcheckableType.test( target.type ) && + target.click && nodeName( target, "input" ) && + dataPriv.get( target, "click" ) || + nodeName( target, "a" ); + } + }, + + beforeunload: { + postDispatch: function( event ) { + + // Support: Firefox 20+ + // Firefox doesn't alert if the returnValue field is not set. + if ( event.result !== undefined && event.originalEvent ) { + event.originalEvent.returnValue = event.result; + } + } + } + } +}; + +// Ensure the presence of an event listener that handles manually-triggered +// synthetic events by interrupting progress until reinvoked in response to +// *native* events that it fires directly, ensuring that state changes have +// already occurred before other listeners are invoked. +function leverageNative( el, type, expectSync ) { + + // Missing expectSync indicates a trigger call, which must force setup through jQuery.event.add + if ( !expectSync ) { + if ( dataPriv.get( el, type ) === undefined ) { + jQuery.event.add( el, type, returnTrue ); + } + return; + } + + // Register the controller as a special universal handler for all event namespaces + dataPriv.set( el, type, false ); + jQuery.event.add( el, type, { + namespace: false, + handler: function( event ) { + var notAsync, result, + saved = dataPriv.get( this, type ); + + if ( ( event.isTrigger & 1 ) && this[ type ] ) { + + // Interrupt processing of the outer synthetic .trigger()ed event + // Saved data should be false in such cases, but might be a leftover capture object + // from an async native handler (gh-4350) + if ( !saved.length ) { + + // Store arguments for use when handling the inner native event + // There will always be at least one argument (an event object), so this array + // will not be confused with a leftover capture object. + saved = slice.call( arguments ); + dataPriv.set( this, type, saved ); + + // Trigger the native event and capture its result + // Support: IE <=9 - 11+ + // focus() and blur() are asynchronous + notAsync = expectSync( this, type ); + this[ type ](); + result = dataPriv.get( this, type ); + if ( saved !== result || notAsync ) { + dataPriv.set( this, type, false ); + } else { + result = {}; + } + if ( saved !== result ) { + + // Cancel the outer synthetic event + event.stopImmediatePropagation(); + event.preventDefault(); + return result.value; + } + + // If this is an inner synthetic event for an event with a bubbling surrogate + // (focus or blur), assume that the surrogate already propagated from triggering the + // native event and prevent that from happening again here. + // This technically gets the ordering wrong w.r.t. to `.trigger()` (in which the + // bubbling surrogate propagates *after* the non-bubbling base), but that seems + // less bad than duplication. + } else if ( ( jQuery.event.special[ type ] || {} ).delegateType ) { + event.stopPropagation(); + } + + // If this is a native event triggered above, everything is now in order + // Fire an inner synthetic event with the original arguments + } else if ( saved.length ) { + + // ...and capture the result + dataPriv.set( this, type, { + value: jQuery.event.trigger( + + // Support: IE <=9 - 11+ + // Extend with the prototype to reset the above stopImmediatePropagation() + jQuery.extend( saved[ 0 ], jQuery.Event.prototype ), + saved.slice( 1 ), + this + ) + } ); + + // Abort handling of the native event + event.stopImmediatePropagation(); + } + } + } ); +} + +jQuery.removeEvent = function( elem, type, handle ) { + + // This "if" is needed for plain objects + if ( elem.removeEventListener ) { + elem.removeEventListener( type, handle ); + } +}; + +jQuery.Event = function( src, props ) { + + // Allow instantiation without the 'new' keyword + if ( !( this instanceof jQuery.Event ) ) { + return new jQuery.Event( src, props ); + } + + // Event object + if ( src && src.type ) { + this.originalEvent = src; + this.type = src.type; + + // Events bubbling up the document may have been marked as prevented + // by a handler lower down the tree; reflect the correct value. + this.isDefaultPrevented = src.defaultPrevented || + src.defaultPrevented === undefined && + + // Support: Android <=2.3 only + src.returnValue === false ? + returnTrue : + returnFalse; + + // Create target properties + // Support: Safari <=6 - 7 only + // Target should not be a text node (#504, #13143) + this.target = ( src.target && src.target.nodeType === 3 ) ? + src.target.parentNode : + src.target; + + this.currentTarget = src.currentTarget; + this.relatedTarget = src.relatedTarget; + + // Event type + } else { + this.type = src; + } + + // Put explicitly provided properties onto the event object + if ( props ) { + jQuery.extend( this, props ); + } + + // Create a timestamp if incoming event doesn't have one + this.timeStamp = src && src.timeStamp || Date.now(); + + // Mark it as fixed + this[ jQuery.expando ] = true; +}; + +// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding +// https://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html +jQuery.Event.prototype = { + constructor: jQuery.Event, + isDefaultPrevented: returnFalse, + isPropagationStopped: returnFalse, + isImmediatePropagationStopped: returnFalse, + isSimulated: false, + + preventDefault: function() { + var e = this.originalEvent; + + this.isDefaultPrevented = returnTrue; + + if ( e && !this.isSimulated ) { + e.preventDefault(); + } + }, + stopPropagation: function() { + var e = this.originalEvent; + + this.isPropagationStopped = returnTrue; + + if ( e && !this.isSimulated ) { + e.stopPropagation(); + } + }, + stopImmediatePropagation: function() { + var e = this.originalEvent; + + this.isImmediatePropagationStopped = returnTrue; + + if ( e && !this.isSimulated ) { + e.stopImmediatePropagation(); + } + + this.stopPropagation(); + } +}; + +// Includes all common event props including KeyEvent and MouseEvent specific props +jQuery.each( { + altKey: true, + bubbles: true, + cancelable: true, + changedTouches: true, + ctrlKey: true, + detail: true, + eventPhase: true, + metaKey: true, + pageX: true, + pageY: true, + shiftKey: true, + view: true, + "char": true, + code: true, + charCode: true, + key: true, + keyCode: true, + button: true, + buttons: true, + clientX: true, + clientY: true, + offsetX: true, + offsetY: true, + pointerId: true, + pointerType: true, + screenX: true, + screenY: true, + targetTouches: true, + toElement: true, + touches: true, + + which: function( event ) { + var button = event.button; + + // Add which for key events + if ( event.which == null && rkeyEvent.test( event.type ) ) { + return event.charCode != null ? event.charCode : event.keyCode; + } + + // Add which for click: 1 === left; 2 === middle; 3 === right + if ( !event.which && button !== undefined && rmouseEvent.test( event.type ) ) { + if ( button & 1 ) { + return 1; + } + + if ( button & 2 ) { + return 3; + } + + if ( button & 4 ) { + return 2; + } + + return 0; + } + + return event.which; + } +}, jQuery.event.addProp ); + +jQuery.each( { focus: "focusin", blur: "focusout" }, function( type, delegateType ) { + jQuery.event.special[ type ] = { + + // Utilize native event if possible so blur/focus sequence is correct + setup: function() { + + // Claim the first handler + // dataPriv.set( this, "focus", ... ) + // dataPriv.set( this, "blur", ... ) + leverageNative( this, type, expectSync ); + + // Return false to allow normal processing in the caller + return false; + }, + trigger: function() { + + // Force setup before trigger + leverageNative( this, type ); + + // Return non-false to allow normal event-path propagation + return true; + }, + + delegateType: delegateType + }; +} ); + +// Create mouseenter/leave events using mouseover/out and event-time checks +// so that event delegation works in jQuery. +// Do the same for pointerenter/pointerleave and pointerover/pointerout +// +// Support: Safari 7 only +// Safari sends mouseenter too often; see: +// https://bugs.chromium.org/p/chromium/issues/detail?id=470258 +// for the description of the bug (it existed in older Chrome versions as well). +jQuery.each( { + mouseenter: "mouseover", + mouseleave: "mouseout", + pointerenter: "pointerover", + pointerleave: "pointerout" +}, function( orig, fix ) { + jQuery.event.special[ orig ] = { + delegateType: fix, + bindType: fix, + + handle: function( event ) { + var ret, + target = this, + related = event.relatedTarget, + handleObj = event.handleObj; + + // For mouseenter/leave call the handler if related is outside the target. + // NB: No relatedTarget if the mouse left/entered the browser window + if ( !related || ( related !== target && !jQuery.contains( target, related ) ) ) { + event.type = handleObj.origType; + ret = handleObj.handler.apply( this, arguments ); + event.type = fix; + } + return ret; + } + }; +} ); + +jQuery.fn.extend( { + + on: function( types, selector, data, fn ) { + return on( this, types, selector, data, fn ); + }, + one: function( types, selector, data, fn ) { + return on( this, types, selector, data, fn, 1 ); + }, + off: function( types, selector, fn ) { + var handleObj, type; + if ( types && types.preventDefault && types.handleObj ) { + + // ( event ) dispatched jQuery.Event + handleObj = types.handleObj; + jQuery( types.delegateTarget ).off( + handleObj.namespace ? + handleObj.origType + "." + handleObj.namespace : + handleObj.origType, + handleObj.selector, + handleObj.handler + ); + return this; + } + if ( typeof types === "object" ) { + + // ( types-object [, selector] ) + for ( type in types ) { + this.off( type, selector, types[ type ] ); + } + return this; + } + if ( selector === false || typeof selector === "function" ) { + + // ( types [, fn] ) + fn = selector; + selector = undefined; + } + if ( fn === false ) { + fn = returnFalse; + } + return this.each( function() { + jQuery.event.remove( this, types, fn, selector ); + } ); + } +} ); + + +var + + // Support: IE <=10 - 11, Edge 12 - 13 only + // In IE/Edge using regex groups here causes severe slowdowns. + // See https://connect.microsoft.com/IE/feedback/details/1736512/ + rnoInnerhtml = /\s*$/g; + +// Prefer a tbody over its parent table for containing new rows +function manipulationTarget( elem, content ) { + if ( nodeName( elem, "table" ) && + nodeName( content.nodeType !== 11 ? content : content.firstChild, "tr" ) ) { + + return jQuery( elem ).children( "tbody" )[ 0 ] || elem; + } + + return elem; +} + +// Replace/restore the type attribute of script elements for safe DOM manipulation +function disableScript( elem ) { + elem.type = ( elem.getAttribute( "type" ) !== null ) + "/" + elem.type; + return elem; +} +function restoreScript( elem ) { + if ( ( elem.type || "" ).slice( 0, 5 ) === "true/" ) { + elem.type = elem.type.slice( 5 ); + } else { + elem.removeAttribute( "type" ); + } + + return elem; +} + +function cloneCopyEvent( src, dest ) { + var i, l, type, pdataOld, udataOld, udataCur, events; + + if ( dest.nodeType !== 1 ) { + return; + } + + // 1. Copy private data: events, handlers, etc. + if ( dataPriv.hasData( src ) ) { + pdataOld = dataPriv.get( src ); + events = pdataOld.events; + + if ( events ) { + dataPriv.remove( dest, "handle events" ); + + for ( type in events ) { + for ( i = 0, l = events[ type ].length; i < l; i++ ) { + jQuery.event.add( dest, type, events[ type ][ i ] ); + } + } + } + } + + // 2. Copy user data + if ( dataUser.hasData( src ) ) { + udataOld = dataUser.access( src ); + udataCur = jQuery.extend( {}, udataOld ); + + dataUser.set( dest, udataCur ); + } +} + +// Fix IE bugs, see support tests +function fixInput( src, dest ) { + var nodeName = dest.nodeName.toLowerCase(); + + // Fails to persist the checked state of a cloned checkbox or radio button. + if ( nodeName === "input" && rcheckableType.test( src.type ) ) { + dest.checked = src.checked; + + // Fails to return the selected option to the default selected state when cloning options + } else if ( nodeName === "input" || nodeName === "textarea" ) { + dest.defaultValue = src.defaultValue; + } +} + +function domManip( collection, args, callback, ignored ) { + + // Flatten any nested arrays + args = flat( args ); + + var fragment, first, scripts, hasScripts, node, doc, + i = 0, + l = collection.length, + iNoClone = l - 1, + value = args[ 0 ], + valueIsFunction = isFunction( value ); + + // We can't cloneNode fragments that contain checked, in WebKit + if ( valueIsFunction || + ( l > 1 && typeof value === "string" && + !support.checkClone && rchecked.test( value ) ) ) { + return collection.each( function( index ) { + var self = collection.eq( index ); + if ( valueIsFunction ) { + args[ 0 ] = value.call( this, index, self.html() ); + } + domManip( self, args, callback, ignored ); + } ); + } + + if ( l ) { + fragment = buildFragment( args, collection[ 0 ].ownerDocument, false, collection, ignored ); + first = fragment.firstChild; + + if ( fragment.childNodes.length === 1 ) { + fragment = first; + } + + // Require either new content or an interest in ignored elements to invoke the callback + if ( first || ignored ) { + scripts = jQuery.map( getAll( fragment, "script" ), disableScript ); + hasScripts = scripts.length; + + // Use the original fragment for the last item + // instead of the first because it can end up + // being emptied incorrectly in certain situations (#8070). + for ( ; i < l; i++ ) { + node = fragment; + + if ( i !== iNoClone ) { + node = jQuery.clone( node, true, true ); + + // Keep references to cloned scripts for later restoration + if ( hasScripts ) { + + // Support: Android <=4.0 only, PhantomJS 1 only + // push.apply(_, arraylike) throws on ancient WebKit + jQuery.merge( scripts, getAll( node, "script" ) ); + } + } + + callback.call( collection[ i ], node, i ); + } + + if ( hasScripts ) { + doc = scripts[ scripts.length - 1 ].ownerDocument; + + // Reenable scripts + jQuery.map( scripts, restoreScript ); + + // Evaluate executable scripts on first document insertion + for ( i = 0; i < hasScripts; i++ ) { + node = scripts[ i ]; + if ( rscriptType.test( node.type || "" ) && + !dataPriv.access( node, "globalEval" ) && + jQuery.contains( doc, node ) ) { + + if ( node.src && ( node.type || "" ).toLowerCase() !== "module" ) { + + // Optional AJAX dependency, but won't run scripts if not present + if ( jQuery._evalUrl && !node.noModule ) { + jQuery._evalUrl( node.src, { + nonce: node.nonce || node.getAttribute( "nonce" ) + }, doc ); + } + } else { + DOMEval( node.textContent.replace( rcleanScript, "" ), node, doc ); + } + } + } + } + } + } + + return collection; +} + +function remove( elem, selector, keepData ) { + var node, + nodes = selector ? jQuery.filter( selector, elem ) : elem, + i = 0; + + for ( ; ( node = nodes[ i ] ) != null; i++ ) { + if ( !keepData && node.nodeType === 1 ) { + jQuery.cleanData( getAll( node ) ); + } + + if ( node.parentNode ) { + if ( keepData && isAttached( node ) ) { + setGlobalEval( getAll( node, "script" ) ); + } + node.parentNode.removeChild( node ); + } + } + + return elem; +} + +jQuery.extend( { + htmlPrefilter: function( html ) { + return html; + }, + + clone: function( elem, dataAndEvents, deepDataAndEvents ) { + var i, l, srcElements, destElements, + clone = elem.cloneNode( true ), + inPage = isAttached( elem ); + + // Fix IE cloning issues + if ( !support.noCloneChecked && ( elem.nodeType === 1 || elem.nodeType === 11 ) && + !jQuery.isXMLDoc( elem ) ) { + + // We eschew Sizzle here for performance reasons: https://jsperf.com/getall-vs-sizzle/2 + destElements = getAll( clone ); + srcElements = getAll( elem ); + + for ( i = 0, l = srcElements.length; i < l; i++ ) { + fixInput( srcElements[ i ], destElements[ i ] ); + } + } + + // Copy the events from the original to the clone + if ( dataAndEvents ) { + if ( deepDataAndEvents ) { + srcElements = srcElements || getAll( elem ); + destElements = destElements || getAll( clone ); + + for ( i = 0, l = srcElements.length; i < l; i++ ) { + cloneCopyEvent( srcElements[ i ], destElements[ i ] ); + } + } else { + cloneCopyEvent( elem, clone ); + } + } + + // Preserve script evaluation history + destElements = getAll( clone, "script" ); + if ( destElements.length > 0 ) { + setGlobalEval( destElements, !inPage && getAll( elem, "script" ) ); + } + + // Return the cloned set + return clone; + }, + + cleanData: function( elems ) { + var data, elem, type, + special = jQuery.event.special, + i = 0; + + for ( ; ( elem = elems[ i ] ) !== undefined; i++ ) { + if ( acceptData( elem ) ) { + if ( ( data = elem[ dataPriv.expando ] ) ) { + if ( data.events ) { + for ( type in data.events ) { + if ( special[ type ] ) { + jQuery.event.remove( elem, type ); + + // This is a shortcut to avoid jQuery.event.remove's overhead + } else { + jQuery.removeEvent( elem, type, data.handle ); + } + } + } + + // Support: Chrome <=35 - 45+ + // Assign undefined instead of using delete, see Data#remove + elem[ dataPriv.expando ] = undefined; + } + if ( elem[ dataUser.expando ] ) { + + // Support: Chrome <=35 - 45+ + // Assign undefined instead of using delete, see Data#remove + elem[ dataUser.expando ] = undefined; + } + } + } + } +} ); + +jQuery.fn.extend( { + detach: function( selector ) { + return remove( this, selector, true ); + }, + + remove: function( selector ) { + return remove( this, selector ); + }, + + text: function( value ) { + return access( this, function( value ) { + return value === undefined ? + jQuery.text( this ) : + this.empty().each( function() { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + this.textContent = value; + } + } ); + }, null, value, arguments.length ); + }, + + append: function() { + return domManip( this, arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.appendChild( elem ); + } + } ); + }, + + prepend: function() { + return domManip( this, arguments, function( elem ) { + if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { + var target = manipulationTarget( this, elem ); + target.insertBefore( elem, target.firstChild ); + } + } ); + }, + + before: function() { + return domManip( this, arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this ); + } + } ); + }, + + after: function() { + return domManip( this, arguments, function( elem ) { + if ( this.parentNode ) { + this.parentNode.insertBefore( elem, this.nextSibling ); + } + } ); + }, + + empty: function() { + var elem, + i = 0; + + for ( ; ( elem = this[ i ] ) != null; i++ ) { + if ( elem.nodeType === 1 ) { + + // Prevent memory leaks + jQuery.cleanData( getAll( elem, false ) ); + + // Remove any remaining nodes + elem.textContent = ""; + } + } + + return this; + }, + + clone: function( dataAndEvents, deepDataAndEvents ) { + dataAndEvents = dataAndEvents == null ? false : dataAndEvents; + deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents; + + return this.map( function() { + return jQuery.clone( this, dataAndEvents, deepDataAndEvents ); + } ); + }, + + html: function( value ) { + return access( this, function( value ) { + var elem = this[ 0 ] || {}, + i = 0, + l = this.length; + + if ( value === undefined && elem.nodeType === 1 ) { + return elem.innerHTML; + } + + // See if we can take a shortcut and just use innerHTML + if ( typeof value === "string" && !rnoInnerhtml.test( value ) && + !wrapMap[ ( rtagName.exec( value ) || [ "", "" ] )[ 1 ].toLowerCase() ] ) { + + value = jQuery.htmlPrefilter( value ); + + try { + for ( ; i < l; i++ ) { + elem = this[ i ] || {}; + + // Remove element nodes and prevent memory leaks + if ( elem.nodeType === 1 ) { + jQuery.cleanData( getAll( elem, false ) ); + elem.innerHTML = value; + } + } + + elem = 0; + + // If using innerHTML throws an exception, use the fallback method + } catch ( e ) {} + } + + if ( elem ) { + this.empty().append( value ); + } + }, null, value, arguments.length ); + }, + + replaceWith: function() { + var ignored = []; + + // Make the changes, replacing each non-ignored context element with the new content + return domManip( this, arguments, function( elem ) { + var parent = this.parentNode; + + if ( jQuery.inArray( this, ignored ) < 0 ) { + jQuery.cleanData( getAll( this ) ); + if ( parent ) { + parent.replaceChild( elem, this ); + } + } + + // Force callback invocation + }, ignored ); + } +} ); + +jQuery.each( { + appendTo: "append", + prependTo: "prepend", + insertBefore: "before", + insertAfter: "after", + replaceAll: "replaceWith" +}, function( name, original ) { + jQuery.fn[ name ] = function( selector ) { + var elems, + ret = [], + insert = jQuery( selector ), + last = insert.length - 1, + i = 0; + + for ( ; i <= last; i++ ) { + elems = i === last ? this : this.clone( true ); + jQuery( insert[ i ] )[ original ]( elems ); + + // Support: Android <=4.0 only, PhantomJS 1 only + // .get() because push.apply(_, arraylike) throws on ancient WebKit + push.apply( ret, elems.get() ); + } + + return this.pushStack( ret ); + }; +} ); +var rnumnonpx = new RegExp( "^(" + pnum + ")(?!px)[a-z%]+$", "i" ); + +var getStyles = function( elem ) { + + // Support: IE <=11 only, Firefox <=30 (#15098, #14150) + // IE throws on elements created in popups + // FF meanwhile throws on frame elements through "defaultView.getComputedStyle" + var view = elem.ownerDocument.defaultView; + + if ( !view || !view.opener ) { + view = window; + } + + return view.getComputedStyle( elem ); + }; + +var swap = function( elem, options, callback ) { + var ret, name, + old = {}; + + // Remember the old values, and insert the new ones + for ( name in options ) { + old[ name ] = elem.style[ name ]; + elem.style[ name ] = options[ name ]; + } + + ret = callback.call( elem ); + + // Revert the old values + for ( name in options ) { + elem.style[ name ] = old[ name ]; + } + + return ret; +}; + + +var rboxStyle = new RegExp( cssExpand.join( "|" ), "i" ); + + + +( function() { + + // Executing both pixelPosition & boxSizingReliable tests require only one layout + // so they're executed at the same time to save the second computation. + function computeStyleTests() { + + // This is a singleton, we need to execute it only once + if ( !div ) { + return; + } + + container.style.cssText = "position:absolute;left:-11111px;width:60px;" + + "margin-top:1px;padding:0;border:0"; + div.style.cssText = + "position:relative;display:block;box-sizing:border-box;overflow:scroll;" + + "margin:auto;border:1px;padding:1px;" + + "width:60%;top:1%"; + documentElement.appendChild( container ).appendChild( div ); + + var divStyle = window.getComputedStyle( div ); + pixelPositionVal = divStyle.top !== "1%"; + + // Support: Android 4.0 - 4.3 only, Firefox <=3 - 44 + reliableMarginLeftVal = roundPixelMeasures( divStyle.marginLeft ) === 12; + + // Support: Android 4.0 - 4.3 only, Safari <=9.1 - 10.1, iOS <=7.0 - 9.3 + // Some styles come back with percentage values, even though they shouldn't + div.style.right = "60%"; + pixelBoxStylesVal = roundPixelMeasures( divStyle.right ) === 36; + + // Support: IE 9 - 11 only + // Detect misreporting of content dimensions for box-sizing:border-box elements + boxSizingReliableVal = roundPixelMeasures( divStyle.width ) === 36; + + // Support: IE 9 only + // Detect overflow:scroll screwiness (gh-3699) + // Support: Chrome <=64 + // Don't get tricked when zoom affects offsetWidth (gh-4029) + div.style.position = "absolute"; + scrollboxSizeVal = roundPixelMeasures( div.offsetWidth / 3 ) === 12; + + documentElement.removeChild( container ); + + // Nullify the div so it wouldn't be stored in the memory and + // it will also be a sign that checks already performed + div = null; + } + + function roundPixelMeasures( measure ) { + return Math.round( parseFloat( measure ) ); + } + + var pixelPositionVal, boxSizingReliableVal, scrollboxSizeVal, pixelBoxStylesVal, + reliableTrDimensionsVal, reliableMarginLeftVal, + container = document.createElement( "div" ), + div = document.createElement( "div" ); + + // Finish early in limited (non-browser) environments + if ( !div.style ) { + return; + } + + // Support: IE <=9 - 11 only + // Style of cloned element affects source element cloned (#8908) + div.style.backgroundClip = "content-box"; + div.cloneNode( true ).style.backgroundClip = ""; + support.clearCloneStyle = div.style.backgroundClip === "content-box"; + + jQuery.extend( support, { + boxSizingReliable: function() { + computeStyleTests(); + return boxSizingReliableVal; + }, + pixelBoxStyles: function() { + computeStyleTests(); + return pixelBoxStylesVal; + }, + pixelPosition: function() { + computeStyleTests(); + return pixelPositionVal; + }, + reliableMarginLeft: function() { + computeStyleTests(); + return reliableMarginLeftVal; + }, + scrollboxSize: function() { + computeStyleTests(); + return scrollboxSizeVal; + }, + + // Support: IE 9 - 11+, Edge 15 - 18+ + // IE/Edge misreport `getComputedStyle` of table rows with width/height + // set in CSS while `offset*` properties report correct values. + // Behavior in IE 9 is more subtle than in newer versions & it passes + // some versions of this test; make sure not to make it pass there! + reliableTrDimensions: function() { + var table, tr, trChild, trStyle; + if ( reliableTrDimensionsVal == null ) { + table = document.createElement( "table" ); + tr = document.createElement( "tr" ); + trChild = document.createElement( "div" ); + + table.style.cssText = "position:absolute;left:-11111px"; + tr.style.height = "1px"; + trChild.style.height = "9px"; + + documentElement + .appendChild( table ) + .appendChild( tr ) + .appendChild( trChild ); + + trStyle = window.getComputedStyle( tr ); + reliableTrDimensionsVal = parseInt( trStyle.height ) > 3; + + documentElement.removeChild( table ); + } + return reliableTrDimensionsVal; + } + } ); +} )(); + + +function curCSS( elem, name, computed ) { + var width, minWidth, maxWidth, ret, + + // Support: Firefox 51+ + // Retrieving style before computed somehow + // fixes an issue with getting wrong values + // on detached elements + style = elem.style; + + computed = computed || getStyles( elem ); + + // getPropertyValue is needed for: + // .css('filter') (IE 9 only, #12537) + // .css('--customProperty) (#3144) + if ( computed ) { + ret = computed.getPropertyValue( name ) || computed[ name ]; + + if ( ret === "" && !isAttached( elem ) ) { + ret = jQuery.style( elem, name ); + } + + // A tribute to the "awesome hack by Dean Edwards" + // Android Browser returns percentage for some values, + // but width seems to be reliably pixels. + // This is against the CSSOM draft spec: + // https://drafts.csswg.org/cssom/#resolved-values + if ( !support.pixelBoxStyles() && rnumnonpx.test( ret ) && rboxStyle.test( name ) ) { + + // Remember the original values + width = style.width; + minWidth = style.minWidth; + maxWidth = style.maxWidth; + + // Put in the new values to get a computed value out + style.minWidth = style.maxWidth = style.width = ret; + ret = computed.width; + + // Revert the changed values + style.width = width; + style.minWidth = minWidth; + style.maxWidth = maxWidth; + } + } + + return ret !== undefined ? + + // Support: IE <=9 - 11 only + // IE returns zIndex value as an integer. + ret + "" : + ret; +} + + +function addGetHookIf( conditionFn, hookFn ) { + + // Define the hook, we'll check on the first run if it's really needed. + return { + get: function() { + if ( conditionFn() ) { + + // Hook not needed (or it's not possible to use it due + // to missing dependency), remove it. + delete this.get; + return; + } + + // Hook needed; redefine it so that the support test is not executed again. + return ( this.get = hookFn ).apply( this, arguments ); + } + }; +} + + +var cssPrefixes = [ "Webkit", "Moz", "ms" ], + emptyStyle = document.createElement( "div" ).style, + vendorProps = {}; + +// Return a vendor-prefixed property or undefined +function vendorPropName( name ) { + + // Check for vendor prefixed names + var capName = name[ 0 ].toUpperCase() + name.slice( 1 ), + i = cssPrefixes.length; + + while ( i-- ) { + name = cssPrefixes[ i ] + capName; + if ( name in emptyStyle ) { + return name; + } + } +} + +// Return a potentially-mapped jQuery.cssProps or vendor prefixed property +function finalPropName( name ) { + var final = jQuery.cssProps[ name ] || vendorProps[ name ]; + + if ( final ) { + return final; + } + if ( name in emptyStyle ) { + return name; + } + return vendorProps[ name ] = vendorPropName( name ) || name; +} + + +var + + // Swappable if display is none or starts with table + // except "table", "table-cell", or "table-caption" + // See here for display values: https://developer.mozilla.org/en-US/docs/CSS/display + rdisplayswap = /^(none|table(?!-c[ea]).+)/, + rcustomProp = /^--/, + cssShow = { position: "absolute", visibility: "hidden", display: "block" }, + cssNormalTransform = { + letterSpacing: "0", + fontWeight: "400" + }; + +function setPositiveNumber( _elem, value, subtract ) { + + // Any relative (+/-) values have already been + // normalized at this point + var matches = rcssNum.exec( value ); + return matches ? + + // Guard against undefined "subtract", e.g., when used as in cssHooks + Math.max( 0, matches[ 2 ] - ( subtract || 0 ) ) + ( matches[ 3 ] || "px" ) : + value; +} + +function boxModelAdjustment( elem, dimension, box, isBorderBox, styles, computedVal ) { + var i = dimension === "width" ? 1 : 0, + extra = 0, + delta = 0; + + // Adjustment may not be necessary + if ( box === ( isBorderBox ? "border" : "content" ) ) { + return 0; + } + + for ( ; i < 4; i += 2 ) { + + // Both box models exclude margin + if ( box === "margin" ) { + delta += jQuery.css( elem, box + cssExpand[ i ], true, styles ); + } + + // If we get here with a content-box, we're seeking "padding" or "border" or "margin" + if ( !isBorderBox ) { + + // Add padding + delta += jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); + + // For "border" or "margin", add border + if ( box !== "padding" ) { + delta += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + + // But still keep track of it otherwise + } else { + extra += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + } + + // If we get here with a border-box (content + padding + border), we're seeking "content" or + // "padding" or "margin" + } else { + + // For "content", subtract padding + if ( box === "content" ) { + delta -= jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); + } + + // For "content" or "padding", subtract border + if ( box !== "margin" ) { + delta -= jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); + } + } + } + + // Account for positive content-box scroll gutter when requested by providing computedVal + if ( !isBorderBox && computedVal >= 0 ) { + + // offsetWidth/offsetHeight is a rounded sum of content, padding, scroll gutter, and border + // Assuming integer scroll gutter, subtract the rest and round down + delta += Math.max( 0, Math.ceil( + elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - + computedVal - + delta - + extra - + 0.5 + + // If offsetWidth/offsetHeight is unknown, then we can't determine content-box scroll gutter + // Use an explicit zero to avoid NaN (gh-3964) + ) ) || 0; + } + + return delta; +} + +function getWidthOrHeight( elem, dimension, extra ) { + + // Start with computed style + var styles = getStyles( elem ), + + // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-4322). + // Fake content-box until we know it's needed to know the true value. + boxSizingNeeded = !support.boxSizingReliable() || extra, + isBorderBox = boxSizingNeeded && + jQuery.css( elem, "boxSizing", false, styles ) === "border-box", + valueIsBorderBox = isBorderBox, + + val = curCSS( elem, dimension, styles ), + offsetProp = "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ); + + // Support: Firefox <=54 + // Return a confounding non-pixel value or feign ignorance, as appropriate. + if ( rnumnonpx.test( val ) ) { + if ( !extra ) { + return val; + } + val = "auto"; + } + + + // Support: IE 9 - 11 only + // Use offsetWidth/offsetHeight for when box sizing is unreliable. + // In those cases, the computed value can be trusted to be border-box. + if ( ( !support.boxSizingReliable() && isBorderBox || + + // Support: IE 10 - 11+, Edge 15 - 18+ + // IE/Edge misreport `getComputedStyle` of table rows with width/height + // set in CSS while `offset*` properties report correct values. + // Interestingly, in some cases IE 9 doesn't suffer from this issue. + !support.reliableTrDimensions() && nodeName( elem, "tr" ) || + + // Fall back to offsetWidth/offsetHeight when value is "auto" + // This happens for inline elements with no explicit setting (gh-3571) + val === "auto" || + + // Support: Android <=4.1 - 4.3 only + // Also use offsetWidth/offsetHeight for misreported inline dimensions (gh-3602) + !parseFloat( val ) && jQuery.css( elem, "display", false, styles ) === "inline" ) && + + // Make sure the element is visible & connected + elem.getClientRects().length ) { + + isBorderBox = jQuery.css( elem, "boxSizing", false, styles ) === "border-box"; + + // Where available, offsetWidth/offsetHeight approximate border box dimensions. + // Where not available (e.g., SVG), assume unreliable box-sizing and interpret the + // retrieved value as a content box dimension. + valueIsBorderBox = offsetProp in elem; + if ( valueIsBorderBox ) { + val = elem[ offsetProp ]; + } + } + + // Normalize "" and auto + val = parseFloat( val ) || 0; + + // Adjust for the element's box model + return ( val + + boxModelAdjustment( + elem, + dimension, + extra || ( isBorderBox ? "border" : "content" ), + valueIsBorderBox, + styles, + + // Provide the current computed size to request scroll gutter calculation (gh-3589) + val + ) + ) + "px"; +} + +jQuery.extend( { + + // Add in style property hooks for overriding the default + // behavior of getting and setting a style property + cssHooks: { + opacity: { + get: function( elem, computed ) { + if ( computed ) { + + // We should always get a number back from opacity + var ret = curCSS( elem, "opacity" ); + return ret === "" ? "1" : ret; + } + } + } + }, + + // Don't automatically add "px" to these possibly-unitless properties + cssNumber: { + "animationIterationCount": true, + "columnCount": true, + "fillOpacity": true, + "flexGrow": true, + "flexShrink": true, + "fontWeight": true, + "gridArea": true, + "gridColumn": true, + "gridColumnEnd": true, + "gridColumnStart": true, + "gridRow": true, + "gridRowEnd": true, + "gridRowStart": true, + "lineHeight": true, + "opacity": true, + "order": true, + "orphans": true, + "widows": true, + "zIndex": true, + "zoom": true + }, + + // Add in properties whose names you wish to fix before + // setting or getting the value + cssProps: {}, + + // Get and set the style property on a DOM Node + style: function( elem, name, value, extra ) { + + // Don't set styles on text and comment nodes + if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) { + return; + } + + // Make sure that we're working with the right name + var ret, type, hooks, + origName = camelCase( name ), + isCustomProp = rcustomProp.test( name ), + style = elem.style; + + // Make sure that we're working with the right name. We don't + // want to query the value if it is a CSS custom property + // since they are user-defined. + if ( !isCustomProp ) { + name = finalPropName( origName ); + } + + // Gets hook for the prefixed version, then unprefixed version + hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; + + // Check if we're setting a value + if ( value !== undefined ) { + type = typeof value; + + // Convert "+=" or "-=" to relative numbers (#7345) + if ( type === "string" && ( ret = rcssNum.exec( value ) ) && ret[ 1 ] ) { + value = adjustCSS( elem, name, ret ); + + // Fixes bug #9237 + type = "number"; + } + + // Make sure that null and NaN values aren't set (#7116) + if ( value == null || value !== value ) { + return; + } + + // If a number was passed in, add the unit (except for certain CSS properties) + // The isCustomProp check can be removed in jQuery 4.0 when we only auto-append + // "px" to a few hardcoded values. + if ( type === "number" && !isCustomProp ) { + value += ret && ret[ 3 ] || ( jQuery.cssNumber[ origName ] ? "" : "px" ); + } + + // background-* props affect original clone's values + if ( !support.clearCloneStyle && value === "" && name.indexOf( "background" ) === 0 ) { + style[ name ] = "inherit"; + } + + // If a hook was provided, use that value, otherwise just set the specified value + if ( !hooks || !( "set" in hooks ) || + ( value = hooks.set( elem, value, extra ) ) !== undefined ) { + + if ( isCustomProp ) { + style.setProperty( name, value ); + } else { + style[ name ] = value; + } + } + + } else { + + // If a hook was provided get the non-computed value from there + if ( hooks && "get" in hooks && + ( ret = hooks.get( elem, false, extra ) ) !== undefined ) { + + return ret; + } + + // Otherwise just get the value from the style object + return style[ name ]; + } + }, + + css: function( elem, name, extra, styles ) { + var val, num, hooks, + origName = camelCase( name ), + isCustomProp = rcustomProp.test( name ); + + // Make sure that we're working with the right name. We don't + // want to modify the value if it is a CSS custom property + // since they are user-defined. + if ( !isCustomProp ) { + name = finalPropName( origName ); + } + + // Try prefixed name followed by the unprefixed name + hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; + + // If a hook was provided get the computed value from there + if ( hooks && "get" in hooks ) { + val = hooks.get( elem, true, extra ); + } + + // Otherwise, if a way to get the computed value exists, use that + if ( val === undefined ) { + val = curCSS( elem, name, styles ); + } + + // Convert "normal" to computed value + if ( val === "normal" && name in cssNormalTransform ) { + val = cssNormalTransform[ name ]; + } + + // Make numeric if forced or a qualifier was provided and val looks numeric + if ( extra === "" || extra ) { + num = parseFloat( val ); + return extra === true || isFinite( num ) ? num || 0 : val; + } + + return val; + } +} ); + +jQuery.each( [ "height", "width" ], function( _i, dimension ) { + jQuery.cssHooks[ dimension ] = { + get: function( elem, computed, extra ) { + if ( computed ) { + + // Certain elements can have dimension info if we invisibly show them + // but it must have a current display style that would benefit + return rdisplayswap.test( jQuery.css( elem, "display" ) ) && + + // Support: Safari 8+ + // Table columns in Safari have non-zero offsetWidth & zero + // getBoundingClientRect().width unless display is changed. + // Support: IE <=11 only + // Running getBoundingClientRect on a disconnected node + // in IE throws an error. + ( !elem.getClientRects().length || !elem.getBoundingClientRect().width ) ? + swap( elem, cssShow, function() { + return getWidthOrHeight( elem, dimension, extra ); + } ) : + getWidthOrHeight( elem, dimension, extra ); + } + }, + + set: function( elem, value, extra ) { + var matches, + styles = getStyles( elem ), + + // Only read styles.position if the test has a chance to fail + // to avoid forcing a reflow. + scrollboxSizeBuggy = !support.scrollboxSize() && + styles.position === "absolute", + + // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-3991) + boxSizingNeeded = scrollboxSizeBuggy || extra, + isBorderBox = boxSizingNeeded && + jQuery.css( elem, "boxSizing", false, styles ) === "border-box", + subtract = extra ? + boxModelAdjustment( + elem, + dimension, + extra, + isBorderBox, + styles + ) : + 0; + + // Account for unreliable border-box dimensions by comparing offset* to computed and + // faking a content-box to get border and padding (gh-3699) + if ( isBorderBox && scrollboxSizeBuggy ) { + subtract -= Math.ceil( + elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - + parseFloat( styles[ dimension ] ) - + boxModelAdjustment( elem, dimension, "border", false, styles ) - + 0.5 + ); + } + + // Convert to pixels if value adjustment is needed + if ( subtract && ( matches = rcssNum.exec( value ) ) && + ( matches[ 3 ] || "px" ) !== "px" ) { + + elem.style[ dimension ] = value; + value = jQuery.css( elem, dimension ); + } + + return setPositiveNumber( elem, value, subtract ); + } + }; +} ); + +jQuery.cssHooks.marginLeft = addGetHookIf( support.reliableMarginLeft, + function( elem, computed ) { + if ( computed ) { + return ( parseFloat( curCSS( elem, "marginLeft" ) ) || + elem.getBoundingClientRect().left - + swap( elem, { marginLeft: 0 }, function() { + return elem.getBoundingClientRect().left; + } ) + ) + "px"; + } + } +); + +// These hooks are used by animate to expand properties +jQuery.each( { + margin: "", + padding: "", + border: "Width" +}, function( prefix, suffix ) { + jQuery.cssHooks[ prefix + suffix ] = { + expand: function( value ) { + var i = 0, + expanded = {}, + + // Assumes a single number if not a string + parts = typeof value === "string" ? value.split( " " ) : [ value ]; + + for ( ; i < 4; i++ ) { + expanded[ prefix + cssExpand[ i ] + suffix ] = + parts[ i ] || parts[ i - 2 ] || parts[ 0 ]; + } + + return expanded; + } + }; + + if ( prefix !== "margin" ) { + jQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber; + } +} ); + +jQuery.fn.extend( { + css: function( name, value ) { + return access( this, function( elem, name, value ) { + var styles, len, + map = {}, + i = 0; + + if ( Array.isArray( name ) ) { + styles = getStyles( elem ); + len = name.length; + + for ( ; i < len; i++ ) { + map[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles ); + } + + return map; + } + + return value !== undefined ? + jQuery.style( elem, name, value ) : + jQuery.css( elem, name ); + }, name, value, arguments.length > 1 ); + } +} ); + + +function Tween( elem, options, prop, end, easing ) { + return new Tween.prototype.init( elem, options, prop, end, easing ); +} +jQuery.Tween = Tween; + +Tween.prototype = { + constructor: Tween, + init: function( elem, options, prop, end, easing, unit ) { + this.elem = elem; + this.prop = prop; + this.easing = easing || jQuery.easing._default; + this.options = options; + this.start = this.now = this.cur(); + this.end = end; + this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" ); + }, + cur: function() { + var hooks = Tween.propHooks[ this.prop ]; + + return hooks && hooks.get ? + hooks.get( this ) : + Tween.propHooks._default.get( this ); + }, + run: function( percent ) { + var eased, + hooks = Tween.propHooks[ this.prop ]; + + if ( this.options.duration ) { + this.pos = eased = jQuery.easing[ this.easing ]( + percent, this.options.duration * percent, 0, 1, this.options.duration + ); + } else { + this.pos = eased = percent; + } + this.now = ( this.end - this.start ) * eased + this.start; + + if ( this.options.step ) { + this.options.step.call( this.elem, this.now, this ); + } + + if ( hooks && hooks.set ) { + hooks.set( this ); + } else { + Tween.propHooks._default.set( this ); + } + return this; + } +}; + +Tween.prototype.init.prototype = Tween.prototype; + +Tween.propHooks = { + _default: { + get: function( tween ) { + var result; + + // Use a property on the element directly when it is not a DOM element, + // or when there is no matching style property that exists. + if ( tween.elem.nodeType !== 1 || + tween.elem[ tween.prop ] != null && tween.elem.style[ tween.prop ] == null ) { + return tween.elem[ tween.prop ]; + } + + // Passing an empty string as a 3rd parameter to .css will automatically + // attempt a parseFloat and fallback to a string if the parse fails. + // Simple values such as "10px" are parsed to Float; + // complex values such as "rotate(1rad)" are returned as-is. + result = jQuery.css( tween.elem, tween.prop, "" ); + + // Empty strings, null, undefined and "auto" are converted to 0. + return !result || result === "auto" ? 0 : result; + }, + set: function( tween ) { + + // Use step hook for back compat. + // Use cssHook if its there. + // Use .style if available and use plain properties where available. + if ( jQuery.fx.step[ tween.prop ] ) { + jQuery.fx.step[ tween.prop ]( tween ); + } else if ( tween.elem.nodeType === 1 && ( + jQuery.cssHooks[ tween.prop ] || + tween.elem.style[ finalPropName( tween.prop ) ] != null ) ) { + jQuery.style( tween.elem, tween.prop, tween.now + tween.unit ); + } else { + tween.elem[ tween.prop ] = tween.now; + } + } + } +}; + +// Support: IE <=9 only +// Panic based approach to setting things on disconnected nodes +Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = { + set: function( tween ) { + if ( tween.elem.nodeType && tween.elem.parentNode ) { + tween.elem[ tween.prop ] = tween.now; + } + } +}; + +jQuery.easing = { + linear: function( p ) { + return p; + }, + swing: function( p ) { + return 0.5 - Math.cos( p * Math.PI ) / 2; + }, + _default: "swing" +}; + +jQuery.fx = Tween.prototype.init; + +// Back compat <1.8 extension point +jQuery.fx.step = {}; + + + + +var + fxNow, inProgress, + rfxtypes = /^(?:toggle|show|hide)$/, + rrun = /queueHooks$/; + +function schedule() { + if ( inProgress ) { + if ( document.hidden === false && window.requestAnimationFrame ) { + window.requestAnimationFrame( schedule ); + } else { + window.setTimeout( schedule, jQuery.fx.interval ); + } + + jQuery.fx.tick(); + } +} + +// Animations created synchronously will run synchronously +function createFxNow() { + window.setTimeout( function() { + fxNow = undefined; + } ); + return ( fxNow = Date.now() ); +} + +// Generate parameters to create a standard animation +function genFx( type, includeWidth ) { + var which, + i = 0, + attrs = { height: type }; + + // If we include width, step value is 1 to do all cssExpand values, + // otherwise step value is 2 to skip over Left and Right + includeWidth = includeWidth ? 1 : 0; + for ( ; i < 4; i += 2 - includeWidth ) { + which = cssExpand[ i ]; + attrs[ "margin" + which ] = attrs[ "padding" + which ] = type; + } + + if ( includeWidth ) { + attrs.opacity = attrs.width = type; + } + + return attrs; +} + +function createTween( value, prop, animation ) { + var tween, + collection = ( Animation.tweeners[ prop ] || [] ).concat( Animation.tweeners[ "*" ] ), + index = 0, + length = collection.length; + for ( ; index < length; index++ ) { + if ( ( tween = collection[ index ].call( animation, prop, value ) ) ) { + + // We're done with this property + return tween; + } + } +} + +function defaultPrefilter( elem, props, opts ) { + var prop, value, toggle, hooks, oldfire, propTween, restoreDisplay, display, + isBox = "width" in props || "height" in props, + anim = this, + orig = {}, + style = elem.style, + hidden = elem.nodeType && isHiddenWithinTree( elem ), + dataShow = dataPriv.get( elem, "fxshow" ); + + // Queue-skipping animations hijack the fx hooks + if ( !opts.queue ) { + hooks = jQuery._queueHooks( elem, "fx" ); + if ( hooks.unqueued == null ) { + hooks.unqueued = 0; + oldfire = hooks.empty.fire; + hooks.empty.fire = function() { + if ( !hooks.unqueued ) { + oldfire(); + } + }; + } + hooks.unqueued++; + + anim.always( function() { + + // Ensure the complete handler is called before this completes + anim.always( function() { + hooks.unqueued--; + if ( !jQuery.queue( elem, "fx" ).length ) { + hooks.empty.fire(); + } + } ); + } ); + } + + // Detect show/hide animations + for ( prop in props ) { + value = props[ prop ]; + if ( rfxtypes.test( value ) ) { + delete props[ prop ]; + toggle = toggle || value === "toggle"; + if ( value === ( hidden ? "hide" : "show" ) ) { + + // Pretend to be hidden if this is a "show" and + // there is still data from a stopped show/hide + if ( value === "show" && dataShow && dataShow[ prop ] !== undefined ) { + hidden = true; + + // Ignore all other no-op show/hide data + } else { + continue; + } + } + orig[ prop ] = dataShow && dataShow[ prop ] || jQuery.style( elem, prop ); + } + } + + // Bail out if this is a no-op like .hide().hide() + propTween = !jQuery.isEmptyObject( props ); + if ( !propTween && jQuery.isEmptyObject( orig ) ) { + return; + } + + // Restrict "overflow" and "display" styles during box animations + if ( isBox && elem.nodeType === 1 ) { + + // Support: IE <=9 - 11, Edge 12 - 15 + // Record all 3 overflow attributes because IE does not infer the shorthand + // from identically-valued overflowX and overflowY and Edge just mirrors + // the overflowX value there. + opts.overflow = [ style.overflow, style.overflowX, style.overflowY ]; + + // Identify a display type, preferring old show/hide data over the CSS cascade + restoreDisplay = dataShow && dataShow.display; + if ( restoreDisplay == null ) { + restoreDisplay = dataPriv.get( elem, "display" ); + } + display = jQuery.css( elem, "display" ); + if ( display === "none" ) { + if ( restoreDisplay ) { + display = restoreDisplay; + } else { + + // Get nonempty value(s) by temporarily forcing visibility + showHide( [ elem ], true ); + restoreDisplay = elem.style.display || restoreDisplay; + display = jQuery.css( elem, "display" ); + showHide( [ elem ] ); + } + } + + // Animate inline elements as inline-block + if ( display === "inline" || display === "inline-block" && restoreDisplay != null ) { + if ( jQuery.css( elem, "float" ) === "none" ) { + + // Restore the original display value at the end of pure show/hide animations + if ( !propTween ) { + anim.done( function() { + style.display = restoreDisplay; + } ); + if ( restoreDisplay == null ) { + display = style.display; + restoreDisplay = display === "none" ? "" : display; + } + } + style.display = "inline-block"; + } + } + } + + if ( opts.overflow ) { + style.overflow = "hidden"; + anim.always( function() { + style.overflow = opts.overflow[ 0 ]; + style.overflowX = opts.overflow[ 1 ]; + style.overflowY = opts.overflow[ 2 ]; + } ); + } + + // Implement show/hide animations + propTween = false; + for ( prop in orig ) { + + // General show/hide setup for this element animation + if ( !propTween ) { + if ( dataShow ) { + if ( "hidden" in dataShow ) { + hidden = dataShow.hidden; + } + } else { + dataShow = dataPriv.access( elem, "fxshow", { display: restoreDisplay } ); + } + + // Store hidden/visible for toggle so `.stop().toggle()` "reverses" + if ( toggle ) { + dataShow.hidden = !hidden; + } + + // Show elements before animating them + if ( hidden ) { + showHide( [ elem ], true ); + } + + /* eslint-disable no-loop-func */ + + anim.done( function() { + + /* eslint-enable no-loop-func */ + + // The final step of a "hide" animation is actually hiding the element + if ( !hidden ) { + showHide( [ elem ] ); + } + dataPriv.remove( elem, "fxshow" ); + for ( prop in orig ) { + jQuery.style( elem, prop, orig[ prop ] ); + } + } ); + } + + // Per-property setup + propTween = createTween( hidden ? dataShow[ prop ] : 0, prop, anim ); + if ( !( prop in dataShow ) ) { + dataShow[ prop ] = propTween.start; + if ( hidden ) { + propTween.end = propTween.start; + propTween.start = 0; + } + } + } +} + +function propFilter( props, specialEasing ) { + var index, name, easing, value, hooks; + + // camelCase, specialEasing and expand cssHook pass + for ( index in props ) { + name = camelCase( index ); + easing = specialEasing[ name ]; + value = props[ index ]; + if ( Array.isArray( value ) ) { + easing = value[ 1 ]; + value = props[ index ] = value[ 0 ]; + } + + if ( index !== name ) { + props[ name ] = value; + delete props[ index ]; + } + + hooks = jQuery.cssHooks[ name ]; + if ( hooks && "expand" in hooks ) { + value = hooks.expand( value ); + delete props[ name ]; + + // Not quite $.extend, this won't overwrite existing keys. + // Reusing 'index' because we have the correct "name" + for ( index in value ) { + if ( !( index in props ) ) { + props[ index ] = value[ index ]; + specialEasing[ index ] = easing; + } + } + } else { + specialEasing[ name ] = easing; + } + } +} + +function Animation( elem, properties, options ) { + var result, + stopped, + index = 0, + length = Animation.prefilters.length, + deferred = jQuery.Deferred().always( function() { + + // Don't match elem in the :animated selector + delete tick.elem; + } ), + tick = function() { + if ( stopped ) { + return false; + } + var currentTime = fxNow || createFxNow(), + remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ), + + // Support: Android 2.3 only + // Archaic crash bug won't allow us to use `1 - ( 0.5 || 0 )` (#12497) + temp = remaining / animation.duration || 0, + percent = 1 - temp, + index = 0, + length = animation.tweens.length; + + for ( ; index < length; index++ ) { + animation.tweens[ index ].run( percent ); + } + + deferred.notifyWith( elem, [ animation, percent, remaining ] ); + + // If there's more to do, yield + if ( percent < 1 && length ) { + return remaining; + } + + // If this was an empty animation, synthesize a final progress notification + if ( !length ) { + deferred.notifyWith( elem, [ animation, 1, 0 ] ); + } + + // Resolve the animation and report its conclusion + deferred.resolveWith( elem, [ animation ] ); + return false; + }, + animation = deferred.promise( { + elem: elem, + props: jQuery.extend( {}, properties ), + opts: jQuery.extend( true, { + specialEasing: {}, + easing: jQuery.easing._default + }, options ), + originalProperties: properties, + originalOptions: options, + startTime: fxNow || createFxNow(), + duration: options.duration, + tweens: [], + createTween: function( prop, end ) { + var tween = jQuery.Tween( elem, animation.opts, prop, end, + animation.opts.specialEasing[ prop ] || animation.opts.easing ); + animation.tweens.push( tween ); + return tween; + }, + stop: function( gotoEnd ) { + var index = 0, + + // If we are going to the end, we want to run all the tweens + // otherwise we skip this part + length = gotoEnd ? animation.tweens.length : 0; + if ( stopped ) { + return this; + } + stopped = true; + for ( ; index < length; index++ ) { + animation.tweens[ index ].run( 1 ); + } + + // Resolve when we played the last frame; otherwise, reject + if ( gotoEnd ) { + deferred.notifyWith( elem, [ animation, 1, 0 ] ); + deferred.resolveWith( elem, [ animation, gotoEnd ] ); + } else { + deferred.rejectWith( elem, [ animation, gotoEnd ] ); + } + return this; + } + } ), + props = animation.props; + + propFilter( props, animation.opts.specialEasing ); + + for ( ; index < length; index++ ) { + result = Animation.prefilters[ index ].call( animation, elem, props, animation.opts ); + if ( result ) { + if ( isFunction( result.stop ) ) { + jQuery._queueHooks( animation.elem, animation.opts.queue ).stop = + result.stop.bind( result ); + } + return result; + } + } + + jQuery.map( props, createTween, animation ); + + if ( isFunction( animation.opts.start ) ) { + animation.opts.start.call( elem, animation ); + } + + // Attach callbacks from options + animation + .progress( animation.opts.progress ) + .done( animation.opts.done, animation.opts.complete ) + .fail( animation.opts.fail ) + .always( animation.opts.always ); + + jQuery.fx.timer( + jQuery.extend( tick, { + elem: elem, + anim: animation, + queue: animation.opts.queue + } ) + ); + + return animation; +} + +jQuery.Animation = jQuery.extend( Animation, { + + tweeners: { + "*": [ function( prop, value ) { + var tween = this.createTween( prop, value ); + adjustCSS( tween.elem, prop, rcssNum.exec( value ), tween ); + return tween; + } ] + }, + + tweener: function( props, callback ) { + if ( isFunction( props ) ) { + callback = props; + props = [ "*" ]; + } else { + props = props.match( rnothtmlwhite ); + } + + var prop, + index = 0, + length = props.length; + + for ( ; index < length; index++ ) { + prop = props[ index ]; + Animation.tweeners[ prop ] = Animation.tweeners[ prop ] || []; + Animation.tweeners[ prop ].unshift( callback ); + } + }, + + prefilters: [ defaultPrefilter ], + + prefilter: function( callback, prepend ) { + if ( prepend ) { + Animation.prefilters.unshift( callback ); + } else { + Animation.prefilters.push( callback ); + } + } +} ); + +jQuery.speed = function( speed, easing, fn ) { + var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : { + complete: fn || !fn && easing || + isFunction( speed ) && speed, + duration: speed, + easing: fn && easing || easing && !isFunction( easing ) && easing + }; + + // Go to the end state if fx are off + if ( jQuery.fx.off ) { + opt.duration = 0; + + } else { + if ( typeof opt.duration !== "number" ) { + if ( opt.duration in jQuery.fx.speeds ) { + opt.duration = jQuery.fx.speeds[ opt.duration ]; + + } else { + opt.duration = jQuery.fx.speeds._default; + } + } + } + + // Normalize opt.queue - true/undefined/null -> "fx" + if ( opt.queue == null || opt.queue === true ) { + opt.queue = "fx"; + } + + // Queueing + opt.old = opt.complete; + + opt.complete = function() { + if ( isFunction( opt.old ) ) { + opt.old.call( this ); + } + + if ( opt.queue ) { + jQuery.dequeue( this, opt.queue ); + } + }; + + return opt; +}; + +jQuery.fn.extend( { + fadeTo: function( speed, to, easing, callback ) { + + // Show any hidden elements after setting opacity to 0 + return this.filter( isHiddenWithinTree ).css( "opacity", 0 ).show() + + // Animate to the value specified + .end().animate( { opacity: to }, speed, easing, callback ); + }, + animate: function( prop, speed, easing, callback ) { + var empty = jQuery.isEmptyObject( prop ), + optall = jQuery.speed( speed, easing, callback ), + doAnimation = function() { + + // Operate on a copy of prop so per-property easing won't be lost + var anim = Animation( this, jQuery.extend( {}, prop ), optall ); + + // Empty animations, or finishing resolves immediately + if ( empty || dataPriv.get( this, "finish" ) ) { + anim.stop( true ); + } + }; + doAnimation.finish = doAnimation; + + return empty || optall.queue === false ? + this.each( doAnimation ) : + this.queue( optall.queue, doAnimation ); + }, + stop: function( type, clearQueue, gotoEnd ) { + var stopQueue = function( hooks ) { + var stop = hooks.stop; + delete hooks.stop; + stop( gotoEnd ); + }; + + if ( typeof type !== "string" ) { + gotoEnd = clearQueue; + clearQueue = type; + type = undefined; + } + if ( clearQueue ) { + this.queue( type || "fx", [] ); + } + + return this.each( function() { + var dequeue = true, + index = type != null && type + "queueHooks", + timers = jQuery.timers, + data = dataPriv.get( this ); + + if ( index ) { + if ( data[ index ] && data[ index ].stop ) { + stopQueue( data[ index ] ); + } + } else { + for ( index in data ) { + if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) { + stopQueue( data[ index ] ); + } + } + } + + for ( index = timers.length; index--; ) { + if ( timers[ index ].elem === this && + ( type == null || timers[ index ].queue === type ) ) { + + timers[ index ].anim.stop( gotoEnd ); + dequeue = false; + timers.splice( index, 1 ); + } + } + + // Start the next in the queue if the last step wasn't forced. + // Timers currently will call their complete callbacks, which + // will dequeue but only if they were gotoEnd. + if ( dequeue || !gotoEnd ) { + jQuery.dequeue( this, type ); + } + } ); + }, + finish: function( type ) { + if ( type !== false ) { + type = type || "fx"; + } + return this.each( function() { + var index, + data = dataPriv.get( this ), + queue = data[ type + "queue" ], + hooks = data[ type + "queueHooks" ], + timers = jQuery.timers, + length = queue ? queue.length : 0; + + // Enable finishing flag on private data + data.finish = true; + + // Empty the queue first + jQuery.queue( this, type, [] ); + + if ( hooks && hooks.stop ) { + hooks.stop.call( this, true ); + } + + // Look for any active animations, and finish them + for ( index = timers.length; index--; ) { + if ( timers[ index ].elem === this && timers[ index ].queue === type ) { + timers[ index ].anim.stop( true ); + timers.splice( index, 1 ); + } + } + + // Look for any animations in the old queue and finish them + for ( index = 0; index < length; index++ ) { + if ( queue[ index ] && queue[ index ].finish ) { + queue[ index ].finish.call( this ); + } + } + + // Turn off finishing flag + delete data.finish; + } ); + } +} ); + +jQuery.each( [ "toggle", "show", "hide" ], function( _i, name ) { + var cssFn = jQuery.fn[ name ]; + jQuery.fn[ name ] = function( speed, easing, callback ) { + return speed == null || typeof speed === "boolean" ? + cssFn.apply( this, arguments ) : + this.animate( genFx( name, true ), speed, easing, callback ); + }; +} ); + +// Generate shortcuts for custom animations +jQuery.each( { + slideDown: genFx( "show" ), + slideUp: genFx( "hide" ), + slideToggle: genFx( "toggle" ), + fadeIn: { opacity: "show" }, + fadeOut: { opacity: "hide" }, + fadeToggle: { opacity: "toggle" } +}, function( name, props ) { + jQuery.fn[ name ] = function( speed, easing, callback ) { + return this.animate( props, speed, easing, callback ); + }; +} ); + +jQuery.timers = []; +jQuery.fx.tick = function() { + var timer, + i = 0, + timers = jQuery.timers; + + fxNow = Date.now(); + + for ( ; i < timers.length; i++ ) { + timer = timers[ i ]; + + // Run the timer and safely remove it when done (allowing for external removal) + if ( !timer() && timers[ i ] === timer ) { + timers.splice( i--, 1 ); + } + } + + if ( !timers.length ) { + jQuery.fx.stop(); + } + fxNow = undefined; +}; + +jQuery.fx.timer = function( timer ) { + jQuery.timers.push( timer ); + jQuery.fx.start(); +}; + +jQuery.fx.interval = 13; +jQuery.fx.start = function() { + if ( inProgress ) { + return; + } + + inProgress = true; + schedule(); +}; + +jQuery.fx.stop = function() { + inProgress = null; +}; + +jQuery.fx.speeds = { + slow: 600, + fast: 200, + + // Default speed + _default: 400 +}; + + +// Based off of the plugin by Clint Helfers, with permission. +// https://web.archive.org/web/20100324014747/http://blindsignals.com/index.php/2009/07/jquery-delay/ +jQuery.fn.delay = function( time, type ) { + time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time; + type = type || "fx"; + + return this.queue( type, function( next, hooks ) { + var timeout = window.setTimeout( next, time ); + hooks.stop = function() { + window.clearTimeout( timeout ); + }; + } ); +}; + + +( function() { + var input = document.createElement( "input" ), + select = document.createElement( "select" ), + opt = select.appendChild( document.createElement( "option" ) ); + + input.type = "checkbox"; + + // Support: Android <=4.3 only + // Default value for a checkbox should be "on" + support.checkOn = input.value !== ""; + + // Support: IE <=11 only + // Must access selectedIndex to make default options select + support.optSelected = opt.selected; + + // Support: IE <=11 only + // An input loses its value after becoming a radio + input = document.createElement( "input" ); + input.value = "t"; + input.type = "radio"; + support.radioValue = input.value === "t"; +} )(); + + +var boolHook, + attrHandle = jQuery.expr.attrHandle; + +jQuery.fn.extend( { + attr: function( name, value ) { + return access( this, jQuery.attr, name, value, arguments.length > 1 ); + }, + + removeAttr: function( name ) { + return this.each( function() { + jQuery.removeAttr( this, name ); + } ); + } +} ); + +jQuery.extend( { + attr: function( elem, name, value ) { + var ret, hooks, + nType = elem.nodeType; + + // Don't get/set attributes on text, comment and attribute nodes + if ( nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + // Fallback to prop when attributes are not supported + if ( typeof elem.getAttribute === "undefined" ) { + return jQuery.prop( elem, name, value ); + } + + // Attribute hooks are determined by the lowercase version + // Grab necessary hook if one is defined + if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { + hooks = jQuery.attrHooks[ name.toLowerCase() ] || + ( jQuery.expr.match.bool.test( name ) ? boolHook : undefined ); + } + + if ( value !== undefined ) { + if ( value === null ) { + jQuery.removeAttr( elem, name ); + return; + } + + if ( hooks && "set" in hooks && + ( ret = hooks.set( elem, value, name ) ) !== undefined ) { + return ret; + } + + elem.setAttribute( name, value + "" ); + return value; + } + + if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { + return ret; + } + + ret = jQuery.find.attr( elem, name ); + + // Non-existent attributes return null, we normalize to undefined + return ret == null ? undefined : ret; + }, + + attrHooks: { + type: { + set: function( elem, value ) { + if ( !support.radioValue && value === "radio" && + nodeName( elem, "input" ) ) { + var val = elem.value; + elem.setAttribute( "type", value ); + if ( val ) { + elem.value = val; + } + return value; + } + } + } + }, + + removeAttr: function( elem, value ) { + var name, + i = 0, + + // Attribute names can contain non-HTML whitespace characters + // https://html.spec.whatwg.org/multipage/syntax.html#attributes-2 + attrNames = value && value.match( rnothtmlwhite ); + + if ( attrNames && elem.nodeType === 1 ) { + while ( ( name = attrNames[ i++ ] ) ) { + elem.removeAttribute( name ); + } + } + } +} ); + +// Hooks for boolean attributes +boolHook = { + set: function( elem, value, name ) { + if ( value === false ) { + + // Remove boolean attributes when set to false + jQuery.removeAttr( elem, name ); + } else { + elem.setAttribute( name, name ); + } + return name; + } +}; + +jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( _i, name ) { + var getter = attrHandle[ name ] || jQuery.find.attr; + + attrHandle[ name ] = function( elem, name, isXML ) { + var ret, handle, + lowercaseName = name.toLowerCase(); + + if ( !isXML ) { + + // Avoid an infinite loop by temporarily removing this function from the getter + handle = attrHandle[ lowercaseName ]; + attrHandle[ lowercaseName ] = ret; + ret = getter( elem, name, isXML ) != null ? + lowercaseName : + null; + attrHandle[ lowercaseName ] = handle; + } + return ret; + }; +} ); + + + + +var rfocusable = /^(?:input|select|textarea|button)$/i, + rclickable = /^(?:a|area)$/i; + +jQuery.fn.extend( { + prop: function( name, value ) { + return access( this, jQuery.prop, name, value, arguments.length > 1 ); + }, + + removeProp: function( name ) { + return this.each( function() { + delete this[ jQuery.propFix[ name ] || name ]; + } ); + } +} ); + +jQuery.extend( { + prop: function( elem, name, value ) { + var ret, hooks, + nType = elem.nodeType; + + // Don't get/set properties on text, comment and attribute nodes + if ( nType === 3 || nType === 8 || nType === 2 ) { + return; + } + + if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { + + // Fix name and attach hooks + name = jQuery.propFix[ name ] || name; + hooks = jQuery.propHooks[ name ]; + } + + if ( value !== undefined ) { + if ( hooks && "set" in hooks && + ( ret = hooks.set( elem, value, name ) ) !== undefined ) { + return ret; + } + + return ( elem[ name ] = value ); + } + + if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { + return ret; + } + + return elem[ name ]; + }, + + propHooks: { + tabIndex: { + get: function( elem ) { + + // Support: IE <=9 - 11 only + // elem.tabIndex doesn't always return the + // correct value when it hasn't been explicitly set + // https://web.archive.org/web/20141116233347/http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/ + // Use proper attribute retrieval(#12072) + var tabindex = jQuery.find.attr( elem, "tabindex" ); + + if ( tabindex ) { + return parseInt( tabindex, 10 ); + } + + if ( + rfocusable.test( elem.nodeName ) || + rclickable.test( elem.nodeName ) && + elem.href + ) { + return 0; + } + + return -1; + } + } + }, + + propFix: { + "for": "htmlFor", + "class": "className" + } +} ); + +// Support: IE <=11 only +// Accessing the selectedIndex property +// forces the browser to respect setting selected +// on the option +// The getter ensures a default option is selected +// when in an optgroup +// eslint rule "no-unused-expressions" is disabled for this code +// since it considers such accessions noop +if ( !support.optSelected ) { + jQuery.propHooks.selected = { + get: function( elem ) { + + /* eslint no-unused-expressions: "off" */ + + var parent = elem.parentNode; + if ( parent && parent.parentNode ) { + parent.parentNode.selectedIndex; + } + return null; + }, + set: function( elem ) { + + /* eslint no-unused-expressions: "off" */ + + var parent = elem.parentNode; + if ( parent ) { + parent.selectedIndex; + + if ( parent.parentNode ) { + parent.parentNode.selectedIndex; + } + } + } + }; +} + +jQuery.each( [ + "tabIndex", + "readOnly", + "maxLength", + "cellSpacing", + "cellPadding", + "rowSpan", + "colSpan", + "useMap", + "frameBorder", + "contentEditable" +], function() { + jQuery.propFix[ this.toLowerCase() ] = this; +} ); + + + + + // Strip and collapse whitespace according to HTML spec + // https://infra.spec.whatwg.org/#strip-and-collapse-ascii-whitespace + function stripAndCollapse( value ) { + var tokens = value.match( rnothtmlwhite ) || []; + return tokens.join( " " ); + } + + +function getClass( elem ) { + return elem.getAttribute && elem.getAttribute( "class" ) || ""; +} + +function classesToArray( value ) { + if ( Array.isArray( value ) ) { + return value; + } + if ( typeof value === "string" ) { + return value.match( rnothtmlwhite ) || []; + } + return []; +} + +jQuery.fn.extend( { + addClass: function( value ) { + var classes, elem, cur, curValue, clazz, j, finalValue, + i = 0; + + if ( isFunction( value ) ) { + return this.each( function( j ) { + jQuery( this ).addClass( value.call( this, j, getClass( this ) ) ); + } ); + } + + classes = classesToArray( value ); + + if ( classes.length ) { + while ( ( elem = this[ i++ ] ) ) { + curValue = getClass( elem ); + cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); + + if ( cur ) { + j = 0; + while ( ( clazz = classes[ j++ ] ) ) { + if ( cur.indexOf( " " + clazz + " " ) < 0 ) { + cur += clazz + " "; + } + } + + // Only assign if different to avoid unneeded rendering. + finalValue = stripAndCollapse( cur ); + if ( curValue !== finalValue ) { + elem.setAttribute( "class", finalValue ); + } + } + } + } + + return this; + }, + + removeClass: function( value ) { + var classes, elem, cur, curValue, clazz, j, finalValue, + i = 0; + + if ( isFunction( value ) ) { + return this.each( function( j ) { + jQuery( this ).removeClass( value.call( this, j, getClass( this ) ) ); + } ); + } + + if ( !arguments.length ) { + return this.attr( "class", "" ); + } + + classes = classesToArray( value ); + + if ( classes.length ) { + while ( ( elem = this[ i++ ] ) ) { + curValue = getClass( elem ); + + // This expression is here for better compressibility (see addClass) + cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); + + if ( cur ) { + j = 0; + while ( ( clazz = classes[ j++ ] ) ) { + + // Remove *all* instances + while ( cur.indexOf( " " + clazz + " " ) > -1 ) { + cur = cur.replace( " " + clazz + " ", " " ); + } + } + + // Only assign if different to avoid unneeded rendering. + finalValue = stripAndCollapse( cur ); + if ( curValue !== finalValue ) { + elem.setAttribute( "class", finalValue ); + } + } + } + } + + return this; + }, + + toggleClass: function( value, stateVal ) { + var type = typeof value, + isValidValue = type === "string" || Array.isArray( value ); + + if ( typeof stateVal === "boolean" && isValidValue ) { + return stateVal ? this.addClass( value ) : this.removeClass( value ); + } + + if ( isFunction( value ) ) { + return this.each( function( i ) { + jQuery( this ).toggleClass( + value.call( this, i, getClass( this ), stateVal ), + stateVal + ); + } ); + } + + return this.each( function() { + var className, i, self, classNames; + + if ( isValidValue ) { + + // Toggle individual class names + i = 0; + self = jQuery( this ); + classNames = classesToArray( value ); + + while ( ( className = classNames[ i++ ] ) ) { + + // Check each className given, space separated list + if ( self.hasClass( className ) ) { + self.removeClass( className ); + } else { + self.addClass( className ); + } + } + + // Toggle whole class name + } else if ( value === undefined || type === "boolean" ) { + className = getClass( this ); + if ( className ) { + + // Store className if set + dataPriv.set( this, "__className__", className ); + } + + // If the element has a class name or if we're passed `false`, + // then remove the whole classname (if there was one, the above saved it). + // Otherwise bring back whatever was previously saved (if anything), + // falling back to the empty string if nothing was stored. + if ( this.setAttribute ) { + this.setAttribute( "class", + className || value === false ? + "" : + dataPriv.get( this, "__className__" ) || "" + ); + } + } + } ); + }, + + hasClass: function( selector ) { + var className, elem, + i = 0; + + className = " " + selector + " "; + while ( ( elem = this[ i++ ] ) ) { + if ( elem.nodeType === 1 && + ( " " + stripAndCollapse( getClass( elem ) ) + " " ).indexOf( className ) > -1 ) { + return true; + } + } + + return false; + } +} ); + + + + +var rreturn = /\r/g; + +jQuery.fn.extend( { + val: function( value ) { + var hooks, ret, valueIsFunction, + elem = this[ 0 ]; + + if ( !arguments.length ) { + if ( elem ) { + hooks = jQuery.valHooks[ elem.type ] || + jQuery.valHooks[ elem.nodeName.toLowerCase() ]; + + if ( hooks && + "get" in hooks && + ( ret = hooks.get( elem, "value" ) ) !== undefined + ) { + return ret; + } + + ret = elem.value; + + // Handle most common string cases + if ( typeof ret === "string" ) { + return ret.replace( rreturn, "" ); + } + + // Handle cases where value is null/undef or number + return ret == null ? "" : ret; + } + + return; + } + + valueIsFunction = isFunction( value ); + + return this.each( function( i ) { + var val; + + if ( this.nodeType !== 1 ) { + return; + } + + if ( valueIsFunction ) { + val = value.call( this, i, jQuery( this ).val() ); + } else { + val = value; + } + + // Treat null/undefined as ""; convert numbers to string + if ( val == null ) { + val = ""; + + } else if ( typeof val === "number" ) { + val += ""; + + } else if ( Array.isArray( val ) ) { + val = jQuery.map( val, function( value ) { + return value == null ? "" : value + ""; + } ); + } + + hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ]; + + // If set returns undefined, fall back to normal setting + if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) { + this.value = val; + } + } ); + } +} ); + +jQuery.extend( { + valHooks: { + option: { + get: function( elem ) { + + var val = jQuery.find.attr( elem, "value" ); + return val != null ? + val : + + // Support: IE <=10 - 11 only + // option.text throws exceptions (#14686, #14858) + // Strip and collapse whitespace + // https://html.spec.whatwg.org/#strip-and-collapse-whitespace + stripAndCollapse( jQuery.text( elem ) ); + } + }, + select: { + get: function( elem ) { + var value, option, i, + options = elem.options, + index = elem.selectedIndex, + one = elem.type === "select-one", + values = one ? null : [], + max = one ? index + 1 : options.length; + + if ( index < 0 ) { + i = max; + + } else { + i = one ? index : 0; + } + + // Loop through all the selected options + for ( ; i < max; i++ ) { + option = options[ i ]; + + // Support: IE <=9 only + // IE8-9 doesn't update selected after form reset (#2551) + if ( ( option.selected || i === index ) && + + // Don't return options that are disabled or in a disabled optgroup + !option.disabled && + ( !option.parentNode.disabled || + !nodeName( option.parentNode, "optgroup" ) ) ) { + + // Get the specific value for the option + value = jQuery( option ).val(); + + // We don't need an array for one selects + if ( one ) { + return value; + } + + // Multi-Selects return an array + values.push( value ); + } + } + + return values; + }, + + set: function( elem, value ) { + var optionSet, option, + options = elem.options, + values = jQuery.makeArray( value ), + i = options.length; + + while ( i-- ) { + option = options[ i ]; + + /* eslint-disable no-cond-assign */ + + if ( option.selected = + jQuery.inArray( jQuery.valHooks.option.get( option ), values ) > -1 + ) { + optionSet = true; + } + + /* eslint-enable no-cond-assign */ + } + + // Force browsers to behave consistently when non-matching value is set + if ( !optionSet ) { + elem.selectedIndex = -1; + } + return values; + } + } + } +} ); + +// Radios and checkboxes getter/setter +jQuery.each( [ "radio", "checkbox" ], function() { + jQuery.valHooks[ this ] = { + set: function( elem, value ) { + if ( Array.isArray( value ) ) { + return ( elem.checked = jQuery.inArray( jQuery( elem ).val(), value ) > -1 ); + } + } + }; + if ( !support.checkOn ) { + jQuery.valHooks[ this ].get = function( elem ) { + return elem.getAttribute( "value" ) === null ? "on" : elem.value; + }; + } +} ); + + + + +// Return jQuery for attributes-only inclusion + + +support.focusin = "onfocusin" in window; + + +var rfocusMorph = /^(?:focusinfocus|focusoutblur)$/, + stopPropagationCallback = function( e ) { + e.stopPropagation(); + }; + +jQuery.extend( jQuery.event, { + + trigger: function( event, data, elem, onlyHandlers ) { + + var i, cur, tmp, bubbleType, ontype, handle, special, lastElement, + eventPath = [ elem || document ], + type = hasOwn.call( event, "type" ) ? event.type : event, + namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split( "." ) : []; + + cur = lastElement = tmp = elem = elem || document; + + // Don't do events on text and comment nodes + if ( elem.nodeType === 3 || elem.nodeType === 8 ) { + return; + } + + // focus/blur morphs to focusin/out; ensure we're not firing them right now + if ( rfocusMorph.test( type + jQuery.event.triggered ) ) { + return; + } + + if ( type.indexOf( "." ) > -1 ) { + + // Namespaced trigger; create a regexp to match event type in handle() + namespaces = type.split( "." ); + type = namespaces.shift(); + namespaces.sort(); + } + ontype = type.indexOf( ":" ) < 0 && "on" + type; + + // Caller can pass in a jQuery.Event object, Object, or just an event type string + event = event[ jQuery.expando ] ? + event : + new jQuery.Event( type, typeof event === "object" && event ); + + // Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true) + event.isTrigger = onlyHandlers ? 2 : 3; + event.namespace = namespaces.join( "." ); + event.rnamespace = event.namespace ? + new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ) : + null; + + // Clean up the event in case it is being reused + event.result = undefined; + if ( !event.target ) { + event.target = elem; + } + + // Clone any incoming data and prepend the event, creating the handler arg list + data = data == null ? + [ event ] : + jQuery.makeArray( data, [ event ] ); + + // Allow special events to draw outside the lines + special = jQuery.event.special[ type ] || {}; + if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) { + return; + } + + // Determine event propagation path in advance, per W3C events spec (#9951) + // Bubble up to document, then to window; watch for a global ownerDocument var (#9724) + if ( !onlyHandlers && !special.noBubble && !isWindow( elem ) ) { + + bubbleType = special.delegateType || type; + if ( !rfocusMorph.test( bubbleType + type ) ) { + cur = cur.parentNode; + } + for ( ; cur; cur = cur.parentNode ) { + eventPath.push( cur ); + tmp = cur; + } + + // Only add window if we got to document (e.g., not plain obj or detached DOM) + if ( tmp === ( elem.ownerDocument || document ) ) { + eventPath.push( tmp.defaultView || tmp.parentWindow || window ); + } + } + + // Fire handlers on the event path + i = 0; + while ( ( cur = eventPath[ i++ ] ) && !event.isPropagationStopped() ) { + lastElement = cur; + event.type = i > 1 ? + bubbleType : + special.bindType || type; + + // jQuery handler + handle = ( + dataPriv.get( cur, "events" ) || Object.create( null ) + )[ event.type ] && + dataPriv.get( cur, "handle" ); + if ( handle ) { + handle.apply( cur, data ); + } + + // Native handler + handle = ontype && cur[ ontype ]; + if ( handle && handle.apply && acceptData( cur ) ) { + event.result = handle.apply( cur, data ); + if ( event.result === false ) { + event.preventDefault(); + } + } + } + event.type = type; + + // If nobody prevented the default action, do it now + if ( !onlyHandlers && !event.isDefaultPrevented() ) { + + if ( ( !special._default || + special._default.apply( eventPath.pop(), data ) === false ) && + acceptData( elem ) ) { + + // Call a native DOM method on the target with the same name as the event. + // Don't do default actions on window, that's where global variables be (#6170) + if ( ontype && isFunction( elem[ type ] ) && !isWindow( elem ) ) { + + // Don't re-trigger an onFOO event when we call its FOO() method + tmp = elem[ ontype ]; + + if ( tmp ) { + elem[ ontype ] = null; + } + + // Prevent re-triggering of the same event, since we already bubbled it above + jQuery.event.triggered = type; + + if ( event.isPropagationStopped() ) { + lastElement.addEventListener( type, stopPropagationCallback ); + } + + elem[ type ](); + + if ( event.isPropagationStopped() ) { + lastElement.removeEventListener( type, stopPropagationCallback ); + } + + jQuery.event.triggered = undefined; + + if ( tmp ) { + elem[ ontype ] = tmp; + } + } + } + } + + return event.result; + }, + + // Piggyback on a donor event to simulate a different one + // Used only for `focus(in | out)` events + simulate: function( type, elem, event ) { + var e = jQuery.extend( + new jQuery.Event(), + event, + { + type: type, + isSimulated: true + } + ); + + jQuery.event.trigger( e, null, elem ); + } + +} ); + +jQuery.fn.extend( { + + trigger: function( type, data ) { + return this.each( function() { + jQuery.event.trigger( type, data, this ); + } ); + }, + triggerHandler: function( type, data ) { + var elem = this[ 0 ]; + if ( elem ) { + return jQuery.event.trigger( type, data, elem, true ); + } + } +} ); + + +// Support: Firefox <=44 +// Firefox doesn't have focus(in | out) events +// Related ticket - https://bugzilla.mozilla.org/show_bug.cgi?id=687787 +// +// Support: Chrome <=48 - 49, Safari <=9.0 - 9.1 +// focus(in | out) events fire after focus & blur events, +// which is spec violation - http://www.w3.org/TR/DOM-Level-3-Events/#events-focusevent-event-order +// Related ticket - https://bugs.chromium.org/p/chromium/issues/detail?id=449857 +if ( !support.focusin ) { + jQuery.each( { focus: "focusin", blur: "focusout" }, function( orig, fix ) { + + // Attach a single capturing handler on the document while someone wants focusin/focusout + var handler = function( event ) { + jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ) ); + }; + + jQuery.event.special[ fix ] = { + setup: function() { + + // Handle: regular nodes (via `this.ownerDocument`), window + // (via `this.document`) & document (via `this`). + var doc = this.ownerDocument || this.document || this, + attaches = dataPriv.access( doc, fix ); + + if ( !attaches ) { + doc.addEventListener( orig, handler, true ); + } + dataPriv.access( doc, fix, ( attaches || 0 ) + 1 ); + }, + teardown: function() { + var doc = this.ownerDocument || this.document || this, + attaches = dataPriv.access( doc, fix ) - 1; + + if ( !attaches ) { + doc.removeEventListener( orig, handler, true ); + dataPriv.remove( doc, fix ); + + } else { + dataPriv.access( doc, fix, attaches ); + } + } + }; + } ); +} +var location = window.location; + +var nonce = { guid: Date.now() }; + +var rquery = ( /\?/ ); + + + +// Cross-browser xml parsing +jQuery.parseXML = function( data ) { + var xml; + if ( !data || typeof data !== "string" ) { + return null; + } + + // Support: IE 9 - 11 only + // IE throws on parseFromString with invalid input. + try { + xml = ( new window.DOMParser() ).parseFromString( data, "text/xml" ); + } catch ( e ) { + xml = undefined; + } + + if ( !xml || xml.getElementsByTagName( "parsererror" ).length ) { + jQuery.error( "Invalid XML: " + data ); + } + return xml; +}; + + +var + rbracket = /\[\]$/, + rCRLF = /\r?\n/g, + rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i, + rsubmittable = /^(?:input|select|textarea|keygen)/i; + +function buildParams( prefix, obj, traditional, add ) { + var name; + + if ( Array.isArray( obj ) ) { + + // Serialize array item. + jQuery.each( obj, function( i, v ) { + if ( traditional || rbracket.test( prefix ) ) { + + // Treat each array item as a scalar. + add( prefix, v ); + + } else { + + // Item is non-scalar (array or object), encode its numeric index. + buildParams( + prefix + "[" + ( typeof v === "object" && v != null ? i : "" ) + "]", + v, + traditional, + add + ); + } + } ); + + } else if ( !traditional && toType( obj ) === "object" ) { + + // Serialize object item. + for ( name in obj ) { + buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add ); + } + + } else { + + // Serialize scalar item. + add( prefix, obj ); + } +} + +// Serialize an array of form elements or a set of +// key/values into a query string +jQuery.param = function( a, traditional ) { + var prefix, + s = [], + add = function( key, valueOrFunction ) { + + // If value is a function, invoke it and use its return value + var value = isFunction( valueOrFunction ) ? + valueOrFunction() : + valueOrFunction; + + s[ s.length ] = encodeURIComponent( key ) + "=" + + encodeURIComponent( value == null ? "" : value ); + }; + + if ( a == null ) { + return ""; + } + + // If an array was passed in, assume that it is an array of form elements. + if ( Array.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) { + + // Serialize the form elements + jQuery.each( a, function() { + add( this.name, this.value ); + } ); + + } else { + + // If traditional, encode the "old" way (the way 1.3.2 or older + // did it), otherwise encode params recursively. + for ( prefix in a ) { + buildParams( prefix, a[ prefix ], traditional, add ); + } + } + + // Return the resulting serialization + return s.join( "&" ); +}; + +jQuery.fn.extend( { + serialize: function() { + return jQuery.param( this.serializeArray() ); + }, + serializeArray: function() { + return this.map( function() { + + // Can add propHook for "elements" to filter or add form elements + var elements = jQuery.prop( this, "elements" ); + return elements ? jQuery.makeArray( elements ) : this; + } ) + .filter( function() { + var type = this.type; + + // Use .is( ":disabled" ) so that fieldset[disabled] works + return this.name && !jQuery( this ).is( ":disabled" ) && + rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) && + ( this.checked || !rcheckableType.test( type ) ); + } ) + .map( function( _i, elem ) { + var val = jQuery( this ).val(); + + if ( val == null ) { + return null; + } + + if ( Array.isArray( val ) ) { + return jQuery.map( val, function( val ) { + return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; + } ); + } + + return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; + } ).get(); + } +} ); + + +var + r20 = /%20/g, + rhash = /#.*$/, + rantiCache = /([?&])_=[^&]*/, + rheaders = /^(.*?):[ \t]*([^\r\n]*)$/mg, + + // #7653, #8125, #8152: local protocol detection + rlocalProtocol = /^(?:about|app|app-storage|.+-extension|file|res|widget):$/, + rnoContent = /^(?:GET|HEAD)$/, + rprotocol = /^\/\//, + + /* Prefilters + * 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example) + * 2) These are called: + * - BEFORE asking for a transport + * - AFTER param serialization (s.data is a string if s.processData is true) + * 3) key is the dataType + * 4) the catchall symbol "*" can be used + * 5) execution will start with transport dataType and THEN continue down to "*" if needed + */ + prefilters = {}, + + /* Transports bindings + * 1) key is the dataType + * 2) the catchall symbol "*" can be used + * 3) selection will start with transport dataType and THEN go to "*" if needed + */ + transports = {}, + + // Avoid comment-prolog char sequence (#10098); must appease lint and evade compression + allTypes = "*/".concat( "*" ), + + // Anchor tag for parsing the document origin + originAnchor = document.createElement( "a" ); + originAnchor.href = location.href; + +// Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport +function addToPrefiltersOrTransports( structure ) { + + // dataTypeExpression is optional and defaults to "*" + return function( dataTypeExpression, func ) { + + if ( typeof dataTypeExpression !== "string" ) { + func = dataTypeExpression; + dataTypeExpression = "*"; + } + + var dataType, + i = 0, + dataTypes = dataTypeExpression.toLowerCase().match( rnothtmlwhite ) || []; + + if ( isFunction( func ) ) { + + // For each dataType in the dataTypeExpression + while ( ( dataType = dataTypes[ i++ ] ) ) { + + // Prepend if requested + if ( dataType[ 0 ] === "+" ) { + dataType = dataType.slice( 1 ) || "*"; + ( structure[ dataType ] = structure[ dataType ] || [] ).unshift( func ); + + // Otherwise append + } else { + ( structure[ dataType ] = structure[ dataType ] || [] ).push( func ); + } + } + } + }; +} + +// Base inspection function for prefilters and transports +function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR ) { + + var inspected = {}, + seekingTransport = ( structure === transports ); + + function inspect( dataType ) { + var selected; + inspected[ dataType ] = true; + jQuery.each( structure[ dataType ] || [], function( _, prefilterOrFactory ) { + var dataTypeOrTransport = prefilterOrFactory( options, originalOptions, jqXHR ); + if ( typeof dataTypeOrTransport === "string" && + !seekingTransport && !inspected[ dataTypeOrTransport ] ) { + + options.dataTypes.unshift( dataTypeOrTransport ); + inspect( dataTypeOrTransport ); + return false; + } else if ( seekingTransport ) { + return !( selected = dataTypeOrTransport ); + } + } ); + return selected; + } + + return inspect( options.dataTypes[ 0 ] ) || !inspected[ "*" ] && inspect( "*" ); +} + +// A special extend for ajax options +// that takes "flat" options (not to be deep extended) +// Fixes #9887 +function ajaxExtend( target, src ) { + var key, deep, + flatOptions = jQuery.ajaxSettings.flatOptions || {}; + + for ( key in src ) { + if ( src[ key ] !== undefined ) { + ( flatOptions[ key ] ? target : ( deep || ( deep = {} ) ) )[ key ] = src[ key ]; + } + } + if ( deep ) { + jQuery.extend( true, target, deep ); + } + + return target; +} + +/* Handles responses to an ajax request: + * - finds the right dataType (mediates between content-type and expected dataType) + * - returns the corresponding response + */ +function ajaxHandleResponses( s, jqXHR, responses ) { + + var ct, type, finalDataType, firstDataType, + contents = s.contents, + dataTypes = s.dataTypes; + + // Remove auto dataType and get content-type in the process + while ( dataTypes[ 0 ] === "*" ) { + dataTypes.shift(); + if ( ct === undefined ) { + ct = s.mimeType || jqXHR.getResponseHeader( "Content-Type" ); + } + } + + // Check if we're dealing with a known content-type + if ( ct ) { + for ( type in contents ) { + if ( contents[ type ] && contents[ type ].test( ct ) ) { + dataTypes.unshift( type ); + break; + } + } + } + + // Check to see if we have a response for the expected dataType + if ( dataTypes[ 0 ] in responses ) { + finalDataType = dataTypes[ 0 ]; + } else { + + // Try convertible dataTypes + for ( type in responses ) { + if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[ 0 ] ] ) { + finalDataType = type; + break; + } + if ( !firstDataType ) { + firstDataType = type; + } + } + + // Or just use first one + finalDataType = finalDataType || firstDataType; + } + + // If we found a dataType + // We add the dataType to the list if needed + // and return the corresponding response + if ( finalDataType ) { + if ( finalDataType !== dataTypes[ 0 ] ) { + dataTypes.unshift( finalDataType ); + } + return responses[ finalDataType ]; + } +} + +/* Chain conversions given the request and the original response + * Also sets the responseXXX fields on the jqXHR instance + */ +function ajaxConvert( s, response, jqXHR, isSuccess ) { + var conv2, current, conv, tmp, prev, + converters = {}, + + // Work with a copy of dataTypes in case we need to modify it for conversion + dataTypes = s.dataTypes.slice(); + + // Create converters map with lowercased keys + if ( dataTypes[ 1 ] ) { + for ( conv in s.converters ) { + converters[ conv.toLowerCase() ] = s.converters[ conv ]; + } + } + + current = dataTypes.shift(); + + // Convert to each sequential dataType + while ( current ) { + + if ( s.responseFields[ current ] ) { + jqXHR[ s.responseFields[ current ] ] = response; + } + + // Apply the dataFilter if provided + if ( !prev && isSuccess && s.dataFilter ) { + response = s.dataFilter( response, s.dataType ); + } + + prev = current; + current = dataTypes.shift(); + + if ( current ) { + + // There's only work to do if current dataType is non-auto + if ( current === "*" ) { + + current = prev; + + // Convert response if prev dataType is non-auto and differs from current + } else if ( prev !== "*" && prev !== current ) { + + // Seek a direct converter + conv = converters[ prev + " " + current ] || converters[ "* " + current ]; + + // If none found, seek a pair + if ( !conv ) { + for ( conv2 in converters ) { + + // If conv2 outputs current + tmp = conv2.split( " " ); + if ( tmp[ 1 ] === current ) { + + // If prev can be converted to accepted input + conv = converters[ prev + " " + tmp[ 0 ] ] || + converters[ "* " + tmp[ 0 ] ]; + if ( conv ) { + + // Condense equivalence converters + if ( conv === true ) { + conv = converters[ conv2 ]; + + // Otherwise, insert the intermediate dataType + } else if ( converters[ conv2 ] !== true ) { + current = tmp[ 0 ]; + dataTypes.unshift( tmp[ 1 ] ); + } + break; + } + } + } + } + + // Apply converter (if not an equivalence) + if ( conv !== true ) { + + // Unless errors are allowed to bubble, catch and return them + if ( conv && s.throws ) { + response = conv( response ); + } else { + try { + response = conv( response ); + } catch ( e ) { + return { + state: "parsererror", + error: conv ? e : "No conversion from " + prev + " to " + current + }; + } + } + } + } + } + } + + return { state: "success", data: response }; +} + +jQuery.extend( { + + // Counter for holding the number of active queries + active: 0, + + // Last-Modified header cache for next request + lastModified: {}, + etag: {}, + + ajaxSettings: { + url: location.href, + type: "GET", + isLocal: rlocalProtocol.test( location.protocol ), + global: true, + processData: true, + async: true, + contentType: "application/x-www-form-urlencoded; charset=UTF-8", + + /* + timeout: 0, + data: null, + dataType: null, + username: null, + password: null, + cache: null, + throws: false, + traditional: false, + headers: {}, + */ + + accepts: { + "*": allTypes, + text: "text/plain", + html: "text/html", + xml: "application/xml, text/xml", + json: "application/json, text/javascript" + }, + + contents: { + xml: /\bxml\b/, + html: /\bhtml/, + json: /\bjson\b/ + }, + + responseFields: { + xml: "responseXML", + text: "responseText", + json: "responseJSON" + }, + + // Data converters + // Keys separate source (or catchall "*") and destination types with a single space + converters: { + + // Convert anything to text + "* text": String, + + // Text to html (true = no transformation) + "text html": true, + + // Evaluate text as a json expression + "text json": JSON.parse, + + // Parse text as xml + "text xml": jQuery.parseXML + }, + + // For options that shouldn't be deep extended: + // you can add your own custom options here if + // and when you create one that shouldn't be + // deep extended (see ajaxExtend) + flatOptions: { + url: true, + context: true + } + }, + + // Creates a full fledged settings object into target + // with both ajaxSettings and settings fields. + // If target is omitted, writes into ajaxSettings. + ajaxSetup: function( target, settings ) { + return settings ? + + // Building a settings object + ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) : + + // Extending ajaxSettings + ajaxExtend( jQuery.ajaxSettings, target ); + }, + + ajaxPrefilter: addToPrefiltersOrTransports( prefilters ), + ajaxTransport: addToPrefiltersOrTransports( transports ), + + // Main method + ajax: function( url, options ) { + + // If url is an object, simulate pre-1.5 signature + if ( typeof url === "object" ) { + options = url; + url = undefined; + } + + // Force options to be an object + options = options || {}; + + var transport, + + // URL without anti-cache param + cacheURL, + + // Response headers + responseHeadersString, + responseHeaders, + + // timeout handle + timeoutTimer, + + // Url cleanup var + urlAnchor, + + // Request state (becomes false upon send and true upon completion) + completed, + + // To know if global events are to be dispatched + fireGlobals, + + // Loop variable + i, + + // uncached part of the url + uncached, + + // Create the final options object + s = jQuery.ajaxSetup( {}, options ), + + // Callbacks context + callbackContext = s.context || s, + + // Context for global events is callbackContext if it is a DOM node or jQuery collection + globalEventContext = s.context && + ( callbackContext.nodeType || callbackContext.jquery ) ? + jQuery( callbackContext ) : + jQuery.event, + + // Deferreds + deferred = jQuery.Deferred(), + completeDeferred = jQuery.Callbacks( "once memory" ), + + // Status-dependent callbacks + statusCode = s.statusCode || {}, + + // Headers (they are sent all at once) + requestHeaders = {}, + requestHeadersNames = {}, + + // Default abort message + strAbort = "canceled", + + // Fake xhr + jqXHR = { + readyState: 0, + + // Builds headers hashtable if needed + getResponseHeader: function( key ) { + var match; + if ( completed ) { + if ( !responseHeaders ) { + responseHeaders = {}; + while ( ( match = rheaders.exec( responseHeadersString ) ) ) { + responseHeaders[ match[ 1 ].toLowerCase() + " " ] = + ( responseHeaders[ match[ 1 ].toLowerCase() + " " ] || [] ) + .concat( match[ 2 ] ); + } + } + match = responseHeaders[ key.toLowerCase() + " " ]; + } + return match == null ? null : match.join( ", " ); + }, + + // Raw string + getAllResponseHeaders: function() { + return completed ? responseHeadersString : null; + }, + + // Caches the header + setRequestHeader: function( name, value ) { + if ( completed == null ) { + name = requestHeadersNames[ name.toLowerCase() ] = + requestHeadersNames[ name.toLowerCase() ] || name; + requestHeaders[ name ] = value; + } + return this; + }, + + // Overrides response content-type header + overrideMimeType: function( type ) { + if ( completed == null ) { + s.mimeType = type; + } + return this; + }, + + // Status-dependent callbacks + statusCode: function( map ) { + var code; + if ( map ) { + if ( completed ) { + + // Execute the appropriate callbacks + jqXHR.always( map[ jqXHR.status ] ); + } else { + + // Lazy-add the new callbacks in a way that preserves old ones + for ( code in map ) { + statusCode[ code ] = [ statusCode[ code ], map[ code ] ]; + } + } + } + return this; + }, + + // Cancel the request + abort: function( statusText ) { + var finalText = statusText || strAbort; + if ( transport ) { + transport.abort( finalText ); + } + done( 0, finalText ); + return this; + } + }; + + // Attach deferreds + deferred.promise( jqXHR ); + + // Add protocol if not provided (prefilters might expect it) + // Handle falsy url in the settings object (#10093: consistency with old signature) + // We also use the url parameter if available + s.url = ( ( url || s.url || location.href ) + "" ) + .replace( rprotocol, location.protocol + "//" ); + + // Alias method option to type as per ticket #12004 + s.type = options.method || options.type || s.method || s.type; + + // Extract dataTypes list + s.dataTypes = ( s.dataType || "*" ).toLowerCase().match( rnothtmlwhite ) || [ "" ]; + + // A cross-domain request is in order when the origin doesn't match the current origin. + if ( s.crossDomain == null ) { + urlAnchor = document.createElement( "a" ); + + // Support: IE <=8 - 11, Edge 12 - 15 + // IE throws exception on accessing the href property if url is malformed, + // e.g. http://example.com:80x/ + try { + urlAnchor.href = s.url; + + // Support: IE <=8 - 11 only + // Anchor's host property isn't correctly set when s.url is relative + urlAnchor.href = urlAnchor.href; + s.crossDomain = originAnchor.protocol + "//" + originAnchor.host !== + urlAnchor.protocol + "//" + urlAnchor.host; + } catch ( e ) { + + // If there is an error parsing the URL, assume it is crossDomain, + // it can be rejected by the transport if it is invalid + s.crossDomain = true; + } + } + + // Convert data if not already a string + if ( s.data && s.processData && typeof s.data !== "string" ) { + s.data = jQuery.param( s.data, s.traditional ); + } + + // Apply prefilters + inspectPrefiltersOrTransports( prefilters, s, options, jqXHR ); + + // If request was aborted inside a prefilter, stop there + if ( completed ) { + return jqXHR; + } + + // We can fire global events as of now if asked to + // Don't fire events if jQuery.event is undefined in an AMD-usage scenario (#15118) + fireGlobals = jQuery.event && s.global; + + // Watch for a new set of requests + if ( fireGlobals && jQuery.active++ === 0 ) { + jQuery.event.trigger( "ajaxStart" ); + } + + // Uppercase the type + s.type = s.type.toUpperCase(); + + // Determine if request has content + s.hasContent = !rnoContent.test( s.type ); + + // Save the URL in case we're toying with the If-Modified-Since + // and/or If-None-Match header later on + // Remove hash to simplify url manipulation + cacheURL = s.url.replace( rhash, "" ); + + // More options handling for requests with no content + if ( !s.hasContent ) { + + // Remember the hash so we can put it back + uncached = s.url.slice( cacheURL.length ); + + // If data is available and should be processed, append data to url + if ( s.data && ( s.processData || typeof s.data === "string" ) ) { + cacheURL += ( rquery.test( cacheURL ) ? "&" : "?" ) + s.data; + + // #9682: remove data so that it's not used in an eventual retry + delete s.data; + } + + // Add or update anti-cache param if needed + if ( s.cache === false ) { + cacheURL = cacheURL.replace( rantiCache, "$1" ); + uncached = ( rquery.test( cacheURL ) ? "&" : "?" ) + "_=" + ( nonce.guid++ ) + + uncached; + } + + // Put hash and anti-cache on the URL that will be requested (gh-1732) + s.url = cacheURL + uncached; + + // Change '%20' to '+' if this is encoded form body content (gh-2658) + } else if ( s.data && s.processData && + ( s.contentType || "" ).indexOf( "application/x-www-form-urlencoded" ) === 0 ) { + s.data = s.data.replace( r20, "+" ); + } + + // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. + if ( s.ifModified ) { + if ( jQuery.lastModified[ cacheURL ] ) { + jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ cacheURL ] ); + } + if ( jQuery.etag[ cacheURL ] ) { + jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ cacheURL ] ); + } + } + + // Set the correct header, if data is being sent + if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) { + jqXHR.setRequestHeader( "Content-Type", s.contentType ); + } + + // Set the Accepts header for the server, depending on the dataType + jqXHR.setRequestHeader( + "Accept", + s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[ 0 ] ] ? + s.accepts[ s.dataTypes[ 0 ] ] + + ( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) : + s.accepts[ "*" ] + ); + + // Check for headers option + for ( i in s.headers ) { + jqXHR.setRequestHeader( i, s.headers[ i ] ); + } + + // Allow custom headers/mimetypes and early abort + if ( s.beforeSend && + ( s.beforeSend.call( callbackContext, jqXHR, s ) === false || completed ) ) { + + // Abort if not done already and return + return jqXHR.abort(); + } + + // Aborting is no longer a cancellation + strAbort = "abort"; + + // Install callbacks on deferreds + completeDeferred.add( s.complete ); + jqXHR.done( s.success ); + jqXHR.fail( s.error ); + + // Get transport + transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR ); + + // If no transport, we auto-abort + if ( !transport ) { + done( -1, "No Transport" ); + } else { + jqXHR.readyState = 1; + + // Send global event + if ( fireGlobals ) { + globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] ); + } + + // If request was aborted inside ajaxSend, stop there + if ( completed ) { + return jqXHR; + } + + // Timeout + if ( s.async && s.timeout > 0 ) { + timeoutTimer = window.setTimeout( function() { + jqXHR.abort( "timeout" ); + }, s.timeout ); + } + + try { + completed = false; + transport.send( requestHeaders, done ); + } catch ( e ) { + + // Rethrow post-completion exceptions + if ( completed ) { + throw e; + } + + // Propagate others as results + done( -1, e ); + } + } + + // Callback for when everything is done + function done( status, nativeStatusText, responses, headers ) { + var isSuccess, success, error, response, modified, + statusText = nativeStatusText; + + // Ignore repeat invocations + if ( completed ) { + return; + } + + completed = true; + + // Clear timeout if it exists + if ( timeoutTimer ) { + window.clearTimeout( timeoutTimer ); + } + + // Dereference transport for early garbage collection + // (no matter how long the jqXHR object will be used) + transport = undefined; + + // Cache response headers + responseHeadersString = headers || ""; + + // Set readyState + jqXHR.readyState = status > 0 ? 4 : 0; + + // Determine if successful + isSuccess = status >= 200 && status < 300 || status === 304; + + // Get response data + if ( responses ) { + response = ajaxHandleResponses( s, jqXHR, responses ); + } + + // Use a noop converter for missing script + if ( !isSuccess && jQuery.inArray( "script", s.dataTypes ) > -1 ) { + s.converters[ "text script" ] = function() {}; + } + + // Convert no matter what (that way responseXXX fields are always set) + response = ajaxConvert( s, response, jqXHR, isSuccess ); + + // If successful, handle type chaining + if ( isSuccess ) { + + // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. + if ( s.ifModified ) { + modified = jqXHR.getResponseHeader( "Last-Modified" ); + if ( modified ) { + jQuery.lastModified[ cacheURL ] = modified; + } + modified = jqXHR.getResponseHeader( "etag" ); + if ( modified ) { + jQuery.etag[ cacheURL ] = modified; + } + } + + // if no content + if ( status === 204 || s.type === "HEAD" ) { + statusText = "nocontent"; + + // if not modified + } else if ( status === 304 ) { + statusText = "notmodified"; + + // If we have data, let's convert it + } else { + statusText = response.state; + success = response.data; + error = response.error; + isSuccess = !error; + } + } else { + + // Extract error from statusText and normalize for non-aborts + error = statusText; + if ( status || !statusText ) { + statusText = "error"; + if ( status < 0 ) { + status = 0; + } + } + } + + // Set data for the fake xhr object + jqXHR.status = status; + jqXHR.statusText = ( nativeStatusText || statusText ) + ""; + + // Success/Error + if ( isSuccess ) { + deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] ); + } else { + deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] ); + } + + // Status-dependent callbacks + jqXHR.statusCode( statusCode ); + statusCode = undefined; + + if ( fireGlobals ) { + globalEventContext.trigger( isSuccess ? "ajaxSuccess" : "ajaxError", + [ jqXHR, s, isSuccess ? success : error ] ); + } + + // Complete + completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] ); + + if ( fireGlobals ) { + globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] ); + + // Handle the global AJAX counter + if ( !( --jQuery.active ) ) { + jQuery.event.trigger( "ajaxStop" ); + } + } + } + + return jqXHR; + }, + + getJSON: function( url, data, callback ) { + return jQuery.get( url, data, callback, "json" ); + }, + + getScript: function( url, callback ) { + return jQuery.get( url, undefined, callback, "script" ); + } +} ); + +jQuery.each( [ "get", "post" ], function( _i, method ) { + jQuery[ method ] = function( url, data, callback, type ) { + + // Shift arguments if data argument was omitted + if ( isFunction( data ) ) { + type = type || callback; + callback = data; + data = undefined; + } + + // The url can be an options object (which then must have .url) + return jQuery.ajax( jQuery.extend( { + url: url, + type: method, + dataType: type, + data: data, + success: callback + }, jQuery.isPlainObject( url ) && url ) ); + }; +} ); + +jQuery.ajaxPrefilter( function( s ) { + var i; + for ( i in s.headers ) { + if ( i.toLowerCase() === "content-type" ) { + s.contentType = s.headers[ i ] || ""; + } + } +} ); + + +jQuery._evalUrl = function( url, options, doc ) { + return jQuery.ajax( { + url: url, + + // Make this explicit, since user can override this through ajaxSetup (#11264) + type: "GET", + dataType: "script", + cache: true, + async: false, + global: false, + + // Only evaluate the response if it is successful (gh-4126) + // dataFilter is not invoked for failure responses, so using it instead + // of the default converter is kludgy but it works. + converters: { + "text script": function() {} + }, + dataFilter: function( response ) { + jQuery.globalEval( response, options, doc ); + } + } ); +}; + + +jQuery.fn.extend( { + wrapAll: function( html ) { + var wrap; + + if ( this[ 0 ] ) { + if ( isFunction( html ) ) { + html = html.call( this[ 0 ] ); + } + + // The elements to wrap the target around + wrap = jQuery( html, this[ 0 ].ownerDocument ).eq( 0 ).clone( true ); + + if ( this[ 0 ].parentNode ) { + wrap.insertBefore( this[ 0 ] ); + } + + wrap.map( function() { + var elem = this; + + while ( elem.firstElementChild ) { + elem = elem.firstElementChild; + } + + return elem; + } ).append( this ); + } + + return this; + }, + + wrapInner: function( html ) { + if ( isFunction( html ) ) { + return this.each( function( i ) { + jQuery( this ).wrapInner( html.call( this, i ) ); + } ); + } + + return this.each( function() { + var self = jQuery( this ), + contents = self.contents(); + + if ( contents.length ) { + contents.wrapAll( html ); + + } else { + self.append( html ); + } + } ); + }, + + wrap: function( html ) { + var htmlIsFunction = isFunction( html ); + + return this.each( function( i ) { + jQuery( this ).wrapAll( htmlIsFunction ? html.call( this, i ) : html ); + } ); + }, + + unwrap: function( selector ) { + this.parent( selector ).not( "body" ).each( function() { + jQuery( this ).replaceWith( this.childNodes ); + } ); + return this; + } +} ); + + +jQuery.expr.pseudos.hidden = function( elem ) { + return !jQuery.expr.pseudos.visible( elem ); +}; +jQuery.expr.pseudos.visible = function( elem ) { + return !!( elem.offsetWidth || elem.offsetHeight || elem.getClientRects().length ); +}; + + + + +jQuery.ajaxSettings.xhr = function() { + try { + return new window.XMLHttpRequest(); + } catch ( e ) {} +}; + +var xhrSuccessStatus = { + + // File protocol always yields status code 0, assume 200 + 0: 200, + + // Support: IE <=9 only + // #1450: sometimes IE returns 1223 when it should be 204 + 1223: 204 + }, + xhrSupported = jQuery.ajaxSettings.xhr(); + +support.cors = !!xhrSupported && ( "withCredentials" in xhrSupported ); +support.ajax = xhrSupported = !!xhrSupported; + +jQuery.ajaxTransport( function( options ) { + var callback, errorCallback; + + // Cross domain only allowed if supported through XMLHttpRequest + if ( support.cors || xhrSupported && !options.crossDomain ) { + return { + send: function( headers, complete ) { + var i, + xhr = options.xhr(); + + xhr.open( + options.type, + options.url, + options.async, + options.username, + options.password + ); + + // Apply custom fields if provided + if ( options.xhrFields ) { + for ( i in options.xhrFields ) { + xhr[ i ] = options.xhrFields[ i ]; + } + } + + // Override mime type if needed + if ( options.mimeType && xhr.overrideMimeType ) { + xhr.overrideMimeType( options.mimeType ); + } + + // X-Requested-With header + // For cross-domain requests, seeing as conditions for a preflight are + // akin to a jigsaw puzzle, we simply never set it to be sure. + // (it can always be set on a per-request basis or even using ajaxSetup) + // For same-domain requests, won't change header if already provided. + if ( !options.crossDomain && !headers[ "X-Requested-With" ] ) { + headers[ "X-Requested-With" ] = "XMLHttpRequest"; + } + + // Set headers + for ( i in headers ) { + xhr.setRequestHeader( i, headers[ i ] ); + } + + // Callback + callback = function( type ) { + return function() { + if ( callback ) { + callback = errorCallback = xhr.onload = + xhr.onerror = xhr.onabort = xhr.ontimeout = + xhr.onreadystatechange = null; + + if ( type === "abort" ) { + xhr.abort(); + } else if ( type === "error" ) { + + // Support: IE <=9 only + // On a manual native abort, IE9 throws + // errors on any property access that is not readyState + if ( typeof xhr.status !== "number" ) { + complete( 0, "error" ); + } else { + complete( + + // File: protocol always yields status 0; see #8605, #14207 + xhr.status, + xhr.statusText + ); + } + } else { + complete( + xhrSuccessStatus[ xhr.status ] || xhr.status, + xhr.statusText, + + // Support: IE <=9 only + // IE9 has no XHR2 but throws on binary (trac-11426) + // For XHR2 non-text, let the caller handle it (gh-2498) + ( xhr.responseType || "text" ) !== "text" || + typeof xhr.responseText !== "string" ? + { binary: xhr.response } : + { text: xhr.responseText }, + xhr.getAllResponseHeaders() + ); + } + } + }; + }; + + // Listen to events + xhr.onload = callback(); + errorCallback = xhr.onerror = xhr.ontimeout = callback( "error" ); + + // Support: IE 9 only + // Use onreadystatechange to replace onabort + // to handle uncaught aborts + if ( xhr.onabort !== undefined ) { + xhr.onabort = errorCallback; + } else { + xhr.onreadystatechange = function() { + + // Check readyState before timeout as it changes + if ( xhr.readyState === 4 ) { + + // Allow onerror to be called first, + // but that will not handle a native abort + // Also, save errorCallback to a variable + // as xhr.onerror cannot be accessed + window.setTimeout( function() { + if ( callback ) { + errorCallback(); + } + } ); + } + }; + } + + // Create the abort callback + callback = callback( "abort" ); + + try { + + // Do send the request (this may raise an exception) + xhr.send( options.hasContent && options.data || null ); + } catch ( e ) { + + // #14683: Only rethrow if this hasn't been notified as an error yet + if ( callback ) { + throw e; + } + } + }, + + abort: function() { + if ( callback ) { + callback(); + } + } + }; + } +} ); + + + + +// Prevent auto-execution of scripts when no explicit dataType was provided (See gh-2432) +jQuery.ajaxPrefilter( function( s ) { + if ( s.crossDomain ) { + s.contents.script = false; + } +} ); + +// Install script dataType +jQuery.ajaxSetup( { + accepts: { + script: "text/javascript, application/javascript, " + + "application/ecmascript, application/x-ecmascript" + }, + contents: { + script: /\b(?:java|ecma)script\b/ + }, + converters: { + "text script": function( text ) { + jQuery.globalEval( text ); + return text; + } + } +} ); + +// Handle cache's special case and crossDomain +jQuery.ajaxPrefilter( "script", function( s ) { + if ( s.cache === undefined ) { + s.cache = false; + } + if ( s.crossDomain ) { + s.type = "GET"; + } +} ); + +// Bind script tag hack transport +jQuery.ajaxTransport( "script", function( s ) { + + // This transport only deals with cross domain or forced-by-attrs requests + if ( s.crossDomain || s.scriptAttrs ) { + var script, callback; + return { + send: function( _, complete ) { + script = jQuery( " + + + + + + + + + \ No newline at end of file diff --git a/Wiki/ENG_Guide/html/index.html b/Wiki/ENG_Guide/html/index.html new file mode 100644 index 00000000..49afe94f --- /dev/null +++ b/Wiki/ENG_Guide/html/index.html @@ -0,0 +1,997 @@ + + + + + + + Home - pyOpenRPA v1.2.0 documentation + + + + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + + + + + + + +
    +
    +
    + +
    +
    +
    pyOpenRPA v1.2.0 documentation
     +
    +
    + +
    +
    + +
    +
    +
    + +
    +

    Welcome to pyOpenRPA’s documentation!

    +
    +
    +

    Indices and tables

    + +
    +
    +

    pyOpenRPA Orchestrator

    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.AgentActivityItemAdd(inGSettings, inHostNameStr, inUserStr, inActivityItemDict)[source]
    +

    Add activity in AgentDict. Check if item is created

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inHostNameStr – Agent host name

      • +

    • inUserStr – User login, where agent is based

      • +

    • inActivityItemDict – ActivityItem

      • +
    +
    +
    Returns
    +

    sad

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.AgentOSCMD(inGSettings, inHostNameStr, inUserStr, inCMDStr, inRunAsyncBool=True)[source]
    +

    pyOpenRPA.Agent: Send CMD to OS. Result return to log + Orchestrator by the A2O connection +def OSCMD(inCMDStr, inRunAsyncBool=True, inGSettings=None): +Send to agent activity item to OSCMD

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inHostNameStr –

      • +

    • inUserStr –

      • +

    • inCMDStr –

      • +

    • inRunAsyncBool –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.AgentOSFileBinaryDataBase64StrCreate(inGSettings, inHostNameStr, inUserStr, inFilePathStr, inFileDataBase64Str)[source]
    +

    pyOpenRPA.Agent: Create binary file by the base64 string (safe for JSON transmission) +def OSFileBinaryDataBase64StrCreate(inFilePathStr, inFileDataBase64Str,inGSettings = None): +Send binary file to Agent (base64 string)

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inHostNameStr –

      • +

    • inUserStr –

      • +

    • inFilePathStr –

      • +

    • inFileDataBase64Str –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.AgentOSFileBinaryDataBytesCreate(inGSettings, inHostNameStr, inUserStr, inFilePathStr, inFileDataBytes)[source]
    +

    pyOpenRPA.Agent: Create binary file by the base64 string (safe for JSON transmition) +def OSFileBinaryDataBase64StrCreate(inFilePathStr, inFileDataBase64Str,inGSettings = None): +Send binary file to Agent (Bytes)

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inHostNameStr –

      • +

    • inUserStr –

      • +

    • inFilePathStr –

      • +

    • inFileDataBytes –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.AgentOSFileTextDataStrCreate(inGSettings, inHostNameStr, inUserStr, inFilePathStr, inFileDataStr, inEncodingStr='utf-8')[source]
    +

    pyOpenRPA.Agent: Create text file by the string +def OSFileTextDataStrCreate(inFilePathStr, inFileDataStr, inEncodingStr = “utf-8”,inGSettings = None): +Create Activity Item for the agent

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inHostNameStr –

      • +

    • inUserStr –

      • +

    • inFilePathStr –

      • +

    • inFileDataStr –

      • +

    • inEncodingStr –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsAutocleaner(inGSettings)[source]
    +

    Interval gsettings auto cleaner

    +
    +
    Parameters
    +

    inGSettings – Global settings dict (singleton)

    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsKeyListValueAppend(inGSettings, inValue, inKeyList=None)[source]
    +

    Append value in GSettings by the key list

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inValue –

      • +

    • inKeyList –

      • +
    +
    +
    Returns
    +

    True every time

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsKeyListValueGet(inGSettings, inKeyList=None)[source]
    +

    Get the value from the GSettings by the key list

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inKeyList –

      • +
    +
    +
    Returns
    +

    value any type

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsKeyListValueOperatorPlus(inGSettings, inValue, inKeyList=None)[source]
    +

    Operator plus value in GSettings by the key list

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inValue –

      • +

    • inKeyList –

      • +
    +
    +
    Returns
    +

    True every time

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsKeyListValueSet(inGSettings, inValue, inKeyList=None)[source]
    +

    Set value in GSettings by the key list

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inValue –

      • +

    • inKeyList –

      • +
    +
    +
    Returns
    +

    bool

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.OSCMD(inCMDStr, inRunAsyncBool=True, inLogger=None)[source]
    +

    OS send command in shell locally

    +
    +
    Parameters
    +
      +

    • inCMDStr –

      • +

    • inRunAsyncBool –

      • +

    • inLogger –

      • +
    +
    +
    Returns
    +

    CMD result string

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.OSCredentialsVerify(inUserStr, inPasswordStr, inDomainStr='')[source]
    +

    Verify user credentials in windows. Return bool

    +
    +
    Parameters
    +
      +

    • inUserStr –

      • +

    • inPasswordStr –

      • +

    • inDomainStr –

      • +
    +
    +
    Returns
    +

    True - Credentials are actual; False - Credentials are not actual

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.OrchestratorRestart(inGSettings=None)[source]
    +

    Orchestrator restart

    +
    +
    Parameters
    +

    inGSettings – Global settings dict (singleton)

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.OrchestratorSessionSave(inGSettings=None)[source]
    +

    Orchestrator session save in file _SessionLast_RDPList.json (encoding = “utf-8”)

    +
    +
    Parameters
    +

    inGSettings – Global settings dict (singleton)

    +
    +
    Returns
    +

    True every time

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.ProcessIsStarted(inProcessNameWOExeStr)[source]
    +

    Check if there is any running process that contains the given name processName.

    +
    +
    Parameters
    +

    inProcessNameWOExeStr –

    +
    +
    Returns
    +

    True - process is running; False - process is not running

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.ProcessListGet(inProcessNameWOExeList=None)[source]
    +

    Check activity of the list of processes

    +
    +
    Parameters
    +

    inProcessNameWOExeList –

    +
    +
    Returns
    +

    TODO FILL THE RESULT DICT

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.ProcessStart(inPathStr, inArgList, inStopProcessNameWOExeStr=None)[source]
    +

    Start process locally [optional: if task name is not started]

    +
    +
    Parameters
    +
      +

    • inPathStr –

      • +

    • inArgList –

      • +

    • inStopProcessNameWOExeStr –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.ProcessStop(inProcessNameWOExeStr, inCloseForceBool, inUserNameStr='%username%')[source]
    +

    Stop process

    +
    +
    Parameters
    +
      +

    • inProcessNameWOExeStr –

      • +

    • inCloseForceBool –

      • +

    • inUserNameStr –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.ProcessorActivityItemAppend(inGSettings, inDef, inArgList=None, inArgDict=None, inArgGSettingsStr=None, inArgLoggerStr=None)[source]
    +

    Add Activity item in Processor list

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inDef –

      • +

    • inArgList –

      • +

    • inArgDict –

      • +

    • inArgGSettingsStr –

      • +

    • inArgLoggerStr –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.ProcessorActivityItemCreate(inDef, inArgList=None, inArgDict=None, inArgGSettingsStr=None, inArgLoggerStr=None)[source]
    +

    Create ActivityItem

    +
    +
    Parameters
    +
      +

    • inDef –

      • +

    • inArgList –

      • +

    • inArgDict –

      • +

    • inArgGSettingsStr –

      • +

    • inArgLoggerStr –

      • +
    +
    +
    Returns
    +

    {}

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.ProcessorAliasDefCreate(inGSettings, inDef, inAliasStr=None)[source]
    +

    Create alias for def (can be used in ActivityItem in field Def)

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inDef –

      • +

    • inAliasStr –

      • +
    +
    +
    Returns
    +

    str Alias

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.ProcessorAliasDefUpdate(inGSettings, inDef, inAliasStr)[source]
    +

    Update alias for def (can be used in ActivityItem in field Def)

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inDef –

      • +

    • inAliasStr –

      • +
    +
    +
    Returns
    +

    str Alias

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.PythonStart(inModulePathStr, inDefNameStr, inArgList=None, inArgDict=None, inLogger=None)[source]
    +

    Python import module and start def

    +
    +
    Parameters
    +
      +

    • inModulePathStr –

      • +

    • inDefNameStr –

      • +

    • inArgList –

      • +

    • inArgDict –

      • +

    • inLogger –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionCMDRun(inGSettings, inRDPSessionKeyStr, inCMDStr, inModeStr='CROSSCHECK')[source]
    +

    Send command in RDP session

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +

    • inCMDStr –

      • +

    • inModeStr –

      • +
    +
    +
    Returns
    +

    True - CMD was executed successfully

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionConnect(inGSettings, inRDPSessionKeyStr, inRDPTemplateDict=None, inHostStr=None, inPortStr=None, inLoginStr=None, inPasswordStr=None)[source]
    +
    +
    Create new RDPSession in RobotRDPActive. Attention - activity will be ignored if key is exists

    2 way of the use

    +
    +
    +

    Var 1: inGSettings, inRDPSessionKeyStr, inRDPTemplateDict +Var 2 (Backward compatibility): inGSettings, inRDPSessionKeyStr, inHostStr, inPortStr, inLoginStr, inPasswordStr

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +

    • inRDPTemplateDict –

      • +

    • inHostStr –

      • +

    • inPortStr –

      • +

    • inLoginStr –

      • +

    • inPasswordStr –

      • +
    +
    +
    Returns
    +

    True every time

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionDisconnect(inGSettings, inRDPSessionKeyStr, inBreakTriggerProcessWOExeList=None)[source]
    +

    Disconnect the RDP session

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +

    • inBreakTriggerProcessWOExeList –

      • +
    +
    +
    Returns
    +

    True every time

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionDublicatesResolve(inGSettings)[source]
    +

    Search dublicates in GSettings RDPlist +!def is developing!

    +
    +
    Parameters
    +

    inGSettings – Global settings dict (singleton)

    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionFileStoredRecieve(inGSettings, inRDPSessionKeyStr, inRDPFilePathStr, inHostFilePathStr)[source]
    +

    Receive file from Session RDP to Host using shared drive in RDP

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +

    • inRDPFilePathStr –

      • +

    • inHostFilePathStr –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionFileStoredSend(inGSettings, inRDPSessionKeyStr, inHostFilePathStr, inRDPFilePathStr)[source]
    +

    Send file from Host to Session RDP using shared drive in RDP

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +

    • inHostFilePathStr –

      • +

    • inRDPFilePathStr –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionLogoff(inGSettings, inRDPSessionKeyStr, inBreakTriggerProcessWOExeList=None)[source]
    +

    Logoff the RDP session

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +

    • inBreakTriggerProcessWOExeList –

      • +
    +
    +
    Returns
    +

    True - logoff is successful

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionMonitorStop(inGSettings, inRDPSessionKeyStr)[source]
    +

    Stop track the RDP session. Current def dont kill RDP session - only stop to track it (it can give )

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionProcessStartIfNotRunning(inGSettings, inRDPSessionKeyStr, inProcessNameWEXEStr, inFilePathStr, inFlagGetAbsPathBool=True)[source]
    +

    Start process if it is not running

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +

    • inProcessNameWEXEStr –

      • +

    • inFilePathStr –

      • +

    • inFlagGetAbsPathBool –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionProcessStop(inGSettings, inRDPSessionKeyStr, inProcessNameWEXEStr, inFlagForceCloseBool)[source]
    +

    Create CMD str to stop process

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +

    • inProcessNameWEXEStr –

      • +

    • inFlagForceCloseBool –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionReconnect(inGSettings, inRDPSessionKeyStr, inRDPTemplateDict=None)[source]
    +

    RDP Session reconnect

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +

    • inRDPTemplateDict –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionResponsibilityCheck(inGSettings, inRDPSessionKeyStr)[source]
    +

    Check RDP Session responsibility TODO NEED DEV + TEST

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inRDPSessionKeyStr –

      • +
    +
    +
    Returns
    +

    True every time

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.RDPTemplateCreate(inLoginStr, inPasswordStr, inHostStr='127.0.0.1', inPortInt=3389, inWidthPXInt=1680, inHeightPXInt=1050, inUseBothMonitorBool=False, inDepthBitInt=32, inSharedDriveList=None)[source]
    +

    Create some RDP template dict to use it when connect/reconnect

    +
    +
    Parameters
    +
      +

    • inLoginStr –

      • +

    • inPasswordStr –

      • +

    • inHostStr –

      • +

    • inPortInt –

      • +

    • inWidthPXInt –

      • +

    • inHeightPXInt –

      • +

    • inUseBothMonitorBool –

      • +

    • inDepthBitInt –

      • +

    • inSharedDriveList –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.SchedulerActivityTimeAddWeekly(inGSettings, inTimeHHMMStr='23:55:', inWeekdayList=None, inActivityList=None)[source]
    +

    Add activity in time weekly

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inTimeHHMMStr –

      • +

    • inWeekdayList –

      • +

    • inActivityList –

      • +
    +
    +
    Returns
    +

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.UACKeyListCheck(inRequest, inRoleKeyList) → bool[source]
    +

    Check is client is has access for the key list

    +
    +
    Parameters
    +
      +

    • inRequest –

      • +

    • inRoleKeyList –

      • +
    +
    +
    Returns
    +

    bool

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.UACSuperTokenUpdate(inGSettings, inSuperTokenStr)[source]
    +

    Add supertoken for the all access (it is need for the robot communication without human)

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inSuperTokenStr –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.UACUpdate(inGSettings, inADLoginStr, inADStr='', inADIsDefaultBool=True, inURLList=None, inRoleHierarchyAllowedDict=None)[source]
    +

    Update user access (UAC)

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inADLoginStr –

      • +

    • inADStr –

      • +

    • inADIsDefaultBool –

      • +

    • inURLList –

      • +

    • inRoleHierarchyAllowedDict –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.WebCPUpdate(inGSettings, inCPKeyStr, inHTMLRenderDef=None, inJSONGeneratorDef=None, inJSInitGeneratorDef=None)[source]
    +

    Add control panel HTML, JSON generator or JS when page init

    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inCPKeyStr –

      • +

    • inHTMLRenderDef –

      • +

    • inJSONGeneratorDef –

      • +

    • inJSInitGeneratorDef –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.WebURLConnectDef(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inDef, inContentTypeStr='application/octet-stream')[source]
    +
    +
    +
    Connect URL to DEF

    “inMethodStr”:”GET|POST”, +“inURLStr”: “/index”, #URL of the request +“inMatchTypeStr”: “”, #”BeginWith|Contains|Equal|EqualCase”, +“inContentTypeStr”: “”, #HTTP Content-type +“inDef”: None #Function with str result

    +
    +
    +
    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inMethodStr –

      • +

    • inURLStr –

      • +

    • inMatchTypeStr –

      • +

    • inDef –

      • +

    • inContentTypeStr –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.WebURLConnectFile(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inFilePathStr, inContentTypeStr='application/octet-stream')[source]
    +
    +
    Connect URL to File

    “inMethodStr”:”GET|POST”, +“inURLStr”: “/index”, #URL of the request +“inMatchTypeStr”: “”, #”BeginWith|Contains|Equal|EqualCase”, +“inFolderPathStr”: “”, #Absolute or relative path

    +
    +
    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inMethodStr –

      • +

    • inURLStr –

      • +

    • inMatchTypeStr –

      • +

    • inFilePathStr –

      • +

    • inContentTypeStr –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.WebURLConnectFolder(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inFolderPathStr)[source]
    +
    +
    Connect URL to Folder

    “inMethodStr”:”GET|POST”, +“inURLStr”: “/Folder/”, #URL of the request +“inMatchTypeStr”: “”, #”BeginWith|Contains|Equal|EqualCase”, +“inFolderPathStr”: “”, #Absolute or relative path

    +
    +
    +
    +
    Parameters
    +
      +

    • inGSettings – Global settings dict (singleton)

      • +

    • inMethodStr –

      • +

    • inURLStr –

      • +

    • inMatchTypeStr –

      • +

    • inFolderPathStr –

      • +
    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.WebUserInfoGet(inRequest)[source]
    +

    Return User info about request

    +
    +
    Parameters
    +

    inRequest –

    +
    +
    Returns
    +

    {“DomainUpperStr”: “”, “UserNameUpperStr”: “”}

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.WebUserIsSuperToken(inRequest, inGSettings)[source]
    +

    Return bool if request is authentificated with supetoken (token which is never expires)

    +
    +
    Parameters
    +
      +

    • inRequest –

      • +

    • inGSettings – Global settings dict (singleton)

      • +
    +
    +
    Returns
    +

    bool True - is supertoken; False - is not supertoken

    +
    +
    +
    +
    +
    +pyOpenRPA.Orchestrator.__Orchestrator__.WebUserUACHierarchyGet(inRequest)[source]
    +

    Return User UAC Hierarchy DICT Return {…}

    +
    +
    Parameters
    +

    inRequest –

    +
    +
    Returns
    +

    UAC Dict {}

    +
    +
    +
    +
    + +
    + +
    + +
    +
    + + \ No newline at end of file diff --git a/Wiki/ENG_Guide/html/objects.inv b/Wiki/ENG_Guide/html/objects.inv new file mode 100644 index 00000000..f6ef50d6 --- /dev/null +++ b/Wiki/ENG_Guide/html/objects.inv @@ -0,0 +1,12 @@ +# Sphinx inventory version 2 +# Project: pyOpenRPA +# Version: +# The remainder of this file is compressed using zlib. +xڵ͎0VZ /-nEF1k[kdo ۾ֆ \ No newline at end of file diff --git a/Wiki/ENG_Guide/html/py-modindex.html b/Wiki/ENG_Guide/html/py-modindex.html new file mode 100644 index 00000000..c6b17f9b --- /dev/null +++ b/Wiki/ENG_Guide/html/py-modindex.html @@ -0,0 +1,50 @@ + + + + + + + - pyOpenRPA v1.2.0 documentation + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/Wiki/ENG_Guide/html/search.html b/Wiki/ENG_Guide/html/search.html new file mode 100644 index 00000000..0234b527 --- /dev/null +++ b/Wiki/ENG_Guide/html/search.html @@ -0,0 +1,166 @@ + + + + + + Search - pyOpenRPA v1.2.0 documentation + + + + + + + + + + + + + + + + + + + Contents + + + + + + + + + Menu + + + + + + + + Expand + + + + + + + + + + + + +
    +
    +
    + +
    +
    +
    pyOpenRPA v1.2.0 documentation
     +
    +
    + +
    +
    + +
    +
    +
    + + +
    +

    Error

    +

    + Please activate JavaScript to enable the search functionality. +

    +
    + + +
    + +
    + +
    + +
    +
    + + + \ No newline at end of file diff --git a/Wiki/ENG_Guide/html/searchindex.js b/Wiki/ENG_Guide/html/searchindex.js new file mode 100644 index 00000000..62c61b11 --- /dev/null +++ b/Wiki/ENG_Guide/html/searchindex.js @@ -0,0 +1 @@ +Search.setIndex({docnames:["Orchestrator","index"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,"sphinx.ext.todo":2,"sphinx.ext.viewcode":1,sphinx:56},filenames:["Orchestrator.rst","index.rst"],objects:{"pyOpenRPA.Orchestrator":{__Orchestrator__:[1,0,0,"-"]},"pyOpenRPA.Orchestrator.__Orchestrator__":{AgentActivityItemAdd:[1,1,1,""],AgentOSCMD:[1,1,1,""],AgentOSFileBinaryDataBase64StrCreate:[1,1,1,""],AgentOSFileBinaryDataBytesCreate:[1,1,1,""],AgentOSFileTextDataStrCreate:[1,1,1,""],GSettingsAutocleaner:[1,1,1,""],GSettingsKeyListValueAppend:[1,1,1,""],GSettingsKeyListValueGet:[1,1,1,""],GSettingsKeyListValueOperatorPlus:[1,1,1,""],GSettingsKeyListValueSet:[1,1,1,""],OSCMD:[1,1,1,""],OSCredentialsVerify:[1,1,1,""],OrchestratorRestart:[1,1,1,""],OrchestratorSessionSave:[1,1,1,""],ProcessIsStarted:[1,1,1,""],ProcessListGet:[1,1,1,""],ProcessStart:[1,1,1,""],ProcessStop:[1,1,1,""],ProcessorActivityItemAppend:[1,1,1,""],ProcessorActivityItemCreate:[1,1,1,""],ProcessorAliasDefCreate:[1,1,1,""],ProcessorAliasDefUpdate:[1,1,1,""],PythonStart:[1,1,1,""],RDPSessionCMDRun:[1,1,1,""],RDPSessionConnect:[1,1,1,""],RDPSessionDisconnect:[1,1,1,""],RDPSessionDublicatesResolve:[1,1,1,""],RDPSessionFileStoredRecieve:[1,1,1,""],RDPSessionFileStoredSend:[1,1,1,""],RDPSessionLogoff:[1,1,1,""],RDPSessionMonitorStop:[1,1,1,""],RDPSessionProcessStartIfNotRunning:[1,1,1,""],RDPSessionProcessStop:[1,1,1,""],RDPSessionReconnect:[1,1,1,""],RDPSessionResponsibilityCheck:[1,1,1,""],RDPTemplateCreate:[1,1,1,""],SchedulerActivityTimeAddWeekly:[1,1,1,""],UACKeyListCheck:[1,1,1,""],UACSuperTokenUpdate:[1,1,1,""],UACUpdate:[1,1,1,""],WebCPUpdate:[1,1,1,""],WebURLConnectDef:[1,1,1,""],WebURLConnectFile:[1,1,1,""],WebURLConnectFolder:[1,1,1,""],WebUserInfoGet:[1,1,1,""],WebUserIsSuperToken:[1,1,1,""],WebUserUACHierarchyGet:[1,1,1,""]}},objnames:{"0":["py","module","Python module"],"1":["py","function","Python function"]},objtypes:{"0":"py:module","1":"py:function"},terms:{"1050":[0,1],"127":[0,1],"1680":[0,1],"3389":[0,1],"byte":[0,1],"function":[0,1],"import":[0,1],"new":[0,1],"return":[0,1],"true":[0,1],"var":[0,1],THE:[0,1],__orchestrator__:[0,1],_sessionlast_rdplist:[0,1],a2o:[0,1],about:[0,1],absolut:[0,1],access:[0,1],activ:[0,1],activityitem:[0,1],actual:[0,1],add:[0,1],agent:[0,1],agentactivityitemadd:[0,1],agentdict:[0,1],agentoscmd:[0,1],agentosfilebinarydatabase64strcr:[0,1],agentosfilebinarydatabytescr:[0,1],agentosfiletextdatastrcr:[0,1],alia:[0,1],all:[0,1],ani:[0,1],append:[0,1],applic:[0,1],attent:[0,1],authentif:[0,1],auto:[0,1],backward:[0,1],base64:[0,1],base:[0,1],beginwith:[0,1],binari:[0,1],bool:[0,1],can:[0,1],check:[0,1],cleaner:[0,1],client:[0,1],cmd:[0,1],command:[0,1],commun:[0,1],compat:[0,1],connect:[0,1],contain:[0,1],content:[0,1],control:[0,1],creat:[0,1],credenti:[0,1],crosscheck:[0,1],current:[0,1],def:[0,1],dev:[0,1],develop:[0,1],dict:[0,1],disconnect:[0,1],domainupperstr:[0,1],dont:[0,1],drive:[0,1],dublic:[0,1],encod:[0,1],equal:[0,1],equalcas:[0,1],everi:[0,1],execut:[0,1],exist:[0,1],expir:[0,1],fals:[0,1],field:[0,1],file:[0,1],fill:[0,1],folder:[0,1],from:[0,1],gener:[0,1],get:[0,1],give:[0,1],given:[0,1],global:[0,1],gset:[0,1],gsettingsautoclean:[0,1],gsettingskeylistvalueappend:[0,1],gsettingskeylistvalueget:[0,1],gsettingskeylistvalueoperatorplu:[0,1],gsettingskeylistvalueset:[0,1],has:[0,1],hierarchi:[0,1],host:[0,1],html:[0,1],http:[0,1],human:[0,1],ignor:[0,1],inactivityitemdict:[0,1],inactivitylist:[0,1],inadisdefaultbool:[0,1],inadloginstr:[0,1],inadstr:[0,1],inaliasstr:[0,1],inargdict:[0,1],inarggsettingsstr:[0,1],inarglist:[0,1],inargloggerstr:[0,1],inbreaktriggerprocesswoexelist:[0,1],incloseforcebool:[0,1],incmdstr:[0,1],incontenttypestr:[0,1],incpkeystr:[0,1],indef:[0,1],indefnamestr:[0,1],indepthbitint:[0,1],index:[0,1],indomainstr:[0,1],inencodingstr:[0,1],infiledatabase64str:[0,1],infiledatabyt:[0,1],infiledatastr:[0,1],infilepathstr:[0,1],inflagforceclosebool:[0,1],inflaggetabspathbool:[0,1],info:[0,1],infolderpathstr:[0,1],ingset:[0,1],inheightpxint:[0,1],inhostfilepathstr:[0,1],inhostnamestr:[0,1],inhoststr:[0,1],inhtmlrenderdef:[0,1],init:[0,1],injsinitgeneratordef:[0,1],injsongeneratordef:[0,1],inkeylist:[0,1],inlogg:[0,1],inloginstr:[0,1],inmatchtypestr:[0,1],inmethodstr:[0,1],inmodestr:[0,1],inmodulepathstr:[0,1],inpasswordstr:[0,1],inpathstr:[0,1],inportint:[0,1],inportstr:[0,1],inprocessnamewexestr:[0,1],inprocessnamewoexelist:[0,1],inprocessnamewoexestr:[0,1],inrdpfilepathstr:[0,1],inrdpsessionkeystr:[0,1],inrdptemplatedict:[0,1],inrequest:[0,1],inrolehierarchyalloweddict:[0,1],inrolekeylist:[0,1],inrunasyncbool:[0,1],inshareddrivelist:[0,1],instopprocessnamewoexestr:[0,1],insupertokenstr:[0,1],interv:[0,1],intimehhmmstr:[0,1],inurllist:[0,1],inurlstr:[0,1],inusebothmonitorbool:[0,1],inusernamestr:[0,1],inuserstr:[0,1],invalu:[0,1],inweekdaylist:[0,1],inwidthpxint:[0,1],item:[0,1],json:[0,1],kei:[0,1],kill:[0,1],list:[0,1],local:[0,1],log:[0,1],login:[0,1],logoff:[0,1],modul:[0,1],name:[0,1],need:[0,1],never:[0,1],none:[0,1],octet:[0,1],onli:[0,1],oper:[0,1],option:[0,1],orchestratorrestart:[0,1],orchestratorsessionsav:[0,1],oscmd:[0,1],oscredentialsverifi:[0,1],osfilebinarydatabase64strcr:[0,1],osfiletextdatastrcr:[0,1],page:[0,1],panel:[0,1],paramet:[0,1],path:[0,1],plu:[0,1],post:[0,1],process:[0,1],processisstart:[0,1],processlistget:[0,1],processnam:[0,1],processor:[0,1],processoractivityitemappend:[0,1],processoractivityitemcr:[0,1],processoraliasdefcr:[0,1],processoraliasdefupd:[0,1],processstart:[0,1],processstop:[0,1],python:[0,1],pythonstart:[0,1],rdp:[0,1],rdplist:[0,1],rdpsession:[0,1],rdpsessioncmdrun:[0,1],rdpsessionconnect:[0,1],rdpsessiondisconnect:[0,1],rdpsessiondublicatesresolv:[0,1],rdpsessionfilestoredreciev:[0,1],rdpsessionfilestoredsend:[0,1],rdpsessionlogoff:[0,1],rdpsessionmonitorstop:[0,1],rdpsessionprocessstartifnotrun:[0,1],rdpsessionprocessstop:[0,1],rdpsessionreconnect:[0,1],rdpsessionresponsibilitycheck:[0,1],rdptemplatecr:[0,1],receiv:[0,1],reconnect:[0,1],rel:[0,1],request:[0,1],respons:[0,1],restart:[0,1],result:[0,1],robot:[0,1],robotrdpact:[0,1],run:[0,1],sad:[0,1],safe:[0,1],save:[0,1],scheduleractivitytimeaddweekli:[0,1],search:[0,1],send:[0,1],session:[0,1],set:[0,1],share:[0,1],shell:[0,1],singleton:[0,1],some:[0,1],sourc:[0,1],start:[0,1],stop:[0,1],str:[0,1],stream:[0,1],string:[0,1],success:[0,1],successfulli:[0,1],supertoken:[0,1],supetoken:[0,1],task:[0,1],templat:[0,1],test:[0,1],text:[0,1],time:[0,1],todo:[0,1],token:[0,1],track:[0,1],transmiss:[0,1],transmit:[0,1],type:[0,1],uac:[0,1],uackeylistcheck:[0,1],uacsupertokenupd:[0,1],uacupd:[0,1],updat:[0,1],url:[0,1],use:[0,1],used:[0,1],user:[0,1],usernam:[0,1],usernameupperstr:[0,1],using:[0,1],utf:[0,1],valu:[0,1],verifi:[0,1],wai:[0,1],webcpupd:[0,1],weburlconnectdef:[0,1],weburlconnectfil:[0,1],weburlconnectfold:[0,1],webuserinfoget:[0,1],webuserissupertoken:[0,1],webuseruachierarchyget:[0,1],weekli:[0,1],when:[0,1],where:[0,1],which:[0,1],window:[0,1],without:[0,1]},titles:["Welcome to pyOpenRPA\u2019s documentation!","Welcome to pyOpenRPA\u2019s documentation!"],titleterms:{document:[0,1],indic:[0,1],orchestr:[0,1],pyopenrpa:[0,1],tabl:[0,1],welcom:[0,1]}}) \ No newline at end of file diff --git a/Wiki/ENG_Guide/markdown/Orchestrator.md b/Wiki/ENG_Guide/markdown/Orchestrator.md new file mode 100644 index 00000000..75f5b07c --- /dev/null +++ b/Wiki/ENG_Guide/markdown/Orchestrator.md @@ -0,0 +1,1105 @@ + +# Welcome to pyOpenRPA’s documentation! + +# Indices and tables + + +* Index + + +* Module Index + + +* Search Page + +# pyOpenRPA Orchestrator + + +### pyOpenRPA.Orchestrator.__Orchestrator__.AgentActivityItemAdd(inGSettings, inHostNameStr, inUserStr, inActivityItemDict) +Add activity in AgentDict. Check if item is created + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inHostNameStr** – Agent host name + + + * **inUserStr** – User login, where agent is based + + + * **inActivityItemDict** – ActivityItem + + + +* **Returns** + + sad + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.AgentOSCMD(inGSettings, inHostNameStr, inUserStr, inCMDStr, inRunAsyncBool=True) +pyOpenRPA.Agent: Send CMD to OS. Result return to log + Orchestrator by the A2O connection +def OSCMD(inCMDStr, inRunAsyncBool=True, inGSettings=None): +Send to agent activity item to OSCMD + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inHostNameStr** – + + + * **inUserStr** – + + + * **inCMDStr** – + + + * **inRunAsyncBool** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.AgentOSFileBinaryDataBase64StrCreate(inGSettings, inHostNameStr, inUserStr, inFilePathStr, inFileDataBase64Str) +pyOpenRPA.Agent: Create binary file by the base64 string (safe for JSON transmission) +def OSFileBinaryDataBase64StrCreate(inFilePathStr, inFileDataBase64Str,inGSettings = None): +Send binary file to Agent (base64 string) + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inHostNameStr** – + + + * **inUserStr** – + + + * **inFilePathStr** – + + + * **inFileDataBase64Str** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.AgentOSFileBinaryDataBytesCreate(inGSettings, inHostNameStr, inUserStr, inFilePathStr, inFileDataBytes) +pyOpenRPA.Agent: Create binary file by the base64 string (safe for JSON transmition) +def OSFileBinaryDataBase64StrCreate(inFilePathStr, inFileDataBase64Str,inGSettings = None): +Send binary file to Agent (Bytes) + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inHostNameStr** – + + + * **inUserStr** – + + + * **inFilePathStr** – + + + * **inFileDataBytes** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.AgentOSFileTextDataStrCreate(inGSettings, inHostNameStr, inUserStr, inFilePathStr, inFileDataStr, inEncodingStr='utf-8') +pyOpenRPA.Agent: Create text file by the string +def OSFileTextDataStrCreate(inFilePathStr, inFileDataStr, inEncodingStr = “utf-8”,inGSettings = None): +Create Activity Item for the agent + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inHostNameStr** – + + + * **inUserStr** – + + + * **inFilePathStr** – + + + * **inFileDataStr** – + + + * **inEncodingStr** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsAutocleaner(inGSettings) +Interval gsettings auto cleaner + + +* **Parameters** + + **inGSettings** – Global settings dict (singleton) + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsKeyListValueAppend(inGSettings, inValue, inKeyList=None) +Append value in GSettings by the key list + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inValue** – + + + * **inKeyList** – + + + +* **Returns** + + True every time + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsKeyListValueGet(inGSettings, inKeyList=None) +Get the value from the GSettings by the key list + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inKeyList** – + + + +* **Returns** + + value any type + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsKeyListValueOperatorPlus(inGSettings, inValue, inKeyList=None) +Operator plus value in GSettings by the key list + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inValue** – + + + * **inKeyList** – + + + +* **Returns** + + True every time + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsKeyListValueSet(inGSettings, inValue, inKeyList=None) +Set value in GSettings by the key list + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inValue** – + + + * **inKeyList** – + + + +* **Returns** + + bool + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.OSCMD(inCMDStr, inRunAsyncBool=True, inLogger=None) +OS send command in shell locally + + +* **Parameters** + + + * **inCMDStr** – + + + * **inRunAsyncBool** – + + + * **inLogger** – + + + +* **Returns** + + CMD result string + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.OSCredentialsVerify(inUserStr, inPasswordStr, inDomainStr='') +Verify user credentials in windows. Return bool + + +* **Parameters** + + + * **inUserStr** – + + + * **inPasswordStr** – + + + * **inDomainStr** – + + + +* **Returns** + + True - Credentials are actual; False - Credentials are not actual + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.OrchestratorRestart(inGSettings=None) +Orchestrator restart + + +* **Parameters** + + **inGSettings** – Global settings dict (singleton) + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.OrchestratorSessionSave(inGSettings=None) +Orchestrator session save in file _SessionLast_RDPList.json (encoding = “utf-8”) + + +* **Parameters** + + **inGSettings** – Global settings dict (singleton) + + + +* **Returns** + + True every time + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.ProcessIsStarted(inProcessNameWOExeStr) +Check if there is any running process that contains the given name processName. + + +* **Parameters** + + **inProcessNameWOExeStr** – + + + +* **Returns** + + True - process is running; False - process is not running + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.ProcessListGet(inProcessNameWOExeList=None) +Check activity of the list of processes + + +* **Parameters** + + **inProcessNameWOExeList** – + + + +* **Returns** + + TODO FILL THE RESULT DICT + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.ProcessStart(inPathStr, inArgList, inStopProcessNameWOExeStr=None) +Start process locally [optional: if task name is not started] + + +* **Parameters** + + + * **inPathStr** – + + + * **inArgList** – + + + * **inStopProcessNameWOExeStr** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.ProcessStop(inProcessNameWOExeStr, inCloseForceBool, inUserNameStr='%username%') +Stop process + + +* **Parameters** + + + * **inProcessNameWOExeStr** – + + + * **inCloseForceBool** – + + + * **inUserNameStr** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.ProcessorActivityItemAppend(inGSettings, inDef, inArgList=None, inArgDict=None, inArgGSettingsStr=None, inArgLoggerStr=None) +Add Activity item in Processor list + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inDef** – + + + * **inArgList** – + + + * **inArgDict** – + + + * **inArgGSettingsStr** – + + + * **inArgLoggerStr** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.ProcessorActivityItemCreate(inDef, inArgList=None, inArgDict=None, inArgGSettingsStr=None, inArgLoggerStr=None) +Create ActivityItem + + +* **Parameters** + + + * **inDef** – + + + * **inArgList** – + + + * **inArgDict** – + + + * **inArgGSettingsStr** – + + + * **inArgLoggerStr** – + + + +* **Returns** + + {} + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.ProcessorAliasDefCreate(inGSettings, inDef, inAliasStr=None) +Create alias for def (can be used in ActivityItem in field Def) + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inDef** – + + + * **inAliasStr** – + + + +* **Returns** + + str Alias + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.ProcessorAliasDefUpdate(inGSettings, inDef, inAliasStr) +Update alias for def (can be used in ActivityItem in field Def) + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inDef** – + + + * **inAliasStr** – + + + +* **Returns** + + str Alias + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.PythonStart(inModulePathStr, inDefNameStr, inArgList=None, inArgDict=None, inLogger=None) +Python import module and start def + + +* **Parameters** + + + * **inModulePathStr** – + + + * **inDefNameStr** – + + + * **inArgList** – + + + * **inArgDict** – + + + * **inLogger** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionCMDRun(inGSettings, inRDPSessionKeyStr, inCMDStr, inModeStr='CROSSCHECK') +Send command in RDP session + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + * **inCMDStr** – + + + * **inModeStr** – + + + +* **Returns** + + True - CMD was executed successfully + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionConnect(inGSettings, inRDPSessionKeyStr, inRDPTemplateDict=None, inHostStr=None, inPortStr=None, inLoginStr=None, inPasswordStr=None) +Create new RDPSession in RobotRDPActive. Attention - activity will be ignored if key is exists + + 2 way of the use + +Var 1: inGSettings, inRDPSessionKeyStr, inRDPTemplateDict +Var 2 (Backward compatibility): inGSettings, inRDPSessionKeyStr, inHostStr, inPortStr, inLoginStr, inPasswordStr + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + * **inRDPTemplateDict** – + + + * **inHostStr** – + + + * **inPortStr** – + + + * **inLoginStr** – + + + * **inPasswordStr** – + + + +* **Returns** + + True every time + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionDisconnect(inGSettings, inRDPSessionKeyStr, inBreakTriggerProcessWOExeList=None) +Disconnect the RDP session + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + * **inBreakTriggerProcessWOExeList** – + + + +* **Returns** + + True every time + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionDublicatesResolve(inGSettings) +Search dublicates in GSettings RDPlist +!def is developing! + + +* **Parameters** + + **inGSettings** – Global settings dict (singleton) + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionFileStoredRecieve(inGSettings, inRDPSessionKeyStr, inRDPFilePathStr, inHostFilePathStr) +Receive file from Session RDP to Host using shared drive in RDP + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + * **inRDPFilePathStr** – + + + * **inHostFilePathStr** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionFileStoredSend(inGSettings, inRDPSessionKeyStr, inHostFilePathStr, inRDPFilePathStr) +Send file from Host to Session RDP using shared drive in RDP + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + * **inHostFilePathStr** – + + + * **inRDPFilePathStr** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionLogoff(inGSettings, inRDPSessionKeyStr, inBreakTriggerProcessWOExeList=None) +Logoff the RDP session + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + * **inBreakTriggerProcessWOExeList** – + + + +* **Returns** + + True - logoff is successful + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionMonitorStop(inGSettings, inRDPSessionKeyStr) +Stop track the RDP session. Current def dont kill RDP session - only stop to track it (it can give ) + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionProcessStartIfNotRunning(inGSettings, inRDPSessionKeyStr, inProcessNameWEXEStr, inFilePathStr, inFlagGetAbsPathBool=True) +Start process if it is not running + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + * **inProcessNameWEXEStr** – + + + * **inFilePathStr** – + + + * **inFlagGetAbsPathBool** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionProcessStop(inGSettings, inRDPSessionKeyStr, inProcessNameWEXEStr, inFlagForceCloseBool) +Create CMD str to stop process + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + * **inProcessNameWEXEStr** – + + + * **inFlagForceCloseBool** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionReconnect(inGSettings, inRDPSessionKeyStr, inRDPTemplateDict=None) +RDP Session reconnect + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + * **inRDPTemplateDict** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionResponsibilityCheck(inGSettings, inRDPSessionKeyStr) +Check RDP Session responsibility TODO NEED DEV + TEST + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + +* **Returns** + + True every time + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPTemplateCreate(inLoginStr, inPasswordStr, inHostStr='127.0.0.1', inPortInt=3389, inWidthPXInt=1680, inHeightPXInt=1050, inUseBothMonitorBool=False, inDepthBitInt=32, inSharedDriveList=None) +Create some RDP template dict to use it when connect/reconnect + + +* **Parameters** + + + * **inLoginStr** – + + + * **inPasswordStr** – + + + * **inHostStr** – + + + * **inPortInt** – + + + * **inWidthPXInt** – + + + * **inHeightPXInt** – + + + * **inUseBothMonitorBool** – + + + * **inDepthBitInt** – + + + * **inSharedDriveList** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.SchedulerActivityTimeAddWeekly(inGSettings, inTimeHHMMStr='23:55:', inWeekdayList=None, inActivityList=None) +Add activity in time weekly + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inTimeHHMMStr** – + + + * **inWeekdayList** – + + + * **inActivityList** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.UACKeyListCheck(inRequest, inRoleKeyList) +Check is client is has access for the key list + + +* **Parameters** + + + * **inRequest** – + + + * **inRoleKeyList** – + + + +* **Returns** + + bool + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.UACSuperTokenUpdate(inGSettings, inSuperTokenStr) +Add supertoken for the all access (it is need for the robot communication without human) + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inSuperTokenStr** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.UACUpdate(inGSettings, inADLoginStr, inADStr='', inADIsDefaultBool=True, inURLList=None, inRoleHierarchyAllowedDict=None) +Update user access (UAC) + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inADLoginStr** – + + + * **inADStr** – + + + * **inADIsDefaultBool** – + + + * **inURLList** – + + + * **inRoleHierarchyAllowedDict** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.WebCPUpdate(inGSettings, inCPKeyStr, inHTMLRenderDef=None, inJSONGeneratorDef=None, inJSInitGeneratorDef=None) +Add control panel HTML, JSON generator or JS when page init + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inCPKeyStr** – + + + * **inHTMLRenderDef** – + + + * **inJSONGeneratorDef** – + + + * **inJSInitGeneratorDef** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.WebURLConnectDef(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inDef, inContentTypeStr='application/octet-stream') +> Connect URL to DEF + +> “inMethodStr”:”GET|POST”, +> “inURLStr”: “/index”, #URL of the request +> “inMatchTypeStr”: “”, #”BeginWith|Contains|Equal|EqualCase”, +> “inContentTypeStr”: “”, #HTTP Content-type +> “inDef”: None #Function with str result + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inMethodStr** – + + + * **inURLStr** – + + + * **inMatchTypeStr** – + + + * **inDef** – + + + * **inContentTypeStr** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.WebURLConnectFile(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inFilePathStr, inContentTypeStr='application/octet-stream') +Connect URL to File + + “inMethodStr”:”GET|POST”, + “inURLStr”: “/index”, #URL of the request + “inMatchTypeStr”: “”, #”BeginWith|Contains|Equal|EqualCase”, + “inFolderPathStr”: “”, #Absolute or relative path + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inMethodStr** – + + + * **inURLStr** – + + + * **inMatchTypeStr** – + + + * **inFilePathStr** – + + + * **inContentTypeStr** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.WebURLConnectFolder(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inFolderPathStr) +Connect URL to Folder + + “inMethodStr”:”GET|POST”, + “inURLStr”: “/Folder/”, #URL of the request + “inMatchTypeStr”: “”, #”BeginWith|Contains|Equal|EqualCase”, + “inFolderPathStr”: “”, #Absolute or relative path + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inMethodStr** – + + + * **inURLStr** – + + + * **inMatchTypeStr** – + + + * **inFolderPathStr** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.WebUserInfoGet(inRequest) +Return User info about request + + +* **Parameters** + + **inRequest** – + + + +* **Returns** + + {“DomainUpperStr”: “”, “UserNameUpperStr”: “”} + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.WebUserIsSuperToken(inRequest, inGSettings) +Return bool if request is authentificated with supetoken (token which is never expires) + + +* **Parameters** + + + * **inRequest** – + + + * **inGSettings** – Global settings dict (singleton) + + + +* **Returns** + + bool True - is supertoken; False - is not supertoken + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.WebUserUACHierarchyGet(inRequest) +Return User UAC Hierarchy DICT Return {…} + + +* **Parameters** + + **inRequest** – + + + +* **Returns** + + UAC Dict {} diff --git a/Wiki/ENG_Guide/markdown/index.md b/Wiki/ENG_Guide/markdown/index.md new file mode 100644 index 00000000..75f5b07c --- /dev/null +++ b/Wiki/ENG_Guide/markdown/index.md @@ -0,0 +1,1105 @@ + +# Welcome to pyOpenRPA’s documentation! + +# Indices and tables + + +* Index + + +* Module Index + + +* Search Page + +# pyOpenRPA Orchestrator + + +### pyOpenRPA.Orchestrator.__Orchestrator__.AgentActivityItemAdd(inGSettings, inHostNameStr, inUserStr, inActivityItemDict) +Add activity in AgentDict. Check if item is created + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inHostNameStr** – Agent host name + + + * **inUserStr** – User login, where agent is based + + + * **inActivityItemDict** – ActivityItem + + + +* **Returns** + + sad + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.AgentOSCMD(inGSettings, inHostNameStr, inUserStr, inCMDStr, inRunAsyncBool=True) +pyOpenRPA.Agent: Send CMD to OS. Result return to log + Orchestrator by the A2O connection +def OSCMD(inCMDStr, inRunAsyncBool=True, inGSettings=None): +Send to agent activity item to OSCMD + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inHostNameStr** – + + + * **inUserStr** – + + + * **inCMDStr** – + + + * **inRunAsyncBool** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.AgentOSFileBinaryDataBase64StrCreate(inGSettings, inHostNameStr, inUserStr, inFilePathStr, inFileDataBase64Str) +pyOpenRPA.Agent: Create binary file by the base64 string (safe for JSON transmission) +def OSFileBinaryDataBase64StrCreate(inFilePathStr, inFileDataBase64Str,inGSettings = None): +Send binary file to Agent (base64 string) + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inHostNameStr** – + + + * **inUserStr** – + + + * **inFilePathStr** – + + + * **inFileDataBase64Str** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.AgentOSFileBinaryDataBytesCreate(inGSettings, inHostNameStr, inUserStr, inFilePathStr, inFileDataBytes) +pyOpenRPA.Agent: Create binary file by the base64 string (safe for JSON transmition) +def OSFileBinaryDataBase64StrCreate(inFilePathStr, inFileDataBase64Str,inGSettings = None): +Send binary file to Agent (Bytes) + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inHostNameStr** – + + + * **inUserStr** – + + + * **inFilePathStr** – + + + * **inFileDataBytes** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.AgentOSFileTextDataStrCreate(inGSettings, inHostNameStr, inUserStr, inFilePathStr, inFileDataStr, inEncodingStr='utf-8') +pyOpenRPA.Agent: Create text file by the string +def OSFileTextDataStrCreate(inFilePathStr, inFileDataStr, inEncodingStr = “utf-8”,inGSettings = None): +Create Activity Item for the agent + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inHostNameStr** – + + + * **inUserStr** – + + + * **inFilePathStr** – + + + * **inFileDataStr** – + + + * **inEncodingStr** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsAutocleaner(inGSettings) +Interval gsettings auto cleaner + + +* **Parameters** + + **inGSettings** – Global settings dict (singleton) + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsKeyListValueAppend(inGSettings, inValue, inKeyList=None) +Append value in GSettings by the key list + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inValue** – + + + * **inKeyList** – + + + +* **Returns** + + True every time + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsKeyListValueGet(inGSettings, inKeyList=None) +Get the value from the GSettings by the key list + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inKeyList** – + + + +* **Returns** + + value any type + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsKeyListValueOperatorPlus(inGSettings, inValue, inKeyList=None) +Operator plus value in GSettings by the key list + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inValue** – + + + * **inKeyList** – + + + +* **Returns** + + True every time + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.GSettingsKeyListValueSet(inGSettings, inValue, inKeyList=None) +Set value in GSettings by the key list + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inValue** – + + + * **inKeyList** – + + + +* **Returns** + + bool + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.OSCMD(inCMDStr, inRunAsyncBool=True, inLogger=None) +OS send command in shell locally + + +* **Parameters** + + + * **inCMDStr** – + + + * **inRunAsyncBool** – + + + * **inLogger** – + + + +* **Returns** + + CMD result string + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.OSCredentialsVerify(inUserStr, inPasswordStr, inDomainStr='') +Verify user credentials in windows. Return bool + + +* **Parameters** + + + * **inUserStr** – + + + * **inPasswordStr** – + + + * **inDomainStr** – + + + +* **Returns** + + True - Credentials are actual; False - Credentials are not actual + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.OrchestratorRestart(inGSettings=None) +Orchestrator restart + + +* **Parameters** + + **inGSettings** – Global settings dict (singleton) + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.OrchestratorSessionSave(inGSettings=None) +Orchestrator session save in file _SessionLast_RDPList.json (encoding = “utf-8”) + + +* **Parameters** + + **inGSettings** – Global settings dict (singleton) + + + +* **Returns** + + True every time + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.ProcessIsStarted(inProcessNameWOExeStr) +Check if there is any running process that contains the given name processName. + + +* **Parameters** + + **inProcessNameWOExeStr** – + + + +* **Returns** + + True - process is running; False - process is not running + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.ProcessListGet(inProcessNameWOExeList=None) +Check activity of the list of processes + + +* **Parameters** + + **inProcessNameWOExeList** – + + + +* **Returns** + + TODO FILL THE RESULT DICT + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.ProcessStart(inPathStr, inArgList, inStopProcessNameWOExeStr=None) +Start process locally [optional: if task name is not started] + + +* **Parameters** + + + * **inPathStr** – + + + * **inArgList** – + + + * **inStopProcessNameWOExeStr** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.ProcessStop(inProcessNameWOExeStr, inCloseForceBool, inUserNameStr='%username%') +Stop process + + +* **Parameters** + + + * **inProcessNameWOExeStr** – + + + * **inCloseForceBool** – + + + * **inUserNameStr** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.ProcessorActivityItemAppend(inGSettings, inDef, inArgList=None, inArgDict=None, inArgGSettingsStr=None, inArgLoggerStr=None) +Add Activity item in Processor list + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inDef** – + + + * **inArgList** – + + + * **inArgDict** – + + + * **inArgGSettingsStr** – + + + * **inArgLoggerStr** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.ProcessorActivityItemCreate(inDef, inArgList=None, inArgDict=None, inArgGSettingsStr=None, inArgLoggerStr=None) +Create ActivityItem + + +* **Parameters** + + + * **inDef** – + + + * **inArgList** – + + + * **inArgDict** – + + + * **inArgGSettingsStr** – + + + * **inArgLoggerStr** – + + + +* **Returns** + + {} + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.ProcessorAliasDefCreate(inGSettings, inDef, inAliasStr=None) +Create alias for def (can be used in ActivityItem in field Def) + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inDef** – + + + * **inAliasStr** – + + + +* **Returns** + + str Alias + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.ProcessorAliasDefUpdate(inGSettings, inDef, inAliasStr) +Update alias for def (can be used in ActivityItem in field Def) + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inDef** – + + + * **inAliasStr** – + + + +* **Returns** + + str Alias + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.PythonStart(inModulePathStr, inDefNameStr, inArgList=None, inArgDict=None, inLogger=None) +Python import module and start def + + +* **Parameters** + + + * **inModulePathStr** – + + + * **inDefNameStr** – + + + * **inArgList** – + + + * **inArgDict** – + + + * **inLogger** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionCMDRun(inGSettings, inRDPSessionKeyStr, inCMDStr, inModeStr='CROSSCHECK') +Send command in RDP session + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + * **inCMDStr** – + + + * **inModeStr** – + + + +* **Returns** + + True - CMD was executed successfully + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionConnect(inGSettings, inRDPSessionKeyStr, inRDPTemplateDict=None, inHostStr=None, inPortStr=None, inLoginStr=None, inPasswordStr=None) +Create new RDPSession in RobotRDPActive. Attention - activity will be ignored if key is exists + + 2 way of the use + +Var 1: inGSettings, inRDPSessionKeyStr, inRDPTemplateDict +Var 2 (Backward compatibility): inGSettings, inRDPSessionKeyStr, inHostStr, inPortStr, inLoginStr, inPasswordStr + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + * **inRDPTemplateDict** – + + + * **inHostStr** – + + + * **inPortStr** – + + + * **inLoginStr** – + + + * **inPasswordStr** – + + + +* **Returns** + + True every time + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionDisconnect(inGSettings, inRDPSessionKeyStr, inBreakTriggerProcessWOExeList=None) +Disconnect the RDP session + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + * **inBreakTriggerProcessWOExeList** – + + + +* **Returns** + + True every time + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionDublicatesResolve(inGSettings) +Search dublicates in GSettings RDPlist +!def is developing! + + +* **Parameters** + + **inGSettings** – Global settings dict (singleton) + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionFileStoredRecieve(inGSettings, inRDPSessionKeyStr, inRDPFilePathStr, inHostFilePathStr) +Receive file from Session RDP to Host using shared drive in RDP + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + * **inRDPFilePathStr** – + + + * **inHostFilePathStr** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionFileStoredSend(inGSettings, inRDPSessionKeyStr, inHostFilePathStr, inRDPFilePathStr) +Send file from Host to Session RDP using shared drive in RDP + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + * **inHostFilePathStr** – + + + * **inRDPFilePathStr** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionLogoff(inGSettings, inRDPSessionKeyStr, inBreakTriggerProcessWOExeList=None) +Logoff the RDP session + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + * **inBreakTriggerProcessWOExeList** – + + + +* **Returns** + + True - logoff is successful + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionMonitorStop(inGSettings, inRDPSessionKeyStr) +Stop track the RDP session. Current def dont kill RDP session - only stop to track it (it can give ) + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionProcessStartIfNotRunning(inGSettings, inRDPSessionKeyStr, inProcessNameWEXEStr, inFilePathStr, inFlagGetAbsPathBool=True) +Start process if it is not running + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + * **inProcessNameWEXEStr** – + + + * **inFilePathStr** – + + + * **inFlagGetAbsPathBool** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionProcessStop(inGSettings, inRDPSessionKeyStr, inProcessNameWEXEStr, inFlagForceCloseBool) +Create CMD str to stop process + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + * **inProcessNameWEXEStr** – + + + * **inFlagForceCloseBool** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionReconnect(inGSettings, inRDPSessionKeyStr, inRDPTemplateDict=None) +RDP Session reconnect + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + * **inRDPTemplateDict** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPSessionResponsibilityCheck(inGSettings, inRDPSessionKeyStr) +Check RDP Session responsibility TODO NEED DEV + TEST + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inRDPSessionKeyStr** – + + + +* **Returns** + + True every time + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.RDPTemplateCreate(inLoginStr, inPasswordStr, inHostStr='127.0.0.1', inPortInt=3389, inWidthPXInt=1680, inHeightPXInt=1050, inUseBothMonitorBool=False, inDepthBitInt=32, inSharedDriveList=None) +Create some RDP template dict to use it when connect/reconnect + + +* **Parameters** + + + * **inLoginStr** – + + + * **inPasswordStr** – + + + * **inHostStr** – + + + * **inPortInt** – + + + * **inWidthPXInt** – + + + * **inHeightPXInt** – + + + * **inUseBothMonitorBool** – + + + * **inDepthBitInt** – + + + * **inSharedDriveList** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.SchedulerActivityTimeAddWeekly(inGSettings, inTimeHHMMStr='23:55:', inWeekdayList=None, inActivityList=None) +Add activity in time weekly + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inTimeHHMMStr** – + + + * **inWeekdayList** – + + + * **inActivityList** – + + + +* **Returns** + + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.UACKeyListCheck(inRequest, inRoleKeyList) +Check is client is has access for the key list + + +* **Parameters** + + + * **inRequest** – + + + * **inRoleKeyList** – + + + +* **Returns** + + bool + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.UACSuperTokenUpdate(inGSettings, inSuperTokenStr) +Add supertoken for the all access (it is need for the robot communication without human) + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inSuperTokenStr** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.UACUpdate(inGSettings, inADLoginStr, inADStr='', inADIsDefaultBool=True, inURLList=None, inRoleHierarchyAllowedDict=None) +Update user access (UAC) + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inADLoginStr** – + + + * **inADStr** – + + + * **inADIsDefaultBool** – + + + * **inURLList** – + + + * **inRoleHierarchyAllowedDict** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.WebCPUpdate(inGSettings, inCPKeyStr, inHTMLRenderDef=None, inJSONGeneratorDef=None, inJSInitGeneratorDef=None) +Add control panel HTML, JSON generator or JS when page init + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inCPKeyStr** – + + + * **inHTMLRenderDef** – + + + * **inJSONGeneratorDef** – + + + * **inJSInitGeneratorDef** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.WebURLConnectDef(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inDef, inContentTypeStr='application/octet-stream') +> Connect URL to DEF + +> “inMethodStr”:”GET|POST”, +> “inURLStr”: “/index”, #URL of the request +> “inMatchTypeStr”: “”, #”BeginWith|Contains|Equal|EqualCase”, +> “inContentTypeStr”: “”, #HTTP Content-type +> “inDef”: None #Function with str result + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inMethodStr** – + + + * **inURLStr** – + + + * **inMatchTypeStr** – + + + * **inDef** – + + + * **inContentTypeStr** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.WebURLConnectFile(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inFilePathStr, inContentTypeStr='application/octet-stream') +Connect URL to File + + “inMethodStr”:”GET|POST”, + “inURLStr”: “/index”, #URL of the request + “inMatchTypeStr”: “”, #”BeginWith|Contains|Equal|EqualCase”, + “inFolderPathStr”: “”, #Absolute or relative path + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inMethodStr** – + + + * **inURLStr** – + + + * **inMatchTypeStr** – + + + * **inFilePathStr** – + + + * **inContentTypeStr** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.WebURLConnectFolder(inGSettings, inMethodStr, inURLStr, inMatchTypeStr, inFolderPathStr) +Connect URL to Folder + + “inMethodStr”:”GET|POST”, + “inURLStr”: “/Folder/”, #URL of the request + “inMatchTypeStr”: “”, #”BeginWith|Contains|Equal|EqualCase”, + “inFolderPathStr”: “”, #Absolute or relative path + + +* **Parameters** + + + * **inGSettings** – Global settings dict (singleton) + + + * **inMethodStr** – + + + * **inURLStr** – + + + * **inMatchTypeStr** – + + + * **inFolderPathStr** – + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.WebUserInfoGet(inRequest) +Return User info about request + + +* **Parameters** + + **inRequest** – + + + +* **Returns** + + {“DomainUpperStr”: “”, “UserNameUpperStr”: “”} + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.WebUserIsSuperToken(inRequest, inGSettings) +Return bool if request is authentificated with supetoken (token which is never expires) + + +* **Parameters** + + + * **inRequest** – + + + * **inGSettings** – Global settings dict (singleton) + + + +* **Returns** + + bool True - is supertoken; False - is not supertoken + + + +### pyOpenRPA.Orchestrator.__Orchestrator__.WebUserUACHierarchyGet(inRequest) +Return User UAC Hierarchy DICT Return {…} + + +* **Parameters** + + **inRequest** – + + + +* **Returns** + + UAC Dict {} diff --git a/Wiki/Help/Basic Syntax _ Markdown Guide.html b/Wiki/_/Basic Syntax _ Markdown Guide.html similarity index 100% rename from Wiki/Help/Basic Syntax _ Markdown Guide.html rename to Wiki/_/Basic Syntax _ Markdown Guide.html diff --git a/Wiki/Help/Basic Syntax _ Markdown Guide_files/1066bc339a3beded5f6c4279870b406c047460fe.js.Без названия b/Wiki/_/Basic Syntax _ Markdown Guide_files/1066bc339a3beded5f6c4279870b406c047460fe.js.Без названия similarity index 100% rename from Wiki/Help/Basic Syntax _ Markdown Guide_files/1066bc339a3beded5f6c4279870b406c047460fe.js.Без названия rename to Wiki/_/Basic Syntax _ Markdown Guide_files/1066bc339a3beded5f6c4279870b406c047460fe.js.Без названия diff --git a/Wiki/Help/Basic Syntax _ Markdown Guide_files/2c5110a7ae8f1f020352b27cb55a6d475561dbe9.js.Без названия b/Wiki/_/Basic Syntax _ Markdown Guide_files/2c5110a7ae8f1f020352b27cb55a6d475561dbe9.js.Без названия similarity index 100% rename from Wiki/Help/Basic Syntax _ Markdown Guide_files/2c5110a7ae8f1f020352b27cb55a6d475561dbe9.js.Без названия rename to Wiki/_/Basic Syntax _ Markdown Guide_files/2c5110a7ae8f1f020352b27cb55a6d475561dbe9.js.Без названия diff --git a/Wiki/Help/Basic Syntax _ Markdown Guide_files/2cc5944412d3c5855eb1f26f2dc9a339c6170fff.css b/Wiki/_/Basic Syntax _ Markdown Guide_files/2cc5944412d3c5855eb1f26f2dc9a339c6170fff.css similarity index 100% rename from Wiki/Help/Basic Syntax _ Markdown Guide_files/2cc5944412d3c5855eb1f26f2dc9a339c6170fff.css rename to Wiki/_/Basic Syntax _ Markdown Guide_files/2cc5944412d3c5855eb1f26f2dc9a339c6170fff.css diff --git a/Wiki/Help/Basic Syntax _ Markdown Guide_files/anchor.min.js.Без названия b/Wiki/_/Basic Syntax _ Markdown Guide_files/anchor.min.js.Без названия similarity index 100% rename from Wiki/Help/Basic Syntax _ Markdown Guide_files/anchor.min.js.Без названия rename to Wiki/_/Basic Syntax _ Markdown Guide_files/anchor.min.js.Без названия diff --git a/Wiki/Help/Basic Syntax _ Markdown Guide_files/docsearch.min.js.Без названия b/Wiki/_/Basic Syntax _ Markdown Guide_files/docsearch.min.js.Без названия similarity index 100% rename from Wiki/Help/Basic Syntax _ Markdown Guide_files/docsearch.min.js.Без названия rename to Wiki/_/Basic Syntax _ Markdown Guide_files/docsearch.min.js.Без названия diff --git a/Wiki/Help/Basic Syntax _ Markdown Guide_files/markdown-mark-white.svg b/Wiki/_/Basic Syntax _ Markdown Guide_files/markdown-mark-white.svg similarity index 100% rename from Wiki/Help/Basic Syntax _ Markdown Guide_files/markdown-mark-white.svg rename to Wiki/_/Basic Syntax _ Markdown Guide_files/markdown-mark-white.svg diff --git a/Wiki/Help/Basic Syntax _ Markdown Guide_files/philly-magic-garden.jpg b/Wiki/_/Basic Syntax _ Markdown Guide_files/philly-magic-garden.jpg similarity index 100% rename from Wiki/Help/Basic Syntax _ Markdown Guide_files/philly-magic-garden.jpg rename to Wiki/_/Basic Syntax _ Markdown Guide_files/philly-magic-garden.jpg diff --git a/Wiki/Help/Basic Syntax _ Markdown Guide_files/shiprock.jpg b/Wiki/_/Basic Syntax _ Markdown Guide_files/shiprock.jpg similarity index 100% rename from Wiki/Help/Basic Syntax _ Markdown Guide_files/shiprock.jpg rename to Wiki/_/Basic Syntax _ Markdown Guide_files/shiprock.jpg diff --git a/Wiki/Help/Basic Syntax _ Markdown Guide_files/tux.png b/Wiki/_/Basic Syntax _ Markdown Guide_files/tux.png similarity index 100% rename from Wiki/Help/Basic Syntax _ Markdown Guide_files/tux.png rename to Wiki/_/Basic Syntax _ Markdown Guide_files/tux.png