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 00000000..4e328dde
Binary files /dev/null and b/Wiki/ENG_Guide/doctrees/Orchestrator.doctree differ
diff --git a/Wiki/ENG_Guide/doctrees/environment.pickle b/Wiki/ENG_Guide/doctrees/environment.pickle
new file mode 100644
index 00000000..cb9306ab
Binary files /dev/null and b/Wiki/ENG_Guide/doctrees/environment.pickle differ
diff --git a/Wiki/ENG_Guide/doctrees/index.doctree b/Wiki/ENG_Guide/doctrees/index.doctree
new file mode 100644
index 00000000..89bb1f61
Binary files /dev/null and b/Wiki/ENG_Guide/doctrees/index.doctree differ
diff --git a/Wiki/ENG_Guide/html/.buildinfo b/Wiki/ENG_Guide/html/.buildinfo
new file mode 100644
index 00000000..78249a26
--- /dev/null
+++ b/Wiki/ENG_Guide/html/.buildinfo
@@ -0,0 +1,4 @@
+# Sphinx build info version 1
+# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
+config: 9f06a687c8e45b7b9c0f1fdb96244db7
+tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/Wiki/ENG_Guide/html/Orchestrator.html b/Wiki/ENG_Guide/html/Orchestrator.html
new file mode 100644
index 00000000..550e7055
--- /dev/null
+++ b/Wiki/ENG_Guide/html/Orchestrator.html
@@ -0,0 +1,999 @@
+
+
+
+
+
+
+ Welcome to pyOpenRPA’s documentation! - pyOpenRPA v1.2.0 documentation
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Contents
+
+
+
+
+
+
+
+
+
+ Expand
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
Welcome to pyOpenRPA’s documentation!
+
+
+
+
+
+
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
+
+
+
+
+
+
+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
+
+
+
+
+
+
+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
+
+
+
+
+
+
+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
+
+
+
+
+
+
+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
+
+
+Returns
+True every time
+
+
+
+
+
+pyOpenRPA.Orchestrator.__Orchestrator__.
GSettingsKeyListValueGet
( inGSettings , inKeyList = None ) [source]
+Get the value from the GSettings by the key list
+
+Parameters
+
+
+Returns
+value any type
+
+
+
+
+
+pyOpenRPA.Orchestrator.__Orchestrator__.
GSettingsKeyListValueOperatorPlus
( inGSettings , inValue , inKeyList = None ) [source]
+Operator plus value in GSettings by the key list
+
+Parameters
+
+
+Returns
+True every time
+
+
+
+
+
+pyOpenRPA.Orchestrator.__Orchestrator__.
GSettingsKeyListValueSet
( inGSettings , inValue , inKeyList = None ) [source]
+Set value in GSettings by the key list
+
+Parameters
+
+
+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
+
+
+
+
+
+
+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
+
+
+
+
+
+
+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
+
+
+Returns
+str Alias
+
+
+
+
+
+pyOpenRPA.Orchestrator.__Orchestrator__.
ProcessorAliasDefUpdate
( inGSettings , inDef , inAliasStr ) [source]
+Update alias for def (can be used in ActivityItem in field Def)
+
+Parameters
+
+
+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
+
+
+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
+
+
+Returns
+True every time
+
+
+
+
+
+pyOpenRPA.Orchestrator.__Orchestrator__.
RDPSessionDisconnect
( inGSettings , inRDPSessionKeyStr , inBreakTriggerProcessWOExeList = None ) [source]
+Disconnect the RDP session
+
+Parameters
+
+
+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
+
+
+Returns
+
+
+
+
+
+
+pyOpenRPA.Orchestrator.__Orchestrator__.
RDPSessionFileStoredSend
( inGSettings , inRDPSessionKeyStr , inHostFilePathStr , inRDPFilePathStr ) [source]
+Send file from Host to Session RDP using shared drive in RDP
+
+Parameters
+
+
+Returns
+
+
+
+
+
+
+pyOpenRPA.Orchestrator.__Orchestrator__.
RDPSessionLogoff
( inGSettings , inRDPSessionKeyStr , inBreakTriggerProcessWOExeList = None ) [source]
+Logoff the RDP session
+
+Parameters
+
+
+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
+
+
+Returns
+
+
+
+
+
+
+pyOpenRPA.Orchestrator.__Orchestrator__.
RDPSessionProcessStartIfNotRunning
( inGSettings , inRDPSessionKeyStr , inProcessNameWEXEStr , inFilePathStr , inFlagGetAbsPathBool = True ) [source]
+Start process if it is not running
+
+Parameters
+
+
+Returns
+
+
+
+
+
+
+pyOpenRPA.Orchestrator.__Orchestrator__.
RDPSessionProcessStop
( inGSettings , inRDPSessionKeyStr , inProcessNameWEXEStr , inFlagForceCloseBool ) [source]
+Create CMD str to stop process
+
+Parameters
+
+
+Returns
+
+
+
+
+
+
+pyOpenRPA.Orchestrator.__Orchestrator__.
RDPSessionReconnect
( inGSettings , inRDPSessionKeyStr , inRDPTemplateDict = None ) [source]
+RDP Session reconnect
+
+Parameters
+
+
+Returns
+
+
+
+
+
+
+pyOpenRPA.Orchestrator.__Orchestrator__.
RDPSessionResponsibilityCheck
( inGSettings , inRDPSessionKeyStr ) [source]
+Check RDP Session responsibility TODO NEED DEV + TEST
+
+Parameters
+
+
+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
+
+
+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
+
+
+
+
+
+
+pyOpenRPA.Orchestrator.__Orchestrator__.
UACUpdate
( inGSettings , inADLoginStr , inADStr = '' , inADIsDefaultBool = True , inURLList = None , inRoleHierarchyAllowedDict = None ) [source]
+Update user access (UAC)
+
+Parameters
+
+
+
+
+
+
+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
+
+
+
+
+
+
+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
+
+
+
+
+
+
+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
+
+
+
+
+
+
+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
+
+
+
+
+
+
+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
+
+
+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
+
+
+
+
+
+
+
+
+
+ Expand
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ All modules for which code is available
+
+
+
+
+
+
+
+
+
\ 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
+
+
+
+
+
+
+
+
+
+ Expand
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 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 = " %u sername%" ):
+
"""
+
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() {
+ $('').
+ attr('href', '#' + this.id).
+ attr('title', _('Permalink to this headline')).
+ appendTo(this);
+ });
+ $('dt[id]').each(function() {
+ $('').
+ 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 00000000..a858a410
Binary files /dev/null and b/Wiki/ENG_Guide/html/_static/file.png differ
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 tags with their contents when inserted outside of
+ // the select element.
+ div.innerHTML = " ";
+ 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 = /
+
+
+
+
+
+
+
+
+