Ivan Maslov
3 years ago
parent
a63853915b
commit
ace87c98aa
@ -1,22 +0,0 @@
|
|||||||
####################################
|
|
||||||
2. Roadmap
|
|
||||||
####################################
|
|
||||||
|
|
||||||
- Guide
|
|
||||||
- ENG - done 2021.03.11
|
|
||||||
- HTML `|OPEN GITLAB| <https://gitlab.com/UnicodeLabs/OpenRPA/-/tree/master/Wiki/ENG_Guide/html/index.html>`_
|
|
||||||
- MarkDown `|OPEN GITLAB| <https://gitlab.com/UnicodeLabs/OpenRPA/-/tree/master/Wiki/ENG_Guide/markdown/index.md>`_
|
|
||||||
- PDF `[|OPEN GITLAB|] <https://gitlab.com/UnicodeLabs/OpenRPA/-/tree/master/Wiki/ENG_Guide/pdf/pyOpenRPA_Guide_ENG.pdf>`_
|
|
||||||
- RUS - queue
|
|
||||||
|
|
||||||
- Tutorial
|
|
||||||
- ENG - queue
|
|
||||||
- RUS - in progress
|
|
||||||
- Article: Less cost - no paid RPA `|OPEN HABR| <https://habr.com/ru/post/506766/>`_
|
|
||||||
- Tutorial Desktop UI `|OPEN HABR| <https://habr.com/ru/post/509644/>`_; `|OPEN GITLAB| <https://gitlab.com/UnicodeLabs/OpenRPA/-/tree/master/Wiki/RUS_Tutorial/DesktopGUI_Habr/index.md>`_
|
|
||||||
- Tutorial Web UI `|OPEN HABR| <https://habr.com/ru/post/515310/>`_; `|OPEN GITLAB| <https://gitlab.com/UnicodeLabs/OpenRPA/-/tree/master/Wiki/RUS_Tutorial/WebGUI_Habr/readme.md>`_
|
|
||||||
- Article: RPA as a core of the IT automation - soon
|
|
||||||
- Leaflet
|
|
||||||
- ENG queue
|
|
||||||
- RUS done 2021.02.23
|
|
||||||
- RUS Leaflet pyOpenRPA v4.pdf `|OPEN GITLAB| <https://gitlab.com/UnicodeLabs/OpenRPA/-/tree/master/Wiki/RUS_Leaflet/RUS%20Leaflet%20pyOpenRPA%20v4.pdf>`_
|
|
||||||
@ -1,5 +1,7 @@
|
|||||||
|
.. _module.studio.description:
|
||||||
|
|
||||||
************************
|
************************
|
||||||
1. Description
|
1. Описание
|
||||||
************************
|
************************
|
||||||
|
|
||||||
pyOpenRPA Studio is the executable process.
|
pyOpenRPA Studio is the executable process.
|
||||||
|
|||||||
|
Before Width: | Height: | Size: 33 KiB After Width: | Height: | Size: 86 KiB |
@ -0,0 +1,44 @@
|
|||||||
|
cd %~dp0
|
||||||
|
@ECHO OFF
|
||||||
|
RD /S /Q "%~dp0..\..\Wiki\RUS_Guide\doctrees"
|
||||||
|
RD /S /Q "%~dp0..\..\Wiki\RUS_Guide\html"
|
||||||
|
RD /S /Q "%~dp0..\..\Wiki\RUS_Guide\markdown"
|
||||||
|
|
||||||
|
set PATH=%PATH%;%~dp0..\..\Resources\WPy64-3720\python-3.7.2.amd64\Scripts
|
||||||
|
set PYTHONPATH=%PYTHONPATH%;%~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\RUS_Guide
|
||||||
|
|
||||||
|
%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 html %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
|
||||||
|
%SPHINXBUILD% -M markdown %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
|
||||||
|
"..\..\Resources\WPy64-3720\python-3.7.2.amd64\python.exe" make_RUS_Guide_2.py
|
||||||
|
|
||||||
|
..\..\Wiki\RUS_Guide\html\index.html
|
||||||
|
goto end
|
||||||
|
|
||||||
|
:help
|
||||||
|
%SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
|
||||||
|
|
||||||
|
:end
|
||||||
|
popd
|
||||||
|
pause>nul
|
||||||
@ -0,0 +1,3 @@
|
|||||||
|
cd %~dp0
|
||||||
|
"..\..\Resources\WPy64-3720\python-3.7.2.amd64\python.exe" make_RUS_Guide_2.py
|
||||||
|
pause>nul
|
||||||
@ -0,0 +1,49 @@
|
|||||||
|
import os, shutil, subprocess
|
||||||
|
|
||||||
|
# Build dir
|
||||||
|
gSourceDirAbsPathStr = os.path.abspath("")
|
||||||
|
gBuildDirAbsPathStr = os.path.abspath("..\\..\\Wiki\\RUS_Guide")
|
||||||
|
gBuildDirHTMLAbsPathStr = os.path.join(gBuildDirAbsPathStr, "html")
|
||||||
|
gBuildDirMDAbsPathStr = os.path.join(gBuildDirAbsPathStr, "markdown")
|
||||||
|
|
||||||
|
# list all dir which have img folder
|
||||||
|
# Copy to md and html
|
||||||
|
|
||||||
|
for root, subFolder, files in os.walk(os.path.abspath("")):
|
||||||
|
for item in files:
|
||||||
|
if item.endswith(".png") :
|
||||||
|
|
||||||
|
fileNamePath = str(os.path.join(root,item))
|
||||||
|
#print(fileNamePath)
|
||||||
|
lFileItemBuildDirHTMLAbsPathStr = root.replace(gSourceDirAbsPathStr, gBuildDirHTMLAbsPathStr)
|
||||||
|
lFileItemBuildHTMLAbsPathStr = str(os.path.join(lFileItemBuildDirHTMLAbsPathStr,item))
|
||||||
|
if not os.path.exists(lFileItemBuildDirHTMLAbsPathStr):
|
||||||
|
os.mkdir(lFileItemBuildDirHTMLAbsPathStr)
|
||||||
|
shutil.copy2(fileNamePath, fileNamePath.replace(gSourceDirAbsPathStr, gBuildDirHTMLAbsPathStr))
|
||||||
|
|
||||||
|
lFileItemBuildDirMDAbsPathStr = root.replace(gSourceDirAbsPathStr, gBuildDirMDAbsPathStr)
|
||||||
|
lFileItemBuildMDAbsPathStr = str(os.path.join(lFileItemBuildDirMDAbsPathStr,item))
|
||||||
|
if not os.path.exists(lFileItemBuildDirMDAbsPathStr):
|
||||||
|
os.mkdir(lFileItemBuildDirMDAbsPathStr)
|
||||||
|
shutil.copy2(fileNamePath, fileNamePath.replace(gSourceDirAbsPathStr, gBuildDirMDAbsPathStr))
|
||||||
|
|
||||||
|
|
||||||
|
# Run PDF generation
|
||||||
|
"""
|
||||||
|
gHTML2PDFPathList = [
|
||||||
|
"index.html",
|
||||||
|
"01_HowToInstall.html",
|
||||||
|
"02_RoadMap.html",
|
||||||
|
"03_Copyrights_Contacts.html"
|
||||||
|
]
|
||||||
|
gWKHTMLtoPDFPath = "..\\..\\Resources\\wkhtmltopdf\\bin\\wkhtmltopdf.exe"
|
||||||
|
gCMDRunStr = f'{os.path.abspath(gWKHTMLtoPDFPath)} --javascript-delay 5000 --load-error-handling ignore --enable-local-file-access '
|
||||||
|
gPDFOutputAbsPath = os.path.join(gBuildDirAbsPathStr, "pyOpenRPA_Guide_ENG.pdf")
|
||||||
|
for lItemStr in gHTML2PDFPathList:
|
||||||
|
gCMDRunStr += f' {os.path.join(gBuildDirHTMLAbsPathStr, lItemStr)} '
|
||||||
|
|
||||||
|
gCMDRunStr += f' "{gPDFOutputAbsPath}" '
|
||||||
|
#os.system("cmd /c "+gCMDRunStr)
|
||||||
|
subprocess.call(gCMDRunStr.split(" "), shell=True)
|
||||||
|
print(gCMDRunStr)
|
||||||
|
"""
|
||||||
@ -0,0 +1,6 @@
|
|||||||
|
cd %~dp0
|
||||||
|
RD /S /Q "%~dp0..\Wiki\RUS_Guide\doctrees"
|
||||||
|
RD /S /Q "%~dp0..\Wiki\RUS_Guide\html"
|
||||||
|
RD /S /Q "%~dp0..\Wiki\RUS_Guide\markdown"
|
||||||
|
GuideSphinx\make_RUS_Guide.bat html
|
||||||
|
pause >nul
|
||||||
@ -1,9 +1,9 @@
|
|||||||
r"""
|
r"""
|
||||||
|
|
||||||
The OpenRPA package (from UnicodeLabs)
|
The pyOpenRPA package
|
||||||
|
|
||||||
"""
|
"""
|
||||||
__version__ = 'v1.2.12'
|
__version__ = 'v1.2.12'
|
||||||
__all__ = []
|
__all__ = []
|
||||||
__author__ = 'Ivan Maslov <ivan.maslov@unicodelabs.ru>'
|
__author__ = 'Ivan Maslov <ivan.maslov@pyopenrpa.ru>'
|
||||||
#from .Core import Robot
|
#from .Core import Robot
|
||||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@ -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: d9a414d4d4d7c1249f90ff5e50cb5408
|
||||||
|
tags: 645f666f9bcd5a90fca523b33c5a78b7
|
||||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
|
After Width: | Height: | Size: 35 KiB |
|
After Width: | Height: | Size: 27 KiB |
|
After Width: | Height: | Size: 37 KiB |
|
After Width: | Height: | Size: 49 KiB |
|
After Width: | Height: | Size: 116 KiB |
|
After Width: | Height: | Size: 26 KiB |
|
After Width: | Height: | Size: 35 KiB |
|
After Width: | Height: | Size: 34 KiB |
|
After Width: | Height: | Size: 37 KiB |
|
After Width: | Height: | Size: 15 KiB |
|
After Width: | Height: | Size: 86 KiB |
|
After Width: | Height: | Size: 15 KiB |
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,32 @@
|
|||||||
|
####################################
|
||||||
|
1. Первый запуск
|
||||||
|
####################################
|
||||||
|
|
||||||
|
Are you ready to install the pyOpenRPA solution on your machine?
|
||||||
|
|
||||||
|
Ok, we start.
|
||||||
|
**Do the following operations:**
|
||||||
|
|
||||||
|
- Download the pyOpenRPA package from master branch on GitLab [Download ZIP](https://gitlab.com/UnicodeLabs/OpenRPA/-/archive/master/OpenRPA-master.zip)
|
||||||
|
- Unzip the package
|
||||||
|
|
||||||
|
**Installation has been completed :)**
|
||||||
|
|
||||||
|
**************************************************
|
||||||
|
How to check installation
|
||||||
|
**************************************************
|
||||||
|
- Run portable python (built in the pyOpenRPA)
|
||||||
|
|
||||||
|
- x32 python (GIT\\Resources\\WPy32-3720\\python-3.7.2\\python.exe)
|
||||||
|
- x64 python (GIT\\Resources\\WPy64-3720\\python-3.7.2.amd64\\python.exe)
|
||||||
|
|
||||||
|
**The pyOpenRPA has been successfully installed if the portable python 3.7.2 was started without any exceptions (see screenshot).**
|
||||||
|
|
||||||
|
.. image:: /img/cb5dec8cecafa7d64f6cd14b2672acce.png
|
||||||
|
:alt: cb5dec8cecafa7d64f6cd14b2672acce.png
|
||||||
|
|
||||||
|
**************************************************
|
||||||
|
System requirements
|
||||||
|
**************************************************
|
||||||
|
- OS Windows 7+. *Need Windows package KB2999226 if use windows Vista/7/8/8.1/Server 2008/Server 2012 (https://support.microsoft.com/ru-ru/help/2999226)*
|
||||||
|
- For OpenCV: OS Windows 7/8/8/10 only (no Windows Server)
|
||||||
@ -0,0 +1,42 @@
|
|||||||
|
.. _3.-Copyrights-&-Contacts:
|
||||||
|
|
||||||
|
####################################
|
||||||
|
2. Права & Контакты
|
||||||
|
####################################
|
||||||
|
|
||||||
|
pyOpenRPA is created by Ivan Maslov (Russia).
|
||||||
|
Hosted by PYOPENRPA LLC (Russia)
|
||||||
|
|
||||||
|
My purpose is to create #IT4Business models in the companies.
|
||||||
|
I can help you to create the new #IT4Business in your company.
|
||||||
|
#IT4Business homepage - https://www.facebook.com/RU.IT4Business
|
||||||
|
#IT4Busines is the methodology which is created for build compact fast and reliable IT function in company.
|
||||||
|
If you has many IT specialists, very long deadlines for the IT tasks, many bugs in IT software - #IT4Business is for you :)
|
||||||
|
|
||||||
|
If you need some IT help - feel free to contact me (prefer e-mail or skype).
|
||||||
|
If you will find some issue in pyOpenRPA - write about it to me via e-mail/skype/gitlab issue.
|
||||||
|
|
||||||
|
Thank you!
|
||||||
|
|
||||||
|
**************************************************
|
||||||
|
Ivan Maslov (CEO & FOUNDER)
|
||||||
|
**************************************************
|
||||||
|
Our contacts:
|
||||||
|
|
||||||
|
- E-mail: Ivan.Maslov@pyOpenRPA.ru
|
||||||
|
- Skype: MegaFinder
|
||||||
|
- Web: https://pyopenrpa.ru/
|
||||||
|
- Telegram: https://t.me/pyopenrpa
|
||||||
|
- WhatsApp | Telegram: +7 906 722 39 25 | @IvanMaslov
|
||||||
|
|
||||||
|
|
||||||
|
**************************************************
|
||||||
|
3-rd party components license dependencies
|
||||||
|
**************************************************
|
||||||
|
- WinPython 3.7.1 32-bit & 64-bit, license MIT (https://github.com/winpython/winpython)
|
||||||
|
- Selenium v..., license Apache 2.0
|
||||||
|
- pywinauto 0.6.5, license BSD 3-Clause (https://github.com/pywinauto/pywinauto)
|
||||||
|
- Semantic UI ..., license MIT (https://github.com/Semantic-Org/Semantic-UI)
|
||||||
|
- PyAutoGUI ..., license BSD 3-Clause (https://github.com/asweigart/pyautogui)
|
||||||
|
- keyboard ..., license MIT (https://github.com/boppreh/keyboard)
|
||||||
|
- pywin32 ..., Python Software Foundation License (PSF) (https://github.com/mhammond/pywin32)
|
||||||
@ -0,0 +1,23 @@
|
|||||||
|
####################################
|
||||||
|
2. Defs
|
||||||
|
####################################
|
||||||
|
|
||||||
|
**************************************************
|
||||||
|
pyOpenRPA.Agent.__Agent__
|
||||||
|
**************************************************
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
.. automodule:: pyOpenRPA.Agent.__Agent__
|
||||||
|
:members:
|
||||||
|
:autosummary:
|
||||||
|
|
||||||
|
|
||||||
|
**********
|
||||||
|
References
|
||||||
|
**********
|
||||||
|
|
||||||
|
`reStructuredText`_
|
||||||
|
|
||||||
|
.. target-notes::
|
||||||
|
.. _`reStructuredText`: http://docutils.sourceforge.net/rst.html
|
||||||
@ -0,0 +1,90 @@
|
|||||||
|
####################################
|
||||||
|
1. Description
|
||||||
|
####################################
|
||||||
|
|
||||||
|
pyOpenRPA Orchestrator is the executable process.
|
||||||
|
|
||||||
|
The features of the orchestrator is:
|
||||||
|
- Centralized/decentralized user control interface (applicable and for business users and for technical users). Web based, support desktop, tablet, phone.
|
||||||
|
- Automatized robots control (customized algorithms, robots scheduling)
|
||||||
|
- Source code mega flexibility: Light Orchestrator architecture is good for own customization
|
||||||
|
|
||||||
|
************************************
|
||||||
|
Global settings dict concept
|
||||||
|
************************************
|
||||||
|
pyOpenRPA project is complex tool which consist of several executable modules such as Robot, Orchestrator, Studio,
|
||||||
|
|
||||||
|
Because of module compexity, we use 1 init arg - inGSettings
|
||||||
|
inGSettings is a complex dictionary which has all reqired parameters for the module execution.
|
||||||
|
|
||||||
|
The description of the GSettings you can find in executable module details.
|
||||||
|
|
||||||
|
************************************
|
||||||
|
Orchestrator how to configure
|
||||||
|
************************************
|
||||||
|
|
||||||
|
|
||||||
|
To init pyOpenRPA Orchestrator instance use script:
|
||||||
|
|
||||||
|
from pyOpenRPA import Orchestrator # Import orchestrator main
|
||||||
|
gSettings = SettingsTemplate.Create(inModeStr="BASIC") # Create GSettings with basic configuration
|
||||||
|
Orchestrator.Orchestrator(inGSettings=gSettings) # Call the orchestrator def
|
||||||
|
|
||||||
|
gSettings structure
|
||||||
|
|
||||||
|
|
||||||
|
************************************
|
||||||
|
Orchestrator architecture
|
||||||
|
************************************
|
||||||
|
Orchestrator has several source code components:
|
||||||
|
- User/robot activity consolidated queue single thread (Processor)
|
||||||
|
- User/robot activity asynchonus many threads (Processor)
|
||||||
|
- Scheduler single thread (main)
|
||||||
|
- RDP keep active many thread
|
||||||
|
- Autocleaner single thread
|
||||||
|
- GUI keep active single thread
|
||||||
|
- HTTP web server single thread (create user socket threads)
|
||||||
|
-
|
||||||
|
|
||||||
|
Below you can find more information about all of the component.
|
||||||
|
|
||||||
|
***************************
|
||||||
|
Component Processor
|
||||||
|
***************************
|
||||||
|
Sync - Append activity list to consolidated processor queue. Execution goes sequency by the activity list order
|
||||||
|
|
||||||
|
Async - Create New thread to execute the activity list
|
||||||
|
|
||||||
|
- Activity list
|
||||||
|
|
||||||
|
List of the activity item
|
||||||
|
|
||||||
|
- Activity item
|
||||||
|
|
||||||
|
Activity item is universal mechanism to execute different algorythms from any sources.
|
||||||
|
The core feature of the Activity is to call python defs with args and kwargs.
|
||||||
|
If you need to init do some activity you can write some python def, then create Activity item with current def.
|
||||||
|
ATTENTION: In some cases (such as web transmition), when you can't transmit python def as object you can use symbolic names for python defs. It is apply you to init all of you want from the web UI.
|
||||||
|
|
||||||
|
?Why i cant transmit python def from the web
|
||||||
|
Because the WEB space is not the Python executable space. Interaction between it spaces create by JSON protocol. So, we know than JSON apply int, float, str, bool, None, list, dict - that is all.
|
||||||
|
|
||||||
|
.. note::
|
||||||
|
Example
|
||||||
|
{
|
||||||
|
"Def":"DefAliasTest", # def link or def alias (look gSettings["Processor"]["AliasDefDict"])
|
||||||
|
"ArgList":[1,2,3], # Args list
|
||||||
|
"ArgDict":{"ttt":1,"222":2,"dsd":3}, # Args dictionary
|
||||||
|
"ArgGSettings": None # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
|
||||||
|
"ArgLogger": None # Name of GSettings attribute: str (ArgDict) or index (for ArgList)
|
||||||
|
}# Pay attention! Do not left comma symbol after the end of the dict - it can be interpretated like a turple..
|
||||||
|
|
||||||
|
|
||||||
|
**********
|
||||||
|
References
|
||||||
|
**********
|
||||||
|
|
||||||
|
`Python-sphinx`_
|
||||||
|
|
||||||
|
.. target-notes::
|
||||||
|
.. _`reStructuredText`: http://docutils.sourceforge.net/rst.html
|
||||||
@ -0,0 +1,88 @@
|
|||||||
|
####################################
|
||||||
|
2. Defs
|
||||||
|
####################################
|
||||||
|
|
||||||
|
**************************************************
|
||||||
|
pyOpenRPA.Orchestrator.__Orchestrator__
|
||||||
|
**************************************************
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
# EXAMPLE 1
|
||||||
|
from pyOpenRPA import Orchestrator
|
||||||
|
Orchestrator.OSCMD(inCMDStr = "git status", inRunAsyncBool=True)
|
||||||
|
|
||||||
|
# EXAMPLE 2
|
||||||
|
from pyOpenRPA.Orchestrator import __Orchestrator__
|
||||||
|
__Orchestrator__.OSCMD(inCMDStr = "git status", inRunAsyncBool=True)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Group Agent...
|
||||||
|
######################
|
||||||
|
Interaction between Orchestrator and pyOpenRPA.Agent daemon process, which can be deployed in another user session.
|
||||||
|
|
||||||
|
Group GSettings...
|
||||||
|
######################
|
||||||
|
Basic defs to work with singleton gSettings.
|
||||||
|
|
||||||
|
Group Storage...
|
||||||
|
######################
|
||||||
|
Defs to work with special locations in Orchestrator: Robot, User (TODO), User + Robot (TODO)
|
||||||
|
|
||||||
|
Group OS...
|
||||||
|
######################
|
||||||
|
Interaction with shell on the Orchestrator user session.
|
||||||
|
|
||||||
|
Group Process...
|
||||||
|
######################
|
||||||
|
Interaction with some process on the Orchestrator user session.
|
||||||
|
|
||||||
|
Group Processor...
|
||||||
|
######################
|
||||||
|
Work with Processor queue (see ...).
|
||||||
|
|
||||||
|
Group Python...
|
||||||
|
######################
|
||||||
|
Work with extra python modules.
|
||||||
|
|
||||||
|
Group RDPSession...
|
||||||
|
######################
|
||||||
|
Interaction with RDP session, where you can manage some robots.
|
||||||
|
|
||||||
|
Group Web...
|
||||||
|
######################
|
||||||
|
Manipulate the Orchestrator WEB side.
|
||||||
|
|
||||||
|
Group UAC...
|
||||||
|
######################
|
||||||
|
Manipulate the User Access Controls (actual for the Orchestrator WEB access for the business users)
|
||||||
|
|
||||||
|
Group Scheduler...
|
||||||
|
######################
|
||||||
|
Work with activity scheduling.
|
||||||
|
|
||||||
|
|
||||||
|
.. automodule:: pyOpenRPA.Orchestrator.__Orchestrator__
|
||||||
|
:members:
|
||||||
|
:autosummary:
|
||||||
|
|
||||||
|
|
||||||
|
**************************************************
|
||||||
|
pyOpenRPA.Orchestrator.Web.Basic
|
||||||
|
**************************************************
|
||||||
|
|
||||||
|
.. automodule:: pyOpenRPA.Orchestrator.Web.Basic
|
||||||
|
:members:
|
||||||
|
:autosummary:
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
**********
|
||||||
|
References
|
||||||
|
**********
|
||||||
|
|
||||||
|
`reStructuredText`_
|
||||||
|
|
||||||
|
.. target-notes::
|
||||||
|
.. _`reStructuredText`: http://docutils.sourceforge.net/rst.html
|
||||||
@ -0,0 +1,9 @@
|
|||||||
|
.. _gSettingsTemplate:
|
||||||
|
************************
|
||||||
|
3. gSettings Template
|
||||||
|
************************
|
||||||
|
|
||||||
|
gSettings structure
|
||||||
|
|
||||||
|
.. include:: ../../pyOpenRPA/Orchestrator/SettingsTemplate.py
|
||||||
|
:literal:
|
||||||
@ -0,0 +1,19 @@
|
|||||||
|
************************
|
||||||
|
4. How to use
|
||||||
|
************************
|
||||||
|
|
||||||
|
You need to run orchestrator process?
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
if __name__ == "__main__": # New init way - allow run as module -m PyOpenRPA.Orchestrator
|
||||||
|
from pyOpenRPA import Orchestrator # Import orchestrator main
|
||||||
|
gSettings = SettingsTemplate.Create(inModeStr="BASIC") # Create GSettings with basic configuration - no more config is available from the box - you can create own
|
||||||
|
# Call the orchestrator main def
|
||||||
|
Orchestrator.Orchestrator(inGSettings=gSettings)
|
||||||
|
|
||||||
|
|
||||||
|
If you need more configurations - so you can see here:
|
||||||
|
|
||||||
|
.. include:: ../../../Orchestrator/OrchestratorSettings.py
|
||||||
|
:literal:
|
||||||
@ -0,0 +1,58 @@
|
|||||||
|
####################################
|
||||||
|
5. UAC - User Access Control
|
||||||
|
####################################
|
||||||
|
|
||||||
|
*****************
|
||||||
|
About
|
||||||
|
*****************
|
||||||
|
Orchestrator has mega feature - user access control (UAC). This feature allow you to manipulate access of the web UI for the all users!
|
||||||
|
|
||||||
|
If you need to give admin rights - you don't customize UAC dict.
|
||||||
|
|
||||||
|
If you need to give some little rights for user only for one robot in orchestrator web panel - you can set the following properties in UAC dict.
|
||||||
|
|
||||||
|
To work with UAC you can use defs ``Orchestrator.UAC`` group.
|
||||||
|
|
||||||
|
!!!ATTENTION!!!
|
||||||
|
|
||||||
|
Need practice example to work with UAC! - too hard to understand
|
||||||
|
|
||||||
|
***************************************************
|
||||||
|
UAC Dict for Orchestrator WEB UI rights
|
||||||
|
***************************************************
|
||||||
|
|
||||||
|
UAC Dict for pyOpenRPA Orchestrator WEB UI rights.
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
"pyOpenRPADict":{
|
||||||
|
"CPKeyDict":{ # Empty dict - all access
|
||||||
|
# "CPKeyStr"{
|
||||||
|
# }
|
||||||
|
},
|
||||||
|
"RDPKeyDict":{ # Empty dict - all access
|
||||||
|
#"RDPKeyStr"{
|
||||||
|
# "FullscreenBool": True,
|
||||||
|
# "IgnoreBool":True,
|
||||||
|
# "ReconnectBool": True
|
||||||
|
# "NothingBool": True # USe option if you dont want to give some access to the RDP controls
|
||||||
|
# }
|
||||||
|
},
|
||||||
|
"AgentKeyDict": { # Empty dict - all access
|
||||||
|
# "AgentKeyStr"{
|
||||||
|
# }
|
||||||
|
},
|
||||||
|
"AdminDict":{ # Empty dict - all access
|
||||||
|
"LogViewerBool":True, # Show log viewer on the web page
|
||||||
|
"CMDInputBool":True, # Execute CMD on the server side and result to the logs
|
||||||
|
"ScreenshotViewerBool":True, # Show button to look screenshots
|
||||||
|
"RestartOrchestratorBool": True, # Restart orchestrator activity
|
||||||
|
"RestartOrchestratorGITPullBool": True, # Turn off (RDP remember) orc + git pull + Turn on (rdp remember)
|
||||||
|
"RestartPCBool": True, # Send CMD to restart pc
|
||||||
|
"NothingBool":True # USe option if you dont want to give some access to the RDP controls
|
||||||
|
},
|
||||||
|
"ActivityDict": { # Empty dict - all access
|
||||||
|
"ActivityListExecuteBool": True, # Execute activity at the current thread
|
||||||
|
"ActivityListAppendProcessorQueueBool": True # Append activity to the processor queue
|
||||||
|
}
|
||||||
|
}
|
||||||
@ -0,0 +1,52 @@
|
|||||||
|
####################################
|
||||||
|
6. Defs Managers
|
||||||
|
####################################
|
||||||
|
|
||||||
|
**************************************************
|
||||||
|
Process (General)
|
||||||
|
**************************************************
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
# EXAMPLE
|
||||||
|
from pyOpenRPA.Orchestrator import Orchestrator
|
||||||
|
lProcess = Orchestrator.Managers.Process(inAgentHostNameStr="PC-DESKTOP",inAgentUserNameStr="ND", inProcessNameWOExeStr="notepad",inStartCMDStr="notepad")
|
||||||
|
|
||||||
|
|
||||||
|
.. automodule:: pyOpenRPA.Orchestrator.Managers.Process
|
||||||
|
:members:
|
||||||
|
:autosummary:
|
||||||
|
|
||||||
|
|
||||||
|
**************************************************
|
||||||
|
Process (Details)
|
||||||
|
**************************************************
|
||||||
|
|
||||||
|
.. automodule:: pyOpenRPA.Orchestrator.Managers.Process
|
||||||
|
:members:
|
||||||
|
:autosummary:
|
||||||
|
|
||||||
|
|
||||||
|
**************************************************
|
||||||
|
ControlPanel (General)
|
||||||
|
**************************************************
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
# EXAMPLE
|
||||||
|
from pyOpenRPA.Orchestrator import Orchestrator
|
||||||
|
lCP = Orchestrator.Managers.ControlPanel(inControlPanelNameStr="TestTTT",inRefreshHTMLJinja2TemplatePathStr="ControlPanel\\test.html", inJinja2TemplateRefreshBool = True)
|
||||||
|
|
||||||
|
|
||||||
|
.. automodule:: pyOpenRPA.Orchestrator.Managers.ControlPanel
|
||||||
|
:members:
|
||||||
|
:autosummary:
|
||||||
|
|
||||||
|
|
||||||
|
**************************************************
|
||||||
|
ControlPanel (Details)
|
||||||
|
**************************************************
|
||||||
|
|
||||||
|
.. automodule:: pyOpenRPA.Orchestrator.Managers.ControlPanel
|
||||||
|
:members:
|
||||||
|
:autosummary:
|
||||||
@ -0,0 +1,22 @@
|
|||||||
|
************************
|
||||||
|
1. Описание
|
||||||
|
************************
|
||||||
|
|
||||||
|
pyOpenRPA Robot is the python package which allow you to create best RPA program.
|
||||||
|
|
||||||
|
The description of the functions you can find page 'Defs' (see menu)
|
||||||
|
|
||||||
|
Here is the example of the pyOpenRPA usage.
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
# EXAMPLE 1
|
||||||
|
from pyOpenRPA.Robot import UIDesktop
|
||||||
|
|
||||||
|
lNotepadOKButton = UIDesktop.UIOSelector_Get_UIO(
|
||||||
|
inSpecificationList=[
|
||||||
|
{"title":"notepad.exe"},{"title":"OK"}],
|
||||||
|
inElement=None,
|
||||||
|
inFlagRaiseException=True)
|
||||||
|
|
||||||
|
lNotepadOKButton.click()
|
||||||
@ -0,0 +1,36 @@
|
|||||||
|
####################################
|
||||||
|
2. Функции
|
||||||
|
####################################
|
||||||
|
|
||||||
|
Here you can find the functions description for interaction with desktop GUI applications
|
||||||
|
|
||||||
|
How to use both x32 and x64 python processes (it can be helpfully, if another app GUI is on another bitness than your app)
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
from pyOpenRPA.Robot import UIDesktop
|
||||||
|
#Section for robot init
|
||||||
|
lPyOpenRPA_SettingsDict = {
|
||||||
|
"Python32FullPath": "..\\Resources\\WPy32-3720\\python-3.7.2\\python.exe", #Set from user: "..\\Resources\\WPy32-3720\\python-3.7.2\\OpenRPARobotGUIx32.exe"
|
||||||
|
"Python64FullPath": "..\\Resources\\WPy64-3720\\python-3.7.2.amd64\\python.exe", #Set from user
|
||||||
|
"Python32ProcessName": "pyOpenRPA_UIDesktopX32.exe", #Config set once
|
||||||
|
"Python64ProcessName": "pyOpenRPA_UIDesktopX64.exe" #Config set once
|
||||||
|
}
|
||||||
|
# Init the pyOpenRPA configuration
|
||||||
|
UIDesktop.Utils.ProcessBitness.SettingsInit(lPyOpenRPA_SettingsDict)
|
||||||
|
# Now you can use pyOpenRPA with both bitness.
|
||||||
|
|
||||||
|
|
||||||
|
.. automodule:: pyOpenRPA.Robot.UIDesktop
|
||||||
|
:members:
|
||||||
|
:autosummary:
|
||||||
|
|
||||||
|
|
||||||
|
**********
|
||||||
|
References
|
||||||
|
**********
|
||||||
|
|
||||||
|
`reStructuredText`_
|
||||||
|
|
||||||
|
.. target-notes::
|
||||||
|
.. _`reStructuredText`: http://docutils.sourceforge.net/rst.html
|
||||||
@ -0,0 +1,226 @@
|
|||||||
|
####################################
|
||||||
|
3. Как использовать?
|
||||||
|
####################################
|
||||||
|
|
||||||
|
The Robot tool is the main module for production process automation. It has no graphic/console interface. All low-level actions to OS are perfoming by the Robot tool in pyOpenRPA.
|
||||||
|
|
||||||
|
**************************************************
|
||||||
|
How to execute RPA script
|
||||||
|
**************************************************
|
||||||
|
You can use the robot by the several ways:
|
||||||
|
|
||||||
|
- In Python script
|
||||||
|
- In Studio script (n/a)
|
||||||
|
|
||||||
|
|
||||||
|
Create python script
|
||||||
|
############################################
|
||||||
|
In order to use robot just add Robot tool folder in work directory and add line "import GUI" in your script.
|
||||||
|
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
import sys
|
||||||
|
sys.path.append('../../')
|
||||||
|
import selenium # [Web app access](https://gitlab.com/UnicodeLabs/OpenRPA/wikis/05.1.-Theory-&-practice:-Web-app-access-(Chrome,-Firefox,-Opera))<br>
|
||||||
|
import GUI # [Win32 & UI Automation access](https://gitlab.com/UnicodeLabs/OpenRPA/wikis/05.2.-Theory-&-practice:-Desktop-app-UI-access-(win32-and-UI-automation-dlls)) <br>
|
||||||
|
import pyautogui #[Screen capture/recognition](https://gitlab.com/UnicodeLabs/OpenRPA/wikis/05.4.-Theory-&-practice:-Screen-capture-&-image-recognition) [#Mouse manipulation](https://gitlab.com/UnicodeLabs/OpenRPA/wikis/05.3.-Theory-&-practice:-Keyboard-&-mouse-manipulation)<br>
|
||||||
|
import cv2 # [Computer vision](https://gitlab.com/UnicodeLabs/OpenRPA/wikis/05.4.-Theory-&-practice:-Screen-capture-&-image-recognition)<br>
|
||||||
|
import keyboard #[Keyboard manipulation](https://gitlab.com/UnicodeLabs/OpenRPA/wikis/05.3.-Theory-&-practice:-Keyboard-&-mouse-manipulation)<br>
|
||||||
|
|
||||||
|
Execute python script
|
||||||
|
############################################
|
||||||
|
|
||||||
|
The pyOpenRPA is fully portable solution. It contains own python enviroment both 32 and 64 bit versions. So, you can execute your python script in several ways:
|
||||||
|
- Execute in python x32 (\OpenRPA\Resources\WPy32-3720\python-3.7.2)
|
||||||
|
- Execute in python x64 (\OpenRPA\Resources\WPy64-3720\python-3.7.2.amd64)
|
||||||
|
- Execute from .cmd file
|
||||||
|
|
||||||
|
Execute in the Python x32
|
||||||
|
############################################
|
||||||
|
|
||||||
|
To execute your python script in x32 bit version just write in command line from x32 python directory:
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
cd "\OpenRPA\Resources\WPy32-3720\python-3.7.2"
|
||||||
|
python.exe "path to your python script.py"
|
||||||
|
|
||||||
|
Execute in the Python x64
|
||||||
|
############################################
|
||||||
|
|
||||||
|
To execute your python script in x32 bit version just write in command line from x32 python directory:
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
cd "\OpenRPA\Resources\WPy64-3720\python-3.7.2.amd64"
|
||||||
|
python.exe "path to your python script.py"
|
||||||
|
|
||||||
|
Execute from .cmd file
|
||||||
|
############################################
|
||||||
|
|
||||||
|
In order to simplify the execution process you can write several code lines in file with the .cmd extension:
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
cd %~dp0
|
||||||
|
copy /Y ..\Resources\WPy32-3720\python-3.7.2\python.exe ..\Resources\WPy32-3720\python-3.7.2\OpenRPAOrchestrator.exe
|
||||||
|
.\..\Resources\WPy32-3720\python-3.7.2\OpenRPAOrchestrator.exe orchestratorMain.py
|
||||||
|
pause >nul
|
||||||
|
|
||||||
|
|
||||||
|
Use in studio script (n/a)
|
||||||
|
############################################
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
import sys
|
||||||
|
sys.path.append('../../')
|
||||||
|
import GUI
|
||||||
|
import keyboard
|
||||||
|
import subprocess
|
||||||
|
import time
|
||||||
|
|
||||||
|
#Highlight the UI Object in Folder explorer
|
||||||
|
GUI.UIOSelector_FocusHighlight([{"class_name":"CabinetWClass","backend":"uia"},{"ctrl_index":2},{"ctrl_index":0},{"ctrl_index":2},{"ctrl_index":0}])
|
||||||
|
|
||||||
|
#Wait 2 seconds
|
||||||
|
time.sleep(3)
|
||||||
|
|
||||||
|
#Loop: get child element of UI List
|
||||||
|
for lItem in GUI.UIOSelector_Get_UIO([{"class_name":"CabinetWClass","backend":"uia"},{"ctrl_index":2},{"ctrl_index":0},{"ctrl_index":2},{"ctrl_index":0}]).children():
|
||||||
|
print(str(lItem))
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Here you can find the docs and examples of the OpenRPA desktop (GUI) app access.
|
||||||
|
|
||||||
|
****************************************************************************************************
|
||||||
|
Desktop app UI access (win32 and UI automation dlls)
|
||||||
|
****************************************************************************************************
|
||||||
|
|
||||||
|
Definitions
|
||||||
|
############################################
|
||||||
|
|
||||||
|
- **UIO** - UI Object (class of pywinauto UI object) [pywinauto.base_wrapper]
|
||||||
|
- **UIOSelector** - List of dict (key attributes)
|
||||||
|
- **PWA** - PyWinAuto
|
||||||
|
- **PWASpecification** - List of dict (key attributes in pywinauto.find_window notation)
|
||||||
|
- **UIOTree** - Recursive Dict of Dict ... (UI Parent -> Child hierarchy)
|
||||||
|
- **UIOInfo** - Dict of UIO attributes
|
||||||
|
- **UIOActivity** - Activity of the UIO (UI object) from the Pywinauto module
|
||||||
|
- **UIOEI** - UI Object info object
|
||||||
|
|
||||||
|
|
||||||
|
What is UIO?
|
||||||
|
############################################
|
||||||
|
UIO is a User Interface Object (pyOpenRPA terminology). For maximum compatibility, this instance is inherited from the object model developed in the [pywinauto library (click to get a list of available class functions)](https://pywinauto.readthedocs.io/en/latest/code/pywinauto.base_wrapper.html).
|
||||||
|
|
||||||
|
This approach allows us to implement useful functionality that has already been successfully developed in other libraries, and Supplement it with the missing functionality. In our case, the missing functionality is the ability to dynamically access UIO objects using UIO selectors.
|
||||||
|
|
||||||
|
|
||||||
|
UIOSelector structure & example
|
||||||
|
############################################
|
||||||
|
UIOSelector is the list of condition items for the UIO in GUI. Each item has condition attributes for detect applicable UIO. Here is the description of the available condition attributes in item.
|
||||||
|
|
||||||
|
**Desciption**
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
[
|
||||||
|
{
|
||||||
|
"depth_start" :: [int, start from 1] :: the depth index, where to start check the condition list (default 1),
|
||||||
|
"depth_end" :: [int, start from 1] :: the depth index, where to stop check the condition list (default 1),
|
||||||
|
"ctrl_index" || "index" :: [int, starts from 0] :: the index of the UIO in parent UIO child list,
|
||||||
|
"title" :: [str] :: the condition for the UIO attribute *title*,
|
||||||
|
"title_re" :: [str] :: regular expression (python ver) for the condition for the UIO attribute *title*,
|
||||||
|
"rich_text" :: [str] :: the condition for the UIO attribute *rich_text*,
|
||||||
|
"rich_text_re" :: [str] :: regular expression (python ver) for the condition for the UIO attribute *rich_text*,
|
||||||
|
"class_name" :: [str] :: the condition for the UIO attribute *class_name*,
|
||||||
|
"class_name_re" :: [str] :: regular expression (python ver) for the condition for the UIO attribute *class_name*,
|
||||||
|
"friendly_class_name" :: [str] :: the condition for the UIO attribute *friendly_class_name*,
|
||||||
|
"friendly_class_name_re" :: [str] :: regular expression (python ver) for the condition for the UIO attribute *friendly_class_name*,
|
||||||
|
"control_type" :: [str] :: the condition for the UIO attribute *control_type*,
|
||||||
|
"control_type_re" :: [str] :: regular expression (python ver) for the condition for the UIO attribute *control_type*,
|
||||||
|
"is_enabled" :: [bool] :: the condition for the UIO attribute *is_enabled*. If UI object is enabled on GUI,
|
||||||
|
"is_visible" :: [bool] :: the condition for the UIO attribute *is_visible*. If UI object is visible on GUI,
|
||||||
|
"backend" :: [str, "win32" || "uia"] :: the method of UIO extraction (default "win32"). ATTENTION! Current option can be only for the first item of the UIO selector. For the next items this option will be implemented from the first item.
|
||||||
|
},
|
||||||
|
{ ... specification next level UIO }
|
||||||
|
]
|
||||||
|
**The UIO selector example**
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
[
|
||||||
|
{"class_name":"CalcFrame", "backend":"win32"}, # 1-st level UIO specification
|
||||||
|
{"title":"Hex", "depth_start":3, "depth_end": 3} # 3-rd level specification (because of attribute depth_start|depth_stop)
|
||||||
|
]
|
||||||
|
|
||||||
|
The UIDesktop module (OpenRPA/Robot/UIDesktop.py)
|
||||||
|
########################################################################################
|
||||||
|
The UIDesktop is extension of the pywinauto module which provide access to the desktop apps by the **win32** and **ui automation** dll frameworks (big thx to the Microsoft :) ).
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
# EXAMPLE 1
|
||||||
|
from pyOpenRPA.Robot import UIDesktop
|
||||||
|
|
||||||
|
UIDesktop.UIOSelector_Get_UIO(
|
||||||
|
inSpecificationList=[
|
||||||
|
{"title":"notepad.exe"},{"title":"OK"}],
|
||||||
|
inElement=None,
|
||||||
|
inFlagRaiseException=True)
|
||||||
|
|
||||||
|
|
||||||
|
The UIDesktop module (OpenRPA/Robot/UIDesktop.py)
|
||||||
|
########################################################################################
|
||||||
|
The UIDesktop is extension of the pywinauto module which provide access to the desktop apps by the **win32** and **ui automation** dll frameworks (big thx to the Microsoft :) ).
|
||||||
|
|
||||||
|
*Naming convention: \<InArgument\>\_\<ActivityName\>\_\<OutArgument - if exist>*<br>
|
||||||
|
|
||||||
|
|
||||||
|
****************************************************************************************************
|
||||||
|
Theory & practice. WEB app UI access (selenium)
|
||||||
|
****************************************************************************************************
|
||||||
|
|
||||||
|
About
|
||||||
|
###############################################
|
||||||
|
The pyOpenRPA support web app manipulation (by the Selenium lib).
|
||||||
|
More docs about selenium you can find here (https://selenium-python.readthedocs.io/)
|
||||||
|
|
||||||
|
How to use
|
||||||
|
###############################################
|
||||||
|
To start use selenium just import selenium modules in the robot tool. Here is the example of the usage.
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
from selenium import webdriver
|
||||||
|
from selenium.webdriver.common.keys import Keys
|
||||||
|
|
||||||
|
driver = webdriver.Chrome()
|
||||||
|
driver.get("http://www.python.org")
|
||||||
|
assert "Python" in driver.title
|
||||||
|
elem = driver.find_element_by_name("q")
|
||||||
|
elem.clear()
|
||||||
|
elem.send_keys("pycon")
|
||||||
|
elem.send_keys(Keys.RETURN)
|
||||||
|
assert "No results found." not in driver.page_source
|
||||||
|
driver.close()
|
||||||
|
|
||||||
|
****************************************************************************************************
|
||||||
|
Theory & practice. Keyboard & mouse manipulation
|
||||||
|
****************************************************************************************************
|
||||||
|
|
||||||
|
|
||||||
|
****************************************************************************************************
|
||||||
|
Theory & practice. Screen capture & image recognition
|
||||||
|
****************************************************************************************************
|
||||||
|
|
||||||
|
How to automate image recognition on PC
|
||||||
|
###########################################
|
||||||
|
|
||||||
|
Here you can find any ways you need to use in your business case:
|
||||||
|
- Find the exact match on the screen with the other image
|
||||||
|
- Use text recognition module (OCR)
|
||||||
|
- Use computer vision (CV) to identify the objects on screen/image/video
|
||||||
|
- Use artificial intelligence (AI) to make custom identification/classification/text recognition
|
||||||
@ -0,0 +1,10 @@
|
|||||||
|
####################################
|
||||||
|
4. Зависимости
|
||||||
|
####################################
|
||||||
|
|
||||||
|
Python 3 x32 [psutil, pywinauto, wmi, PIL, keyboard, pyautogui, win32api (pywin32), selenium, openCV, tesseract, requests, lxml, PyMuPDF]
|
||||||
|
Python 3 x64 [psutil, pywinauto, wmi, PIL, keyboard, pyautogui, win32api (pywin32), selenium, openCV, tesseract, requests, lxml, PyMuPDF]
|
||||||
|
pywinauto (Windows GUI automation)
|
||||||
|
Semantic UI CSS framework
|
||||||
|
JsRender by https://www.jsviews.com (switch to Handlebars)
|
||||||
|
Handlebars
|
||||||
@ -0,0 +1,5 @@
|
|||||||
|
************************
|
||||||
|
1. Описание
|
||||||
|
************************
|
||||||
|
|
||||||
|
pyOpenRPA Studio is the executable process.
|
||||||
@ -0,0 +1,126 @@
|
|||||||
|
####################################
|
||||||
|
2. Как использовать?
|
||||||
|
####################################
|
||||||
|
|
||||||
|
Content
|
||||||
|
=======
|
||||||
|
|
||||||
|
- `How to run <#how-to-run>`__
|
||||||
|
- `UI Description <#ui-description>`__
|
||||||
|
- `How to extract UI tree <#how-to-extract-ui-tree>`__
|
||||||
|
- `How to search UI object by mouse
|
||||||
|
hover <#how-to-search-ui-object-by-mouse-hover>`__
|
||||||
|
- `How to extract UI object
|
||||||
|
properties <#how-to-extract-ui-object-properties>`__
|
||||||
|
|
||||||
|
How to run
|
||||||
|
==========
|
||||||
|
|
||||||
|
- For OS x32
|
||||||
|
- Run (double click): OpenRPA\_32.cmd (for OS x32)
|
||||||
|
- For OS x64
|
||||||
|
- Run (double click): OpenRPA\_64.cmd (for OS x64)
|
||||||
|
- Wait text "running server" in console. Default browser will be open
|
||||||
|
automatically
|
||||||
|
- **Attention!** The studio tool does not support the Internet explorer
|
||||||
|
(any version) for GUI rendering (lol)
|
||||||
|
|
||||||
|
.. image:: /img/504b98f76747f63900a2943532a946bb.png
|
||||||
|
:alt: 504b98f76747f63900a2943532a946bb.png
|
||||||
|
|
||||||
|
|
||||||
|
UI Description
|
||||||
|
==============
|
||||||
|
|
||||||
|
**The studio tool GUI contains of:**
|
||||||
|
|
||||||
|
1. UI tree viewer
|
||||||
|
2. Selected UI object hierarchy list
|
||||||
|
3. Selected UI object property list
|
||||||
|
4. UIO selector editor
|
||||||
|
5. UIO action panel
|
||||||
|
6. Another Python activity panel
|
||||||
|
7. Action/activity list
|
||||||
|
|
||||||
|
*Look it on the GUI screenshots are listed below*
|
||||||
|
|
||||||
|
GUI Screenshot 1
|
||||||
|
----------------
|
||||||
|
|
||||||
|
.. image:: /img/d3d6ad14a7e50843bd89d2b14a092fee.png
|
||||||
|
:alt: 504b98f76747f63900a2943532a946bb.png
|
||||||
|
|
||||||
|
|
||||||
|
GUI Screenshot 2
|
||||||
|
----------------
|
||||||
|
|
||||||
|
.. image:: /img/65b7d51c0a5b21e6b27dc23d4062d3ca.png
|
||||||
|
:alt: 65b7d51c0a5b21e6b27dc23d4062d3ca.png
|
||||||
|
|
||||||
|
|
||||||
|
How to extract UI tree
|
||||||
|
======================
|
||||||
|
|
||||||
|
In order to extract the UI tree do the following: in ``UI tree viewer``
|
||||||
|
choose the object you are interested and click the button "Expand". ##
|
||||||
|
|
||||||
|
Action: Click the button "Expand"
|
||||||
|
---------------------------------------
|
||||||
|
|
||||||
|
.. image:: /img/6effc376ff6ea928840674bd744caced.png
|
||||||
|
:alt: 6effc376ff6ea928840674bd744caced.png
|
||||||
|
|
||||||
|
Result
|
||||||
|
---------------------------------------
|
||||||
|
|
||||||
|
.. image:: /img/18b9ab36126c8c32168bf5bbb9330701.png
|
||||||
|
:alt: 18b9ab36126c8c32168bf5bbb9330701.png
|
||||||
|
|
||||||
|
How to search UI object by mouse hover
|
||||||
|
---------------------------------------
|
||||||
|
In order to search UI object do the
|
||||||
|
following: in ``UI tree viewer`` choose the parent object, where you are
|
||||||
|
want to search UI object, and click the button "Mouse search". The mouse
|
||||||
|
search mode will start. Turn mouse on the UI object you are interested
|
||||||
|
and wait when the studio will highlight the UI object. After the
|
||||||
|
hightlight hold the "Ctrl" key and wait 3 seconds. The interested UI
|
||||||
|
object will be shown in ``UI tree viewer``.
|
||||||
|
|
||||||
|
Action: Click the button "Mouse search"
|
||||||
|
---------------------------------------
|
||||||
|
|
||||||
|
.. image:: /img/84d7e4de0c840631f87cf7b325b53ad8.png
|
||||||
|
:alt: 84d7e4de0c840631f87cf7b325b53ad8.png
|
||||||
|
|
||||||
|
Action: Turn mouse on the UI object you are interested and hold the "Ctrl" key for 3 seconds
|
||||||
|
--------------------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
.. image:: /img/b7c38d622bf5b7afa5b26d1686d7302a.png
|
||||||
|
:alt: b7c38d622bf5b7afa5b26d1686d7302a.png
|
||||||
|
|
||||||
|
Result: The interested UI object will be shown in ``UI tree viewer``
|
||||||
|
--------------------------------------------------------------------
|
||||||
|
|
||||||
|
.. image:: /img/629bbf4db2c01b9c640194230949fcd2.png
|
||||||
|
:alt: 629bbf4db2c01b9c640194230949fcd2.png
|
||||||
|
|
||||||
|
How to extract UI object properties
|
||||||
|
===================================
|
||||||
|
|
||||||
|
In order to extract UI object properties do the following: in
|
||||||
|
``Selected UI object hierarchy list`` choose the UI object you are
|
||||||
|
interested and click it. The UI object property list will be shown in
|
||||||
|
``Selected UI object property list``
|
||||||
|
|
||||||
|
Action: Choose the UI object you are interested and click it
|
||||||
|
------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
.. image:: /img/2c27be5bdde20b5d062cbb40e74eaec5.png
|
||||||
|
:alt: 2c27be5bdde20b5d062cbb40e74eaec5.png
|
||||||
|
|
||||||
|
Result: The UI object property list will be shown in ``Selected UI object property list``
|
||||||
|
-----------------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
.. image:: /img/f235ae29099a713e0246cd574ac3a17c.png
|
||||||
|
:alt: f235ae29099a713e0246cd574ac3a17c.png
|
||||||
|
|
||||||
@ -0,0 +1,30 @@
|
|||||||
|
####################################
|
||||||
|
2. Defs StopSafe
|
||||||
|
####################################
|
||||||
|
|
||||||
|
How to use StopSafe on the robot side
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
from pyOpenRPA.Tools import StopSafe
|
||||||
|
StopSafe.Init(inLogger=None)
|
||||||
|
StopSafe.IsSafeStop() # True - WM_CLOSE SIGNAL has come. taskkill /im someprocess.exe
|
||||||
|
|
||||||
|
|
||||||
|
.. automodule:: pyOpenRPA.Tools.StopSafe
|
||||||
|
:members:
|
||||||
|
:autosummary:
|
||||||
|
|
||||||
|
|
||||||
|
.. automodule:: pyOpenRPA.Tools.Debugger
|
||||||
|
:members:
|
||||||
|
:autosummary:
|
||||||
|
|
||||||
|
|
||||||
|
**********
|
||||||
|
References
|
||||||
|
**********
|
||||||
|
|
||||||
|
`reStructuredText`_
|
||||||
|
|
||||||
|
.. target-notes::
|
||||||
|
.. _`reStructuredText`: http://docutils.sourceforge.net/rst.html
|
||||||
File diff suppressed because it is too large
Load Diff
@ -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;
|
||||||
|
}
|
||||||
|
}
|
||||||
@ -0,0 +1 @@
|
|||||||
|
.fa:before{-webkit-font-smoothing:antialiased}.clearfix{*zoom:1}.clearfix:after,.clearfix:before{display:table;content:""}.clearfix:after{clear:both}@font-face{font-family:FontAwesome;font-style:normal;font-weight:400;src:url(fonts/fontawesome-webfont.eot?674f50d287a8c48dc19ba404d20fe713?#iefix) format("embedded-opentype"),url(fonts/fontawesome-webfont.woff2?af7ae505a9eed503f8b8e6982036873e) format("woff2"),url(fonts/fontawesome-webfont.woff?fee66e712a8a08eef5805a46892932ad) format("woff"),url(fonts/fontawesome-webfont.ttf?b06871f281fee6b241d60582ae9369b9) format("truetype"),url(fonts/fontawesome-webfont.svg?912ec66d7572ff821749319396470bde#FontAwesome) format("svg")}.fa:before{font-family:FontAwesome;font-style:normal;font-weight:400;line-height:1}.fa:before,a .fa{text-decoration:inherit}.fa:before,a .fa,li .fa{display:inline-block}li .fa-large:before{width:1.875em}ul.fas{list-style-type:none;margin-left:2em;text-indent:-.8em}ul.fas li .fa{width:.8em}ul.fas li .fa-large:before{vertical-align:baseline}.fa-book:before,.icon-book:before{content:"\f02d"}.fa-caret-down:before,.icon-caret-down:before{content:"\f0d7"}.fa-caret-up:before,.icon-caret-up:before{content:"\f0d8"}.fa-caret-left:before,.icon-caret-left:before{content:"\f0d9"}.fa-caret-right:before,.icon-caret-right:before{content:"\f0da"}.rst-versions{position:fixed;bottom:0;left:0;width:300px;color:#fcfcfc;background:#1f1d1d;font-family:Lato,proxima-nova,Helvetica Neue,Arial,sans-serif;z-index:400}.rst-versions a{color:#2980b9;text-decoration:none}.rst-versions .rst-badge-small{display:none}.rst-versions .rst-current-version{padding:12px;background-color:#272525;display:block;text-align:right;font-size:90%;cursor:pointer;color:#27ae60}.rst-versions .rst-current-version:after{clear:both;content:"";display:block}.rst-versions .rst-current-version .fa{color:#fcfcfc}.rst-versions .rst-current-version .fa-book,.rst-versions .rst-current-version .icon-book{float:left}.rst-versions .rst-current-version.rst-out-of-date{background-color:#e74c3c;color:#fff}.rst-versions .rst-current-version.rst-active-old-version{background-color:#f1c40f;color:#000}.rst-versions.shift-up{height:auto;max-height:100%;overflow-y:scroll}.rst-versions.shift-up .rst-other-versions{display:block}.rst-versions .rst-other-versions{font-size:90%;padding:12px;color:grey;display:none}.rst-versions .rst-other-versions hr{display:block;height:1px;border:0;margin:20px 0;padding:0;border-top:1px solid #413d3d}.rst-versions .rst-other-versions dd{display:inline-block;margin:0}.rst-versions .rst-other-versions dd a{display:inline-block;padding:6px;color:#fcfcfc}.rst-versions.rst-badge{width:auto;bottom:20px;right:20px;left:auto;border:none;max-width:300px;max-height:90%}.rst-versions.rst-badge .fa-book,.rst-versions.rst-badge .icon-book{float:none;line-height:30px}.rst-versions.rst-badge.shift-up .rst-current-version{text-align:right}.rst-versions.rst-badge.shift-up .rst-current-version .fa-book,.rst-versions.rst-badge.shift-up .rst-current-version .icon-book{float:left}.rst-versions.rst-badge>.rst-current-version{width:auto;height:30px;line-height:30px;padding:0 6px;display:block;text-align:center}@media screen and (max-width:768px){.rst-versions{width:85%;display:none}.rst-versions.shift{display:block}}
|
||||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
|
After Width: | Height: | Size: 434 KiB |
Binary file not shown.
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in new issue